DirectionsService class
google.maps.DirectionsService
class
Usługa obliczania trasy między co najmniej 2 miejscami.
Dostęp przez połączenie telefoniczne const {DirectionsService} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
---|---|
DirectionsService |
DirectionsService() Parametry: brak
Tworzy nową instancję DirectionsService , która wysyła zapytania o trasy do serwerów Google. |
Metody | |
---|---|
route |
route(request[, callback]) Parametry:
Wartość zwracana:
Promise<DirectionsResult> Prześlij prośbę o wyświetlenie trasy. |
Interfejs DirectionsRequest
google.maps.DirectionsRequest
interfejs
Zapytanie o trasę wysłane do DirectionsService
.
Właściwości | |
---|---|
destination |
Typ:
string|LatLng|Place|LatLngLiteral Lokalizacja miejsca docelowego. Możesz podać ciąg tekstowy do geokodowania, wartość LatLng lub wartość Place . Wymagane. |
origin |
Typ:
string|LatLng|Place|LatLngLiteral Miejsce pochodzenia. Możesz podać ciąg tekstowy do geokodowania, wartość LatLng lub wartość Place . Wymagane. |
travelMode |
Typ:
TravelMode Typ routingu. Wymagane. |
avoidFerries optional |
Typ:
boolean optional Jeśli true , usługa Wskazówki dojazdu ma omijać promy, jeśli to możliwe. Opcjonalnie: |
avoidHighways optional |
Typ:
boolean optional Jeśli true , usługa Wskazówki dojazdu ma omijać autostrady, o ile to możliwe. Opcjonalnie: |
avoidTolls optional |
Typ:
boolean optional Jeśli true , usługa Wyznaczanie trasy ma unikać dróg płatnych, o ile to możliwe. Opcjonalnie: |
drivingOptions optional |
Typ:
DrivingOptions optional Ustawienia, które mają zastosowanie tylko do żądań, w których travelMode to DRIVING . Ten obiekt nie będzie miał wpływu na inne tryby podróży. |
language optional |
Typ:
string optional Identyfikator języka, w którym mają być zwracane wyniki (jeśli to możliwe). Zobacz listę obsługiwanych języków. |
optimizeWaypoints optional |
Typ:
boolean optional Jeśli parametr ma wartość true , DirectionsService spróbuje zmienić kolejność podanych punktów pośrednich, aby zminimalizować ogólny koszt trasy. Jeśli punkty pośrednie są optymalizowane, sprawdź element DirectionsRoute.waypoint_order w odpowiedzi, aby określić nową kolejność. |
provideRouteAlternatives optional |
Typ:
boolean optional Określa, czy należy podać alternatywne trasy. Opcjonalnie: |
region optional |
Typ:
string optional Kod regionu używany jako preferencja w przypadku żądań geokodowania. Kod regionu może mieć 2-znakową wartość domeny krajowej 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 jej kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”). |
transitOptions optional |
Typ:
TransitOptions optional Ustawienia, które mają zastosowanie tylko do żądań, w których travelMode to TRANSIT. Ten obiekt nie będzie miał wpływu na inne tryby podróży. |
unitSystem optional |
Typ:
UnitSystem optional Domyślnie: system jednostek stosowany w kraju pochodzenia.
Preferowany układ jednostek do wyświetlania odległości. |
waypoints optional |
Typ:
Array<DirectionsWaypoint> optional Tablica punktów pośrednich. Droga jest obliczana od punktu początkowego do punktu docelowego przez każdy punkt pośredni w tym tablicy. Maksymalną liczbę punktów pośrednich znajdziesz w przewodniku dla programistów. Punkty pośrednie nie są obsługiwane w przypadku wskazówek dojazdu transportem publicznym. Opcjonalnie: |
stałe DirectionsStatus
google.maps.DirectionsStatus
stałe
Stan zwrócony przez DirectionsService
po zakończeniu wywołania route()
. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'OK'
lub google.maps.DirectionsStatus.OK
.
Dostęp przez połączenie telefoniczne const {DirectionsStatus} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
INVALID_REQUEST |
Podany DirectionsRequest jest nieprawidłowy. |
MAX_WAYPOINTS_EXCEEDED |
W pliku DirectionsRequest podano zbyt wiele DirectionsWaypoint . Maksymalną liczbę punktów pośrednich znajdziesz w przewodniku dla programistów. |
NOT_FOUND |
Nie udało się zgeokodować co najmniej jednego punktu początkowego, docelowego lub pośredniego. |
OK |
Odpowiedź zawiera prawidłowy DirectionsResult . |
OVER_QUERY_LIMIT |
Strona przekroczyła limit żądań w zbyt krótkim czasie. |
REQUEST_DENIED |
Strona internetowa nie może korzystać z usługi wskazówek. |
UNKNOWN_ERROR |
Nie udało się zrealizować żądania trasy z powodu błędu serwera. Jeśli spróbujesz ponownie, żądanie może się powieść. |
ZERO_RESULTS |
Nie udało się znaleźć trasy między miejscem wylotu a miejscem docelowym. |
Interfejs DirectionsResult
google.maps.DirectionsResult
interfejs
Odpowiedź na żądanie dotyczące wskazówek, pobrana z serwera wskazówek. Możesz je renderować za pomocą DirectionsRenderer
lub zanalizować i samodzielnie wyrenderować. Musisz wyświetlać ostrzeżenia i prawa autorskie zgodnie z Warunkami korzystania z usługi Google Maps Platform. Pamiętaj, że chociaż ten wynik jest „podobny do JSON”, nie jest to ściśle format JSON, ponieważ pośrednio zawiera obiekty LatLng
.
Właściwości | |
---|---|
request |
Typ:
DirectionsRequest Żądanie DirectionsRequest, które zwróciło ten wynik. |
routes |
Typ:
Array<DirectionsRoute> Tablica elementów DirectionsRoute , z których każdy zawiera informacje o elementach i krokach, z których się składa. Będzie tylko jedna trasa, chyba że DirectionsRequest została utworzona z ustawieniem provideRouteAlternatives true . |
available_travel_modes optional |
Typ:
Array<TravelMode> optional Zawiera listę dostępnych trybów podróży. To pole jest zwracane, gdy żądanie określa tryb podróży i nie daje żadnych wyników. Tablica zawiera dostępne środki transportu w krajach, w których znajduje się dany zestaw punktów pośrednich. To pole nie jest zwracane, jeśli co najmniej 1 punkt pośredni to „punkt pośredni”. |
geocoded_waypoints optional |
Typ:
Array<DirectionsGeocodedWaypoint> optional Tablica DirectionsGeocodedWaypoint , z której każda zawiera informacje o geokodowaniu punktu początkowego, docelowego i punktów pośrednich. |
Klasa DirectionsRenderer
google.maps.DirectionsRenderer
class
Wyświetla wskazówki dojazdu uzyskane z DirectionsService
.
Te zajęcia trwają MVCObject
.
Dostęp przez połączenie telefoniczne const {DirectionsRenderer} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) Parametry:
Tworzy mechanizm renderowania z podanymi opcjami. Wskazówki dojazdu mogą być renderowane na mapie (jako nakładki wizualne) lub dodatkowo w panelu <div> (jako instrukcje tekstowe). |
Metody | |
---|---|
getDirections |
getDirections() Parametry: brak
Wartość zwracana:
DirectionsResult Zwraca bieżący zestaw kierunków dla renderowania. |
getMap |
getMap() Parametry: brak
Wartość zwracana:
Map Zwraca mapę, na której renderowany jest element DirectionsResult . |
getPanel |
getPanel() Parametry: brak
Wartość zwracana:
HTMLElement|null Zwraca panel <div> , w którym renderowany jest element DirectionsResult . |
getRouteIndex |
getRouteIndex() Parametry: brak
Wartość zwracana:
number Zwraca bieżący (liczony od 0) indeks trasy używany przez ten obiekt DirectionsRenderer . |
setDirections |
setDirections(directions) Parametry:
Zwracana wartość: brak
Ustaw renderowanie tak, aby używać wyniku z DirectionsService . Ustawienie w ten sposób prawidłowego zestawu wskazówek spowoduje wyświetlenie wskazówek na mapie i w panelu renderowania. |
setMap |
setMap(map) Parametry:
Zwracana wartość: brak
Ta metoda określa mapę, na której będą renderowane wskazówki. Kliknij null , aby usunąć trasę z mapy. |
setOptions |
setOptions(options) Parametry:
Zwracana wartość: brak
Zmiana ustawień opcji tego DirectionsRenderer po inicjalizacji. |
setPanel |
setPanel(panel) Parametry:
Zwracana wartość: brak
Ta metoda renderuje wskazówki w <div> . Kliknij null , aby usunąć treści z panelu. |
setRouteIndex |
setRouteIndex(routeIndex) Parametry:
Zwracana wartość: brak
Ustaw indeks (od 0) trasy w obiekcie DirectionsResult , który ma zostać wyrenderowany. Domyślnie renderowana jest pierwsza trasa w tablicy. |
Uzyskane:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Wydarzenia | |
---|---|
directions_changed |
function() Argumenty: brak.
To zdarzenie jest wywoływane, gdy zmieniają się wyrenderowane wskazówki. Dzieje się to, gdy ustawiana jest nowa wartość DirectionsResult lub gdy użytkownik skończy przeciąganie zmiany na ścieżce wskazówek. |
Interfejs DirectionsRendererOptions
google.maps.DirectionsRendererOptions
interfejs
Ten obiekt definiuje właściwości, które można ustawić w obiekcie DirectionsRenderer
.
Właściwości | |
---|---|
directions optional |
Typ:
DirectionsResult optional wskazówki do wyświetlenia na mapie lub w panelu <div> , pobrane jako obiekt DirectionsResult z elementu DirectionsService . |
draggable optional |
Typ:
boolean optional Jeśli true , użytkownik może przeciągać i modyfikować ścieżki tras renderowanych przez ten DirectionsRenderer . |
hideRouteList optional |
Typ:
boolean optional Domyślnie:
false Ta właściwość wskazuje, czy renderowanie ma wyświetlać listę tras do wyboru przez użytkownika w panelu wskazówek. |
infoWindow optional |
Typ:
InfoWindow optional InfoWindow , w którym mają być renderowane informacje tekstowe po kliknięciu znacznika. Treść dotychczasowego okna z informacjami zostanie zastąpiona, a jego pozycja zostanie zmieniona. Jeśli nie określisz okna informacji, DirectionsRenderer utworzy i użyje własnego okna informacji. Ta właściwość zostanie zignorowana, jeśli element suppressInfoWindows ma wartość true . |
map optional |
Typ:
Map optional Mapa, na której mają być wyświetlane wskazówki. |
markerOptions optional |
Typ:
MarkerOptions optional Opcje znaczników. Wszystkie znaczniki renderowane przez DirectionsRenderer będą używać tych opcji. |
panel optional |
Typ:
HTMLElement optional <div> , w którym mają być wyświetlane wskazówki. |
polylineOptions optional |
Typ:
PolylineOptions optional Opcje wielokątów. Wszystkie linie złożone renderowane przez DirectionsRenderer będą używać tych opcji. |
preserveViewport optional |
Typ:
boolean optional Domyślnie:
false Jeśli ta opcja ma wartość true lub jeśli centrum i powiększenie mapy nie zostały nigdy ustawione, mapa wejściowa jest wyśrodkowana i powiększona do pudełka ograniczającego tego zestawu wskazówek. |
routeIndex optional |
Typ:
number optional Indeks trasy w obiekcie DirectionsResult . Wartością domyślną jest 0. |
suppressBicyclingLayer optional |
Typ:
boolean optional Wyłącz renderowanie BicyclingLayer , gdy użytkownik poprosi o wskazówki dojazdu rowerem. |
suppressInfoWindows optional |
Typ:
boolean optional Zablokuj renderowanie okien z informacjami. |
suppressMarkers optional |
Typ:
boolean optional Wyłącz renderowanie znaczników. |
suppressPolylines optional |
Typ:
boolean optional Zablokuj renderowanie linii złożonych. |
Interfejs DirectionsWaypoint
google.maps.DirectionsWaypoint
interfejs
DirectionsWaypoint
reprezentuje lokalizację między miejscem wylotu a miejscem docelowym, przez którą powinna przebiegać trasa.
Właściwości | |
---|---|
location optional |
Typ:
string|LatLng|LatLngLiteral|Place optional Lokalizacja punktu na trasie. Może to być ciąg adresu, wartość LatLng lub Place . Opcjonalnie: |
stopover optional |
Typ:
boolean optional Domyślnie:
true Jeśli true , wskazuje, że ten punkt drogi jest przystankiem między miejscem początkowym a miejscem docelowym. W efekcie trasa zostanie podzielona na 2 części. Jeśli false , wskazuje, że trasa powinna być poprowadzona przez ten punkt orientacyjny, ale nie podzielona na 2 części. Jest to przydatne, gdy chcesz utworzyć trasę w odpowiedzi na przeciąganie przez użytkownika punktów na mapie. |
Interfejs DirectionsGeocodedWaypoint
google.maps.DirectionsGeocodedWaypoint
interfejs
Pojedynczy punkt docelowy z geokodowaniem.
Właściwości | |
---|---|
partial_match optional |
Typ:
boolean optional Czy geokoder nie zwrócił dokładnego dopasowania do pierwotnego punktu orientacyjnego, ale udało się dopasować część żądanego adresu. |
place_id optional |
Typ:
string optional Identyfikator miejsca powiązany z punktem kontrolnym. Identyfikatory miejsc jednoznacznie identyfikują miejsce w bazie danych Miejsc Google i w Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz w Przewodniku dla deweloperów interfejsu Places API. |
types optional |
Typ:
Array<string> optional Tablica ciągów znaków oznaczająca typ zwróconego elementu z dane geokodowane. Listę możliwych ciągów znaków znajdziesz w sekcji Typy elementów adresu w Przewodniku dla programistów. |
Interfejs DirectionsRoute
google.maps.DirectionsRoute
interfejs
Pojedyncza trasa zawierająca zestaw etapów w DirectionsResult
. Pamiętaj, że chociaż ten obiekt jest „podobny do JSON”, nie jest to ściśle JSON, ponieważ zawiera bezpośrednio i pośrednio obiekty LatLng
.
Właściwości | |
---|---|
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órej każda pozycja zawiera informacje o krokach, z których się składa. Dla każdego punktu pośredniego lub miejsca docelowego będzie jeden etap. Trasa bez punktów pośrednich będzie zawierać 1 DirectionsLeg , a trasy z 1 punktem pośrednim – 2 DirectionsLeg . |
overview_path |
Tablica elementów LatLng reprezentujących cały przebieg tej trasy. Ścieżka jest uproszczona, aby była odpowiednia w kontekstach, w których wymagana jest niewielka liczba wierzchołków (np. adresy URL interfejsu Static Maps API). |
overview_polyline |
Typ:
string Zakodowiona linia łamana trasy w overview_path. Ta linia łamana to przybliżona (wygładzona) ścieżka wyników wskazówek. |
summary |
Typ:
string Zawiera krótki tekstowy opis trasy, który umożliwia nazwanie trasy i odróżnienie jej od tras alternatywnych. |
warnings |
Typ:
Array<string> Ostrzeżenia wyświetlane podczas wyświetlania tych wskazówek. |
waypoint_order |
Typ:
Array<number> Jeśli ustawienie optimizeWaypoints to true , to pole będzie zawierać permutację punktów docelowych wejściowych w zmienionej kolejności. Jeśli np. dane wejściowe to:Pochodzenie: Los Angeles Punkty pośrednie: Dallas, Bangor, Phoenix Docelowy: Nowy Jork a wyjście z optymalizacją zostało posortowane w taki sposób: Pochodzenie: Los Angeles Punkty pośrednie: Phoenix, Dallas, Bangor Docelowy: Nowy Jork to to pole będzie zawierać Array z wartościami [2, 0, 1]. Pamiętaj, że numeracja punktów kontrolnych jest liczona od 0.Jeśli stopover dowolnego z podanych punktów pośrednich ma wartość false , to pole będzie puste, ponieważ optymalizacja trasy jest niedostępna w przypadku takich zapytań. |
fare optional |
Typ:
TransitFare optional Łączna opłata za całą podróż. Dotyczy tylko próśb o przejazd. |
Interfejs DirectionsLeg
google.maps.DirectionsLeg
interfejs
Pojedynczy etap składający się z szeregu kroków w ramach DirectionsResult
. Niektóre pola w etapu mogą nie zostać zwrócone w przypadku niektórych żądań. Pamiętaj, że chociaż ten wynik jest „podobny do JSON”, to nie jest to ściśle JSON, ponieważ zawiera bezpośrednio i pośrednio obiekty LatLng
.
Właściwości | |
---|---|
end_address |
Typ:
string Adres miejsca docelowego na tym etapie. Te treści mają być odczytywane w postaci, w której są zapisane. Nie należy ich analizować programowo. |
end_location |
Typ:
LatLng DirectionsService oblicza trasy między lokalizacjami, korzystając z najbliższej opcji transportu (zazwyczaj drogi) w miejscach początkowym i końcowym. end_location wskazuje rzeczywiste miejsce docelowe z kodem geograficznym, które może być inne niż end_location ostatniego kroku, jeśli np. droga nie znajduje się w pobliżu miejsca docelowego tego etapu. |
start_address |
Typ:
string Adres miejsca początkowego tego odcinka. Te treści mają być odczytywane w postaci, w której są zapisane. Nie należy ich analizować programowo. |
start_location |
Typ:
LatLng DirectionsService oblicza trasy między lokalizacjami, korzystając z najbliższej opcji transportu (zazwyczaj drogi) w miejscach początkowym i końcowym. start_location wskazuje rzeczywiste położenie początkowe z geokodowaniem, które może być inne niż start_location pierwszego kroku, jeśli na przykład droga nie znajduje się w pobliżu początku tego etapu. |
steps |
Typ:
Array<DirectionsStep> tablica DirectionsStep , z której każda kolumna zawiera informacje o poszczególnych krokach tego odcinka; |
|
Typ:
Array<?> Informacje o prędkości ruchu na danym odcinku. |
via_waypoints |
Tablica punktów pośrednich bez postojów na tym odcinku, które zostały określone w pierwotnej prośbie. Wycofane w przypadku tras alternatywnych. Wersja 3.27 będzie ostatnią wersją interfejsu API, która dodaje dodatkowe Jeśli do implementowania przeciąganych wskazówek używasz usługi Directions Service, zalecamy wyłączenie przeciągania alternatywnych tras. Tylko główna trasa powinna być przeciągana. Użytkownicy mogą przeciągać główną trasę, aż dopasuje się ona do trasy alternatywnej. |
arrival_time optional |
Typ:
Time optional Szacowany czas przybycia na ten odcinek. Dotyczy tylko żądań TRANSIT. |
departure_time optional |
Typ:
Time optional Szacowany czas odjazdu na tym odcinku. Dotyczy tylko żądań TRANSIT. |
distance optional |
Typ:
Distance optional Całkowita odległość pokonana na tym odcinku. Ta właściwość może być niezdefiniowana, ponieważ odległość może być nieznana. |
duration optional |
Typ:
Duration optional Łączny czas trwania tego etapu. Ta wartość może być undefined , ponieważ czas trwania może być nieznany. |
duration_in_traffic optional |
Typ:
Duration optional Łączny czas trwania tego etapu, biorąc pod uwagę warunki drogowe wskazane przez właściwość trafficModel . Ta wartość może być undefined , ponieważ czas trwania może być nieznany. |
Interfejs DirectionsStep
google.maps.DirectionsStep
interfejs
Pojedynczy DirectionsStep
w ramach DirectionsResult
. Niektóre pola mogą być undefined
. Pamiętaj, że chociaż ten obiekt jest „podobny do JSON”, nie jest to stricte JSON, ponieważ zawiera bezpośrednio obiekty LatLng
.
Właściwości | |
---|---|
encoded_lat_lngs |
Typ:
string Zakodowana reprezentacja linii łamanej kroku. To jest przybliżona (wygładzona) ścieżka kroku. |
end_location |
Typ:
LatLng Miejsce zakończenia tego kroku. |
|
Typ:
LatLng Miejsce zakończenia tego kroku. |
instructions |
Typ:
string Instrukcje dotyczące tego kroku. |
|
Sekwencja LatLng opisująca przebieg tego kroku. To jest przybliżona (wygładzona) ścieżka kroku. |
maneuver |
Typ:
string Zawiera działanie, które należy wykonać w przypadku bieżącego kroku ( turn-left , merge , straight itd.). Wartości mogą ulec zmianie, a nowe mogą zostać wprowadzone bez wcześniejszego powiadomienia. |
path |
Sekwencja LatLng opisująca przebieg tego kroku. To jest 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óży użyty w tym kroku. |
distance optional |
Typ:
Distance optional Dystans pokonany na tym etapie. Ta właściwość może być undefined , ponieważ odległość może być nieznana. |
duration optional |
Typ:
Duration optional Typowy czas wykonania tego kroku w sekundach i w formie tekstowej. Ta wartość może być undefined , ponieważ czas trwania może być nieznany. |
|
Typ:
DirectionsPolyline optional Zawiera obiekt z jedną właściwością „points”, który zawiera zakodowany wielokąt reprezentujący krok. Ta polilinia jest przybliżoną (wygładzoną) ścieżką kroku. |
steps optional |
Typ:
Array<DirectionsStep> optional Podkroki tego kroku. Określone dla odcinków nieprzejazdowych tras tranzytowych. |
transit optional |
Typ:
TransitDetails optional Szczegóły dotyczące tego etapu dotyczące transportu. Ta właściwość nie będzie zdefiniowana, chyba że tryb podróży tego kroku to TRANSIT . |
transit_details optional |
Typ:
TransitDetails optional Szczegóły dotyczące tego etapu, jeśli tryb podróży to TRANSIT . |
Interfejs DirectionsPolyline
google.maps.DirectionsPolyline
interfejs
Obiekt zawierający właściwość points
, która opisuje ścieżkę złożoną DirectionsStep
.
Właściwości | |
---|---|
points |
Typ:
string |
Interfejs Miejsca
google.maps.Place
interfejs
Zawiera informacje potrzebne do zlokalizowania, identyfikacji lub opisania miejsca w celu DirectionsRequest
lub DistanceMatrixRequest
. W tym kontekście „miejsce” oznacza firmę, punkt orientacyjny lub lokalizację geograficzną. Informacje o pobieraniu informacji o miejscu znajdziesz w artykule PlacesService
.
Właściwości | |
---|---|
location optional |
Typ:
LatLng|LatLngLiteral optional LatLng elementu opisanego przez to miejsce. |
placeId optional |
Typ:
string optional Identyfikator miejsca (np. firmy lub punktu orientacyjnego). Identyfikator miejsca to unikalny identyfikator miejsca w bazie danych Map Google. Pamiętaj, że placeId to najdokładniejszy sposób identyfikacji miejsca. Jeśli to możliwe, należy podać wartość placeId zamiast query . Identyfikator miejsca można pobrać z dowolnego żądania wysłanego do interfejsu Places API, np. TextSearch. Identyfikatory miejsc można też pobierać z zapytań do Geocoding API. Więcej informacji znajdziesz w artykule Omówienie identyfikatorów miejsc. |
query optional |
Typ:
string optional wyszukiwane hasło opisujące miejsce (np. firmę lub punkt orientacyjny); Przykładowe zapytanie: „Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW”. Jeśli to możliwe, należy podać wartość placeId zamiast query . Interfejs API nie gwarantuje dokładności rozwiązywania ciągu zapytania na miejsce. Jeśli podana jest zarówno wartość placeId , jak i query , wystąpi błąd. |
TravelMode: stałe
google.maps.TravelMode
stałe
Prawidłowe środki transportu, które można określić w tagu DirectionsRequest
, oraz środki transportu zwracane w tagu DirectionsStep
. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'BICYCLING'
lub google.maps.TravelMode.BICYCLING
.
Dostęp przez połączenie telefoniczne const {TravelMode} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
BICYCLING |
Określa żądanie trasy rowerowej. |
DRIVING |
Wskazuje żądanie trasy dojazdu. |
TRANSIT |
Określa żądanie dotyczące wskazówek dojazdu transportem publicznym. |
WALKING |
Określa żądanie trasy pieszo. |
Interfejs DrivingOptions
google.maps.DrivingOptions
interfejs
Konfiguruje DirectionsRequest
, gdy tryb podróży ma wartość DRIVING
.
Właściwości | |
---|---|
departureTime |
Typ:
Date Pożądany czas wyjazdu na trasie, określony jako obiekt Date . Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 r. Musisz określić tę wartość, aby DrivingOptions był prawidłowy. Czas wyjazdu musi być ustawiony na bieżącą godzinę lub godzinę w przyszłości. Nie może ona przypadać w przeszłości. |
trafficModel optional |
Typ:
TrafficModel optional Preferowane założenie do stosowania podczas prognozowania czasu trwania ruchu. Wartość domyślna to BEST_GUESS . |
TrafficModel stałe
google.maps.TrafficModel
stałe
Założenia, których należy używać podczas prognozowania czasu trwania ruchu. Określony w ramach DirectionsRequest
lub DistanceMatrixRequest
. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'bestguess'
lub google.maps.TrafficModel.BEST_GUESS
.
Dostęp przez połączenie telefoniczne const {TrafficModel} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
BEST_GUESS |
Użyj danych historycznych o ruchu, aby oszacować czas spędzony w korku. |
OPTIMISTIC |
Korzystając z danych historycznych o ruchu, możesz optymistycznie oszacować czas trwania ruchu. |
PESSIMISTIC |
Korzystając z danych historycznych o ruchu, możesz podać pesymistyczny szacunek jego trwania. |
Interfejs TransitOptions
google.maps.TransitOptions
interfejs
Obiekt TransitOptions do uwzględnienia w DirectionsRequest
, gdy tryb podróży ma wartość TRANSIT.
Właściwości | |
---|---|
arrivalTime optional |
Typ:
Date optional Pożądany czas przybycia na trasę, podany jako obiekt Date. Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 r. Jeśli podano czas przyjazdu, czas wyjazdu jest ignorowany. |
departureTime optional |
Typ:
Date optional Pożądana godzina wyjazdu na trasie, podana jako obiekt Date. Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 r. Jeśli nie określono ani godziny wyjazdu, ani godziny przyjazdu, przyjmuje się, że jest to „teraz”. |
modes optional |
Typ:
Array<TransitMode> optional Co najmniej jeden preferowany środek transportu, np. autobus lub pociąg. Jeśli nie podasz preferencji, interfejs API zwróci domyślną najlepszą trasę. |
routingPreference optional |
Typ:
TransitRoutePreference optional Preferencja, która może wpływać na wybór trasy przejazdu, np. mniejsza odległość do przejścia. Jeśli nie podasz preferencji, interfejs API zwróci domyślną najlepszą trasę. |
stałe TransitMode
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 nazwy stałej. Na przykład 'BUS'
lub google.maps.TransitMode.BUS
.
Dostęp przez połączenie telefoniczne const {TransitMode} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
BUS |
Określa autobus jako preferowany środek transportu. |
RAIL |
Określa kolej 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 TransitRoutePreference
google.maps.TransitRoutePreference
stałe
Prawidłowy typ trasy transportu publicznego, który można podać w TransitOptions
. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'LESS_WALKING'
lub google.maps.TransitRoutePreference.LESS_WALKING
.
Dostęp przez połączenie telefoniczne const {TransitRoutePreference} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
FEWER_TRANSFERS |
Określa, że obliczona trasa powinna preferować ograniczoną liczbę przesiadek. |
LESS_WALKING |
Określa, że obliczona trasa powinna preferować ograniczone odcinki piesze. |
Interfejs TransitFare
google.maps.TransitFare
interfejs
Cena DirectionsRoute
składająca się z wartości i waluty.
Właściwości | |
---|---|
currency |
Typ:
string Kod waluty w formacie ISO 4217 wskazujący walutę, w której wyrażona jest cena. |
value |
Typ:
number Wartość liczbowa ceny wyrażona w danej currency . |
Interfejs TransitDetails
google.maps.TransitDetails
interfejs
Szczegóły dotyczące wyjazdu, przyjazdu i rodzaju transportu użytego na tym etapie.
Właściwości | |
---|---|
arrival_stop |
Typ:
TransitStop Przystanek docelowy tego etapu przejazdu. |
arrival_time |
Typ:
Time Czas przybycia w ramach tego kroku określony jako obiekt Time. |
departure_stop |
Typ:
TransitStop Przystanek początkowy tego etapu przejazdu. |
departure_time |
Typ:
Time Czas wyjazdu w danym kroku określony jako obiekt Time. |
headsign |
Typ:
string Kierunek, w którym należy jechać na tej linii, jak jest oznaczony na pojeździe lub na przystanku odjazdu. |
headway |
Typ:
number Oczekiwana liczba sekund między równoważnymi pojazdami na tym przystanku. |
line |
Typ:
TransitLine Szczegóły dotyczące linii tranzytowej użytej na tym etapie. |
num_stops |
Typ:
number Liczba przystanków na tym etapie. Obejmuje przystanek docelowy, ale nie przystanek początkowy. |
trip_short_name |
Typ:
string Tekst, który pojawia się w rozkładach jazdy i na tablicach informacyjnych, aby zidentyfikować przejazd dla pasażerów, na przykład aby zidentyfikować numery pociągów w przypadku podróży pociągiem podmiejskim. Tekst jednoznacznie identyfikuje przejazd w ramach dnia roboczego. |
Interfejs TransitStop
google.maps.TransitStop
interfejs
Szczegóły dotyczące przystanku lub stacji.
Właściwości | |
---|---|
location |
Typ:
LatLng Lokalizacja tego przystanku. |
name |
Typ:
string Nazwa przystanku. |
Interfejs TransitLine
google.maps.TransitLine
interfejs
Informacje o linii transportu publicznego obsługującej ten etap podróży.
Właściwości | |
---|---|
agencies |
Typ:
Array<TransitAgency> Operator transportu publicznego obsługujący tę linię. |
color |
Typ:
string Kolor często używany w oznakowaniu tej linii transportu publicznego, reprezentowany jako ciąg heksadecymalny. |
icon |
Typ:
string Adres URL ikony powiązanej z tą linią. |
name |
Typ:
string Pełna nazwa tej linii transportu publicznego, np. „8 Avenue Local”. |
short_name |
Typ:
string Krótka nazwa tej linii transportu publicznego, np. „E”. |
text_color |
Typ:
string Kolor tekstu często używany na tablicach informacyjnych dla tej linii transportu publicznego, reprezentowany jako ciąg szesnastkowy. |
url |
Typ:
string Adres URL agencji, który jest specyficzny dla tej linii tranzytowej. |
vehicle |
Typ:
TransitVehicle Typ pojazdu, np. pociąg lub autobus. |
Interfejs TransitAgency
google.maps.TransitAgency
interfejs
Informacje o agencji, która zarządza linią transportową.
Właściwości | |
---|---|
name |
Typ:
string Nazwa tego przewoźnika. |
phone |
Typ:
string Numer telefonu przewoźnika. |
url |
Typ:
string Adres URL przewoźnika. |
Interfejs TransitVehicle
google.maps.TransitVehicle
interfejs
Informacje o pojeździe, który kursuje na danej linii.
Właściwości | |
---|---|
icon |
Typ:
string Adres URL ikony odpowiadającej rodzajowi pojazdu używanego na tej linii. |
local_icon |
Typ:
string Adres URL ikony odpowiadającej rodzajowi pojazdu używanego w danym regionie zamiast ikony ogólnej. |
name |
Typ:
string Nazwa tego typu pojazdu, np. „Pociąg” lub „Autobus”. |
type |
Typ:
VehicleType Typ pojazdu, np. pociąg, autobus lub prom. |
VehicleType stałe
google.maps.VehicleType
stałe
Możliwe wartości typów pojazdów.
Dostęp przez połączenie telefoniczne const {VehicleType} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
BUS |
Autobus. |
CABLE_CAR |
Pojazd poruszający się na kablu, zwykle na ziemi. Koleje linowe mogą być typu GONDOLA_LIFT . |
COMMUTER_TRAIN |
Kolej podmiejska. |
FERRY |
Prom. |
FUNICULAR |
Pojazd ciągnięty na stromym wzniesieniu za pomocą kabla. |
GONDOLA_LIFT |
Kolej gondolowa. |
HEAVY_RAIL |
Koleje ciężkie. |
HIGH_SPEED_TRAIN |
Pociąg szybkobieżny. |
INTERCITY_BUS |
Autobus dalekobieżny. |
METRO_RAIL |
Kolej miejska. |
MONORAIL |
Kolej jednoszynowa. |
OTHER |
Inne pojazdy. |
RAIL |
Rail. |
SHARE_TAXI |
Wspólne taksówki to rodzaj transportu autobusowego z możliwością wsiadania i wysadzania pasażerów w dowolnym miejscu na trasie. Zwykle taksówki do przewozu grup korzystają z minibusów. |
SUBWAY |
Podziemna kolej miejska. |
TRAM |
Kolej miejska na powierzchni. |
TROLLEYBUS |
Trolejbus. |
stałe UnitSystem
google.maps.UnitSystem
stałe
Prawidłowe systemy jednostek, które można określić w elemencie DirectionsRequest
.
Dostęp przez połączenie telefoniczne const {UnitSystem} = await google.maps.importLibrary("core")
. Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
IMPERIAL |
Określa, że odległości w elementach DirectionsResult powinny być wyrażone w jednostkach imperialnych. |
METRIC |
Określa, że odległości w elementach DirectionsResult powinny być wyrażone w jednostkach metrycznych. |
Interfejs Dystans
google.maps.Distance
interfejs
Reprezentacja odległości w postaci wartości liczbowej i ciągu tekstowego.
Właściwości | |
---|---|
text |
Typ:
string Wartość odległości w postaci ciągu znaków, która jest określana za pomocą parametru UnitSystem w żądaniu. |
value |
Typ:
number Odległość w metrach. |
Czas trwaniainterfejsu
google.maps.Duration
interfejs
Czas trwania w postaci wartości liczbowej i ciągu tekstowego.
Właściwości | |
---|---|
text |
Typ:
string Ciąg tekstowy reprezentujący wartość czasu trwania. |
value |
Typ:
number Czas trwania w sekundach. |
Interfejs Czas
google.maps.Time
interfejs
Reprezentacja czasu jako obiekt Date, zlokalizowany ciąg znaków i strefa czasowa.
Właściwości | |
---|---|
text |
Typ:
string Tekst reprezentujący wartość czasu. Czas jest wyświetlany w strefie czasowej przystanku. |
time_zone |
Typ:
string Strefa czasowa, w której znajduje się ten przystanek. Wartość to nazwa strefy czasowej zdefiniowana w bazie danych stref czasowych IANA, np. „America/New_York”. |
value |
Typ:
Date Czas wyjazdu lub przyjazdu, podany jako obiekt JavaScript Date. |
DirectionsTravelMode: stałe
google.maps.DirectionsTravelMode
stałe
stałe DirectionsUnitSystem.
google.maps.DirectionsUnitSystem
stałe