L'API Geocoding è un servizio che fornisce la geocodifica e la geocodifica inversa degli indirizzi.
La geocodifica è il processo di conversione degli indirizzi (come un indirizzo stradale) in coordinate geografiche (come latitudine e longitudine), che puoi utilizzare per posizionare indicatori su una mappa o per 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 ID luogo specifico.
Richiesta e risposta di esempio
Puoi accedere 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)
L'esempio seguente 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 verificarlo 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 sulla creazione di URL di richiesta di geocodifica, sui parametri disponibili e sulla comprensione della 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 di indirizzi)
Il seguente esempio 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 testare questa operazione 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 di latitudine e longitudine.
Consulta la guida per gli sviluppatori per ulteriori informazioni sulla creazione di URL di richiesta di geocodifica inversa, sui parametri disponibili e sulla comprensione della risposta.
Di seguito è riportato un esempio di risposta di geocodifica inversa in formato 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 ti aiutano a sviluppare con le API del servizio web Google Maps fornendo implementazioni integrate di attività comuni, come autenticazione, limitazione delle richieste e riprovo automatico. L'API Geocoding è disponibile nei client Java, Python, Go e Node.js per i servizi Google Maps.
Autenticazione, quote, prezzi e norme
Autenticazione
Per utilizzare l'API Geocoding, devi prima abilitarla e ottenere le credenziali di autenticazione appropriate. Per ulteriori informazioni, consulta Inizia a utilizzare 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ù
L'API Geocoding offre molte altre possibilità. Per ulteriori demo, esempi, parametri disponibili, codici di stato e messaggi di errore e altri dettagli, consulta la Guida per gli sviluppatori dell'API Geocoding.
La guida per gli sviluppatori dell'API Geocoding descrive il servizio web dell'API Geocoding. È destinata agli sviluppatori di siti web e app mobile che vogliono utilizzare i dati di geocodifica all'interno delle mappe fornite da una delle API di Google Maps Platform.