Omówienie obliczania macierzy tras

Compute Route Matrix to metoda w usłudze Routes API, która akceptuje żądanie HTTPS i zwraca odległości i czasy podróży dla macierzy tras między różnymi lokalizacjami początkowymi i docelowymi. Obliczaj czas podróży i odległość do wielu miejsc docelowych z uwzględnieniem maksymalnie 625 elementów trasy.

Potrzebujesz tras dojazdu? Jeśli interesują Cię wskazówki dojazdu, zapoznaj się z omówieniem Compute Routes.

Przeprowadzasz migrację? Jeśli przeprowadzasz migrację z interfejsu Distance Matrix API (starszego), zapoznaj się z instrukcjami migracji, zaczynając od sekcji Dlaczego warto przejść na interfejs Routes API.

Dlaczego warto korzystać z macierzy wyznaczania tras

Za pomocą interfejsu Compute Route Matrix możesz określać najbardziej efektywne trasy do planowania wysyłek, np.:

• Jak najlepiej przypisać grupę pracowników do odbioru serii paczek

• określać najlepszy magazyn, z którego można wysłać paczki do miejsca docelowego;

Co można robić za pomocą interfejsu Compute Route Matrix?

Za pomocą interfejsu Compute Route Matrix możesz uzyskać macierz możliwych tras między wieloma lokalizacjami początkowymi i końcowymi. W przypadku każdego żądania po stronie serwera możesz określić wiele punktów początkowych i docelowych, przy czym liczba punktów początkowych pomnożona przez liczbę punktów docelowych nie może przekraczać 625. Możesz przesyłać strumieniowo elementy odpowiedzi, zanim zostanie obliczona cała macierz, co zmniejsza opóźnienie odpowiedzi.

Możesz poprosić o te rodzaje danych o trasach, aby określić najskuteczniejszy sposób kierowania pasażerów, przesyłek lub pracowników między wieloma miejscami początkowymi i docelowymi:

• Odległość w kilometrach lub milach dla wybranego środka transportu

• Szacowany czas podróży w ruchu

Jak działa macierz wyznaczania tras

Metoda ComputeRouteMatrix akceptuje żądanie HTTP POST z treścią żądania w formacie JSON, która zawiera szczegóły żądania. Wymagane są co najmniej 1 punkt początkowy, co najmniej 2 punkty docelowe, travelMode i maska pola, która określa, które pola mają zostać zwrócone.

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

Odpowiedź zawiera możliwe trasy dla kombinacji wszystkich punktów pośrednich wylotu i docelowych.

Zasoby

W tabeli poniżej znajdziesz podsumowanie zasobów dostępnych za pomocą metody Compute Route Matrix interfejsu Routes API oraz zwracanych przez nią danych.

Jak korzystać z macierzy wyznaczania tras

Dostępne biblioteki klienta

Listę dostępnych bibliotek klienta dla metody Compute Route Matrix znajdziesz w sekcji Biblioteki klienta.

Co dalej?

• Pobieranie macierzy tras
• Dostępne opcje macierzy tras
• Wybieranie informacji do zwrócenia
• Migracja ze starszej wersji Distance Matrix API
• Migracja z wersji podglądowej interfejsu Routes API do wersji ogólnodostępnej