Punti di navigazione

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 per i percorsi 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 e partire da un luogo. Il punto è intenzionalmente leggermente spostato dalla linea di mezzeria della strada per contrassegnare chiaramente il lato della strada in cui si trova il luogo.
  • restricted_travel_modes è un elenco di modalità di viaggio da cui non è possibile accedere al 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 rispetto alla quale è applicato l'offset del punto di navigazione.

I punti di navigazione vengono restituiti per la maggior parte dei luoghi con una posizione precisa, ad esempio indirizzi, edifici e stabilimenti. 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, per ricevere i punti di navigazione devi fornire il parametro NAVIGATION_POINTS calcoli extra nella richiesta. I clienti possono verificarlo controllando che il campo road_name all'interno di alcuni punti di navigazione venga restituito e che il campo location all'interno di 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 di calcoli aggiuntivi NAVIGATION_POINTS 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 qualsiasi di queste richieste, fornisci questo parametro: extra_computations=NAVIGATION_POINTS.

Richiesta di esempio

La seguente query utilizza il geocoding dei luoghi per ottenere punti di navigazione per un ristorante a Mountain View, in 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. Ti invitiamo a inviare un feedback all'indirizzo geocoding-feedback-channel@google.com.