Route Matrix

RouteMatrix

klasa google.maps.routes.RouteMatrix
biblioteka "routes"

Macierz tras obliczonych dla zbioru par miejsc wyjazdu i docelowych przez RouteMatrix.computeRouteMatrix

const {RouteMatrix} = await google.maps.importLibrary("routes");
computeRouteMatrix
computeRouteMatrix(request)
Parametry:
Wartość zwracana: Promise<{matrix:RouteMatrix}>
Pobiera listę miejsc początkowych i docelowych oraz zwraca macierz zawierającą informacje o trasie dla każdej kombinacji miejsca początkowego i docelowego.

Uwaga: ta metoda wymaga określenia maski pola odpowiedzi w żądaniu przez ustawienie właściwości ComputeRouteMatrixRequest.fields. Wartość jest listą ścieżek pól.

Na przykład:
  • Maska pola wszystkich dostępnych pól: fields: ['*']
  • Maska pola czasu trwania i odległości na poziomie trasy: fields: ['durationMillis', 'distanceMeters']

Nie zalecamy używania maski pola odpowiedzi z symbolem wieloznacznym fields: ['*'], ponieważ:
  • Wybór tylko potrzebnych pól pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, co pozwala nam zwracać wyniki z mniejszym opóźnieniem.
  • Wybieranie tylko tych pól, które są potrzebne w zadaniu produkcyjnym, zapewnia stabilny czas oczekiwania. W przyszłości możemy dodać więcej pól odpowiedzi, a te nowe pola mogą wymagać dodatkowego czasu na obliczenia. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może dojść do spadku wydajności, ponieważ każde nowe pole, które dodamy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybranie tylko potrzebnych pól powoduje, że odpowiedź jest mniejsza, a tym samym szybciej się wczytuje.
rows
readonly
Wiersze macierzy. Każdy wiersz odpowiada miejscu wyjazdu i zawiera tablicę obiektów RouteMatrixItem, z których każdy reprezentuje trasę do miejsca docelowego.
Dziedziczone: toJSON

RouteMatrixRow

klasa google.maps.routes.RouteMatrixRow
biblioteka "routes"

Odpowiada źródłu przekazanemu do RouteMatrix.computeRouteMatrix. Zawiera listę RouteMatrixItem, gdzie każdy element reprezentuje trasę do miejsca docelowego.

const {RouteMatrixRow} = await google.maps.importLibrary("routes");
items
readonly
informacje o trasie do każdego miejsca docelowego;
Dziedziczone: toJSON

RouteMatrixItem

klasa google.maps.routes.RouteMatrixItem
biblioteka "routes"

Zawiera informacje o trasie obliczone dla pary miejsce początkowe/miejsce docelowe przekazanej do metody RouteMatrix.computeRouteMatrix.

const {RouteMatrixItem} = await google.maps.importLibrary("routes");
condition
readonly
Wskazuje, czy trasa została znaleziona.
distanceMeters
readonly
Typ: number optional
Odległość do pokonania na trasie w metrach.
durationMillis
readonly
Typ: number optional
Czas potrzebny na pokonanie trasy w milisekundach. Jeśli ustawisz parametr ComputeRouteMatrixRequest.routingPreference na TRAFFIC_UNAWARE, ta wartość będzie taka sama jak RouteMatrixItem.staticDurationMillis. Jeśli ustawisz parametr ComputeRouteMatrixRequest.routingPreference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość będzie obliczana z uwzględnieniem warunków na drodze.

Uwaga: jeśli czas trwania przekracza 2^53 milisekund, ta wartość to Number.POSITIVE_INFINITY.
error
readonly
Typ: RouteMatrixItemError optional
Błąd, który wystąpił podczas obliczania trasy.
fallbackInfo
readonly
Typ: FallbackInfo optional
W niektórych przypadkach, gdy serwer nie może obliczyć trasy z uwzględnieniem podanych preferencji dla danej pary punktu początkowego i docelowego, może on użyć innego trybu obliczeń. Gdy używana jest kreacja zastępcza, to pole zawiera szczegółowe informacje o odpowiedzi zastępczej. W przeciwnym razie to pole nie jest ustawione.
localizedValues
readonly
Tekstowe reprezentacje właściwości RouteMatrixItem.
staticDurationMillis
readonly
Typ: number optional
Czas podróży trasą bez uwzględnienia warunków na drodze.

Uwaga: jeśli czas trwania przekracza 2^53 milisekund, ta wartość to Number.POSITIVE_INFINITY.
travelAdvisory
readonly
Typ: RouteTravelAdvisory optional
Dodatkowe informacje o trasie.

ComputeRouteMatrixRequest interface

interfejs google.maps.routes.ComputeRouteMatrixRequest

Żądanie macierzy tras.
destinations
Tablica miejsc docelowych, która określa kolumny macierzy odpowiedzi. Wartość przekazywana jako ciąg znaków może być adresem, kodem Plus Code lub nazwą zasobu miejsca. Wartości wysokości nie są brane pod uwagę.
fields
Typ: Iterable<string>
Kolekcja pól do pobrania. Wpisz ["*"] we wszystkich polach.
origins
Tablica miejsc początkowych, która określa wiersze macierzy odpowiedzi. Wartość przekazywana jako ciąg znaków może być adresem, kodem Plus Code lub nazwą zasobu miejsca. Wartości wysokości nie są brane pod uwagę.

Obowiązuje kilka ograniczeń dotyczących liczby punktów początkowych i docelowych:
  • Łączna liczba miejsc rozpoczęcia i zakończenia podróży określonych jako string lub Place nie może przekraczać 50.
  • Iloczyn liczby punktów początkowych i docelowych nie może przekraczać 625.
  • Jeśli parametr ComputeRouteMatrixRequest.routingPreference jest ustawiony na TRAFFIC_AWARE_OPTIMAL, iloczyn liczby miejsc początkowych i docelowych nie może być większy niż 100.
  • Jeśli parametr ComputeRouteMatrixRequest.travelMode jest ustawiony na TRANSIT, iloczyn liczby miejsc początkowych i docelowych nie może być większy niż 100.
arrivalTime
opcjonalne
Typ: Date optional
Godzina przyjazdu.

Uwaga: można ustawić tylko wtedy, gdy parametr ComputeRouteMatrixRequest.travelMode ma wartość TRANSIT. Możesz podać ComputeRouteMatrixRequest.departureTime lub ComputeRouteMatrixRequest.arrivalTime, ale nie obie te wartości. Przejazdy transportem publicznym są dostępne do 7 dni wstecz lub 100 dni do przodu.
departureTime
opcjonalne
Typ: Date optional
Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie zostanie użyty czas wysłania żądania.

Uwaga: czas w przeszłości możesz określić tylko wtedy, gdy parametr ComputeRouteMatrixRequest.travelMode ma wartość TRANSIT. Przejazdy transportem publicznym są dostępne do 7 dni wstecz lub 100 dni do przodu.
extraComputations
opcjonalne
Lista dodatkowych obliczeń, które mogą być użyte do realizacji żądania.

Uwaga: te dodatkowe obliczenia mogą zwracać dodatkowe pola w odpowiedzi. Te dodatkowe pola muszą być też określone w parametrze ComputeRouteMatrixRequest.fields, aby zostały zwrócone w odpowiedzi.
internalUsageAttributionIds
opcjonalne
Typ: Iterable<string> optional
Identyfikatory używane do przypisywania wywołań do konkretnych pakietów lub bibliotek OSS.
language
opcjonalne
Typ: string optional
Kod języka w standardzie BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Identyfikator języka Unicode. Listę obsługiwanych języków znajdziesz w sekcji Obsługa języków. Jeśli nie podasz tej wartości, język zostanie określony na podstawie ustawień lokalizacji interfejsu Google Maps JavaScript API. W przeciwnym razie język jest określany na podstawie lokalizacji pierwszego miejsca wylotu.
region
opcjonalne
Typ: string optional
Kod regionu określony jako dwuznakowa wartość ccTLD („domena najwyższego poziomu”). Więcej informacji znajdziesz w artykule Domeny krajowe najwyższego poziomu. Jeśli nie podasz tej wartości, region zostanie określony na podstawie ustawień lokalizacji interfejsu Google Maps JavaScript API. W przeciwnym razie region jest określany na podstawie lokalizacji pierwszego źródła.
routingPreference
opcjonalne
Typ: RoutingPreference optional
Określa sposób obliczania macierzy tras. Serwer próbuje użyć wybranego ustawienia trasy do obliczenia macierzy tras. Jeśli ustawienie routingu powoduje błąd lub bardzo długie opóźnienie, zwracany jest błąd. Tę opcję możesz określić tylko wtedy, gdy ComputeRouteMatrixRequest.travelMode ma wartość DRIVING lub TWO_WHEELER. W przeciwnym razie żądanie się nie powiedzie.
trafficModel
opcjonalne
Typ: TrafficModel optional
Określa założenia, które mają być używane podczas obliczania czasu w ruchu ulicznym. To ustawienie wpływa na wartość zwracaną w polu RouteMatrixItem.durationMillis, które zawiera przewidywany czas w ruchu ulicznym na podstawie średnich historycznych. Parametr ComputeRouteMatrixRequest.trafficModel jest dostępny tylko w przypadku żądań, w których parametr ComputeRouteMatrixRequest.routingPreference ma wartość TRAFFIC_AWARE_OPTIMAL, a parametr ComputeRouteMatrixRequest.travelMode ma wartość DRIVING. Domyślna wartość to BEST_GUESS.
transitPreference
opcjonalne
Typ: TransitPreference optional
Określa preferencje, które wpływają na trasę zwracaną w przypadku tras TRANSIT.

Uwaga: można określić tylko wtedy, gdy parametr ComputeRouteMatrixRequest.travelMode ma wartość TRANSIT.
travelMode
opcjonalne
Typ: TravelMode optional
Określa środek transportu.
units
opcjonalne
Typ: UnitSystem optional
Określa jednostki miary dla pól wyświetlania. Jeśli nie podasz tej wartości, jednostki wyświetlania zostaną określone na podstawie lokalizacji pierwszego punktu początkowego.

Stałe ComputeRouteMatrixExtraComputation

stałe google.maps.routes.ComputeRouteMatrixExtraComputation
biblioteka "routes"

Dodatkowe obliczenia do wykonania podczas realizacji żądania. Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ ComputeRouteMatrixExtraComputationString.

const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes");
TOLLS Informacje o opłatach za przejazd dla elementów macierzy. Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Stałe RouteMatrixItemCondition

stałe google.maps.routes.RouteMatrixItemCondition
biblioteka "routes"

Stan zwracanej trasy. Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ RouteMatrixItemConditionString.

const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes");
ROUTE_EXISTS Znaleziono trasę i uzupełniono odpowiednie informacje o elemencie. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
ROUTE_NOT_FOUND Nie udało się znaleźć trasy. Więcej informacji znajdziesz w dokumentacji usługi internetowej.

RouteMatrixItemError

class google.maps.routes.RouteMatrixItemError extends Error
library "routes"

Błąd, który wystąpił podczas RouteMatrix.computeRouteMatrix w przypadku określonej pary punktu początkowego i docelowego.

const {RouteMatrixItemError} = await google.maps.importLibrary("routes");
Dziedziczone: toJSON

RouteMatrixItemLocalizedValues

klasa google.maps.routes.RouteMatrixItemLocalizedValues
biblioteka "routes"

Reprezentacje tekstowe: RouteMatrixItem.

const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
Typ: string optional
Odległość do przebycia elementu macierzy tras w formie tekstowej.
distanceLanguage
readonly
Typ: string optional
Kod języka BCP-47 tekstu odległości, np. „en-US” lub „sr-Latn”.

Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
readonly
Typ: string optional
Czas trwania w formie tekstowej, zlokalizowany dla regionu zapytania. uwzględnia warunki na drodze;

Uwaga: jeśli nie poprosisz o informacje o natężeniu ruchu, ta wartość będzie taka sama jak RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage
readonly
Typ: string optional
Kod języka tekstu czasu trwania w standardzie BCP-47, np. „en-US” lub „sr-Latn”.

Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
readonly
Typ: string optional
Czas trwania bez uwzględniania warunków na drodze, przedstawiony w formie tekstowej.
staticDurationLanguage
readonly
Typ: string optional
Kod języka BCP-47 tekstu statycznego dotyczącego czasu trwania, np. „en-US” lub „sr-Latn”.
transitFare
readonly
Typ: string optional
Opłata za przejazd w formie tekstowej.
transitFareLanguage
readonly
Typ: string optional
Kod języka w standardzie BCP-47 dla tekstu opłaty za przejazd, np. „en-US” lub „sr-Latn”.

Więcej informacji znajdziesz na stronie http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
Dziedziczone: toJSON

Interfejs RouteMatrixOrigin

interfejs google.maps.routes.RouteMatrixOrigin

Pojedyncze źródło dla ComputeRouteMatrixRequest.
waypoint
Lokalizacja punktu początkowego. Wartość przekazywana jako ciąg znaków może być adresem lub kodem Plus Code. Wartości wysokości nie są brane pod uwagę.
routeModifiers
opcjonalne
Typ: RouteModifiers optional
Modyfikatory dla każdej trasy, która ma to miejsce jako punkt początkowy.