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(11mo ago)06MITPHPPHP >=7.4

Since Jul 13Pushed 11mo agoCompare

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

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

25

—

LowBetter than 35% of packages

Maintenance50

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

354d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/20558256?v=4)[Osynapsy](/maintainers/osynapsy)[@osynapsy](https://github.com/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

[dachcom-digital/formbuilder

Pimcore FormBuilder - create forms easily!

94284.4k](/packages/dachcom-digital-formbuilder)[arsenaltech/nova-tab

A Laravel Nova field.

74131.2k](/packages/arsenaltech-nova-tab)

PHPackages © 2026

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