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ć wskazaną trasę przez zmianę ich kolejności zatrzymuje się w bardziej efektywnej kolejności. 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 na trasie
Upewnij się, że żaden z punktów na trasie nie ma ustawionego parametru
via
natrue
, przez przykład:{"address": "Clare,SA", "via": true}
. Więcej informacji na temat: pośrednie punkty pośrednie, zobacz Określanie pośrednich punktów pośrednich.Upewnij się, że nagłówek
routing_preference
nie jest ustawiony naTRAFFIC_AWARE_OPTIMAL
.Ustaw
optimize_waypoint_order
natrue
. Na przykład:"optimizeWaypointOrder": "true",
Określ pole
routes.optimizedIntermediateWaypointIndex
w polu maska: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 podanych w żądaniu, zaczynając od 0;
Optymalizuje kolejność punktów pośrednich na podstawie ich numerów indeksu do punktów pośrednich w żądaniu.
Zwraca zoptymalizowaną kolejność punktów pośrednich w obiekcie
routes
w funkcjiwaypoint_order
w poluroutes.optimizedIntermediateWaypointIndex
.
Przykład
W tym żądaniu prosi się o zoptymalizowanie trasy z Adelaide w Australii Południowej do każdego z głównych regionów winiarskich w tej prowincji, a następnie o 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 indeksu dla czterech punktów pośrednich podanych w żądaniu, usługa zwraca następnie zoptymalizowaną kolejność:
"optimizedIntermediateWaypointIndex": [ 3, 2, 0, 1 ]