I descrittori degli indirizzi restituiscono informazioni aggiuntive alla risposta di geocodifica inversa standard, che consente di descrivere le coordinate di latitudine e longitudine utilizzando punti di riferimento e aree. Guarda la demo dei descrittori degli indirizzi per esplorare l'API.
Richieste di geocodifica inverse - Parametri aggiuntivi
Parametri facoltativi
Di seguito sono riportati i parametri facoltativi che puoi includere in una richiesta di geocodifica inversa:
enable_address_descriptor
: un parametro booleano da includere nella richiesta di geocodifica inversa per aggiungere il descrittore di indirizzo alla risposta di geocodifica inversa standard.
Esempio di geocodifica inversa
La seguente query contiene il valore di latitudine/longitudine per una località a Delhi:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&key=YOUR_API_KEY&enable_address_descriptor=true
Risposta
La query precedente restituisce un address_descriptor
aggiuntivo, come segue:
{
"address_descriptor" : {
"areas" : [
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Turkman Gate"
},
"place_id" : "ChIJ_7LLvyb9DDkRMKKxP9YyXgs"
},
{
"containment" : "OUTSKIRTS",
"display_name" : {
"language_code" : "en",
"text" : "Chandni Chowk"
},
"place_id" : "ChIJWcXciBr9DDkRUb4dCDykTwI"
},
{
"containment" : "NEAR",
"display_name" : {
"language_code" : "en",
"text" : "Katar Ganj"
},
"place_id" : "ChIJH3cWUyH9DDkRaw-9CjvcRvY"
}
],
"landmarks" : [
{
"display_name" : {
"language_code" : "en",
"text" : "Delite Cinema"
},
"straight_line_distance_meters" : 29.9306755065918,
"place_id" : "ChIJLfiYDCT9DDkROoEa7NdupUM",
"travel_distance_meters" : 418.7794799804688,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "establishment", "movie_theater", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "YES Bank"
},
"straight_line_distance_meters" : 66.83731079101562,
"place_id" : "ChIJFYHM3yb9DDkRRKGkZl2mpSQ",
"travel_distance_meters" : 489.0340270996094,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "UCO Bank"
},
"straight_line_distance_meters" : 25.38849639892578,
"place_id" : "ChIJ-c6_wCb9DDkRjIk1LeqRtGM",
"travel_distance_meters" : 403.2246398925781,
"spatial_relationship" : "ACROSS_THE_ROAD",
"types" : [ "atm", "bank", "establishment", "finance", "point_of_interest" ]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Delhi By Cycle Meeting Point"
},
"straight_line_distance_meters" : 44.02867126464844,
"place_id" : "ChIJNxVfkSb9DDkRJD22l-eGFdM",
"travel_distance_meters" : 97.41281890869141,
"spatial_relationship" : "AROUND_THE_CORNER",
"types" : [
"establishment",
"point_of_interest",
"tourist_attraction",
"travel_agency"
]
},
{
"display_name" : {
"language_code" : "en",
"text" : "Axis Bank Branch"
},
"straight_line_distance_meters" : 102.3495178222656,
"place_id" : "ChIJr3uaDCT9DDkR8roHTVSn1x4",
"travel_distance_meters" : 330.8566284179688,
"spatial_relationship" : "DOWN_THE_ROAD",
"types" : [ "bank", "establishment", "finance", "point_of_interest" ]
}
]
},
... Results (reverse geocoding response) ...
In ogni oggetto address_descriptor
sono presenti due array: landmarks
e
areas
. L'array landmarks
contiene fino a 5 risultati classificati in ordine di pertinenza tenendo conto della vicinanza alla coordinata richiesta, della prevalenza del punto di riferimento e della sua visibilità. Ogni risultato di punto di riferimento contiene i seguenti valori:
place_id
è l'ID luogo del risultato dei punti di riferimento. Consulta la panoramica di Place ID.display_name
è il nome visualizzato del punto di riferimento e contienelanguage_code
etext
.straight_line_distance_meters
è la distanza punto a punto in metri tra la coordinata di input e il risultato dei punti di riferimento.travel_distance_meters
è la distanza in metri percorsa attraverso la rete stradale (senza indicare i limiti stradali) tra la coordinata di input e il risultato dei punti di riferimento.spatial_relationship
è la relazione stimata tra la coordinata di input e il risultato dei punti di riferimento:"NEAR"
è la relazione predefinita quando non si applica nessuno dei seguenti casi."WITHIN"
quando la coordinata di input è contenuta entro i limiti della struttura associata al punto di riferimento."BESIDE"
quando la coordinata di input è direttamente adiacente al punto di accesso o al punto di accesso del punto di riferimento."ACROSS_THE_ROAD"
quando la coordinata di input è esattamente opposta al punto di riferimento sull'altro lato del percorso."DOWN_THE_ROAD"
quando la coordinata di input si trova lungo lo stesso percorso del punto di riferimento, ma non"BESIDES"
o"ACROSS_THE_ROAD"
."AROUND_THE_CORNER"
quando la coordinata di input si trova lungo una rotta perpendicolare come punto di riferimento (limitata a una singola svolta)."BEHIND"
quando la coordinata di input è spaziale vicina al punto di riferimento, ma lontana dal suo punto di accesso.types
sono i tipi di luogo del punto di riferimento.
L'oggetto areas
contiene fino a tre risposte e si limita ai luoghi che
rappresentano regioni di piccole dimensioni, come quartieri, zone secondarie e grandi
complessi. Le aree che contengono la coordinata richiesta sono elencate per prime e sono ordinate dalla più piccola alla più grande. Ogni risultato di areas
contiene i seguenti valori:
place_id
è l'ID luogo del risultato delle aree. Consulta la panoramica di Place ID.display_name
è il nome visualizzato dell'area e contienelanguage_code
etext
.containment
è la relazione di contenimento stimata tra la coordinata di input e il risultato delle aree:"NEAR"
è la relazione predefinita quando non si applica nessuno dei seguenti casi."WITHIN"
quando la coordinata di input è vicina al centro dell'area."OUTSKIRTS"
quando la coordinata di input è vicina al bordo dell'area.
Copertura
Questa funzionalità è disponibile soltanto in determinati paesi.
Feedback
Si tratta di una funzionalità sperimentale e vorremmo ricevere un feedback. Invia un'email all'indirizzo address-descriptors-feedback@google.com.