Passare dall’API Google Geocoding in una riga

Addrova offre un endpoint compatibile con Google. Nella maggior parte dei casi cambia l’URL di base e la chiave, e mantiene il resto del suo codice.

Guida rapida (EN)Vedere cosa è supportato

Prima e dopo

L’URL di base di produzione https://api.addrova.eu non è ancora online; il percorso qui sotto proviene dalla specifica dell’API.

Google

https://maps.googleapis.com/maps/api/geocode/json
  ?address=10+rue+de+Rivoli+Paris
  &key=GOOGLE_KEY

Addrova (endpoint compatibile)

https://api.addrova.eu/compat/google/maps/api/geocode/json
  ?address=10+rue+de+Rivoli+Paris
  &key=ADDROVA_KEY

Viene emulato solo il formato delle richieste e delle risposte. Non si usa alcun dato di Google.

Cosa è supportato

Elemento	Supporto
address	Geocodifica diretta
latlng	Geocodifica inversa (`lat,lng`)
components	Viene considerato solo `country:XX`
language, region	Accettati
Risposta	status, results con formatted_address, place_id, types, partial_match, address_components e geometry (location, location_type, viewport)
Errori	Nel formato Google: un campo `status` con HTTP 200, così i client esistenti continuano a funzionare
Estensione di Addrova	Un elenco `attribution`, ignorato dai client esistenti; lo mostri accanto ai risultati

Il valore di place_id è un identificatore di Addrova, non un place ID di Google: non li mescoli.

Lista di controllo per il passaggio

Sostituire l’URL di base, il prefisso del percorso e la chiave API.
Far passare un campione dei suoi indirizzi in entrambi i servizi e confrontare i risultati.
Mostrare l’attribuzione accanto ai risultati, come richiedono le licenze dei dati.
Una volta validato, conservare le coordinate nel suo database. Non si applica alcuna scadenza.

Perché la conservazione conta

Le condizioni di Google limitano il tempo per cui latitudine e longitudine possono essere tenute in cache, e solo gli identificatori di luogo possono essere conservati senza limiti (vedere le condizioni di Google Maps Platform e le politiche dell’API Geocoding). Se deve conservare le coordinate, verifichi le condizioni vigenti per il suo caso. Addrova consente la conservazione permanente.