Omówienie obliczania macierzy tras

Deweloperzy z Europejskiego Obszaru Gospodarczego (EOG)

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

Potrzebujesz wskazówek dojazdu? Jeśli interesują Cię wskazówki dojazdu, zapoznaj się z artykułem Omówienie wyznaczania tras.

Przenoszenie danych? Jeśli migrujesz z interfejsu Distance Matrix API (starszej wersji), zapoznaj się z instrukcjami migracji, zaczynając od sekcji Dlaczego warto przejść na interfejs Routes API.

Dlaczego warto korzystać z interfejsu Compute Routes Matrix

Korzystając z macierzy wyznaczania tras, możesz określić najbardziej efektywne trasy do zaplanowania wysyłki, takie jak:

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

  • Określanie najlepszego magazynu, z którego można wysłać paczki do ich ostatecznego miejsca przeznaczenia

Co można zrobić za pomocą funkcji obliczania macierzy tras?

Za pomocą funkcji obliczania macierzy wyznaczania tras możesz uzyskać macierz możliwych tras pomiędzy wieloma punktami początkowymi i końcowymi. W jednym żądaniu po stronie serwera możesz podać wiele źródeł i miejsc docelowych, przy czym liczba źródeł może być pomnożona przez liczbę miejsc docelowych, co daje maksymalnie 625 miejsc. Możesz przesyłać strumieniowo elementy odpowiedzi, zanim zostanie obliczona cała tablica, co zmniejsza opóźnienie odpowiedzi.

Aby określić najbardziej wydajny sposób kierowania pasażerów, przesyłek lub pracowników między wieloma punktami początkowymi i docelowymi, możesz poprosić o te rodzaje danych dotyczących tras:

  • Odległość w kilometrach lub milach w wybranym trybie podróżowania

  • Szacowany czas podróży w trakcie

Jak działa macierz wyznaczania tras

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

Przykład

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 źródła i celu.

Zasoby

Tabela poniżej zawiera podsumowanie zasobów dostępnych za pomocą metody Compute Route Matrix interfejsu Routes API oraz danych zwracanych przez tę metodę.

Zasoby danych Zwrócone dane Format zwracanej wartości
ComputeRouteMatrix Zwraca tablicę dróg od jednego punktu początkowego do jednego punktu docelowego. JSON

Jak korzystać z macierzy wyznaczania tras

1 Konfiguracja Zacznij od skonfigurowania projektu Google Cloud, a następnie wykonaj instrukcje konfiguracji.
2 Informacje o sposobie rozliczania interfejsu Routes API Więcej informacji znajdziesz w artykule Wykorzystanie i rozliczenia.
3 Obliczanie macierzy tras i sprawdzanie odpowiedzi Więcej informacji znajdziesz w artykułach Pobieranie macierzy tras i Sprawdzanie odpowiedzi z macierzy tras.

Dostępne biblioteki klienta

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

Co dalej?