Ustawianie punktu na drodze, przez którą przechodzi

Domyślnie punkty pośrednie służą do zatrzymywania się w celu podjęcia lub wysadzania pasażera, ale możesz też określić, że punkt pośredni ma służyć tylko do przejazdu.

Trasa zawierająca punkt kontrolny źródła, punkt kontrolny pośredni przelotu i punkt kontrolny miejsca docelowego zawiera tylko 1 etap, który łączy miejsce wylotu z miejscem docelowym, przechodząc przez punkt kontrolny pośredni (nazywany via).

Skonfiguruj pośredni punkt kontrolny jako punkt kontrolny przelotowy, ustawiając właściwość via punktu kontrolnego na true za pomocą Waypoint (REST) lub Waypoint (gRPC).

Właściwość via jest najbardziej skuteczna podczas tworzenia tras w odpowiedzi na przeciąganie punktów na mapie przez użytkownika. Dzięki temu użytkownik może zobaczyć, jak może wyglądać ostateczna trasa w czasie rzeczywistym, i zapewnić, że punkty pośrednie są umieszczane w miejscach dostępnych dla usługi Obliczanie tras.

Uwaga: stosowanie prefiksu via: w celu uniknięcia przystanków powoduje, że trasy są ściśle interpretowane jako punkty drogi. Taka interpretacja może spowodować znaczne objazdy na trasie lub kod stanu ZERO_RESULTS w odpowiedzi, jeśli interfejs Routes API nie może utworzyć trasy przez ten punkt.

Ten przykład pokazuje, jak oznaczyć punkt pośredni jako punkt przelotu.

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

Dostęp do identyfikatorów miejsc docelowych na trasie

Jeśli określisz lokalizację punktu początkowego, docelowego lub pośredniego jako ciąg znaków adresu lub kod plus, interfejs API spróbuje znaleźć najbardziej odpowiednią lokalizację, która ma odpowiedni identyfikator miejsca. Tablica geocodingResults.intermediates w wynikach zawiera identyfikator miejsca odpowiadający lokalizacji punktów kontrolnych wraz z dodatkowymi danymi o tej lokalizacji.

Uwaga: jeśli punkt kontrolny jest określony jako identyfikator miejsca lub współrzędne geograficzne, jest pomijany w wynikach wyszukiwania identyfikatora miejsca.

W przypadku każdego elementu tablicy intermediates użyj właściwości intermediateWaypointRequestIndex, aby określić, który punkt pośredni w żądaniu odpowiada identyfikatorowi miejsca w odpowiedzi.

Na przykład:

• W żądaniu podajesz 3 punkty pośrednie. Dwa z nich są określone za pomocą ciągów adresów, a jeden – za pomocą współrzędnych szerokości i długości geograficznej.

• W polu maski odpowiedzi uwzględniasz element geocodingResults, aby zwrócić w wynikach tablicę geocodingResults.

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'

Odpowiedź zawiera tablicę geocodingResults z identyfikatorem miejsca docelowego, miejsca wylotu i 2 z 3 punktów pośrednich. Są to punkty kontrolne o indeksach 0 i 2 w żądaniu. Punkt kontrolny o indeksie 1 w żądaniu został określony za pomocą współrzędnych geograficznych, dlatego został pominięty w tablicy geocodingResults w odpowiedzi.

{
  "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"
      }
    ]
  }
}