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):
- Strumieniowanie umożliwia zwracanie elementów przed obliczeniem całej macierzy, co zmniejsza opóźnienie.
ComputeRouteMatrixma 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 będzie można użyć metody ComputeRouteMatrix w kodzie, 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:
thought gRPC: https://developers.google.com/maps/documentation/routes_preferred/reference/rpc/google.maps.routes.v1
Poniżej znajdziesz ogólne instrukcje wywoływania metody ComputeRouteMatrix za pomocą gRPC:
Pobierz niezbędne bufory protokołu z 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.
Wygeneruj odpowiedni kod bufora protokołu w preferowanym języku i za pomocą wybranego zestawu narzędzi do kompilacji.
Wygeneruj prośbę. W żądaniu muszą być przesyłane 2 wymagane rodzaje metadanych:
- X-Goog-Api-Key musi być ustawiony na klucz interfejsu API.
Parametr X-Goog-Fieldmask musi być ustawiony na listę pól, których potrzebujesz z odpowiedzi, rozdzielonych przecinkami. 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żyj symbolu wieloznacznego, aby przetestować i zrozumieć odpowiedź interfejsu API, ale w kodzie produkcyjnym wyraźnie podaj 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.
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. Z tego powodu każdy element zawiera origin_index i destination_index. W przypadku miejsc początkowych i docelowych określonych w żądaniu miejsce początkowe trasy odpowiada origins[origin_index] dla danego elementu, a miejsce docelowe trasy odpowiada 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.