Forse non tutti lo sanno: è possibile utilizzare il geocoder di Google senza visualizzare la relativa mappa. Questo "giochetto" può tornare utile per diversi scopi: dalla popolazione di database alla compilazione di campi di moduli... L'unica limitazione è la nostra fantasia...

Vediamo in questo primo tutorial della serie (lanciata ormai quasi 2 mesi fa, mannaggia, come vola il tempo) come attivare il geocoder e utilizzarlo senza dover per forza visualizzare la nostra Google Maps.

Questa piccola introduzione presenterà la funzione geocode() che ci servirà (modificata o meno) in tutte le altre "lezioni".

Cosa ci serve per partire?

• Un editor HTML (scegliete il vostro preferito)
• Una Google Maps API Key (vale anche se inserite "localhost" come sito web)
• Un browser (preferibilmente Firefox)

Partiamo: per prima cosa dobbiamo caricare gli script di supporto alle Google Maps. Funziona tutto come al solito: c'è una funzione load() da chiamare al caricamento della pagina e una funzione GUnload() che verrà chiamata all'uscita.

Troverete un esempio che vi fornisce un primo "setup" della pagina web da utilizzare quando richiederete la chiave API

var geocoder = null;
 
function load()
{
	if (GBrowserIsCompatible())
	{
		// Creo GeoCoder assegnandolo alla variabile globale
		geocoder = new GClientGeocoder();
	}
}

Notate la variabile var geocoder = null presente fuori dalla funzione. Lì finirà il nostro geocoder in attesa di richieste

La funzione che si occupa di interrogare il geocoder si chiama (viva la fantasia) geocode() e riceve come unico parametro l'indirizzo da codificare.

function geocode(indirizzo)
{
	var address = indirizzo + ", Italia";
	geocoder.getLatLng(address,
	function(point)
	{
		if (!point)
		{
			// Indirizzo non trovato
			alert(address + " non trovato!");
		}
		else
		{
			// Utilizzo i dati ricavati dal geocoder
			alert(address + "\n" +
                               "Longitudine: " + point.x + "\n" +
                               "Latitudine: " + point.y);
		}
	});
}

Cosa fa questa funzione? Riceve come parametro il nostro indirizzo (guardate i link dell'esempio per la corretta formattazione della stringa da passare), aggiunge alla stringa la parola "Italia" (altro aiuto per un corretto geocoding) e interroga il geocoder utilizzando la funzione getLatLng().

getLatLng() riceve due parametri: il primo è ovviamente l'indirizzo da ricercare, mentre il secondo è una funzione di callback (in questo caso ho utilizzato una funzione anonima, ma nulla vieta di usare una funzione dichiarata precedentemente) che si occuperà di gestire il punto ritornato.

Prevedete sempre un set di istruzioni che gestisca l'eventuale errore del geocoder: in questo caso viene lanciato un alert() che segnala che l'indirizzo non è stato trovato.

Se il punto è stato trovato ci viene restituito un oggetto point da cui possiamo ricavare le coordinate X e Y da utilizzare come più ci piace.

Qui il primo esempio della serie.

Se usate firebug (usatelo!) noterete che viene chiamata, al click sul link, la pagina http://maps.google.com/maps/geo?output=json (più qualche altro parametro, come l'indirizzo cercato e la chiave API utilizzata): ci tornerà utile più avanti.

Beh, per oggi basta, fate qualche esperimento (cambiando i link) e troverete che per ottenere il tasso più basso possibile di errori vi toccherà comporre l'indirizzo passato in questo modo:

indirizzo, comune, regione, nazione

Almeno, questo è quello che mi permette di codificare il maggior numero di indirizzi possibile senza troppi errori. Noterete anche che a volte il geocoder fa differenza tra le vie con nome composto da due parore (Via Giuseppe Garibaldi e Via Garibaldi, ad esempio) per alcuni indirizzi.

Occhio quindi, una verifica dei dati è sempre da fare!!!

Ci sono domande?

P.s.
Questa e le altre puntate (che seguiranno a brevissimo) saranno tutte raccolte in un "ebook" che troverete qui sul blog alla fine della serie