L'API Geocoding è un servizio che fornisce geocodifica e geocodifica inversa di indirizzi.
La geocodifica è il processo di conversione degli indirizzi (ad es. la via). in coordinate geografiche (come latitudine e longitudine), che puoi utilizzare per inserire gli indicatori su una mappa o posizionarla.
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 è stato assegnato un ID luogo.
Esempio di richiesta e risposta
Puoi accedere all'API Geocoding tramite un'interfaccia HTTP. Persone che seguo sono esempi di richieste di geocodifica e geocodifica inversa.
Richiesta e risposta di geocodifica (ricerca di latitudine/longitudine)
Nell'esempio seguente vengono richieste 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 tuo 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 . creare URL di richieste di geocodifica e 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"
}
Inverti richiesta e risposta di geocodifica (ricerca indirizzo)
Nell'esempio seguente viene richiesto 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_KEY
Puoi verificarlo inserendo l'URL nel tuo browser web (assicurati di sostituire "YOUR_API_KEY" con la tua chiave API effettiva). La risposta include un indirizzo leggibile per la latitudine e la longitudine in ogni località.
Consulta la guida per gli sviluppatori per ulteriori informazioni . creando URL di richieste di geocodifica inversa e 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 consentono di sviluppare con le API del servizio web di Google Maps fornendo servizi semplici, implementazioni native di attività comuni, come autenticazione, limitazione e nuovo tentativo automatico. L'API Geocoding è disponibile nel 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 abilitare l'API e ottenere le credenziali di autenticazione appropriate. Per ulteriori informazioni, vedi Inizia a utilizzare Google Maps Platform.
Quote e prezzi
Rivedi l'utilizzo e la fatturazione pagina per maggiori dettagli su quote e prezzi impostati per l'API Geocoding.
Norme
L'utilizzo dell'API Geocoding deve essere conforme alle Norme relative alle API.
Scopri di più
Ma puoi fare molto di più con l'API Geocoding. Consulta le guida per gli sviluppatori dell'API Geocoding per altre demo. esempi, parametri disponibili, codici di stato e messaggi di errore e altri dettagli.
Lo La guida per gli sviluppatori dell'API Geocoding descrive 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 piattaforme su quelle di livello inferiore.