Negli ultimi mesi ho lavorato ad un mio progetto personale, Oltre Tata, probabilmente alcuni di voi ne avranno già sentito parlare. In pratica un motore di ricerca geolocalizzato attraverso il quale agevolare l’incontro tra domanda ed offerta di educatrice familiari e famiglie.
In questo progetto ho esplorato in maniera dettagliata vari servizi esterni di geolocalizzazione, in pratica dei servizi web che prendono in input un indirizzo e restituiscono come risultato un punto nello spazio terrestre identificato attraverso la latitudine e la longitudine.
Il mio requisito principale era quello di avere più di un servizio attivo in modo da diminuire il rischio di non avere una risposta in caso il servizio fosse down o non trovasse l’indirizzo stesso. Dato questo requisito ho iniziato a studiare i vari servizi in giro per la rete e alla fine ne ho scelti due: Google Geocoding e OpenStreetMap Nominatim.
Scelti i due servizi ho deciso di creare un componente php 5.3 che fosse trasparente nelle configurazione dei servizi e nel modo in cui il mio codice potesse comunicare con loro ed è nato GeoAdapter. Il componente è rilasciato sotto licenza MIT.
L’architettura del componente è suddivisa in una classe Search che si occupa di passare la query ai servizi. Due classi di servizio che adattano l’interfaccia di Google Geocoding e OpenStreetMap Nominatim all’interfaccia della classe Search, una classe SearchCache che serve a crare una cache delle richieste fatte in modo da abbassare il numero di chiamate che si fa al servizio e una classe Location che viene restituita come risultato della ricerca che rappresenta il punto cercato e implementa un metodo per cercare la distanza tra due punti.
Il componente è del tutto configurabile e estendendo l’interfaccia Service è possibile aggiungere altri servizi di geolocalizzazione. Di seguito un esempio di utilizzo del componente:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
| require_once(__DIR__.'/../lib/Geo/Autoload.php');
Geo\Autoload::register();
class Search extends Geo\Search
{
protected function configure()
{
$this->addService(new Geo\Service\OpenStreetMap\Nominatim);
$this->addService(new Geo\Service\GoogleMap\GeoCode);
}
}
$search = new Search();
$search->query('via Montenapoleone, Milano');
$location_a = $search->getFirst();
$search->query('piazza Boccolino, Osimo');
$location_b = $search->getFirst();
echo 'Address1: via Montenapoleone, Milano'.PHP_EOL;
echo 'Latitude: '.$location_a->getLatitude().PHP_EOL;
echo 'Longitude: '.$location_a->getLongitude().PHP_EOL.PHP_EOL;
echo 'Address2: piazza Boccolino, Osimo'.PHP_EOL;
echo 'Latitude: '.$location_b->getLatitude().PHP_EOL;
echo 'Longitude: '.$location_b->getLongitude().PHP_EOL.PHP_EOL;
echo 'Distance from Address1 to Address2: '.$location_a->distance($location_b).' Km'.PHP_EOL; |
Questo codice restituirà il seguente output:
Address1: via Montenapoleone, Milano
Latitude: 45.4685166
Longitude: 9.1948891
Address2: piazza Boccolino, Osimo
Latitude: 43.4863912
Longitude: 13.4825126
Distance from Address1 to Address2: 251.64 Km
Attraverso questo componente sono ruscito a localizzare tutte le educatrici che si iscrivono ad Oltre Tata e a memorizzare in fase di regitrazione del loro profilo le loro coordinate geospaziali.
Una volta memorizzate le loro coordinate su database ho dovuto creare una query che dato il punto di ricerca della famiglia restituisse in un raggio di 30km tutte le educatrici disponibili. Un post di Derick mi è corso in aiuto e dopo un’attenta lettura di tutte le funzioni trigonometriche per il calcolo delle distanze ho trovato la soluzione implementando la seguente formula in una query SQL:
acos( sin(latA) * sin(latB) +cos(latA) * cos(latB) * cos(longB - longA) ) * 3956
dove latA è la latitudine del punto A, latB è la latitudine del punto B, longB è la longitudine del punto B e longA è la longitudine del punto A. Alla fine della formula moltiplico tutto per 3956 per avere il totale in km. Tutti i valori di latitudine e longitudine devono essere dati in valoti radianti.
In questo modo ad esempio se voglio cercare babysitter a milano il sistema cerca prima il punto di ricerca e poi trova tutte le educatrici nelle vicinanze di quel punto, stessa cosa per le altre città come Roma, Napoli, Ancona e così via.
Sentitevi liberi di clonare GeoAdapeter e di aggiungere ulteriori servizi, o di migliorare il componente, però mi raccomando inviatemi le vostre pull request 
!!
