Inizia a utilizzare l'API Geocoding v4

Sviluppatori dello Spazio economico europeo (SEE)

Se il tuo indirizzo di fatturazione si trova nello Spazio economico europeo, a partire dall'8 luglio 2025, i Termini di servizio di Google Maps Platform per il SEE si applicheranno al tuo utilizzo dei servizi. La funzionalità varia in base alla regione. Scopri di più.

Prima di iniziare: prima di iniziare a utilizzare l'API Geocoding, devi avere un progetto con un account di fatturazione e le API Geocoding attive. Ti consigliamo di creare più proprietari del progetto e amministratori della fatturazione, in modo che il tuo team abbia sempre a disposizione qualcuno con questi ruoli. Per saperne di più, consulta Configurazione nella console Cloud.

L'API Geocoding v4 è un servizio che fornisce geocodifica, geocodifica inversa di indirizzi e ID luogo e informazioni sulla destinazione.

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 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)

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.

curl -H "X-Goog-Api-Key: YOUR_API_KEY" \
"https://geocode.googleapis.com/v4beta/geocode/address/1600+Amphitheatre+Parkway,+Mountain+View,+CA"

Puoi testare questa operazione inserendo l'URL nel browser web (assicurati di sostituire YOUR_API_KEY con la tua chiave API). La risposta include la latitudine e la longitudine dell'indirizzo.

Consulta la guida per gli sviluppatori per saperne di più su come creare URL di richieste di geocodifica, sui parametri disponibili e su come interpretare la risposta.

Di seguito è riportato un esempio di risposta di geocodifica in JSON:

{
  "results": [
    {
      "place": "//places.googleapis.com/places/ChIJ2Z2idB66j4ARI43TG-9RoCQ",
      "placeId": "ChIJ2Z2idB66j4ARI43TG-9RoCQ",
      "location": {
        "latitude": 37.4438238,
        "longitude": -122.0869895
      },
      "granularity": "ROOFTOP",
      "viewport": {
        "low": {
          "latitude": 37.4424748197085,
          "longitude": -122.0883384802915
        },
        "high": {
          "latitude": 37.445172780291493,
          "longitude": -122.08564051970852
        }
      },
      "formattedAddress": "1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
      "postalAddress": {
        "regionCode": "US",
        "languageCode": "en",
        "postalCode": "94043-1351",
        "administrativeArea": "CA",
        "locality": "Mountain View",
        "addressLines": [
          "1600 Amphitheatre Pkwy"
        ]
      },
      "addressComponents": [
        {
          "longText": "1600",
          "shortText": "1600",
          "types": [
            "street_number"
          ]
        },
        {
          "longText": "Amphitheatre Parkway",
          "shortText": "Amphitheatre Pkwy",
          "types": [
            "route"
          ],
          "languageCode": "en"
        },
        {
          "longText": "Mountain View",
          "shortText": "Mountain View",
          "types": [
            "locality",
            "political"
          ],
          "languageCode": "en"
        },
        {
          "longText": "Santa Clara County",
          "shortText": "Santa Clara County",
          "types": [
            "administrative_area_level_2",
            "political"
          ],
          "languageCode": "en"
        },
        {
          "longText": "California",
          "shortText": "CA",
          "types": [
            "administrative_area_level_1",
            "political"
          ],
          "languageCode": "en"
        },
        {
          "longText": "United States",
          "shortText": "US",
          "types": [
            "country",
            "political"
          ],
          "languageCode": "en"
        },
        {
          "longText": "94043",
          "shortText": "94043",
          "types": [
            "postal_code"
          ]
        },
        {
          "longText": "1351",
          "shortText": "1351",
          "types": [
            "postal_code_suffix"
          ]
        }
      ],
      "types": [
        "premise",
        "street_address"
      ]
    }
  ]
}

Richiesta e risposta di geocodifica inversa (ricerca indirizzo)

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://geocode.googleapis.com/v4beta/geocode/location/37.4225508,-122.0846338?key=YOUR_API_KEY

Puoi 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 su come creare URL di richiesta di geocodifica inversa, sui parametri disponibili e su come interpretare la risposta.

Di seguito è riportato un esempio di risposta di geocodifica inversa in formato JSON:

{
  "results": [
    {
      "place": "//places.googleapis.com/places/ChIJHRNUiQK6j4ARJ__Hrbt6qsE",
      "placeId": "ChIJHRNUiQK6j4ARJ__Hrbt6qsE",
      "location": {
        "latitude": 37.4225657,
        "longitude": -122.08465439999999
      },
      "granularity": "ROOFTOP",
      "viewport": {
        "low": {
          "latitude": 37.421214719708509,
          "longitude": -122.08603273029148
        },
        "high": {
          "latitude": 37.423912680291508,
          "longitude": -122.0833347697085
        }
      },
      "bounds": {
        "low": {
          "latitude": 37.4225178,
          "longitude": -122.08484599999998
        },
        "high": {
          "latitude": 37.422609600000008,
          "longitude": -122.0845215
        }
      },
      "formattedAddress": "Google Building 40, 1600 Amphitheatre Pkwy, Mountain View, CA 94043, USA",
      "postalAddress": {
        "regionCode": "US",
        "languageCode": "en",
        "postalCode": "94043",
        "administrativeArea": "CA",
        "locality": "Mountain View",
        "addressLines": [
          "Google Building 40",
          "1600 Amphitheatre Pkwy"
        ]
      },
      "addressComponents": [
        {
          "longText": "Google Building 40",
          "shortText": "Google Building 40",
          "types": [
            "premise"
          ],
          "languageCode": "en"
        },
        {
          "longText": "1600",
          "shortText": "1600",
          "types": [
            "street_number"
          ]
        },
        {
          "longText": "Amphitheatre Parkway",
          "shortText": "Amphitheatre Pkwy",
          "types": [
            "route"
          ],
          "languageCode": "en"
        },
        {
          "longText": "Mountain View",
          "shortText": "Mountain View",
          "types": [
            "locality",
            "political"
          ],
          "languageCode": "en"
        },
        {
          "longText": "Santa Clara County",
          "shortText": "Santa Clara County",
          "types": [
            "administrative_area_level_2",
            "political"
          ],
          "languageCode": "en"
        },
        {
          "longText": "California",
          "shortText": "CA",
          "types": [
            "administrative_area_level_1",
            "political"
          ],
          "languageCode": "en"
        },
        {
          "longText": "United States",
          "shortText": "US",
          "types": [
            "country",
            "political"
          ],
          "languageCode": "en"
        },
        {
          "longText": "94043",
          "shortText": "94043",
          "types": [
            "postal_code"
          ]
        }
      ],
      "types": [
        "street_address",
        "subpremise"
      ]
    },
    ... Additional results truncated in this example[] ...
}

Autenticazione, quote, prezzi e norme

Autenticazione

Per utilizzare l'API Geocoding, devi prima abilitarla e ottenere le credenziali di autenticazione appropriate. Per saperne di più, consulta la pagina Guida introduttiva 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.

Nota: durante l'anteprima, i metodi dell'API Geocoding v4 sono limitati a 25 query al secondo (QPS). Per informazioni su come richiedere una quota più elevata, consulta Visualizza e gestisci le quote e seleziona API Geocoding come servizio.

Norme

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