Route Matrix

RouteMatrix

google.maps.routes.RouteMatrix zajęcia

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

Aby uzyskać dostęp, zadzwoń pod numer const {RouteMatrix} = await google.maps.importLibrary("routes").
Zobacz Biblioteki w Maps JavaScript API.
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
Wiersze macierzy. Każdy wiersz odpowiada miejscu wyjazdu i zawiera tablicę obiektów RouteMatrixItem, z których każdy reprezentuje trasę do miejsca docelowego.
toJSON
toJSON()
Parametry: brak
Wartość zwracana:  Object
Konwertuje na obiekt.

RouteMatrixRow

google.maps.routes.RouteMatrixRow zajęcia

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

Aby uzyskać dostęp, zadzwoń pod numer const {RouteMatrixRow} = await google.maps.importLibrary("routes").
Zobacz Biblioteki w Maps JavaScript API.
items
informacje o trasie do każdego miejsca docelowego;
toJSON
toJSON()
Parametry: brak
Wartość zwracana:  Object
Konwertuje na obiekt.

RouteMatrixItem

google.maps.routes.RouteMatrixItem zajęcia

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

Aby uzyskać dostęp, zadzwoń pod numer const {RouteMatrixItem} = await google.maps.importLibrary("routes").
Zobacz Biblioteki w Maps JavaScript API.
condition
Typ:  RouteMatrixItemCondition optional
Wskazuje, czy trasa została znaleziona.
distanceMeters
Typ:  number optional
Odległość do pokonania na trasie w metrach.
durationMillis
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
Typ:  RouteMatrixItemError optional
Błąd, który wystąpił podczas obliczania trasy.
fallbackInfo
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
Tekstowe reprezentacje właściwości RouteMatrixItem.
staticDurationMillis
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
Typ:  RouteTravelAdvisory optional
Dodatkowe informacje o trasie.
toJSON
toJSON()
Parametry: brak
Wartość zwracana:  Object
Konwertuje na obiekt.

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 optional
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 optional
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 optional
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.
language optional
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 optional
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 optional
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 optional
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 optional
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 optional
Typ:  TravelMode optional
Określa środek transportu.
units optional
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

google.maps.routes.ComputeRouteMatrixExtraComputation stałe

Dodatkowe obliczenia do wykonania w przypadku żądania RouteMatrix.computeRouteMatrix.

Aby uzyskać dostęp, zadzwoń pod numer const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
Zobacz Biblioteki w Maps JavaScript API.
TOLLS Informacje o opłatach za przejazd dla elementów macierzy.

Stałe RouteMatrixItemCondition

google.maps.routes.RouteMatrixItemCondition stałe

Stan trasy dla danej pary miejsce wyjazdu / miejsce docelowe.

Aby uzyskać dostęp, zadzwoń pod numer const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes").
Zobacz Biblioteki w Maps JavaScript API.
ROUTE_EXISTS Znaleziono trasę.
ROUTE_NOT_FOUND Nie udało się znaleźć trasy.

RouteMatrixItemError

google.maps.routes.RouteMatrixItemError zajęcia

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

Ta klasa rozszerza klasę Error.

Aby uzyskać dostęp, zadzwoń pod numer const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
Zobacz Biblioteki w Maps JavaScript API.
toJSON
toJSON()
Parametry: brak
Wartość zwracana:  Object
Konwertuje na obiekt.

RouteMatrixItemLocalizedValues

google.maps.routes.RouteMatrixItemLocalizedValues zajęcia

Reprezentacje tekstowe: RouteMatrixItem.

Aby uzyskać dostęp, zadzwoń pod numer const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
Zobacz Biblioteki w Maps JavaScript API.
distance
Typ:  string optional
Odległość do przebycia elementu macierzy tras w formie tekstowej.
distanceLanguage
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
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
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
Typ:  string optional
Czas trwania bez uwzględniania warunków na drodze, przedstawiony w formie tekstowej.
staticDurationLanguage
Typ:  string optional
Kod języka BCP-47 tekstu statycznego dotyczącego czasu trwania, np. „en-US” lub „sr-Latn”.
transitFare
Typ:  string optional
Opłata za przejazd w formie tekstowej.
transitFareLanguage
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.
toJSON
toJSON()
Parametry: brak
Wartość zwracana:  Object
Konwertuje na obiekt.

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 optional
Typ:  RouteModifiers optional
Modyfikatory dla każdej trasy, która ma to miejsce jako punkt początkowy.