Impostare un punto di accesso per un percorso

Per impostazione predefinita, i tappe intermedi vengono utilizzati per fermarsi in caso di fermate e discese, ma puoi anche specificare che un Waypoint intermedio serve solo per attraversarlo.

Una route che contiene un Waypoint di origine, un Waypoint intermedio pass-through e un Waypoint di destinazione contiene solo una tratta di percorso che collega l'origine e la destinazione, mentre passa per il Waypoint intermedio (chiamato via).

Configura un Waypoint intermedio in modo che sia un Waypoint pass-through impostando la proprietà via del Waypoint su true utilizzando Waypoint (REST) o Waypoint (gRPC).

La proprietà via è più efficace quando si creano percorsi in risposta all'utente che trascina i tappe sulla mappa. In questo modo l'utente può vedere in tempo reale l'aspetto che potrebbe avere la route finale e garantire che le tappe siano posizionate in luoghi accessibili da Compute Route.

Attenzione: l'utilizzo del prefisso via: per evitare le soste genera percorsi rigorosamente interpretati del Waypoint. Questa interpretazione potrebbe causare gravi deviazioni sul percorso o ZERO_RESULTS nel codice di stato della risposta se l'API Routes non è in grado di creare un percorso attraverso quel punto.

L'esempio seguente mostra come contrassegnare un Waypoint intermedio come Passaggio di passaggio.

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

Consente di accedere agli ID luogo per i punti intermedi intermedi

Se specifichi la posizione di un punto di partenza, di arrivo o intermedio come stringa 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 dei waypoint, insieme a dati aggiuntivi sulla località.

Nota: se un Waypoint viene specificato come ID luogo o come coordinate di latitudine/longitudine, viene omesso dai risultati di ricerca dell'ID luogo.

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

Ad esempio:

• Puoi specificare tre tappe intermedie in una richiesta. Due di questi waypoint sono specificati tramite stringhe di indirizzi e uno tramite coordinate di latitudine/longitudine.

• Includi geocodingResults nella maschera del campo di risposta per indicare di 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 dei tre tappe. Questi sono iwaypoint negli indici 0 e 2 della richiesta. Poiché il Waypoint all'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"
      }
    ]
  }
}