L’algoritmo opera secondo un principio banale:

• utilizzando la provincia si effettua una query e si estrae il primo marker M1 con coordinate (Lat1,Lng1)
• utilizzando la stringa ottenuta dalla concatenazione di provincia e comune si effettua una query e si estrae dalla lista di marker potenzialmente ritornati, quello più vicino a M1, detto marker M2
• utilizzando la stringa ottenuta dalla concatenazione di provincia e comune ed indirizzo si effettua una query e si estrae dalla lista di marker potenzialmente ritornati, quello più vicino a M2, detto marker M3
• se M3 è diverso da null il codice ritorna M3, altrimenti, se M2 è diverso da null il codice ritorna M2. Nel caso che sia M3 che M2 siano nulli il codice ritorna M1 (che auspicabilmente è non nullo).

In questo modo specificando separatamente provincia, comune ed indirizzo abbiamo più possibilità di avere un risultato (anche in caso di typo nell’input utente) ed una maggiore accuratezza. Ad esempio la libreria ritorna un risultato valido per la query “via+akjsnckxjnjncnds+pistoia+quarrata“, ritornando le coordinate di un punto non ben precisato di Quarrata (comunque meglio di null).

Come usare la libreria JCoord

Per utilizzare JCoord è necessario scaricare il binario JCoord.jar ed includerlo nel proprio progetto Java. La libreria dipende da diversi  altri jar, ma per comodità ho combinato tutto in un unico archivio ready-to-use. 

Una volta inclusa la libreria nel progetto vediamo nello snippet sotto come utilizzarla per risolvere una coppia di coordinate a partire da un indirizzo:

// init variables
String provincia = "Pistoia";
String comune = "Agliana";
String address = "Viale Roma 34";

// call the static method of JCooord
LatLng coord = GeoCodeResolver.findExactCoordForAddress(provincia, comune, address);

// get coordinate as double values
double latidude = coord.getLat();
double longitude = coord.getLng();

A parte le linee di inizializzazione e get delle cooordinate quindi la risoluzione dell’indirizzo si limita ad una sola linea di codice, che può essere tranquillamente chiamata sia da un applicazione desktop che da un bean di un’applicazione web.

Alternativamente è possibile chiamare la libreria in modo tradizionale, passando un’unica stringa, senza utilizzare l’algoritmo di ottimizzazione. In questo caso la chiamata è ancora più semplice:

// init variables
String address = "Pistoia Agliana Viale Roma 34";

// call the static method of JCooord
LatLng coord = GeoCodeResolver.findCoordForAddress(address);

// get coordinate as double values
double latidude = coord.getLat();
double longitude = coord.getLng();

Download

Potete scaricare la libreria alla URL sotto (eh su un Like non costa nulla :-p):

[wp-like-locker]

Scarica JCoord.jar: http://elbuild.com/jcoord/JCoord.jar

[/wp-like-locker]