Obliczanie macierzy tras

Możesz obliczyć odległość i czas trwania trasy dla wielu punktów początkowych i docelowych, korzystając z metody ComputeRouteMatrix interfejsu Routes Preferred API. ComputeRouteMatrix obsługuje zarówno strumieniowe wywołania gRPC, jak i wywołania REST HTTP.

Na podstawie listy par punktów początkowych i docelowych ComputeRouteMatrixoblicza odległość i czas trwania trasy rozpoczynającej się w każdym punkcie początkowym i kończącej się w każdym punkcie docelowym. Każdy element strumienia odpowiada informacjom o jednej trasie.

Metoda ComputeRouteMatrix ma kilka zalet w porównaniu z interfejsem Distance Matrix API (starsza wersja):

  • Streaming umożliwia zwracanie elementów, zanim zostanie obliczona cała macierz, co zmniejsza opóźnienie.
  • ComputeRouteMatrix ma szczegółowe opcje obliczania ruchu, dzięki czemu możesz podejmować decyzje dotyczące kompromisu między jakością a opóźnieniem.
  • Żądania są wykonywane w infrastrukturze Google z wyższym priorytetem, co zapewnia większą dostępność.
  • Możesz określić kierunek jazdy i informacje o stronie drogi dla punktów pośrednich.
  • Możesz poprosić o zwrócenie informacji o opłatach drogowych wraz z długością trasy i szacowanym czasem dotarcia.

Włączanie metody ComputeRouteMatrix

Zanim zaczniesz używać w kodzie metody ComputeRouteMatrix, musisz ją włączyć. Więcej informacji o włączaniu metod interfejsu Routes Preferred API znajdziesz w artykule Pierwsze kroki.

Używanie metody ComputeRouteMatrix

Metoda ComputeRouteMatrix jest dostępna w punkcie końcowym Routes Preferred v1.

Szczegółowe informacje znajdziesz w tych dokumentach:

gRPC: https://developers.google.com/maps/documentation/routes_preferred/reference/rpc/google.maps.routes.v1

REST: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRouteMatrix

Poniżej znajdziesz ogólne instrukcje wywoływania metody ComputeRouteMatrix za pomocą gRPC:

  1. Sprawdź niezbędne bufory protokołu w repozytorium googleapis:

    https://github.com/googleapis/googleapis/tree/master/google/maps/routes

    Pamiętaj, że niektóre systemy kompilacji, np. Go, mogą robić to automatycznie.

  2. Wygeneruj odpowiedni kod bufora protokołu w preferowanym języku i za pomocą wybranego zestawu narzędzi do kompilacji.

  3. Wygeneruj prośbę. W żądaniu muszą być przesyłane 2 wymagane rodzaje metadanych:

    • Wartość X-Goog-Api-Key musi być ustawiona na Twój klucz interfejsu API.

    • X-Goog-Fieldmask musi być ustawiony na listę pól rozdzielonych przecinkami, które chcesz uzyskać w odpowiedzi. Na przykład: X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status. Możesz użyć symbolu wieloznacznego (*), aby oznaczyć wszystkie pola, ale nie jest to zalecane. Używaj symbolu wieloznacznego, aby testować i rozumieć odpowiedź interfejsu API, ale w kodzie produkcyjnym wyraźnie wymieniaj pola, które chcesz uwzględnić w masce pola.

      Więcej informacji o tworzeniu ciągu maski pola znajdziesz na stronie https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto. Pamiętaj, że wyłączenie niepotrzebnych pól może skrócić czas oczekiwania, ponieważ pola te mogą wymagać dodatkowych obliczeń. Opóźnienie pozostanie stabilne, jeśli określisz potrzebne pola, a później dodasz nowe pola, które wymagają większej mocy obliczeniowej.

  4. Wyślij żądanie na adres routespreferred.googleapis.com:443.Musisz użyć protokołu TLS.

Przykłady użycia metody ComputeRouteMatrix znajdziesz w artykule Przykłady obliczania macierzy tras (wersja beta).

Jedną z cech wyróżniających metodę ComputeRouteMatrix jest to, że kody błędów mogą być zwracane dla całego strumienia lub dla poszczególnych elementów. Na przykład połączenie strumieniowe zwraca błąd, jeśli żądanie jest nieprawidłowo sformułowane (np. ma 0 źródeł). Jeśli jednak błąd dotyczy tylko kilku elementów strumienia (np. ustawienia nieprawidłowego identyfikatora miejsca dla miejsca pochodzenia), kody błędów będą zawierać tylko elementy, których dotyczy błąd.

Elementy zwracane przez strumień nie muszą być zwracane w określonej kolejności. Dlatego każdy element zawiera origin_index i destination_index. W przypadku źródeł i miejsc docelowych określonych w żądaniu miejsce początkowe trasy jest równoważne origins[origin_index] dla danego elementu, a miejsce docelowe trasy jest równoważne destinations[destination_index]. Tablice te są indeksowane od zera. Ważne jest, aby przechowywać kolejność list miejsc początkowych i docelowych.

Obliczanie opłat za przejazd

Informacje o obliczaniu opłat za przejazd znajdziesz w artykule Obliczanie opłat za przejazd.

Przykłady obliczania opłat za przejazd znajdziesz w artykule Przykłady obliczania macierzy tras.