Pośrednie punkty pośrednie są domyślnie używane do zatrzymywania w przypadku odbioru i oddania, ale możesz też określić, że pośredni punkt pośredni ma służyć tylko do przejazdu.
Trasa zawierająca punkt drogi źródłowej, punkt drogi pośredniej, przez który można przejść, i punkt drogi docelowej zawiera tylko 1 etap, który łączy miejsce wyjazdu z miejscem docelowym, przechodząc przez punkt pośredni (nazywany via
).
Skonfiguruj pośredni punkt pośredni jako punkt pośredni, ustawiając właściwość via
punktu pośredniego na true
przy użyciu Waypoint (REST) lub Waypoint (gRPC).
Właściwość via
sprawdza się najlepiej przy tworzeniu tras w odpowiedzi na przeciąganie punktów na mapie przez użytkownika. Dzięki temu użytkownik może zobaczyć w czasie rzeczywistym, jak może wyglądać końcowa trasa, i ma pewność, że punkty na trasie są umieszczone w lokalizacjach dostępnych dla tras Compute.
Poniższy przykład pokazuje, jak oznaczyć pośredni punkt pośredni jako punkt pośredni.
{ "location": { "latLng": { "latitude":37.419734, "longitude":-122.0827784 } }, "via": true }
Dostęp do identyfikatorów miejsc pośrednich punktów pośrednich
Jeśli określisz lokalizację punktu początkowego, docelowego lub pośredniego punktu pośredniego jako ciągu adresu lub kodu plusa, interfejs API spróbuje znaleźć najtrafniejszą 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.
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 określasz trzy pośrednie 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 wylotu, miejsca docelowego i 2 z 3 punktów na trasie. Są to punkty kontrolne o indeksach 0 i 2 w żądaniu. Punkt pośredni w pozycji 1 żądania został określony za pomocą współrzędnych szerokości i długości geograficznej, dlatego w odpowiedzi jest pomijany w tablicy geocodingResults
.
{ "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" } ] } }