PHPackages                             osynapsy/geocoding - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. osynapsy/geocoding

ActiveLibrary[Utility & Helpers](/categories/utility)

osynapsy/geocoding
==================

Geocoding module for Osynapsy framework

1.0(10mo ago)06MITPHPPHP >=7.4

Since Jul 13Pushed 10mo agoCompare

[ Source](https://github.com/osynapsy/geocoding)[ Packagist](https://packagist.org/packages/osynapsy/geocoding)[ RSS](/packages/osynapsy-geocoding/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependenciesVersions (2)Used By (0)

Osynapsy\\Geocoding
===================

[](#osynapsygeocoding)

Un package professionale e flessibile per la geocodifica di indirizzi da usare in contesti backend-driven.

✨ Caratteristiche principali
----------------------------

[](#-caratteristiche-principali)

- Provider multipli: Nominatim, Google, OpenCage
- Fallback automatico
- Supporto a endpoint configurabili e chiavi API esterne
- Interfaccia `ProviderInterface`
- Completamente testabile e conforme a PSR-4

🔧 Installazione
---------------

[](#-installazione)

```
composer require osynapsy/geocoding
```

⚡ Esempio d'uso
---------------

[](#-esempio-duso)

```
use Osynapsy\Geocoding\Geocoder;
use Osynapsy\Geocoding\Provider\Nominatim;
use Osynapsy\Geocoding\Provider\Google;
use Osynapsy\Geocoding\Provider\OpenCage;

$geocoder = new Geocoder([
    new Nominatim(),
    new Google('GOOGLE_API_KEY'),
    new OpenCage('OPENCAGE_API_KEY')
]);

$location = $geocoder->locate('Via Roma 10, Milano');

if ($location) {
    echo $location->lat . ',' . $location->lng;
}
```

🧱 Implementazione di un nuovo provider
--------------------------------------

[](#-implementazione-di-un-nuovo-provider)

Crea una classe che implementa `ProviderInterface` e implementa:

```
public function getCoordinates(string $address): ?Location;
```

📬 Contatti
----------

[](#-contatti)

Creato da [Pietro Celeste](mailto:p.celeste@qanda.cc) per il framework Osynapsy.

⚠ Licenza
---------

[](#-licenza)

MIT

###  Health Score

26

—

LowBetter than 43% of packages

Maintenance54

Moderate activity, may be stable

Popularity4

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity36

Early-stage or recently created project

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

309d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/226ca9f83b5b027ed3c17cdba7c9d1893e04b748380cf80a1c2975cdf824389a?d=identicon)[osynapsy](/maintainers/osynapsy)

---

Top Contributors

[![osynapsy](https://avatars.githubusercontent.com/u/20558256?v=4)](https://github.com/osynapsy "osynapsy (4 commits)")

### Embed Badge

![Health badge](/badges/osynapsy-geocoding/health.svg)

```
[![Health](https://phpackages.com/badges/osynapsy-geocoding/health.svg)](https://phpackages.com/packages/osynapsy-geocoding)
```

###  Alternatives

[php-unoconv/php-unoconv

Unoconv PHP, an Object Oriented library for easy file conversion with LibreOffice's unoconv

77345.9k2](/packages/php-unoconv-php-unoconv)[laminas/laminas-migration

Migrate a Zend Framework project or third-party library to target Laminas/Expressive/Apigility

6056.1k6](/packages/laminas-laminas-migration)[firegento/extendedimport

Extended Import Features (ported from AvS\_FastSimpleImport)

6344.1k1](/packages/firegento-extendedimport)[ezsystems/symfony-tools

eZ Systems Symfony Tools

19306.9k2](/packages/ezsystems-symfony-tools)[venveo/craft-bulkedit

Bulk edit Craft CMS element fields

24125.6k](/packages/venveo-craft-bulkedit)[ada-u/chocoflake

64bit time based id generator

14117.3k](/packages/ada-u-chocoflake)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)