Impostare un punto di accesso per un percorso

Per impostazione predefinita, le tappe intermedie vengono utilizzate per fermarsi per le corse di andata e ritorno, ma puoi anche specificare che una tappa intermedia deve essere attraversata.

Un percorso che contiene una tappa di origine, una tappa intermedia e una tappa di destinazione contiene solo un tratto che collega l'origine e la destinazione, mentre passa attraverso la tappa intermedia (detta via).

Per configurare un waypoint intermedio come waypoint passthrough, imposta la proprietà via del waypoint su true utilizzando Waypoint (REST) o Waypoint (gRPC).

La proprietà via è più efficace quando crei percorsi in risposta all'utente che trascina le tappe sulla mappa. In questo modo l'utente può vedere in tempo reale l'aspetto del percorso finale e assicurarsi che le tappe siano posizionate in località accessibili alle route Compute.

L'esempio seguente mostra come contrassegnare una tappa intermedia come tappa del passaggio.

{
  "location": {
    "latLng": {
      "latitude":37.419734,
      "longitude":-122.0827784
    }
  },
  "via": true
}

Accedi agli ID dei luoghi per le tappe intermedie

Se specifichi la posizione di un'origine, una destinazione o una tappa intermedia come stringa di indirizzo o come Plus Code, l'API tenta di trovare la località più pertinente con un ID luogo corrispondente. L'array geocodingResults.intermediates nei risultati contiene l'ID luogo corrispondente alla posizione delle tappe, insieme a dati aggiuntivi sulla località.

Per ogni elemento dell'array intermediates, utilizza la proprietà intermediateWaypointRequestIndex per determinare quale tappa intermedia nella richiesta corrisponde all'ID luogo nella risposta.

Ad esempio:

• Devi specificare tre tappe intermedie in una richiesta. Due di queste tappe sono specificate da stringhe di indirizzi e uno da coordinate di latitudine/longitudine.

• Includi geocodingResults nella maschera del campo di risposta per specificare che deve restituire l'array geocodingResults nei risultati.

curl -X POST -d '{
  "origin":{
    "address": "1600 Amphitheatre Parkway, Mountain View, CA"
  },
  "destination":{
    "address": "24 Willie Mays Plaza, San Francisco, CA 94107"
  },
  "intermediates": [
    {
      "address": "450 Serra Mall, Stanford, CA 94305, USA"
    },
    {
      "location":{
        "latLng":{
          "latitude": 37.419734,
          "longitude": -122.0807784
        }
      }
    },
    {
      "address": "1836 El Camino Real, Redwood City, CA 94063"
    }
  ],
  "travelMode": "DRIVE",
}'
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY'
-H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.legs,geocodingResults'
'https://routes.googleapis.com/directions/v2:computeRoutes'

La risposta include l'array geocodingResults contenente l'ID luogo per l'origine, la destinazione e per due delle tre tappe. Questi sono i waypoint agli indici 0 e 2 della richiesta. Poiché il waypoint nell'indice 1 della richiesta è stato specificato utilizzando le coordinate di latitudine/longitudine, viene omesso dall'array geocodingResults nella risposta.

{
  "routes": [{...}],
  "geocodingResults": {
    "origin": {
      "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJj38IfwK6j4ARNcyPDnEGa9g"
    },
    "destination": {
     "geocoderStatus": {},
      "type": [
        "premise"
      ],
      "placeId": "ChIJI7ES6tl_j4ARVpDZoXbWAiY"
    },
    "intermediates": [
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 0,
        "type": [
            "street_address"
        ],
        "placeId": "ChIJvdLMGyq7j4ARScE5tWX_C0Y"
      },
      {
        "geocoderStatus": {},
        "intermediateWaypointRequestIndex": 2,
        "type": [
          "premise"
        ],
        "placeId": "ChIJkTc0GKajj4AR9UMsOSHwGD0"
      }
    ]
  }
}