I descrittori di indirizzo includono informazioni aggiuntive che aiutano a descrivere una località utilizzando punti di riferimento e aree. Dai un'occhiata alla demo dei descrittori di indirizzi per esplorare la funzionalità.
Parametri aggiuntivi
I descrittori degli indirizzi possono essere attivati tramite l'utilizzo del parametro extra_computations. Includi extra_computations=ADDRESS_DESCRIPTORS in una richiesta di geocodifica
, in una richiesta di geocodifica inversa
o in una richiesta di geocodifica di luoghi
per ricevere i descrittori degli indirizzi nella tua risposta.
Esempio di geocodifica
La seguente query contiene l'indirizzo di un luogo a Delhi:
https://maps.googleapis.com/maps/api/geocode/json?address=4118,+Kalan+Mehal+Chandni+Chowk,+New+Delhi&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Esempio di geocodifica dei luoghi
La seguente query contiene l'ID luogo di un luogo a Delhi:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJyxAX8Bj9DDkRgBfAnBYa66Q&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Esempio di geocodifica inversa
La seguente query contiene il valore della latitudine/longitudine per una località di Delhi:
https://maps.googleapis.com/maps/api/geocode/json?latlng=28.640964,77.235875&extra_computations=ADDRESS_DESCRIPTORS&key=YOUR_API_KEY
Risposta
Un esempio di address_descriptor è il seguente:
{
"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" ]
}
]
}
}
In ogni oggetto address_descriptor sono presenti due array: landmarks e
areas. L'array landmarks contiene fino a 5 risultati classificati in ordine di
pertinente 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 posizione del risultato dei punti di riferimento. Consulta la panoramica dell'ID luogo.display_nameè il nome visualizzato del punto di riferimento e contienelanguage_codeetext.straight_line_distance_metersè la distanza in metri tra la coordinata di input e il risultato dei punti di riferimento.travel_distance_metersè la distanza in metri percorsa tramite la rete stradale (ignorando le limitazioni stradali) tra la coordinata inserita 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 nessuna delle seguenti condizioni."WITHIN"quando la coordinata di input è contenuta nei limiti della struttura associata al punto di riferimento."BESIDE"quando la coordinata inserita è direttamente adiacente al punto di riferimento o al punto di accesso del punto di riferimento."ACROSS_THE_ROAD"quando la coordinata inserita si trova direttamente di fronte 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 un percorso perpendicolare come il punto di riferimento (limitato a un singolo tornante)."BEHIND"quando la coordinata di input è spaziale vicina al punto di riferimento, ma lontana dal suo punto di accesso.typessono 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 areas contiene i seguenti valori:
place_idè l'ID luogo del risultato delle aree. Consulta la panoramica dell'ID luogo.display_nameè il nome visualizzato dell'area e contienelanguage_codeetext.containmentè la relazione di contenimento stimata tra la coordinata di input e il risultato delle aree:"NEAR"è la relazione predefinita quando non si applica nessuna delle seguenti condizioni."WITHIN"quando la coordinata di input è vicina al centro dell'area."OUTSKIRTS"quando la coordinata inserita è vicina al bordo dell'area.
Copertura
I descrittori degli indirizzi sono disponibili in tutte le regioni. Per informazioni dettagliate, consulta la copertura per regione.
Feedback
Questa è una funzionalità in anteprima e ci farebbe piacere ricevere un feedback. Invia un'email all'indirizzo address-descriptors-feedback@google.com.