Routes Data

Klasa Route

klasa google.maps.routes.Route
biblioteka "routes"

Zawiera trasę, która składa się z serii połączonych odcinków drogi łączących początkowe, końcowe i pośrednie punkty orientacyjne.

const {Route} = await google.maps.importLibrary("routes");
computeRoutes
computeRoutes(request)
Parametry:
Wartość zwracana: Promise<{
  routes:Array<Route> optional,
  fallbackInfo:FallbackInfo optional,
  geocodingResults:GeocodingResults optional
}>
Zwraca trasę główną wraz z opcjonalnymi trasami alternatywnymi na podstawie zestawu punktów końcowych i pośrednich.

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

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

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.
description
readonly
Typ: string optional
Opis trasy.
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 ComputeRoutesRequest.routingPreference na TRAFFIC_UNAWARE, ta wartość będzie taka sama jak Route.staticDurationMillis. Jeśli ustawisz parametr ComputeRoutesRequest.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.
legs
readonly
Typ: Array<RouteLeg> optional
Zbiór odcinków (segmentów ścieżki między punktami pośrednimi), które składają się na trasę. Każdy etap odpowiada podróży między 2 punktami, które nie są punktami via.

Na przykład:
  • Trasa bez pośrednich punktów orientacyjnych ma tylko jeden odcinek.
  • Trasa, która obejmuje jeden punkt pośredni inny niż via, ma 2 etapy.
  • Trasa, która zawiera 1 punkt pośredni via, ma 1 etap.
Kolejność etapów odpowiada kolejności punktów orientacyjnych od origin do intermediates i destination.
localizedValues
readonly
Typ: RouteLocalizedValues optional
Tekstowe reprezentacje właściwości Route.
optimizedIntermediateWaypointIndices
readonly
Typ: Array<number> optional
Jeśli ustawisz parametr ComputeRoutesRequest.optimizeWaypointOrder na true, to pole będzie zawierać zoptymalizowaną kolejność punktów pośrednich. W przeciwnym razie to pole jest puste. Indeks zaczyna się od 0 dla pierwszego pośredniego punktu na trasie podanego w danych wejściowych.

Jeśli na przykład podasz te dane wejściowe:
  • Pochodzenie: LA
  • Pośrednie punkty orientacyjne: Dallas, Bangor, Phoenix
  • Miejsce docelowe: Nowy Jork
, a zoptymalizowana kolejność punktów pośrednich to Phoenix, Dallas, Bangor, to pole będzie miało wartość [2, 0, 1].
path
readonly
Typ: Array<LatLngAltitude> optional
Lista LatLngAltitude trasy, których można użyć do narysowania linii łamanej trasy. Szczegółowość ścieżki można kontrolować, ustawiając ComputeRoutesRequest.polylineQuality.
polylineDetails
readonly
Typ: PolylineDetails optional
Zawiera informacje o szczegółach na ścieżce.
routeLabels
readonly
Typ: Array<RouteLabel> optional
Etykiety trasy, które są przydatne do identyfikowania konkretnych właściwości lub porównywania ich z innymi.
routeToken
readonly
Typ: string optional
Nieprzezroczysty token, który można przekazać do pakietu Navigation SDK, aby odtworzyć trasę podczas nawigacji, a w przypadku zmiany trasy zachować pierwotny zamiar podczas tworzenia trasy. Traktuj ten token jako nieprzezroczysty obiekt blob. Nie porównuj jej wartości w różnych żądaniach, ponieważ może się ona zmieniać, nawet jeśli usługa zwraca dokładnie tę samą trasę.

Uwaga: routeToken jest dostępny tylko w przypadku żądań, w których parametr ComputeRoutesRequest.routingPreference ma wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL. Nie jest obsługiwana w przypadku żądań, które mają via punktów pośrednich.
speedPaths
readonly
Typ: Array<SpeedPath> optional
Grupowanie odcinków trasy z odpowiadającymi im odczytami prędkości. Aby to pole zostało wypełnione, pole ComputeRoutesRequest.routingPreference musi mieć wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, a pole ComputeRoutesRequest.extraComputations musi zawierać wartość TRAFFIC_ON_POLYLINE.
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.
viewport
readonly
Typ: LatLngBounds optional
Ramka ograniczająca widoczny obszar trasy.
warnings
readonly
Typ: Array<string> optional
Tablica ostrzeżeń, które mają się wyświetlać podczas wyświetlania trasy.
Alphacreate3DPolylines
create3DPolylines([options])
Parametry:
Wartość zwracana: Promise<Array<Polyline3DElement>>
Tworzy linie łamane 3D dla trasy na podstawie dostępnych danych.
createPolylines
createPolylines([options])
Parametry:
Wartość zwracana: Array<Polyline>
tworzy linie łamane trasy na podstawie dostępnych danych;

Polilinie multimodalne:
  • Wymagania:
  • tworzy linię łamaną dla każdego segmentu trasy multimodalnej; Polilinie są stylizowane zgodnie z trybem podróży i danymi linii transportu publicznego, jeśli są dostępne. Można przekazać opcje, aby zmienić styl linii łamanej na podstawie środka transportu i linii transportu publicznego.

Linie łamane ruchu:
  • Wymagania:
  • Tworzy linię łamaną dla każdego interwału trasy, gdy odczyt prędkości różni się od poprzedniego interwału. Do linii łamanych stosowany jest domyślny styl oparty na prędkości. Można przekazać opcje, aby zmienić styl linii łamanej na podstawie prędkości.

Linia łamana ogółem:
  • Wymagania:
  • Tworzy jedną linię łamaną dla całej trasy z zastosowaniem domyślnego stylu. Możesz przekazać opcje, aby zmienić styl linii łamanej na podstawie środka transportu. Aby uzyskać więcej opcji dostosowywania, utwórz linie łamane bezpośrednio za pomocą Route.path lub RouteLeg.path.
AlphacreatePopover
createPopover()
Parametry: brak
Wartość zwracana: Promise<PopoverElement>
Tworzy wyskakujące okienko dla trasy na podstawie dostępnych danych, skonfigurowane w sposób odpowiedni do dodawania adnotacji do trasy na mapie. Obecnie używa Route.localizedValues, Route.path i Route.legs, jeśli są dostępne.
createWaypointAdvancedMarkers
createWaypointAdvancedMarkers([options])
Wartość zwracana: Promise<Array<AdvancedMarkerElement>>
Tworzy znaczniki trasy oznaczone literami „A”, „B”, „C” itd. dla każdego punktu na trasie. Do znaczników stosowany jest styl domyślny. Można przekazać opcje, aby zmienić styl znacznika na podstawie indeksu znacznika lub właściwości odpowiedniego elementu RouteLeg. Jeśli trasa nie ma etapów, parametr WaypointMarkerDetails.leg będzie niezdefiniowany.

Aby uwzględnić punkty pośrednie, należy poprosić o pole "legs" w ComputeRoutesRequest.fields.
AlphacreateWaypointMarkers
Parametry:
Wartość zwracana: Promise<Array<T>>
tworzy znaczniki miejsca wyjazdu i miejsca docelowego na trasie; Znaczniki mają domyślny styl, chyba że określono funkcję customOverride. Punkty pośrednie nie są obecnie obsługiwane.

Utworzone znaczniki mają domyślnie ustawioną wartość CollisionBehavior na CollisionBehavior.REQUIRED_AND_HIDES_OPTIONAL.
Dziedziczone: toJSON

ComputeRoutesRequest

interfejs google.maps.routes.ComputeRoutesRequest

Prośba o trasy.

destination
Miejsce docelowe trasy. 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ę przy obliczaniu tras.
fields
Typ: Iterable<string>
Kolekcja pól do pobrania. Wpisz ["*"] we wszystkich polach.
origin
Punkt początkowy trasy. 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ę przy obliczaniu tras.
arrivalTime
opcjonalne
Typ: Date optional
Godzina przyjazdu.

Uwaga: można ustawić tylko wtedy, gdy parametr ComputeRoutesRequest.travelMode ma wartość TRANSIT. Możesz podać ComputeRoutesRequest.departureTime lub ComputeRoutesRequest.arrivalTime, ale nie obie te wartości. Przejazdy transportem publicznym są dostępne do 7 dni wstecz lub 100 dni do przodu.
computeAlternativeRoutes
opcjonalne
Typ: boolean optional
Określa, czy oprócz trasy mają być obliczane trasy alternatywne. W przypadku żądań, które zawierają pośrednie punkty orientacyjne, nie są zwracane żadne trasy alternatywne.
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 ComputeRoutesRequest.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 ComputeRoutesRequest.fields, aby zostały zwrócone w odpowiedzi.
intermediates
opcjonalne
Typ: Iterable<Waypoint> optional
Zbiór punktów pośrednich na trasie (z wyjątkiem punktów końcowych), w których można się zatrzymać lub przez które można przejechać. Obsługiwanych jest maksymalnie 25 punktów pośrednich.
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 źródła.
optimizeWaypointOrder
opcjonalne
Typ: boolean optional
Jeśli zasada ma wartość Prawda, usługa próbuje zminimalizować ogólny koszt trasy, zmieniając kolejność określonych punktów pośrednich. Żądanie nie powiedzie się, jeśli którykolwiek z punktów pośrednich jest punktem pośrednim typu „via”. Aby znaleźć nową kolejność, użyj Route.optimizedIntermediateWaypointIndices w odpowiedzi. Jeśli w parametrze ComputeRoutesRequest.fields nie ma żądania "optimizedIntermediateWaypointIndices", żądanie się nie powiedzie. Jeśli ma wartość „false”, pole Route.optimizedIntermediateWaypointIndices w odpowiedzi będzie puste.
polylineQuality
opcjonalne
Typ: PolylineQuality optional
Określa preferencje dotyczące jakości linii łamanej.
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 punktu początkowego.
requestedReferenceRoutes
opcjonalne
Typ: Iterable<ReferenceRoute> optional
Określa, jakie trasy referencyjne mają być obliczane w ramach żądania oprócz trasy domyślnej. Trasa referencyjna to trasa, która ma inny cel obliczania trasy niż trasa domyślna. Na przykład obliczanie trasy referencyjnej FUEL_EFFICIENT uwzględnia różne parametry, które pozwalają wygenerować optymalną trasę z najniższym spalaniem. Podczas korzystania z tej funkcji szukaj ikony Route.routeLabels na trasach.
routeModifiers
opcjonalne
Typ: RouteModifiers optional
Zestaw warunków, które należy spełnić, wpływających na sposób obliczania tras. Możesz na przykład określić, jakich dróg chcesz unikać, np. dróg płatnych lub autostrad.
routingPreference
opcjonalne
Typ: RoutingPreference optional
Określa sposób obliczania trasy. Serwer próbuje obliczyć trasę, korzystając z wybranego ustawienia trasy. 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 ComputeRoutesRequest.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ści Route.durationMillis i RouteLeg.durationMillis, które zawierają przewidywany czas w ruchu ulicznym na podstawie średnich historycznych. Parametr ComputeRoutesRequest.trafficModel jest dostępny tylko w przypadku żądań, w których parametr ComputeRoutesRequest.routingPreference ma wartość TRAFFIC_AWARE_OPTIMAL, a parametr ComputeRoutesRequest.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 ComputeRoutesRequest.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, takich jak instrukcje nawigacji. Ta wartość nie ma wpływu na jednostki miary używane do określania odległości i czasu trwania trasy, odcinka i kroku. Jeśli nie podasz tej wartości, jednostki wyświetlania zostaną określone na podstawie lokalizacji punktu początkowego.

Stałe ComputeRoutesExtraComputation

stałe google.maps.routes.ComputeRoutesExtraComputation
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 ComputeRoutesExtraComputationString.

const {ComputeRoutesExtraComputation} = await google.maps.importLibrary("routes");
FLYOVER_INFO_ON_POLYLINE Informacje o wiaduktach na trasach. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
FUEL_CONSUMPTION Szacowane zużycie paliwa na trasach. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS Więcej informacji znajdziesz w dokumentacji usługi internetowej.
NARROW_ROAD_INFO_ON_POLYLINE Informacje o wąskich drogach na trasach. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
TOLLS Informacje o opłatach za przejazd na trasach. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
TRAFFIC_ON_POLYLINE linie łamane tras z uwzględnieniem natężenia ruchu, Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Interfejs CreateWaypointMarkersOptions

interfejs google.maps.routes.CreateWaypointMarkersOptions<T = MarkerElement|Marker3DElement|MarkerInteractiveElement|Marker3DInteractiveElement>

Opcje tworzenia znaczników punktów pośrednich.

forEach
opcjonalne
Typ: function(T): void optional
Funkcja niestandardowa do mutowania utworzonych elementów. Domyślna funkcja forEach dołącza do każdego znacznika pinezki z glifami A–Z. Aby zmienić to działanie, zastąp tę funkcję.
markerClass
opcjonalne
Typ: new () => T optional
Konstruktor elementu do utworzenia. Obsługiwane typy:

Interfejs DirectionalLocationLiteral

interfejs google.maps.routes.DirectionalLocationLiteral rozszerza LatLngAltitudeLiteral, LatLngLiteral
implementowany przez DirectionalLocation

Dla wygody zamiast instancji DirectionalLocation akceptowane są literały obiektów. Gdy interfejs Maps JavaScript API napotka te elementy, zostaną one przekonwertowane na DirectionalLocation.

heading
opcjonalne
Typ: number optional
Kierunek kompasu powiązany z kierunkiem ruchu. Wartości kierunku mogą być liczbami od 0 do 360, gdzie 0 oznacza kierunek północny, 90 – wschodni itd. Tego pola możesz używać tylko w przypadku DRIVING i TWO_WHEELER ComputeRoutesRequest.travelMode.
Dziedziczone: altitude, lat, lng

Klasa DirectionalLocation

class google.maps.routes.DirectionalLocation extends LatLngAltitude implements DirectionalLocationLiteral, LatLngAltitudeLiteral, LatLngLiteral
library "routes"

Zawiera punkt geograficzny i opcjonalny nagłówek.

const {DirectionalLocation} = await google.maps.importLibrary("routes");
Dziedziczone: LatLngAltitude
heading
readonly
Typ: number optional
Kierunek kompasu powiązany z kierunkiem ruchu. Wartości kierunku mogą być liczbami od 0 do 360, gdzie 0 oznacza kierunek północny, 90 – wschodni itd. Tego pola możesz używać tylko w przypadku DRIVING i TWO_WHEELER ComputeRoutesRequest.travelMode.
Dziedziczone: altitude, lat, lng
toJSON
toJSON([key])
Parametry:
  • key: string optional
Wartość zwracana: DirectionalLocationLiteral
Konwertuje na zwykły obiekt.
Dziedziczone: equals

Klasa FallbackInfo

klasa google.maps.routes.FallbackInfo
biblioteka "routes"

Informacje o tym, jak i dlaczego w odpowiedzi Route.computeRoutes został użyty wynik zastępczy. Jeśli to pole jest ustawione, oznacza to, że serwer użył innego trybu routingu niż preferowany jako zastępczy.

const {FallbackInfo} = await google.maps.importLibrary("routes");
reason
readonly
Typ: FallbackReason optional
Powód, dla którego użyto odpowiedzi zastępczej zamiast pierwotnej. To pole jest wypełniane tylko wtedy, gdy uruchomiony jest tryb zastępczy i zwracana jest odpowiedź zastępcza.
routingMode
readonly
Typ: FallbackRoutingMode optional
Tryb routingu użyty w odpowiedzi. Jeśli uruchomiono kreację zastępczą, tryb może się różnić od preferencji dotyczących kierowania ustawionych w pierwotnym żądaniu klienta.
Dziedziczone: toJSON

Stałe FallbackReason

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

Powody użycia odpowiedzi zastępczej. 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 FallbackReasonString.

const {FallbackReason} = await google.maps.importLibrary("routes");
LATENCY_EXCEEDED Nie udało nam się na czas zakończyć obliczeń z użyciem preferowanego trybu wyznaczania trasy, ale udało nam się zwrócić wynik obliczony w trybie alternatywnym. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
SERVER_ERROR Podczas obliczania tras w preferowanym trybie wyznaczania trasy wystąpił błąd serwera, ale udało nam się zwrócić wynik obliczony w trybie alternatywnym. Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Stałe FallbackRoutingMode

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

Rzeczywisty tryb routingu używany w przypadku zwróconej odpowiedzi zastępczej. 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 FallbackRoutingModeString.

const {FallbackRoutingMode} = await google.maps.importLibrary("routes");
TRAFFIC_AWARE Więcej informacji znajdziesz w dokumentacji usługi internetowej.
TRAFFIC_UNAWARE Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Klasa GeocodedWaypoint

klasa google.maps.routes.GeocodedWaypoint
biblioteka "routes"

Geokodowanie lokalizacji używanych jako punkty orientacyjne. Wypełniane tylko w przypadku punktów orientacyjnych adresu. Zawiera szczegółowe informacje o wynikach geokodowania, które pozwalają określić, do czego został przypisany dany adres.

const {GeocodedWaypoint} = await google.maps.importLibrary("routes");
geocoderStatus
readonly
Typ: RPCStatus optional
Wskazuje kod stanu wynikający z operacji geokodowania.
intermediateWaypointRequestIndex
readonly
Typ: number optional
Indeks odpowiedniego punktu pośredniego w żądaniu. Wypełniane tylko wtedy, gdy odpowiedni punkt pośredni jest punktem pośrednim.
partialMatch
readonly
Typ: boolean
Oznacza, że geokoder nie zwrócił dopasowania ścisłego do pierwotnego żądania, ale udało mu się dopasować część żądanego adresu. Sprawdź, czy w pierwotnym żądaniu nie ma błędów pisowni lub niekompletnego adresu.
placeId
readonly
Typ: string
Identyfikator miejsca dla tego wyniku.
types
readonly
Typ: Array<string>
Typy wyniku w postaci co najmniej 1 tagu typu. Obsługiwane typy znajdziesz na stronie https://developers.google.com/maps/documentation/geocoding/requests-geocoding#Types.
Dziedziczone: toJSON

Klasa GeocodingResults

klasa google.maps.routes.GeocodingResults
biblioteka "routes"

Zawiera obiekty GeocodedWaypoint dla miejsca początkowego, docelowego i punktów pośrednich. Wypełniane tylko w przypadku punktów orientacyjnych adresu.

const {GeocodingResults} = await google.maps.importLibrary("routes");
destination
readonly
Typ: GeocodedWaypoint optional
Punkt na trasie z kodem geograficznym dla miejsca docelowego.
intermediates
readonly
Typ: Array<GeocodedWaypoint> optional
Lista pośrednich punktów na trasie z kodem geograficznym, z których każdy zawiera pole indeksu odpowiadające pozycji punktu na trasie liczonej od zera w kolejności, w jakiej zostały określone w żądaniu.
origin
readonly
Typ: GeocodedWaypoint optional
Punkt pośredni z geokodowaniem dla miejsca wyjazdu.
Dziedziczone: toJSON

Klasa MultiModalSegment

klasa google.maps.routes.MultiModalSegment
biblioteka "routes"

Zawiera podsumowanie informacji o multimodalnym odcinku RouteLeg.steps trasy. Segment multimodalny to co najmniej 1 sąsiadujący element RouteLegStep, który ma ten sam element TravelMode.

const {MultiModalSegment} = await google.maps.importLibrary("routes");
instructions
readonly
Typ: string optional
Instrukcje poruszania się po tym segmencie multimodalnym.
maneuver
readonly
Typ: string optional
Manewr nawigacyjny do wykonania na tym etapie. Listę możliwych wartości znajdziesz w sekcji Manewr.
stepEndIndex
readonly
Typ: number
Odpowiedni indeks RouteLegStep, który jest końcem segmentu multimodalnego.
stepStartIndex
readonly
Typ: number
Odpowiedni indeks RouteLegStep, który jest początkiem segmentu multimodalnego.
travelMode
readonly
Typ: TravelMode optional
Tryb podróży używany w tym segmencie multimodalnym.
Dziedziczone: toJSON

Klasa PolylineDetailInfo

klasa google.maps.routes.PolylineDetailInfo
biblioteka "routes"

Zawiera informacje o elemencie drogi na odcinku linii łamanej.

const {PolylineDetailInfo} = await google.maps.importLibrary("routes");
endIndex
readonly
Typ: number optional
Indeks końcowy tego obiektu drogowego w łamanej.
presence
readonly
Typ: RoadFeatureState optional
Wskazuje, czy element drogi występuje wzdłuż linii łamanej.
startIndex
readonly
Typ: number optional
Indeks początkowy tego elementu drogi w łamanej.
Dziedziczone: toJSON

PolylineDetails

klasa google.maps.routes.PolylineDetails
biblioteka "routes"

Szczegóły odpowiadające danemu indeksowi lub ciągłemu segmentowi linii łamanej. W przypadku linii łamanej z punktami P_0, P_1, ... , P_N (indeks od zera) PolylineDetails opisuje cechę drogi w danym przedziale.

const {PolylineDetails} = await google.maps.importLibrary("routes");
flyoverInfo
readonly
Szczegóły przelotu wzdłuż linii łamanej.
narrowRoadInfo
readonly
Szczegóły wąskiej drogi wzdłuż linii łamanej.
Dziedziczone: toJSON

Stałe PolylineQuality

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

Zestaw wartości określających jakość linii łamanej. 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 PolylineQualityString.

const {PolylineQuality} = await google.maps.importLibrary("routes");
HIGH_QUALITY Określa polilinię wysokiej jakości, która składa się z większej liczby punktów niż OVERVIEW, co zwiększa rozmiar odpowiedzi. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
OVERVIEW Określa linię łamaną przeglądu, która składa się z niewielkiej liczby punktów. Więcej informacji znajdziesz w dokumentacji usługi internetowej.

ReferenceRoute constants

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

Obsługiwana trasa referencyjna w żądaniu ComputeRoutesRequest. 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 ReferenceRouteString.

const {ReferenceRoute} = await google.maps.importLibrary("routes");
FUEL_EFFICIENT Trasa z najniższym spalaniem. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
SHORTER_DISTANCE Trasa o krótszym dystansie. Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Stałe RoadFeatureState

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

Zawiera stany obiektów na drodze wzdłuż odcinka linii łamanej. 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 RoadFeatureStateString.

const {RoadFeatureState} = await google.maps.importLibrary("routes");
DOES_NOT_EXIST Droga nie istnieje. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
EXISTS Obiekt na drodze istnieje. Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Stałe RouteLabel

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

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 RouteLabelString.

const {RouteLabel} = await google.maps.importLibrary("routes");
DEFAULT_ROUTE Domyślna „najlepsza” trasa zwrócona na potrzeby obliczania trasy. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
DEFAULT_ROUTE_ALTERNATE Alternatywa dla domyślnej „najlepszej” trasy. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
FUEL_EFFICIENT Trasa z najniższym spalaniem. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
SHORTER_DISTANCE trasa o krótszym dystansie, Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Klasa RouteLeg

klasa google.maps.routes.RouteLeg
biblioteka "routes"

Zawiera segment między punktami orientacyjnymi, które nie są punktami via.

const {RouteLeg} = await google.maps.importLibrary("routes");
distanceMeters
readonly
Typ: number
Odległość do przebycia na danym odcinku trasy w metrach.
durationMillis
readonly
Typ: number optional
Czas potrzebny na pokonanie odcinka trasy w milisekundach. Jeśli ustawisz parametr ComputeRoutesRequest.routingPreference na TRAFFIC_UNAWARE, ta wartość będzie taka sama jak staticDurationMillis. Jeśli ustawisz parametr ComputeRoutesRequest.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.
endLocation
readonly
Typ: DirectionalLocation optional
Lokalizacja końcowa tego odcinka. Ta lokalizacja może się różnić od: ComputeRoutesRequest.destination. Jeśli na przykład ComputeRoutesRequest.destination nie znajduje się w pobliżu drogi, jest to punkt na drodze.
localizedValues
readonly
Tekstowe reprezentacje właściwości RouteLeg.
path
readonly
Lista LatLngAltitude odcinka trasy, których można użyć do narysowania linii łamanej odcinka trasy. Szczegółowość ścieżki można kontrolować, ustawiając ComputeRoutesRequest.polylineQuality.
speedPaths
readonly
Grupowanie sekcji ścieżki etapu trasy z odpowiadającymi im odczytami prędkości. Aby to pole zostało wypełnione, pole ComputeRoutesRequest.routingPreference musi mieć wartość TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL, a pole ComputeRoutesRequest.extraComputations musi zawierać wartość TRAFFIC_ON_POLYLINE.
startLocation
readonly
Typ: DirectionalLocation optional
Lokalizacja początkowa tego odcinka. Ta lokalizacja może się różnić od: ComputeRoutesRequest.origin. Jeśli na przykład ComputeRoutesRequest.origin nie znajduje się w pobliżu drogi, jest to punkt na drodze.
staticDurationMillis
readonly
Typ: number optional
Czas podróży na danym odcinku bez uwzględniania warunków na drodze.

Uwaga: jeśli czas trwania przekracza 2^53 milisekund, ta wartość to Number.POSITIVE_INFINITY.
steps
readonly
Tablica kroków oznaczających segmenty w ramach tego etapu. Każdy krok odpowiada jednej instrukcji nawigacji.
stepsOverview
readonly
Typ: StepsOverview optional
Informacje ogólne o krokach w tym: RouteLeg. To pole jest wypełniane tylko w przypadku tras TRANSIT.
travelAdvisory
readonly
Zawiera dodatkowe informacje, o których należy poinformować użytkownika, np. o możliwych ograniczeniach strefy ruchu na danym odcinku trasy.
Dziedziczone: toJSON

Klasa RouteLegLocalizedValues

klasa google.maps.routes.RouteLegLocalizedValues
biblioteka "routes"

Reprezentacje tekstowe: RouteLeg.

const {RouteLegLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
Typ: string optional
Odległość do pokonania na danym odcinku trasy 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;
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”.
Dziedziczone: toJSON

Klasa RouteLegStep

klasa google.maps.routes.RouteLegStep
biblioteka "routes"

Zawiera segment: RouteLeg. Krok odpowiada pojedynczej instrukcji nawigacji. Odcinki trasy składają się z kroków.

const {RouteLegStep} = await google.maps.importLibrary("routes");
distanceMeters
readonly
Typ: number
Odległość do pokonania na tym etapie w metrach.
endLocation
readonly
Typ: DirectionalLocation optional
Lokalizacja końcowa tego kroku.
instructions
readonly
Typ: string optional
Instrukcje dotyczące tego kroku.
localizedValues
readonly
Tekstowe reprezentacje właściwości RouteLegStep.
maneuver
readonly
Typ: string optional
Manewr nawigacyjny do wykonania na tym etapie. Listę możliwych wartości znajdziesz w sekcji Manewr.
path
readonly
Lista LatLngAltitude etapu odcinka trasy, których można użyć do narysowania linii łamanej etapu odcinka trasy. Szczegółowość ścieżki można kontrolować, ustawiając ComputeRoutesRequest.polylineQuality. Aby to pole zostało wypełnione, musisz poprosić o pole "path" w ComputeRoutesRequest.fields.
startLocation
readonly
Typ: DirectionalLocation optional
Lokalizacja początkowa tego kroku.
staticDurationMillis
readonly
Typ: number optional
Czas trwania tego kroku bez uwzględniania warunków na drodze.

Uwaga: jeśli czas trwania przekracza 2^53 milisekund, ta wartość to Number.POSITIVE_INFINITY.
transitDetails
readonly
Typ: TransitDetails optional
Szczegóły dotyczące tego kroku, jeśli środek transportu to TRANSIT.
travelMode
readonly
Typ: TravelMode optional
Tryb podróży używany na tym etapie.
Dziedziczone: toJSON

Klasa RouteLegStepLocalizedValues

klasa google.maps.routes.RouteLegStepLocalizedValues
biblioteka "routes"

Tekstowe reprezentacje właściwości RouteLegStep.

const {RouteLegStepLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
Typ: string optional
Odległość do przebycia na danym etapie trasy 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.
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”.

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

Klasa RouteLegTravelAdvisory

klasa google.maps.routes.RouteLegTravelAdvisory
biblioteka "routes"

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany na stronie RouteLeg.

const {RouteLegTravelAdvisory} = await google.maps.importLibrary("routes");
speedReadingIntervals
readonly
Przedziały odczytu prędkości ze szczegółowymi informacjami o gęstości ruchu. Dotyczy TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference. Interwały obejmują całą polilinię RouteLeg bez nakładania się. Punkt początkowy określonego przedziału jest taki sam jak punkt końcowy poprzedniego przedziału.

Przykład:
 polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo
readonly
Typ: TollInfo optional
Zawiera informacje o opłatach na konkretnej trasie RouteLeg. To pole jest wypełniane tylko wtedy, gdy na trasie RouteLeg są spodziewane opłaty. Jeśli to pole jest ustawione, ale pole TollInfo.estimatedPrices nie jest wypełnione, odcinek trasy zawiera opłaty, ale szacowana cena jest nieznana. Jeśli to pole jest puste, na trasie RouteLeg nie ma opłat.
Dziedziczone: toJSON

Klasa RouteLocalizedValues

klasa google.maps.routes.RouteLocalizedValues
biblioteka "routes"

Tekstowe reprezentacje właściwości Route.

const {RouteLocalizedValues} = await google.maps.importLibrary("routes");
distance
readonly
Typ: string optional
Odległość do przebycia na trasie 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 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”.
Dziedziczone: toJSON

Interfejs RouteModifiers

interfejs google.maps.routes.RouteModifiers

Zawiera zestaw opcjonalnych warunków, które należy spełnić podczas obliczania tras.

avoidFerries
opcjonalne
Typ: boolean optional
Jeśli ustawisz wartość true, trasy będą w miarę możliwości omijać promy, a preferowane będą trasy bez promów. Dotyczy tylko DRIVING lub TWO_WHEELER TravelMode.
avoidHighways
opcjonalne
Typ: boolean optional
Jeśli ustawisz wartość true, trasa będzie w miarę możliwości omijać autostrady, preferując drogi, które nie są autostradami. Dotyczy tylko DRIVING lub TWO_WHEELER TravelMode.
avoidIndoor
opcjonalne
Typ: boolean optional
Jeśli ustawisz wartość true, nawigacja będzie w miarę możliwości unikać nawigowania wewnątrz budynków, preferując trasy, które nie zawierają nawigacji wewnątrz budynków. Dotyczy tylko: WALKING TravelMode.
avoidTolls
opcjonalne
Typ: boolean optional
Jeśli ustawisz wartość true, trasa będzie w miarę możliwości omijać drogi płatne, preferując te bezpłatne. Dotyczy tylko DRIVING lub TWO_WHEELER TravelMode.
tollPasses
opcjonalne
Typ: Iterable<string> optional
Zawiera informacje o opłatach drogowych. Jeśli podano winiety, interfejs API próbuje zwrócić cenę winiety. Jeśli nie podasz informacji o winietach, interfejs API potraktuje winietę jako nieznaną i spróbuje zwrócić cenę gotówkową. Dotyczy tylko DRIVING lub TWO_WHEELER TravelMode. Listę prawidłowych wartości znajdziesz w sekcji TollPass.
vehicleInfo
opcjonalne
Typ: VehicleInfo optional
Określa informacje o pojeździe.

RoutePolyline3DOptions interface

interfejs google.maps.routes.RoutePolyline3DOptions

Opcje tworzenia linii łamanych 3D trasy.

colorScheme
opcjonalne
Typ: ColorScheme optional
Schemat kolorów, który ma być używany w przypadku polilinii 3D. Jeśli ten parametr ma wartość FOLLOW_SYSTEM, a mapa colorScheme też ma wartość FOLLOW_SYSTEM, linie łamane będą rysowane w tym samym trybie ciemnym lub jasnym co mapa. Jeśli nie zostanie określony, AlphaRoute.create3DPolylines spróbuje użyć colorScheme mapy lub wróci do ustawienia domyślnego systemu.
polylineOptions
opcjonalne
Opcje dostosowywania stylu polilinii 3D.
trafficPolylinesDisabled
opcjonalne
Typ: boolean optional
Określa, czy wyłączyć linie łamane uwzględniające natężenie ruchu. Polilinie uwzględniające natężenie ruchu są dostępne tylko wtedy, gdy parametr routingPreference jest ustawiony na TRAFFIC_AWARE lub TRAFFIC_AWARE_OPTIMAL.

Interfejs RoutePolylineDetails

interfejs google.maps.routes.RoutePolylineDetails

Szczegółowe informacje o odcinku trasy odpowiadającym linii łamanej, które można wykorzystać do dostosowania stylu linii łamanej.

speed
opcjonalne
Typ: Speed optional
Odczyt prędkości na odcinku trasy odpowiadającym tej linii łamanej. Wartość jest podawana tylko w przypadku tras z informacjami o natężeniu ruchu.
transitDetails
opcjonalne
Typ: TransitDetails optional
Szczegóły transportu publicznego dotyczące odcinka trasy odpowiadającego tej linii łamanej. Wartość jest podawana tylko w przypadku tras z informacjami o transporcie publicznym.
travelMode
opcjonalne
Typ: TravelMode optional
Tryb podróży na odcinku trasy odpowiadającym tej linii łamanej. Puste w przypadku linii łamanych natężenia ruchu.

Interfejs RoutePolylineOptions

interfejs google.maps.routes.RoutePolylineOptions

Opcje tworzenia linii łamanych trasy.

colorScheme
opcjonalne
Typ: ColorScheme optional
Schemat kolorów, który ma być używany w przypadku polilinii. Jeśli ten parametr ma wartość FOLLOW_SYSTEM, a mapa colorScheme też ma wartość FOLLOW_SYSTEM, linie łamane będą rysowane w tym samym trybie ciemnym lub jasnym co mapa. Jeśli nie zostanie określony, Route.createPolylines spróbuje użyć colorScheme mapy lub wróci do ustawienia domyślnego systemu.
polylineOptions
opcjonalne
Opcje dostosowywania stylu linii łamanej. Może to być obiekt PolylineOptions, który jest stosowany do wszystkich linii łamanych trasy, lub funkcja, która przyjmuje domyślne wartości PolylineOptions i RoutePolylineDetails i zwraca wartość PolylineOptions, która ma zostać zastosowana do tej linii łamanej.

Klasa RouteTravelAdvisory

klasa google.maps.routes.RouteTravelAdvisory
biblioteka "routes"

Zawiera dodatkowe informacje, o których użytkownik powinien zostać poinformowany na stronie Route.

const {RouteTravelAdvisory} = await google.maps.importLibrary("routes");
fuelConsumptionMicroliters
readonly
Typ: number optional
Przewidywane zużycie paliwa w mikrolitrach.

Uwaga: jeśli zużycie paliwa przekracza 2^53 mikrolitrów, ta wartość wynosi Number.POSITIVE_INFINITY.
routeRestrictionsPartiallyIgnored
readonly
Typ: boolean optional
Route może mieć ograniczenia, które nie są odpowiednie dla żądanego środka transportu lub modyfikatorów trasy.
speedReadingIntervals
readonly
Przedziały odczytu prędkości ze szczegółowymi informacjami o gęstości ruchu. Dotyczy TRAFFIC_AWARE i TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routingPreference. Interwały obejmują całą polilinię Route bez nakładania się. Punkt początkowy określonego przedziału jest taki sam jak punkt końcowy poprzedniego przedziału.

Przykład:
 polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speedReadingIntervals: [A,C), [C,D), [D,G)
tollInfo
readonly
Typ: TollInfo optional
Zawiera informacje o opłatach na drodze Route. To pole jest wypełniane tylko wtedy, gdy na trasie Route są spodziewane opłaty. Jeśli to pole jest ustawione, ale pole TollInfo.estimatedPrices nie jest wypełnione, trasa zawiera opłaty, ale szacunkowa cena jest nieznana. Jeśli to pole jest puste, na trasie Route nie ma opłat.
transitFare
readonly
Typ: Money optional
Jeśli jest obecny, zawiera łączną opłatę lub koszty biletów dla tego elementu Route. Ta właściwość jest zwracana tylko w przypadku TRANSIT ComputeRoutesRequest.travelMode i tylko w przypadku tras, na których informacje o opłatach są dostępne dla wszystkich etapów transportu publicznego.
Dziedziczone: toJSON

RoutingPreference constants

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

Zbiór wartości określających czynniki, które należy wziąć pod uwagę podczas obliczania 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 RoutingPreferenceString.

const {RoutingPreference} = await google.maps.importLibrary("routes");
TRAFFIC_AWARE Oblicza trasy z uwzględnieniem aktualnych warunków na drodze. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
TRAFFIC_AWARE_OPTIMAL Oblicza trasy z uwzględnieniem aktualnych warunków na drodze, bez stosowania większości optymalizacji wydajności. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
TRAFFIC_UNAWARE Oblicza trasy bez uwzględniania aktualnych warunków na drodze. Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Stałe szybkości

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

Klasyfikacja prędkości na linii łamanej na podstawie danych o natężeniu ruchu. 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 SpeedString.

const {Speed} = await google.maps.importLibrary("routes");
NORMAL Normalna prędkość, brak opóźnień w ruchu. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
SLOW Wykryto spowolnienie, średnie natężenie ruchu. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
TRAFFIC_JAM Opóźnienia w ruchu. Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Interfejs SpeedPath

interfejs google.maps.routes.SpeedPath

Grupuje LatLngAltitude odcinka trasy z odczytem prędkości na tym odcinku.

path
Ścieżka objęta tą ścieżką prędkości.
speed
opcjonalne
Typ: Speed optional
Odczyt prędkości na ścieżce.

Klasa SpeedReadingInterval

klasa google.maps.routes.SpeedReadingInterval
biblioteka "routes"

Wskaźnik natężenia ruchu na ciągłym odcinku linii łamanej lub ścieżki. W przypadku ścieżki z punktami P_0, P_1, ... , P_N (indeks od zera) SpeedReadingInterval opisuje natężenie ruchu w danym przedziale.

const {SpeedReadingInterval} = await google.maps.importLibrary("routes");
endPolylinePointIndex
readonly
Typ: number optional
Indeks końcowy tego interwału w łamanej.
speed
readonly
Typ: Speed optional
Szybkość ruchu w tym przedziale czasu.
startPolylinePointIndex
readonly
Typ: number optional
Indeks początkowy tego interwału w linii łamanej.

Klasa StepsOverview

klasa google.maps.routes.StepsOverview
biblioteka "routes"

Zawiera ogólne informacje o liście RouteLeg.steps.

const {StepsOverview} = await google.maps.importLibrary("routes");
multiModalSegments
readonly
Podsumowanie informacji o różnych segmentach multimodalnych RouteLeg.steps.
Dziedziczone: toJSON

Klasa TollInfo

klasa google.maps.routes.TollInfo
biblioteka "routes"

Zawiera informacje o opłatach na Route lub RouteLeg.

const {TollInfo} = await google.maps.importLibrary("routes");
estimatedPrices
readonly
Typ: Array<Money> optional
Kwota opłat za przejazd dla odpowiedniego Route lub RouteLeg. Ta lista zawiera kwotę w każdej walucie, która ma zostać naliczona przez punkty poboru opłat. Zwykle ta lista zawiera tylko 1 element w przypadku tras z opłatami w jednej walucie. W przypadku podróży międzynarodowych ta lista może zawierać kilka pozycji, aby odzwierciedlić opłaty w różnych walutach. To pole może być pustą tablicą, jeśli opłaty są oczekiwane, ale szacunkowa cena jest nieznana.
Dziedziczone: toJSON

Klasa TransitAgency

klasa google.maps.routes.TransitAgency
biblioteka "routes"

Informacje o przewoźniku.

const {TransitAgency} = await google.maps.importLibrary("routes");
name
readonly
Typ: string optional
Nazwa przewoźnika.
phoneNumber
readonly
Typ: string optional
Numer telefonu przewoźnika sformatowany zgodnie z ustawieniami regionalnymi.
url
readonly
Typ: URL optional
Adres URL przewoźnika.
Dziedziczone: toJSON

Klasa TransitDetails

klasa google.maps.routes.TransitDetails
biblioteka "routes"

Dodatkowe informacje o etapie transportu publicznego na trasie.

const {TransitDetails} = await google.maps.importLibrary("routes");
arrivalStop
readonly
Typ: TransitStop optional
Informacje o przystanku docelowym dla danego kroku.
arrivalTime
readonly
Typ: Date optional
Szacowany czas dotarcia na miejsce w przypadku danego kroku.
departureStop
readonly
Typ: TransitStop optional
Informacje o przystanku początkowym dla danego kroku.
departureTime
readonly
Typ: Date optional
Szacowany czas odjazdu w ramach kroku.
headsign
readonly
Typ: string optional
Określa kierunek jazdy na tej linii, zgodnie z oznaczeniem na pojeździe lub na przystanku odjazdu. Kierunek to często stacja końcowa.
headwayMillis
readonly
Typ: number optional
Określa oczekiwany czas w milisekundach między odjazdami z tego samego przystanku w tym czasie. Jeśli na przykład wartość częstotliwości wynosi 600 000, to w przypadku spóźnienia się na autobus trzeba będzie poczekać 10 minut.

Uwaga: jeśli odstęp przekracza 2^53 milisekund, ta wartość wynosi Number.POSITIVE_INFINITY.
stopCount
readonly
Typ: number
Liczba przystanków od przystanku początkowego do końcowego. Ta liczba obejmuje przystanek docelowy, ale nie obejmuje przystanku początkowego. Jeśli na przykład trasa zaczyna się na przystanku A, przechodzi przez przystanki B i C, a kończy się na przystanku D, wartość pola stopCount będzie wynosić 3.
transitLine
readonly
Typ: TransitLine optional
Informacje o linii transportu publicznego używanej na danym etapie.
tripShortText
readonly
Typ: string optional
Tekst, który pojawia się w harmonogramach i na tablicach informacyjnych, aby ułatwić pasażerom identyfikację przejazdu. Tekst jednoznacznie identyfikuje przejazd w ciągu dnia obsługi. Na przykład „538” to tripShortText pociągu Amtrak, który odjeżdża z San Jose w Kalifornii o 15:10 w dni powszednie do Sacramento w Kalifornii.
Dziedziczone: toJSON

Klasa TransitLine

klasa google.maps.routes.TransitLine
biblioteka "routes"

Informacje o linii transportu publicznego.

const {TransitLine} = await google.maps.importLibrary("routes");
agencies
readonly
Przewoźnik (lub przewoźnicy) obsługujący tę linię transportu publicznego.
color
readonly
Typ: string optional
Kolor często używany na znakach dotyczących tej linii. Wartość jest podawana w formacie szesnastkowym.
iconURL
readonly
Typ: URL optional
Adres URL ikony powiązanej z tą linią.
name
readonly
Typ: string optional
Pełna nazwa tej linii transportu publicznego, np. „8 Avenue Local”.
shortName
readonly
Typ: string optional
Krótka nazwa tej linii transportu publicznego. Zwykle jest to numer linii, np. „M7” lub „355”.
textColor
readonly
Typ: string optional
Kolor często używany w tekście na znakach dotyczących tej linii. Wartość jest podawana w formacie szesnastkowym.
url
readonly
Typ: URL optional
Adres URL tej linii transportu publicznego podany przez przewoźnika.
vehicle
readonly
Typ: TransitVehicle optional
Typ pojazdu, który obsługuje tę linię transportu publicznego.
Dziedziczone: toJSON

TransitPreference interface

interfejs google.maps.routes.TransitPreference

Ustawienia tras opartych na TRANSIT, które wpływają na zwracaną trasę.

allowedTransitModes
opcjonalne
Typ: Iterable<TransitMode> optional
Zestaw środków transportu, które mają być używane podczas wyznaczania trasy TRANSIT. Domyślnie są to wszystkie obsługiwane środki transportu.
routingPreference
opcjonalne
Preferencja dotycząca trasy, która po określeniu wpływa na zwracaną trasę TRANSIT.

Klasa TransitStop

klasa google.maps.routes.TransitStop
biblioteka "routes"

Informacje o przystanku transportu publicznego.

const {TransitStop} = await google.maps.importLibrary("routes");
location
readonly
Typ: DirectionalLocation optional
Lokalizacja przystanku wyrażona za pomocą współrzędnych szerokości i długości geograficznej oraz opcjonalnego kierunku.
name
readonly
Typ: string optional
Nazwa przystanku transportu publicznego.
Dziedziczone: toJSON

Klasa TransitVehicle

klasa google.maps.routes.TransitVehicle
biblioteka "routes"

Informacje o pojeździe używanym na trasach transportu publicznego.

const {TransitVehicle} = await google.maps.importLibrary("routes");
iconURL
readonly
Typ: URL optional
Adres URL ikony powiązanej z tym typem pojazdu.
localIconURL
readonly
Typ: URL optional
Adres URL ikony powiązanej z tym typem pojazdu, na podstawie lokalnych znaków transportowych.
name
readonly
Typ: string optional
Nazwa tego pojazdu pisana wielkimi literami.
nameLanguage
readonly
Typ: string optional
Kod języka w standardzie BCP-47 dla tekstu nazwy pojazdu, np. „en-US” lub „sr-Latn”.

Więcej informacji znajdziesz na stronie https://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
vehicleType
readonly
Typ: string optional
rodzaj użytego pojazdu;

Listę możliwych wartości znajdziesz na stronie https://developers.google.com/maps/documentation/routes/reference/rpc/google.maps.routing.v2#transitvehicletype.
Dziedziczone: toJSON

Stałe VehicleEmissionType

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

Zestaw wartości opisujących typ emisji pojazdu. 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 VehicleEmissionTypeString.

const {VehicleEmissionType} = await google.maps.importLibrary("routes");
DIESEL Pojazd z silnikiem Diesla. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
ELECTRIC Pojazd zasilany energią elektryczną. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
GASOLINE Pojazd z silnikiem benzynowym. Więcej informacji znajdziesz w dokumentacji usługi internetowej.
HYBRID Pojazd hybrydowy (np. benzynowy i elektryczny). Więcej informacji znajdziesz w dokumentacji usługi internetowej.

Interfejs VehicleInfo

interfejs google.maps.routes.VehicleInfo

Zawiera informacje o pojeździe, takie jak typ emisji.

emissionType
opcjonalne
Typ: VehicleEmissionType optional
Opisuje typ emisji pojazdu. Dotyczy tylko trybu podróży DRIVING.

Interfejs Waypoint

interfejs google.maps.routes.Waypoint

Reprezentuje punkt na trasie.

location
Lokalizacja punktu na trasie. Ciąg znaków może być adresem, kodem Plus Code lub nazwą zasobu miejsca.
sideOfRoad
opcjonalne
Typ: boolean optional
Wskazuje, że lokalizacja tego punktu na trasie ma preferować zatrzymanie pojazdu po określonej stronie drogi. Gdy ustawisz tę wartość, trasa będzie przebiegać przez lokalizację, dzięki czemu pojazd będzie mógł zatrzymać się po tej stronie drogi, po której znajduje się lokalizacja. Ta opcja działa tylko w przypadku DRIVING i TWO_WHEELER ComputeRoutesRequest.travelMode
vehicleStopover
opcjonalne
Typ: boolean optional
Wskazuje, że punkt pośredni jest przeznaczony dla pojazdów, które mają się zatrzymać, aby odebrać lub wysadzić pasażera. Gdy ustawisz tę wartość, obliczona trasa nie będzie obejmować punktów pośrednich innych niż via na drogach, które nie nadają się do odbioru i wysadzania pasażerów. Ta opcja działa tylko w przypadku DRIVING i TWO_WHEELER ComputeRoutesRequest.travelMode oraz gdy Waypoint.location nie jest string ani Place.
via
opcjonalne
Typ: boolean optional
Oznacza ten punkt orientacyjny jako kamień milowy, a nie punkt zatrzymania. W przypadku każdego punktu pośredniego, który nie jest via, w ComputeRoutesRequest Route.computeRoutes dołącza wpis do tablicy Route.legs, aby podać szczegóły postojów na danym etapie podróży.

Ustaw tę wartość na true, jeśli chcesz, aby trasa przebiegała przez ten punkt pośredni bez zatrzymywania się. Punkty pośrednie nie powodują dodania wpisu do tablicy Route.legs, ale wyznaczają trasę przez dany punkt.

Uwagi:
  • Tę wartość możesz ustawić tylko w przypadku punktów pośrednich. Jeśli ustawisz to pole w punktach końcowych, żądanie się nie powiedzie.
  • Jeśli pole ComputeRoutesRequest.optimizeWaypointOrder ma wartość true, to pole nie może mieć wartości „true”. W przeciwnym razie żądanie się nie powiedzie.

Interfejs WaypointMarkerDetails

interfejs google.maps.routes.WaypointMarkerDetails

Szczegóły dotyczące punktu pośredniego, które można wykorzystać do dostosowania stylu znacznika.

index
Typ: number
Indeks znacznika.
totalMarkers
Typ: number
Łączna liczba znaczników na trasie.
leg
opcjonalne
Typ: RouteLeg optional
Odcinek, do którego należy znacznik. Jeśli trasa nie ma etapów, pole jest puste.