Optymalizuj kolejność przystanków na trasie

Domyślnie interfejs Routes API Compute Routes oblicza trasę przez wiele przystanków, nazywanych punktami pośrednimi, w w określonej kolejności.

Interfejs Routes API może zoptymalizować wskazaną trasę przez zmianę ich kolejności zatrzymuje się w bardziej efektywnej kolejności. Optymalizacja punktów pośrednich pod kątem podróży w czasie, ale uwzględnia też inne czynniki, takie jak odległość i liczba skrętów podczas wyboru najodpowiedniejszej trasy.

Optymalizacja punktów na trasie

  1. Upewnij się, że żaden z punktów na trasie nie ma ustawionego parametru via na true, 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.

  2. Sprawdź, czy routing_preference nie ma wartości TRAFFIC_AWARE_OPTIMAL.

  3. Ustaw optimize_waypoint_order na true. Na przykład:

    "optimizeWaypointOrder": "true",
    
  4. 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 na trasie:

  1. Automatycznie indeksuje punkty na trasie na podstawie podanej przez Ciebie kolejności ich w żądaniu, zaczynając od 0.

  2. Optymalizuje kolejność punktów pośrednich na podstawie ich numerów indeksu przypisane do punktów pośrednich w żądaniu.

  3. Zwraca zoptymalizowaną kolejność punktów pośrednich w obiekcie routes w funkcji waypoint_order w polu routes.optimizedIntermediateWaypointIndex.

Przykład

Ta prośba dotyczy optymalizacji trasy z Adelaide w Australii Południowej, do każdego z głównych regionów winiarskich w Australii Południowej, a potem wróci do Adelajdy.

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": "Connawarra,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.optimizedIntermediateWaypointIndex' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

Interfejs Routes API indeksuje pośrednie punkty pośrednie podane w od 0. Na przykład:

0    {"address": "Barossa+Valley,SA"},
1    {"address": "Clare,SA"},
2    {"address": "Connawarra,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
            ]