osynapsy / geocoding
Geocoding module for Osynapsy framework
1.0
2025-07-13 19:42 UTC
Requires
- php: >=7.4
This package is auto-updated.
Last update: 2025-07-13 19:45:06 UTC
README
Un package professionale e flessibile per la geocodifica di indirizzi da usare in contesti backend-driven.
✨ 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
composer require osynapsy/geocoding
⚡ Esempio d'uso
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
Crea una classe che implementa ProviderInterface
e implementa:
public function getCoordinates(string $address): ?Location;
📬 Contatti
Creato da Pietro Celeste per il framework Osynapsy.
⚠ Licenza
MIT