Domyślnie metoda interfejsu Routes API Compute Routes
oblicza trasę z kilkoma przystankami, zwanymi punktami pośrednimi, w kolejności, w jakiej je podasz.
Interfejs Routes API może zoptymalizować podany szlak, zmieniając kolejność przystanków na bardziej efektywną. Optymalizacja punktów kontrolnych optymalizuje czas podróży, ale przy podejmowaniu decyzji o najbardziej efektywnej trasie bierze pod uwagę także inne czynniki, takie jak odległość i liczba zakrętów.
Optymalizacja punktów pośrednich
Upewnij się, że żaden z punktów pośrednich na trasie nie ma wartości
via
ustawionej natrue
, na przykład{"address": "Clare,SA", "via": true}
. Więcej informacji o pośrednich punktach pośrednich znajdziesz w artykule Określanie pośrednich punktów pośrednich.Sprawdź, czy
routing_preference
nie ma wartościTRAFFIC_AWARE_OPTIMAL
.Ustaw
optimize_waypoint_order
natrue
. Na przykład:"optimizeWaypointOrder": "true",
W polu maski wskaż pole
routes.optimizedIntermediateWaypointIndex
:REST
-H X-Goog-FieldMask: routes.optimizedIntermediateWaypointIndex
RPC
const (fieldMask = "routes.optimizedIntermediateWaypointIndex")
Jak optymalizować kolejność punktów na trasie
Oto jak interfejs Routes API optymalizuje kolejność punktów pośrednich na trasie:
Automatycznie indeksuje punkty pośrednie na podstawie kolejności podanej w żądaniu, zaczynając od 0.
Optymalizuje kolejność punktów kontrolnych za pomocą numerów indeksu przypisanych do punktów kontrolnych w żądaniu.
Zwraca kolejność punktów kontrolnych zoptymalizowanych w obiekcie
routes
w poluwaypoint_order
w sekcjiroutes.optimizedIntermediateWaypointIndex
.
Przykład
Prośba o optymalizację trasy z Adelaide w Australii Południowej do każdego z głównych regionów winiarskich w Australii Południowej, a potem powrót do Adelaide.
curl -X POST -H 'content-type: application/json' -d ' { "origin": { "address": "Adelaide,SA" }, "destination": { "address": "Adelaide,SA" }, "intermediates": [ {"address": "Barossa+Valley,SA"}, {"address": "Clare,SA"}, {"address": "Coonawarra,SA"}, {"address": "McLaren+Vale,SA"} ], "travelMode": "DRIVE", "optimizeWaypointOrder": "true" }' \ -H 'Content-Type: application/json' \ -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes,geocodingResults.intermediates.intermediateWaypointRequestIndex' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
Interfejs Routes API indeksuje pośrednie punkty kontrolne podane w żądaniu, zaczynając od 0. Na przykład:
0 {"address": "Barossa+Valley,SA"}, 1 {"address": "Clare,SA"}, 2 {"address": "Coonawarrav,SA"}, 3 {"address": "McLaren+Vale,SA"}
Korzystając z numerów indeksów 4 punktów kontrolnych podanych w żądaniu, usługa zwraca zoptymalizowany porządek:
"optimizedIntermediateWaypointIndex": [ 3, 2, 0, 1 ].