Il campo navigation_points
all'interno della risposta di geocodifica contiene un elenco di punti utili per raggiungere il luogo. Nello specifico, devono essere
utilizzati come punti di partenza o di arrivo quando si calcola un percorso su una rete stradale da
o verso il luogo. Ogni punto di navigazione contiene i seguenti valori:
location
contiene il valore di latitudine e longitudine del punto di navigazione. Questa posizione sarà sempre molto vicina alla rete stradale e rappresenta un punto di partenza o di arrivo ideale per raggiungere un luogo. Il punto è intenzionalmente leggermente spostato rispetto alla linea centrale della strada per indicare chiaramente il lato della strada in cui si trova il luogo.restricted_travel_modes
è un elenco di modalità di trasporto da cui non è possibile raggiungere il punto di navigazione:"DRIVE"
è la modalità di viaggio corrispondente alle indicazioni stradali."WALK"
è la modalità di viaggio corrispondente alle indicazioni a piedi.road_name
contiene il nome della strada da cui è offset il punto di navigazione.
I punti di navigazione vengono restituiti per la maggior parte dei luoghi con una posizione precisa, ad esempio indirizzi stradali, edifici e attività commerciali. I luoghi che rappresentano aree di grandi dimensioni, come città e regioni, in cui una posizione esatta può essere ambigua potrebbero non restituire punti di navigazione.
Avviso di migrazione
A partire dal 17 aprile, devi fornire il parametro NAVIGATION_POINTS
extra
computations nella richiesta per ricevere i punti di navigazione. I clienti possono
testare questa funzionalità verificando che il campo road_name
in alcuni punti di navigazione
venga restituito e che il campo location
in ogni punto di navigazione contenga i
seguenti quattro campi secondari (lat
, lng
, latitude
, longitude
).
Inoltre, devi eseguire la migrazione ai campi location.lat
e location.lng
anziché ai campi location.latitude
e location.longitude
. In una release futura, le richieste che non contengono il parametro NAVIGATION_POINTS
per i calcoli aggiuntivi non includeranno punti di navigazione nella risposta e i campi location.latitude
e location.longitude
non verranno più restituiti.
Dettagli della richiesta
Puoi ottenere punti di navigazione nei seguenti tipi di richieste:
Per una qualsiasi di queste richieste, fornisci questo parametro:
extra_computations=NAVIGATION_POINTS
.
Esempio di richiesta
La seguente query utilizza il geocoding del luogo per ottenere i punti di navigazione per un ristorante a Mountain View, California, Stati Uniti:
https://maps.googleapis.com/maps/api/geocode/json?place_id=ChIJZ54APTS3j4ARBYZD956MHq8&extra_computations=NAVIGATION_POINTS&key=YOUR_API_KEY
Esempio di risposta
La risposta alla query precedente mostra un array di punti di navigazione:
{
"navigation_points": [
{
"location": {
"lat": 37.3940894,
"lng": -122.0788389,
},
"restricted_travel_modes": ["WALK"],
"road_name": "Castro Street"
},
{
"location": {
"lat": 37.394273,
"lng": -122.0793078,
},
"restricted_travel_modes": ["WALK"],
"road_name": "Wild Cherry Lane"
},
{
"location": {
"lat": 37.3941202,
"lng": -122.0789189,
},
"restricted_travel_modes": ["DRIVE"]
}
]
}
Feedback
Questa è una funzione sperimentale. Apprezziamo il tuo feedback all'indirizzo geocoding-feedback-channel@google.com.