L'API Geocoding è un servizio che fornisce la geocodifica e la geocodifica inversa degli indirizzi.
La geocodifica è il processo di conversione di indirizzi (ad esempio un indirizzo stradale) in coordinate geografiche (ad esempio latitudine e longitudine), che puoi utilizzare per inserire indicatori su una mappa o posizionare la mappa.
La geocodifica inversa è il processo di conversione delle coordinate geografiche in un indirizzo leggibile.
Puoi anche utilizzare l'API Geocoding per trovare l'indirizzo di un determinato ID luogo.
Richiesta e risposta di esempio
Accedi all'API Geocoding tramite un'interfaccia HTTP. Di seguito sono riportati esempi di richieste di geocodifica e geocodifica inversa.
Richiesta e risposta di geocodifica (ricerca di latitudine/longitudine)
Il seguente esempio richiede la latitudine e la longitudine di "1600 Amphitheatre Parkway, Mountain View, CA" e specifica che l'output deve essere in formato JSON.
https://maps.googleapis.com/maps/api/geocode/json?address=1600+Amphitheatre+Parkway,+Mountain+View,+CA&key=YOUR_API_KEY
Puoi testarlo inserendo l'URL nel browser web (assicurati di sostituire
YOUR_API_KEY con la tua chiave API effettiva).
La risposta include la latitudine e la longitudine dell'indirizzo.
Consulta la guida per gli sviluppatori per ulteriori informazioni su come creare URL di richiesta di geocodifica e su parametri disponibili nonché su come interpretare la risposta.
Di seguito è riportato un esempio di risposta di geocodifica in JSON:
{ "results" : [ { "address_components" : [ { "long_name" : "1600", "short_name" : "1600", "types" : [ "street_number" ] }, { "long_name" : "Amphitheatre Parkway", "short_name" : "Amphitheatre Pkwy", "types" : [ "route" ] }, { "long_name" : "Mountain View", "short_name" : "Mountain View", "types" : [ "locality", "political" ] }, { "long_name" : "Santa Clara County", "short_name" : "Santa Clara County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "California", "short_name" : "CA", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "94043", "short_name" : "94043", "types" : [ "postal_code" ] } ], "formatted_address" : "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA", "geometry" : { "location" : { "lat" : 37.4267861, "lng" : -122.0806032 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 37.4281350802915, "lng" : -122.0792542197085 }, "southwest" : { "lat" : 37.4254371197085, "lng" : -122.0819521802915 } } }, "place_id" : "ChIJtYuu0V25j4ARwu5e4wwRYgE", "plus_code" : { "compound_code" : "CWC8+R3 Mountain View, California, United States", "global_code" : "849VCWC8+R3" }, "types" : [ "street_address" ] } ], "status" : "OK" }
Richiesta e risposta di geocodifica inversa (ricerca indirizzo)
L'esempio seguente richiede l'indirizzo corrispondente a una determinata latitudine/longitudine a Brooklyn, New York, Stati Uniti. Specifica che l'output deve essere in formato JSON.
https://maps.googleapis.com/maps/api/geocode/json?latlng=40.714224,-73.961452&key=YOUR_API_KEYPuoi verificare inserendo l'URL nel browser web (assicurati di sostituire "YOUR_API_KEY" con la tua chiave API effettiva). La risposta include un indirizzo leggibile per la posizione con la latitudine e la longitudine.
Consulta la guida per gli sviluppatori per ulteriori informazioni su come creare URL di richiesta di geocodifica inversa e su parametri disponibili nonché su come interpretare la risposta.
Di seguito è riportato un esempio di risposta di geocodifica inversa in JSON:
{ "plus_code" : { "compound_code" : "P27Q+MC New York, NY, USA", "global_code" : "87G8P27Q+MC" }, "results" : [ { "address_components" : [ { "long_name" : "279", "short_name" : "279", "types" : [ "street_number" ] }, { "long_name" : "Bedford Avenue", "short_name" : "Bedford Ave", "types" : [ "route" ] }, { "long_name" : "Williamsburg", "short_name" : "Williamsburg", "types" : [ "neighborhood", "political" ] }, { "long_name" : "Brooklyn", "short_name" : "Brooklyn", "types" : [ "political", "sublocality", "sublocality_level_1" ] }, { "long_name" : "Kings County", "short_name" : "Kings County", "types" : [ "administrative_area_level_2", "political" ] }, { "long_name" : "New York", "short_name" : "NY", "types" : [ "administrative_area_level_1", "political" ] }, { "long_name" : "United States", "short_name" : "US", "types" : [ "country", "political" ] }, { "long_name" : "11211", "short_name" : "11211", "types" : [ "postal_code" ] } ], "formatted_address" : "279 Bedford Ave, Brooklyn, NY 11211, USA", "geometry" : { "location" : { "lat" : 40.7142484, "lng" : -73.9614103 }, "location_type" : "ROOFTOP", "viewport" : { "northeast" : { "lat" : 40.71559738029149, "lng" : -73.9600613197085 }, "southwest" : { "lat" : 40.71289941970849, "lng" : -73.96275928029151 } } }, "place_id" : "ChIJT2x8Q2BZwokRpBu2jUzX3dE", "plus_code" : { "compound_code" : "P27Q+MC Brooklyn, New York, United States", "global_code" : "87G8P27Q+MC" }, "types" : [ "bakery", "cafe", "establishment", "food", "point_of_interest", "store" ] }, ... Additional results truncated in this example[] ... ], "status" : "OK" }
Inizia a programmare con le nostre librerie client
Le librerie client semplificano lo sviluppo con le API di servizio web di Google Maps fornendo implementazioni native semplici di attività comuni, come l'autenticazione, la limitazione delle richieste e il nuovo tentativo automatico. L'API Geocoding è disponibile nel client Java, nel client Python, nel client Go e nel client Node.js per i servizi Google Maps.
Autenticazione, quote, prezzi e norme
Autenticazione
Per utilizzare l'API Geocoding, devi prima attivarla e ottenere le credenziali di autenticazione appropriate. Per ulteriori informazioni, consulta Introduzione a Google Maps Platform.
Quote e prezzi
Consulta la pagina Utilizzo e fatturazione per informazioni dettagliate sulle quote e sui prezzi impostati per l'API Geocoding.
Norme
L'utilizzo dell'API Geocoding deve essere conforme alle norme relative alle API.
Scopri di più
Puoi fare molto di più con l'API Geocoding. Consulta la guida per gli sviluppatori dell'API Geocoding per ulteriori demo, esempi, parametri disponibili, codici di stato e messaggi di errore e altri dettagli.
La guida per gli sviluppatori dell'API Geocoding descrive il servizio web dell'API Geocoding. È destinata agli sviluppatori di siti web e mobile che vogliono utilizzare i dati di geocodifica all'interno delle mappe forniti da una delle API di Google Maps Platform.