Klasa RouteService
google.maps.DirectionsService
klasa
Usługa służąca do obliczania trasy między co najmniej 2 miejscami.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {DirectionsService} = await google.map.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
DirectionsService |
DirectionsService() Parametry: brak
Tworzy nowe wystąpienie elementu DirectionsService , które wysyła zapytania o trasy do serwerów Google. |
Metody | |
---|---|
route |
route(request[, callback]) Parametry:
Zwrócona wartość:
Promise<DirectionsResult> Wyślij zapytanie o wskazówki dojazdu. |
Interfejs RouteRequest
google.maps.DirectionsRequest
interfejs
Zapytanie o trasę będzie wysyłane na adres DirectionsService
.
Usługi | |
---|---|
destination |
Typ:
string|LatLng|Place|LatLngLiteral Lokalizacja miejsca docelowego. Można go podać w postaci ciągu do geokodowania, LatLng lub Place . Wymagany. |
origin |
Typ:
string|LatLng|Place|LatLngLiteral Lokalizacja punktu początkowego. Można go podać w postaci ciągu do geokodowania, LatLng lub Place . Wymagany. |
travelMode |
Typ:
TravelMode Żądany typ routingu. Wymagany. |
avoidFerries optional |
Typ:
boolean optional Jeśli true , w miarę możliwości unika usługi promów, jeśli to możliwe. Opcjonalne. |
avoidHighways optional |
Typ:
boolean optional Jeśli true , w miarę możliwości unika usługi autostrad, gdy wskaże trasę. Opcjonalne. |
avoidTolls optional |
Typ:
boolean optional Jeśli true , w miarę możliwości unika usługi płatnej. Opcjonalne. |
drivingOptions optional |
Typ:
DrivingOptions optional Ustawienia stosowane tylko do żądań, w których travelMode to DRIVING . Nie będzie to miało wpływu na inne środki transportu. |
language optional |
Typ:
string optional Identyfikator języka, w którym jest zwracany wynik (jeśli to możliwe). Zobacz listę obsługiwanych języków. |
optimizeWaypoints optional |
Typ:
boolean optional Jeśli zasada ma wartość true , DirectionsService próbuje zmienić kolejność podanych punktów pośrednich, aby zminimalizować ogólny koszt trasy. Jeśli punkty trasy są zoptymalizowane, sprawdź DirectionsRoute.waypoint_order w odpowiedzi, aby określić nową kolejność. |
provideRouteAlternatives optional |
Typ:
boolean optional Określa, czy należy podać alternatywne trasy. Opcjonalne. |
region optional |
Typ:
string optional Kod regionu używany jako odchylenie w żądaniach geokodowania. Kod regionu może mieć wartość 2-znakową ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład ccTLD Wielkiej Brytanii to „uk” ( .co.uk ), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Wielka Brytania i Irlandia Północna”). |
transitOptions optional |
Typ:
TransitOptions optional Ustawienia stosowane tylko do żądań, w przypadku których travelMode to TRANSPORT. Nie będzie to miało wpływu na inne środki transportu. |
unitSystem optional |
Typ:
UnitSystem optional Domyślny – system jednostek używanych w kraju pochodzenia.
Preferowany system jednostek podczas wyświetlania odległości. |
waypoints optional |
Typ:
Array<DirectionsWaypoint> optional Tablica pośrednich punktów pośrednich. Wskazówki są obliczane od początku do miejsca docelowego przy użyciu każdego punktu na trasie. Informacje o maksymalnej liczbie punktów pośrednich znajdziesz w przewodniku dla programistów. Punkty pośrednie nie są obsługiwane w przypadku trasy dojazdu transportem publicznym. Opcjonalne. |
stałe kierunki
google.maps.DirectionsStatus
stałe
Stan zwrócony przez DirectionsService
po zakończeniu wywołania route()
. Określ je za pomocą wartości lub używając stałej wartości. na przykład 'OK'
lub google.maps.DirectionsStatus.OK
.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {DirectionsStatus} = await google.map.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
INVALID_REQUEST |
Podana wartość DirectionsRequest jest nieprawidłowa. |
MAX_WAYPOINTS_EXCEEDED |
W polu DirectionsRequest podano za dużo elementów DirectionsWaypoint . Informacje o maksymalnej liczbie punktów pośrednich znajdziesz w przewodniku dla programistów. |
NOT_FOUND |
Nie udało się przetworzyć danych geograficznych co najmniej jednego punktu początkowego, miejsca docelowego lub punktów pośrednich. |
OK |
Odpowiedź zawiera prawidłowy element DirectionsResult . |
OVER_QUERY_LIMIT |
Strona przekroczyła limit żądań w krótkim czasie. |
REQUEST_DENIED |
Strona internetowa nie może korzystać z usługi wskazówek dojazdu. |
UNKNOWN_ERROR |
Nie można przetworzyć żądania trasy z powodu błędu serwera. Jeśli spróbujesz ponownie, prośba może się nie powieść. |
ZERO_RESULTS |
Nie znaleziono trasy między miejscem początkowym a miejscem docelowym. |
Interfejs RouteResult
google.maps.DirectionsResult
interfejs
Odpowiedź dotycząca trasy została pobrana z serwera trasy. Możesz je renderować za pomocą DirectionsRenderer
lub przeanalizować ten obiekt i wyrenderować samodzielnie. Ostrzeżenia i prawa autorskie muszą wyświetlać się zgodnie z Warunkami korzystania z usługi Google Maps Platform. Zwróć uwagę, że ten wynik jest „podobnie do JSON”, ale nie jest tylko JSON, ponieważ pośrednio zawiera obiekty LatLng
.
Usługi | |
---|---|
routes |
Typ:
Array<DirectionsRoute> Tablica DirectionsRoute , z których każdy zawiera informacje o nogach i stopniach ich budowy. Będzie tylko 1 trasa, chyba że ustawiono DirectionsRequest z zasadą provideRouteAlternatives ustawioną na true . |
available_travel_modes optional |
Typ:
Array<TravelMode> optional Zawiera szereg dostępnych środków transportu. To pole jest zwracane, gdy żądanie określa tryb podróży i nie zwraca żadnych wyników. Tablica zawiera dostępne środki transportu w krajach z określonym zestawem punktów pośrednich. To pole nie jest zwracane, jeśli co najmniej 1 z punktów pośrednich zawiera „punkty pośrednie”. |
geocoded_waypoints optional |
Typ:
Array<DirectionsGeocodedWaypoint> optional Tablica DirectionsGeocodedWaypoint , z których każdy zawiera informacje o geokodowaniu pochodzenia, miejsca docelowego i punktów na drodze. |
Klasa RouteRenderer
google.maps.DirectionsRenderer
klasa
Renderowanie trasy uzyskanej z DirectionsService
.
Te zajęcia rozciągają się do MVCObject
.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {DirectionsRenderer} = await google.map.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) Parametry:
Tworzy mechanizm renderowania z podanymi opcjami. Trasa dojazdu może być wyświetlana na mapie (w postaci nakładek wizualnych) lub dodatkowo na panelu <div> (jako instrukcje tekstowe). |
Metody | |
---|---|
getDirections |
getDirections() Parametry: brak
Zwrócona wartość:
DirectionsResult Zwraca bieżący zestaw wskazówek renderowania. |
getMap |
getMap() Parametry: brak
Zwrócona wartość:
Map Zwraca mapę, na której jest renderowana właściwość DirectionsResult . |
getPanel |
getPanel() Parametry: brak
Zwrócona wartość:
HTMLElement|null Zwraca panel <div> , w którym jest renderowana właściwość DirectionsResult . |
getRouteIndex |
getRouteIndex() Parametry: brak
Zwrócona wartość:
number Zwraca indeks bieżącej trasy (oparty o zero) używany przez ten obiekt DirectionsRenderer . |
setDirections |
setDirections(directions) Parametry:
Zwróć wartość: brak
Ustaw mechanizm renderowania, aby użyć wyniku z elementu DirectionsService . Takie ustawienie wskazówek dojazdu spowoduje wyświetlenie ich na specjalnej mapie i w panelu użytkownika. |
setMap |
setMap(map) Parametry:
Zwróć wartość: brak
Ta metoda określa mapę, na której będą renderowane trasy. Aby usunąć trasę z mapy, przejedź null . |
setOptions |
setOptions(options) Parametry:
Zwróć wartość: brak
Zmień ustawienia opcji tego urządzenia DirectionsRenderer po jego zainicjowaniu. |
setPanel |
setPanel(panel) Parametry:
Zwróć wartość: brak
Ta metoda renderuje trasę w interfejsie <div> . Aby usunąć treść z panelu, naciśnij null . |
setRouteIndex |
setRouteIndex(routeIndex) Parametry:
Zwróć wartość: brak
Ustaw indeks trasy (oparty na zero) w obiekcie DirectionsResult do renderowania. Domyślnie renderowana jest pierwsza trasa w tablicy. |
Dziedziczone:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Zdarzenia | |
---|---|
directions_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane, gdy zmieni się wyrenderowana trasa – gdy zostanie ustawiony nowy element DirectionsResult lub użytkownik zakończy przeciąganie zmiany na ścieżce dojazdu. |
Interfejs RouteRendererOptions
google.maps.DirectionsRendererOptions
interfejs
Ten obiekt określa właściwości, które można ustawić w obiekcie DirectionsRenderer
.
Usługi | |
---|---|
directions optional |
Typ:
DirectionsResult optional Trasa dojazdu do wyświetlenia na mapie lub w panelu <div> została pobrana jako obiekt DirectionsResult z DirectionsService . |
draggable optional |
Typ:
boolean optional Jeśli zasada true , umożliwia użytkownikowi przeciąganie i modyfikowanie ścieżek wyrenderowanych przez ten DirectionsRenderer . |
hideRouteList optional |
Typ:
boolean optional Domyślne:
false Ta właściwość wskazuje, czy mechanizm renderowania powinien wyświetlać listę wybieranych przez użytkownika tras w panelu trasy. |
infoWindow optional |
Typ:
InfoWindow optional InfoWindow , w którym jest renderowane informacje tekstowe po kliknięciu znacznika. Obecna zawartość okna informacyjnego zostanie zastąpiona, a jej pozycja przeniesiona. Jeśli nie określisz okna informacyjnego, DirectionsRenderer utworzy własne okno informacyjne i będzie je używać. Jeśli właściwość suppressInfoWindows jest ustawiona na true , ta właściwość będzie ignorowana. |
map optional |
Typ:
Map optional Mapa, na której chcesz wyświetlić trasę. |
markerOptions optional |
Typ:
MarkerOptions optional Opcje znaczników. Z tych opcji będą korzystać wszystkie znaczniki renderowane przez DirectionsRenderer . |
panel optional |
Typ:
HTMLElement optional <div> , w którym mają być wyświetlane wskazówki dojazdu. |
polylineOptions optional |
Typ:
PolylineOptions optional Opcje linii łamanych. Wszystkie linie łamane renderowane przez DirectionsRenderer będą wykorzystywać te opcje. |
preserveViewport optional |
Typ:
boolean optional Domyślne:
false Jeśli ta opcja ma wartość true lub środek i powiększenie mapy nie zostały nigdy ustawione, mapa wejściowa jest wyśrodkowana i powiększona do ramki ograniczającej ten zestaw wskazówek. |
routeIndex optional |
Typ:
number optional Indeks trasy w obiekcie DirectionsResult . Wartość domyślna to 0. |
suppressBicyclingLayer optional |
Typ:
boolean optional Pomijaj renderowanie BicyclingLayer , gdy wymagane są wskazówki dojazdu rowerem. |
suppressInfoWindows optional |
Typ:
boolean optional Pomijaj renderowanie okien informacyjnych. |
suppressMarkers optional |
Typ:
boolean optional Pomijaj renderowanie znaczników. |
suppressPolylines optional |
Typ:
boolean optional Blokuj renderowanie linii łamanych. |
Interfejs TrasaWaypoint
google.maps.DirectionsWaypoint
interfejs
DirectionsWaypoint
reprezentuje lokalizację między miejscem wylotu a miejscem docelowym, przez który powinna być kierowana podróż.
Usługi | |
---|---|
location optional |
Typ:
string|LatLng|LatLngLiteral|Place optional Lokalizacja punktu pośredniego. Może to być ciąg adresu, LatLng lub Place . Opcjonalne. |
stopover optional |
Typ:
boolean optional Domyślne:
true Jeśli true , oznacza, że ten punkt pośredni jest przystankiem między punktem początkowym i docelowym. W ten sposób trasa może zostać podzielona na 2 nogi. Jeśli false , wskazuje, że odchylenie trasy ma być poprzedzane przez ten punkt na drodze, ale nie przez podzielone na 2 nogi. Jest to przydatne, gdy chcesz utworzyć trasę w odpowiedzi na przeciąganie punktów na mapie. |
Interfejs RouteGeocodedWaypoint
google.maps.DirectionsGeocodedWaypoint
interfejs
Pojedynczy geokodowany punkt na trasie.
Usługi | |
---|---|
partial_match optional |
Typ:
boolean optional Czy geokoder nie zwrócił dokładnego dopasowania do punktu początkowego, mimo że mógł dopasować część żądanego adresu. |
place_id optional |
Typ:
string optional Identyfikator miejsca powiązany z punktem pośrednim. Identyfikatory miejsc jednoznacznie identyfikują miejsca w bazie danych Miejsc Google i w Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów korzystających z interfejsu Places API. |
types optional |
Typ:
Array<string> optional Tablica ciągów znaków określających typ zwracanego elementu kodującego. Listę możliwych ciągów tekstowych znajdziesz w przewodniku dla programistów w sekcji Typy komponentów adresu. |
Interfejs RouteRoute
google.maps.DirectionsRoute
interfejs
Pojedyncza trasa zawierająca zestaw nóg w DirectionsResult
. Pamiętaj, że chociaż ten obiekt jest „podobny do JSON”, nie jest ścisły, ponieważ zawiera bezpośrednio i pośrednio obiekty LatLng
.
Usługi | |
---|---|
bounds |
Typ:
LatLngBounds Granice tej trasy. |
copyrights |
Typ:
string Tekst dotyczący praw autorskich, który ma być wyświetlany na tej trasie. |
legs |
Typ:
Array<DirectionsLeg> Tablica DirectionsLeg , z których każdy zawiera informacje o kolejnych krokach. Będzie jeden etap na każdy punkt pośredni lub miejsce docelowe. Trasa bez punktów pośrednich będzie zawierać 1 obiekt DirectionsLeg , a trasa z 1 punktem pośrednim – 2. |
overview_path |
Tablica LatLng z całą trasą tej trasy. Ścieżka została uproszczona, aby była odpowiednia w kontekście, w których wymagana jest niewielka liczba wierzchołków (np. w przypadku adresów URL interfejsu Static Maps API). |
overview_polyline |
Typ:
string Zakodowana linia łamana w trasie. Ta linia łamana jest przybliżoną (wygładzoną) ścieżką wyznaczonych tras. |
summary |
Typ:
string Zawiera krótki opis tekstowy trasy, nadając jej nazwę i oddzielając ją od alternatywnych. |
warnings |
Typ:
Array<string> Ostrzeżenia wyświetlane podczas wyświetlania tych wskazówek. |
waypoint_order |
Typ:
Array<number> Jeśli optimizeWaypoints ma wartość true , to pole będzie zawierać zmienioną kolejność punktów wejściowych. Jeśli na przykład dane wejściowe:Origin: Los Angeles Waypoints: Dallas, Bangor, Phoenix Miejsce docelowe: Nowy Jork , a zoptymalizowane dane wyjściowe są uporządkowane w ten sposób: Origin: Los Angeles Waypoints: Phoenix, Dallas, Bangor Miejsce docelowe: Nowy Jork , to pole będzie 1] i będzie zawierać [, 0, Array . Pamiętaj, że numeracja punktów pośrednich jest oparta na wartości zero.Jeśli którykolwiek z punktów wejścia ma wartość stopover ustawioną na false , to pole będzie puste, ponieważ optymalizacja trasy nie jest dostępna dla takich zapytań. |
fare optional |
Typ:
TransitFare optional Łączna cena za całą podróż środkami transportu publicznego. Dotyczy tylko żądań o transport publiczny. |
RouteLeg Interfejs
google.maps.DirectionsLeg
interfejs
Pojedyncza noga składająca się z zestawu kroków w DirectionsResult
. Niektóre pola w nodze mogą nie zostać zwrócone w przypadku wszystkich żądań. Zwróć uwagę, że ten wynik jest „podobnie do JSON”, ale nie jest tylko JSON, ponieważ zawiera bezpośrednio i pośrednio obiekty LatLng
.
Usługi | |
---|---|
end_address |
Typ:
string Adres miejsca docelowego tego kroku. Ta treść jest przeznaczona do odczytu bez zmian. Nie przetwarzaj automatycznie sformatowanego adresu. |
end_location |
Typ:
LatLng DirectionsService oblicza trasę między lokalizacjami, korzystając z najbliższej opcji transportu (zwykle drogi) w lokalizacji początkowej i końcowej. end_location wskazuje rzeczywiste miejsce geograficzne, które może być inne niż end_location ostatniego kroku, jeśli np. droga znajduje się w pobliżu miejsca docelowego tego kroku. |
start_address |
Typ:
string Adres punktu początkowego tego nogi. Ta treść jest przeznaczona do odczytu bez zmian. Nie przetwarzaj automatycznie sformatowanego adresu. |
start_location |
Typ:
LatLng DirectionsService oblicza trasę między lokalizacjami, korzystając z najbliższej opcji transportu (zwykle drogi) w lokalizacji początkowej i końcowej. start_location wskazuje rzeczywiste pochodzenie geograficzne, które może być inne niż start_location pierwszego kroku, jeśli np. droga nie znajduje się blisko punktu początkowego tego kroku. |
steps |
Typ:
Array<DirectionsStep> Tablica DirectionsStep , z których każdy zawiera informacje o poszczególnych krokach w tym kroku. |
|
Typ:
Array<?> Informacje o prędkości ruchu drogowego na nodze. |
via_waypoints |
Tablica punktów pośrednich na tym etapie, które zostały określone w pierwotnym żądaniu. Wycofane w innych trasach Wersja 3.27 to ostatnia wersja interfejsu API, która dodaje dodatkowe Jeśli korzystasz z usługi Trasa dojazdu do implementacji funkcji przeciągania, zalecamy wyłączenie alternatywnej trasy. Możesz przeciągać tylko trasę główną. Użytkownicy mogą przeciągać trasę główną, która pasuje do trasy alternatywnej. |
arrival_time optional |
Typ:
Time optional Szacowany czas przybycia na ten etap. Dotyczy tylko żądań TRANSIT. |
departure_time optional |
Typ:
Time optional Szacowany czas odjazdu tego kroku. Dotyczy tylko żądań TRANSIT. |
distance optional |
Typ:
Distance optional Całkowita odległość pokonana w przypadku tego nogi. Ta właściwość może być nieokreślona, ponieważ odległość może być nieznana. |
duration optional |
Typ:
Duration optional Całkowity czas trwania tego kroku. Może to być undefined , bo czas trwania może być nieznany. |
duration_in_traffic optional |
Typ:
Duration optional Łączny czas trwania tego kroku z uwzględnieniem warunków drogowych określonych przez właściwość trafficModel . Może to być undefined , bo czas trwania może być nieznany. |
Wskazówki dojazdu interfejs
google.maps.DirectionsStep
interfejs
Pojedyncza DirectionsStep
w DirectionsResult
. Niektóre pola to undefined
. Pamiętaj, że chociaż ten obiekt jest w formacie JSON, nie jest dokładny, ponieważ zawiera bezpośrednio obiekty LatLng
.
Usługi | |
---|---|
encoded_lat_lngs |
Typ:
string Zakodowana linia łamana kroku. To przybliżona (wygładzona) ścieżka kroku. |
end_location |
Typ:
LatLng Lokalizacja końcowa tego kroku. |
|
Typ:
LatLng Lokalizacja końcowa tego kroku. |
instructions |
Typ:
string Instrukcje. |
|
Sekwencja LatLng opisująca przebieg tego kroku. To przybliżona (wygładzona) ścieżka kroku. |
maneuver |
Typ:
string Zawiera działania, które mają zostać wykonane w bieżącym kroku ( turn-left , merge , straight itd.). Wartości mogą się zmieniać, a nowe wartości można wprowadzać bez wcześniejszego powiadomienia. |
path |
Sekwencja LatLng opisująca przebieg tego kroku. To przybliżona (wygładzona) ścieżka kroku. |
start_location |
Typ:
LatLng Lokalizacja początkowa tego kroku. |
|
Typ:
LatLng Lokalizacja początkowa tego kroku. |
travel_mode |
Typ:
TravelMode Tryb podróżowania używany w tym kroku. |
distance optional |
Typ:
Distance optional Dystans pokonany w tym kroku. Może to być undefined , bo odległość może być nieznana. |
duration optional |
Typ:
Duration optional Typowy czas potrzebny na wykonanie tego kroku w sekundach i w postaci tekstowej. Może to być undefined , bo czas trwania może być nieznany. |
|
Typ:
DirectionsPolyline optional Zawiera obiekt z jedną właściwością „points” (punkty), która przechowuje zakodowaną linię łamaną dla danego kroku. Ta linia łamana to przybliżona (wygładzona) ścieżka kroku. |
steps optional |
Typ:
Array<DirectionsStep> optional Kroki podrzędne tego kroku. Przeznaczony dla niepublicznych tras transportu publicznego. |
transit optional |
Typ:
TransitDetails optional Szczegóły tego kroku dotyczące poszczególnych środków transportu. Ta właściwość będzie nieokreślona, chyba że tryb podróży tego kroku to TRANSIT . |
transit_details optional |
Typ:
TransitDetails optional Szczegóły dotyczące tego kroku, jeśli tryb podróży to TRANSIT . |
Interfejs RoutePolyline
google.maps.DirectionsPolyline
interfejs
Obiekt zawierający właściwość points
opisujące łamaną DirectionsStep
.
Usługi | |
---|---|
points |
Typ:
string |
Miejsce interfejsu
google.maps.Place
interfejs
Zawiera informacje potrzebne do zlokalizowania, zidentyfikowania lub omówienia miejsca w polu DirectionsRequest
lub DistanceMatrixRequest
. W tym kontekście „miejsce” oznacza firmę, ciekawe miejsce lub lokalizację geograficzną. Aby dowiedzieć się więcej o pobieraniu informacji o miejscu, przeczytaj artykuł PlacesService
.
Usługi | |
---|---|
location optional |
Typ:
LatLng|LatLngLiteral optional LatLng elementu opisanego przez to miejsce. |
placeId optional |
Typ:
string optional Identyfikator miejsca (np. firma lub ciekawe miejsce). Identyfikator miejsca to unikalny identyfikator miejsca w bazie danych Map Google. placeId to najdokładniejszy sposób identyfikowania miejsca. Jeśli to możliwe, określ placeId , a nie query . Identyfikator miejsca można pobierać z dowolnego żądania do interfejsu Places API, takiego jak TextSearch. Identyfikatory miejsc można też pobierać z żądań do interfejsu Geocoding API. Więcej informacji znajdziesz w omówieniu identyfikatorów miejsc. |
query optional |
Typ:
string optional Zapytanie opisujące miejsce (np. firmę lub ciekawe miejsce). Przykładowe zapytanie to „Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW”. Jeśli to możliwe, określ placeId , a nie query . Interfejs API nie gwarantuje dokładności rozpoznawania ciągu zapytania w określonym miejscu. Jeśli podana jest zarówno wartość placeId , jak i query , występuje błąd. |
stałe TravelMode
google.maps.TravelMode
stałe
Prawidłowe środki transportu, które można określić w DirectionsRequest
, a także tryby podróży zwrócone w DirectionsStep
. Określ je za pomocą wartości lub używając stałej wartości. na przykład 'BICYCLING'
lub google.maps.TravelMode.BICYCLING
.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {TravelMode} = await google.map.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
BICYCLING |
Określa żądanie wskazówek dojazdu rowerem. |
DRIVING |
Określa żądanie wskazówek dojazdu. |
TRANSIT |
Określa żądanie wskazówek dojazdu transportem publicznym. |
WALKING |
Określa żądanie trasy pieszej. |
Interfejs DriveOptions
google.maps.DrivingOptions
interfejs
Konfiguruje zasadę DirectionsRequest
, gdy środek transportu jest ustawiony na DRIVING
.
Usługi | |
---|---|
departureTime |
Typ:
Date Żądany czas odjazdu na trasie określony jako obiekt Date . Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 roku. Musisz określić to pole, aby element DrivingOptions był prawidłowy. Godzina wyjazdu musi być ustawiona na aktualną godzinę lub godzinę w przyszłości. Nie może przypadać w przeszłości. |
trafficModel optional |
Typ:
TrafficModel optional Preferowane założenie używane przy prognozowaniu czasu trwania ruchu. Wartość domyślna to BEST_GUESS . |
Stałe TrafficModel
google.maps.TrafficModel
stałe
Założenia używane przy prognozowaniu czasu trwania ruchu. Określany jako element DirectionsRequest
lub DistanceMatrixRequest
. Określ je za pomocą wartości lub używając stałej wartości. na przykład 'bestguess'
lub google.maps.TrafficModel.BEST_GUESS
.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {TrafficModel} = await google.map.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
BEST_GUESS |
Wykorzystaj historyczne dane o natężeniu ruchu, aby najlepiej oszacować czas spędzony w ruchu. |
OPTIMISTIC |
Wykorzystanie danych historycznych o ruchu do oszacowania, jak długo będzie trwać ruch. |
PESSIMISTIC |
Pełen pesymistyczny szacunek czasu trwania ruchu na podstawie historycznych danych o ruchu. |
Interfejs TransportOptions
google.maps.TransitOptions
interfejs
Obiekt TransportOptions, który ma być zawarty w elemencie DirectionsRequest
, gdy tryb podróży jest ustawiony na TRANSIT.
Usługi | |
---|---|
arrivalTime optional |
Typ:
Date optional Żądana godzina przyjazdu na trasie określona jako obiekt daty. Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 roku. Jeśli podasz godzinę przyjazdu, czas wyjazdu będzie ignorowany. |
departureTime optional |
Typ:
Date optional Żądany czas odjazdu na trasie określony jako obiekt daty. Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 roku. Jeśli nie podasz godziny wyjazdu ani czasu przyjazdu, przyjmuje się datę „teraz”. |
modes optional |
Typ:
Array<TransitMode> optional Jeden lub kilka preferowanych środków transportu, np. autobus lub pociąg. Jeśli nie ustawisz żadnej preferencji, interfejs API zwróci domyślną najlepszą trasę. |
routingPreference optional |
Typ:
TransitRoutePreference optional Ustawienie, które może wpływać na wybór trasy transportu publicznego, na przykład mniej chodzenia. Jeśli nie ustawisz żadnej preferencji, interfejs API zwróci domyślną najlepszą trasę. |
Stałe TransportMode
google.maps.TransitMode
stałe
Prawidłowy środek transportu, np. autobus, który można określić w TransitOptions
. Określ je za pomocą wartości lub używając stałej wartości. na przykład 'BUS'
lub google.maps.TransitMode.BUS
.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {TransitMode} = await google.map.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
BUS |
Określa autobusy jako preferowany środek transportu. |
RAIL |
Określa przejazd kolejowy jako preferowany środek transportu. |
SUBWAY |
Określa metro jako preferowany środek transportu. |
TRAIN |
Określa pociąg jako preferowany środek transportu. |
TRAM |
Określa tramwaj jako preferowany środek transportu. |
Stałe TransportRoute Preferred
google.maps.TransitRoutePreference
stałe
Prawidłowy typ trasy transportu publicznego, który można określić w TransitOptions
. Określ je za pomocą wartości lub używając stałej wartości. na przykład 'LESS_WALKING'
lub google.maps.TransitRoutePreference.LESS_WALKING
.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {TransitRoutePreference} = await google.map.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
FEWER_TRANSFERS |
Określa, że obliczona trasa powinna mieć ograniczoną liczbę transferów. |
LESS_WALKING |
Określa, że obliczona trasa powinna preferować ograniczoną liczbę spacerów. |
Interfejs TransportFare
google.maps.TransitFare
interfejs
Cena w postaci wartości DirectionsRoute
i waluty.
Usługi | |
---|---|
currency |
Typ:
string Kod waluty ISO 4217 wskazujący walutę, w której wyrażona jest cena. |
value |
Typ:
number Wartość liczbowa ceny wyrażona w podanego currency . |
Interfejs TransportDetails
google.maps.TransitDetails
interfejs
Szczegóły odjazdu, przyjazdu i środka transportu publicznego użytego w tym kroku.
Usługi | |
---|---|
arrival_stop |
Typ:
TransitStop Przyjazd na tym kroku transportu publicznego. |
arrival_time |
Typ:
Time Godzina przybycia tego kroku określona jako obiekt Time. |
departure_stop |
Typ:
TransitStop Przystanek odlotu tego kroku. |
departure_time |
Typ:
Time Czas wyjazdu tego kroku określony jako obiekt Time. |
headsign |
Typ:
string Kierunek, w którym należy przejechać tę linię, wybrany na pojeździe lub przy przystanku. |
headway |
Typ:
number Oczekiwana liczba sekund między równoważnymi pojazdami. |
line |
Typ:
TransitLine Szczegóły linii transportu publicznego użyte w tym kroku. |
num_stops |
Typ:
number Liczba przystanków na tym kroku. Obejmuje przystanek przylotu, ale nie przystanek docelowy. |
trip_short_name |
Typ:
string Tekst wyświetlany na rozkładach i tablicach rejestracyjnych, aby identyfikować pasażerów transportu publicznego, np. numery pociągów do pracy. Tekst ten jednoznacznie informuje o podróży danego dnia. |
TransportStop
google.maps.TransitStop
interfejs
Szczegóły przystanku lub stacji transportu publicznego.
Usługi | |
---|---|
location |
Typ:
LatLng Lokalizacja tego przystanku. |
name |
Typ:
string Nazwa tego przystanku transportu publicznego. |
Interfejs TransportLine
google.maps.TransitLine
interfejs
Informacje o linii transportu publicznego obsługującej ten etap.
Usługi | |
---|---|
agencies |
Typ:
Array<TransitAgency> Przewoźnik obsługujący tę linię. |
color |
Typ:
string Kolor powszechnie używany na szyldach transportu publicznego, podany w postaci szesnastkowej. |
icon |
Typ:
string Adres URL ikony powiązanej z danym wierszem. |
name |
Typ:
string Pełna nazwa tej linii transportu publicznego, np. „ul. Główna 8”. |
short_name |
Typ:
string Krótka nazwa tej linii transportu publicznego, np. „E”. |
text_color |
Typ:
string Kolor tekstu najczęściej używany w znakach tej linii transportu publicznego, podany w postaci szesnastkowej. |
url |
Typ:
string Adres URL przewoźnika wyznaczony dla tego wiersza transportu publicznego. |
vehicle |
Typ:
TransitVehicle Typ używanego pojazdu, np. pociąg lub autobus. |
Interfejs Transport Agency
google.maps.TransitAgency
interfejs
Informacje o przewoźnika, który obsługuje linie transportu publicznego.
Usługi | |
---|---|
name |
Typ:
string Nazwa tego przewoźnika. |
phone |
Typ:
string Numer telefonu przewoźnika. |
url |
Typ:
string Adres URL przewoźnika. |
Interfejs TransportVehicle
google.maps.TransitVehicle
interfejs
Informacje o pojeździe, który porusza się na linii transportu publicznego.
Usługi | |
---|---|
icon |
Typ:
string Adres URL ikony odpowiadającej typowi pojazdu używanej w tej linii. |
local_icon |
Typ:
string Adres URL ikony odpowiadającej typowi pojazdu używanemu w tym regionie zamiast bardziej ogólnej ikony. |
name |
Typ:
string Nazwa tego typu środków transportu publicznego, np. „Pociąg” lub „Autobus”. |
type |
Typ:
VehicleType Typ używanego pojazdu, np. pociąg, autobus lub prom. |
Stałe TypeType
google.maps.VehicleType
stałe
Możliwe wartości typów pojazdów.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {VehicleType} = await google.map.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
BUS |
Autobus. |
CABLE_CAR |
Pojazd korzystający z kabla, zwykle na ziemi. Kolejki linowe mogą mieć typ GONDOLA_LIFT . |
COMMUTER_TRAIN |
Kolej podmiejska. |
FERRY |
Prom. |
FUNICULAR |
Pojazd naciągnięty po stromym zboczu za pomocą kabla. |
GONDOLA_LIFT |
Kolejka linowa. |
HEAVY_RAIL |
Ciężarowa linia kolejowa. |
HIGH_SPEED_TRAIN |
Pociąg o dużej prędkości. |
INTERCITY_BUS |
Autobus dalekobieżny. |
METRO_RAIL |
Tramwaj |
MONORAIL |
Kolej jednoszynowa. |
OTHER |
Inne pojazdy. |
RAIL |
Pociąg. |
SHARE_TAXI |
Taksówka zbiorowa to rodzaj autobusu, który można zawieźć i odebrać pasażerów w dowolnym miejscu na trasie. Zwykle taksówka zbiorowa korzysta z pojazdów minibusów. |
SUBWAY |
Metro. |
TRAM |
Nad ziemią. |
TROLLEYBUS |
Trolejbus. |
stałe UnitSystem
google.maps.UnitSystem
stałe
Prawidłowe systemy jednostek, które można określić w DirectionsRequest
.
Jeśli używasz aplikacji v=beta
, możesz zadzwonić pod numer const {UnitSystem} = await google.map.importLibrary("core")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
IMPERIAL |
Określa, że dystans w parametrze DirectionsResult powinien być wyrażony w jednostkach imperialnych. |
METRIC |
Określa, że dystans w parametrze DirectionsResult powinien być wyrażony w jednostkach metrycznych. |
Odległość
google.maps.Distance
interfejs
Przedstawienie odległości jako wartość liczbowa i wyświetlany ciąg.
Usługi | |
---|---|
text |
Typ:
string Ciąg znaków reprezentujący dystans z zastosowaniem wartości UnitSystem określonej w żądaniu. |
value |
Typ:
number Odległość w metrach. |
Czas trwania
google.maps.Duration
interfejs
Przedstawienie czasu trwania jako wartości liczbowej i wyświetlanego ciągu znaków.
Usługi | |
---|---|
text |
Typ:
string Ciąg znaków reprezentujący czas trwania. |
value |
Typ:
number Czas trwania w sekundach. |
Interfejs Time
google.maps.Time
interfejs
Przedstawienie czasu jako obiektu daty, zlokalizowanego ciągu znaków i strefy czasowej.
Usługi | |
---|---|
text |
Typ:
string Ciąg znaków reprezentujący wartość czasu. Czas jest wyświetlany w strefie czasowej przystanku. |
time_zone |
Typ:
string Strefa czasowa, w której znajduje się przystanek. Wartość to nazwa strefy czasowej określona w bazie danych stref czasowych IANA, np. „Ameryka/Nowy_Jork”. |
value |
Typ:
Date Czas odjazdu lub przyjazdu określony za pomocą obiektu JavaScript Date. |
Stałe RouteTravelMode
google.maps.DirectionsTravelMode
stałe
stałe RouteUnitSystem
google.maps.DirectionsUnitSystem
stałe