Inizia

L'API Geocoding è un servizio che fornisce geocodifica e geocodifica inversa degli indirizzi.

La geocodifica è il processo di conversione degli indirizzi (come una via) in coordinate geografiche (come latitudine e longitudine), che puoi utilizzare per posizionare degli 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.

Esempio di richiesta e risposta

Puoi accedere all'API Geocoding tramite un'interfaccia HTTP. Di seguito sono riportati alcuni esempi di richieste di geocodifica e di geocodifica inversa.

Richiesta e risposta di geocodifica (ricerca 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 verificare 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 richieste di geocodifica e sui parametri disponibili e per comprendere 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 di indirizzi)

L'esempio seguente richiede l'indirizzo corrispondente a una latitudine/longitudine specificata a Brooklyn, NY, USA. e 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_KEY

Puoi verificarlo 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 richieste di geocodifica inversa e sui parametri disponibili e per comprendere 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 dei servizi web di Google Maps fornendo implementazioni semplici e native di attività comuni, come autenticazione, limitazione delle richieste e nuovi tentativi automatici. L'API Geocoding è disponibile in client Java, client Python, client Go e client Node.js per i servizi Google Maps.

Autenticazione, quote, prezzi e criteri

Autenticazione

Per utilizzare l'API Geocoding, devi prima abilitarla e ottenere le credenziali di autenticazione corrette. Per maggiori informazioni, consulta la guida introduttiva a Google Maps Platform.

Quote e prezzi

Consulta la pagina relativa a utilizzo e fatturazione per i dettagli sulle quote e sui prezzi impostati per l'API Geocoding.

Criteri

L'utilizzo dell'API Geocoding deve essere conforme alle norme relative alle API.

Scopri di più

Puoi fare di più con l'API Geocoding. Consulta la guida per gli sviluppatori dell'API Geocoding per ulteriori demo, esempi, parametri disponibili, codici di stato, 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 dispositivi mobili che vogliono utilizzare i dati di geocodifica all'interno di mappe fornite da una delle API Google Maps Platform.