Route Matrix (beta)

RouteMatrix class

google.maps.routes.RouteMatrix zajęcia

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

Dostęp przez połączenie pod numer const {RouteMatrix} = await google.maps.importLibrary("routes").
 Zobacz Biblioteki w Maps JavaScript API.
computeRouteMatrix
computeRouteMatrix(request)
Parametry: 
Zwracana wartość:  Promise<{matrix:RouteMatrix}>
Przyjmuje listę źródeł i miejsc docelowych oraz zwraca macierz zawierającą informacje o trasach dla każdej kombinacji źródła i miejsca docelowego.

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

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

Używanie maski pola odpowiedzi z symbolem wieloznacznym fields: ['*'] jest odradzane, ponieważ:
  • Wybieranie tylko potrzebnych pól pomaga naszemu serwerowi oszczędzać cykle obliczeniowe, dzięki czemu możemy zwracać wyniki z mniejszym opóźnieniem.
  • Wybieranie w zadaniu produkcyjnym tylko potrzebnych pól zapewnia stabilną wydajność w zakresie opóźnień. W przyszłości możemy dodać więcej pól odpowiedzi, a nowe pola mogą wymagać dodatkowego czasu obliczeniowego. Jeśli wybierzesz wszystkie pola lub wszystkie pola na najwyższym poziomie, może to spowodować spadek wydajności, ponieważ każde nowe pole, które dodamy, będzie automatycznie uwzględniane w odpowiedzi.
  • Wybieranie tylko potrzebnych pól powoduje zmniejszenie rozmiaru odpowiedzi, a tym samym szybsze wczytywanie przez sieć.
rows
Wiersze macierzy. Każdy wiersz odpowiada miejscu pochodzenia i zawiera tablicę obiektów RouteMatrixItem, z których każdy reprezentuje trasę do miejsca docelowego.
toJSON
toJSON()
Parametry: brak
Zwracana wartość:  Object
Konwertuje na obiekt.

RouteMatrixRow

google.maps.routes.RouteMatrixRow zajęcia

Odpowiada pochodzeniu przekazanemu do RouteMatrix.computeRouteMatrix. Zawiera listę RouteMatrixItem, z których każdy element reprezentuje trasę do miejsca docelowego.

Dostęp przez połączenie 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
Zwracana wartość:  Object
Konwertuje na obiekt.

RouteMatrixItem class

google.maps.routes.RouteMatrixItem zajęcia

Zawiera informacje o trasie obliczone dla pary punktów początkowego i docelowego przekazanej do RouteMatrix.computeRouteMatrix.

Dostęp przez połączenie 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ść podróży na trasie w metrach.
durationMillis
Typ:  number optional
Czas potrzebny na pokonanie trasy w milisekundach. Jeśli ustawisz wartość ComputeRouteMatrixRequest.routingPreference na TRAFFIC_UNAWARE, ta wartość będzie taka sama jak RouteMatrixItem.staticDurationMillis. Jeśli ustawisz ComputeRouteMatrixRequest.routingPreference na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, ta wartość zostanie obliczona z uwzględnieniem warunków ruchu.

Uwaga: jeśli czas trwania przekracza 2^53 milisekund, ta wartość wynosi 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 punktów początkowego i docelowego, może użyć innego trybu obliczeń. Gdy używana jest odpowiedź zastępcza, to pole zawiera szczegółowe informacje o niej. W przeciwnym razie to pole nie jest ustawione.
localizedValues
Tekstowe reprezentacje właściwości RouteMatrixItem.
staticDurationMillis
Typ:  number optional
Czas podróży po trasie bez uwzględnienia warunków drogowych.

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

ComputeRouteMatrixRequest interfejs

google.maps.routes.ComputeRouteMatrixRequestinterfejs

Prośba o macierz 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 lub nazwą zasobu Miejsca. Wartości wysokości nie są brane pod uwagę.
fields
Typ:  Iterable<string>
Zbiór pól do pobrania. W przypadku wszystkich pól określ wartość ["*"].
origins
Tablica punktów początkowych, która określa wiersze macierzy odpowiedzi. Wartość przekazywana jako ciąg znaków może być adresem, kodem plus lub nazwą zasobu Miejsca. Wartości wysokości nie są brane pod uwagę.

 W przypadku liczby różnych miejsc pochodzenia i docelowych obowiązuje kilka ograniczeń rozmiaru:
  • Łączna liczba miejsc odjazdu i miejsc docelowych określonych jako string lub Place nie może przekraczać 50.
  • Iloczyn liczby punktów początkowych i liczby punktów docelowych nie może być większy niż 625.
  • Jeśli parametr ComputeRouteMatrixRequest.routingPreference ma wartość TRAFFIC_AWARE_OPTIMAL, iloczyn liczby miejsc docelowych i początkowych nie może być większy niż 100.
  • Jeśli parametr ComputeRouteMatrixRequest.travelMode ma wartość TRANSIT, iloczyn liczby miejsc docelowych i początkowych nie może być większy niż 100.
arrivalTime optional
Typ:  Date optional
Godzina przyjazdu.

Uwaga: można ustawić tylko wtedy, gdy ustawienie ComputeRouteMatrixRequest.travelMode ma wartość TRANSIT. Możesz określić wartość ComputeRouteMatrixRequest.departureTime lub ComputeRouteMatrixRequest.arrivalTime, ale nie obie jednocześnie. Trasy transportu publicznego są dostępne do 7 dni wstecz i 100 dni w przyszłości.
departureTime optional
Typ:  Date optional
Godzina odjazdu. Jeśli nie ustawisz tej wartości, domyślnie będzie to czas wysłania żądania.

 Uwaga: możesz określić czas w przeszłości tylko wtedy, gdy wartość ComputeRouteMatrixRequest.travelMode jest ustawiona na TRANSIT. Trasy transportu publicznego są dostępne do 7 dni wstecz i 100 dni w przyszłości.
extraComputations optional
Lista dodatkowych obliczeń, które mogą być użyte do zrealizowania żądania.

 Uwaga: te dodatkowe obliczenia mogą zwracać dodatkowe pola w odpowiedzi. Te dodatkowe pola muszą być też określone w parametrze ComputeRouteMatrixRequest.fields, aby były zwracane w odpowiedzi.
language optional
Typ:  string optional
Kod języka w formacie BCP-47, np. „en-US” lub „sr-Latn”. Więcej informacji znajdziesz w artykule Identyfikator ustawień regionalnych 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 wywnioskowany z ustawień lokalizacji interfejsu Google Maps JavaScript API. W przeciwnym razie język jest określany na podstawie lokalizacji pierwszego źródła.
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 wywnioskowany 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 routingu do obliczenia macierzy trasy. Jeśli preferencja routingu spowoduje błąd lub wyjątkowo 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. To ustawienie wpływa na wartość zwracaną w parametrze RouteMatrixItem.durationMillis, który zawiera przewidywany czas dojazdu w ruchu na podstawie średnich wartości historycznych. ComputeRouteMatrixRequest.trafficModel jest dostępna 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 TRANSIT tras.

Uwaga: można określić tylko wtedy, gdy ustawienie 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ą wywnioskowane na podstawie lokalizacji pierwszego źródła.

Stałe ComputeRouteMatrixExtraComputation

google.maps.routes.ComputeRouteMatrixExtraComputation stałe

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

Dostęp przez połączenie pod numer const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
 Zobacz Biblioteki w Maps JavaScript API.
TOLLS Informacje o opłatach za przejazd w przypadku elementów macierzy.

Stałe RouteMatrixItemCondition

google.maps.routes.RouteMatrixItemCondition stałe

Stan trasy dla danej pary miejsc wyjazdu i docelowego.

Dostęp przez połączenie 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 class

google.maps.routes.RouteMatrixItemError zajęcia

Błąd, który wystąpił podczas RouteMatrix.computeRouteMatrix w przypadku konkretnej pary punktów początkowego i docelowego.

Ta klasa rozszerza klasę Error.

Dostęp przez połączenie pod numer const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
 Zobacz Biblioteki w Maps JavaScript API.
toJSON
toJSON()
Parametry: brak
Zwracana wartość:  Object
Konwertuje na obiekt.

RouteMatrixItemLocalizedValues class

google.maps.routes.RouteMatrixItemLocalizedValues zajęcia

Tekstowe reprezentacje RouteMatrixItem.

Dostęp przez połączenie pod numer const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
 Zobacz Biblioteki w Maps JavaScript API.
distance
Typ:  string optional
Odległość podróży elementu macierzy tras w formie tekstowej.
distanceLanguage
Typ:  string optional
Kod języka tekstu odległości w formacie BCP-47, 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 w regionie zapytania. Uwzględnia warunki na drodze.

Uwaga: jeśli nie zażądasz informacji o ruchu, ta wartość będzie taka sama jak wartość atrybutu RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage
Typ:  string optional
Kod języka tekstu czasu trwania w formacie 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ędnienia warunków na drogach, przedstawiony w formie tekstowej.
staticDurationLanguage
Typ:  string optional
Kod języka statycznego tekstu czasu trwania w formacie BCP-47, np. „en-US” lub „sr-Latn”.
transitFare
Typ:  string optional
Opłata za przejazd transportem publicznym w formie tekstowej.
transitFareLanguage
Typ:  string optional
Kod języka tekstu ceny transportu publicznego w formacie BCP-47, 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
Zwracana wartość:  Object
Konwertuje na obiekt.

RouteMatrixOrigin interfejs

google.maps.routes.RouteMatrixOrigininterfejs

Pojedyncze źródło dla ComputeRouteMatrixRequest.
waypoint
Lokalizacja miejsca pochodzenia. 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 każdej trasy, która ma to miejsce jako punkt początkowy.