Punti di navigazione

Sviluppatori dello Spazio economico europeo (SEE)

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_POINTSextra 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.