DirectionsService class
google.maps.DirectionsService
zajęcia
Usługa do obliczania trasy między co najmniej 2 miejscami.
Dostęp przez połączenie pod numer const {DirectionsService} = await google.maps.importLibrary("routes")
.
Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
---|---|
DirectionsService |
DirectionsService() Parametry: brak
Tworzy nową instancję klasy DirectionsService , która wysyła zapytania o wskazówki dojazdu na serwery Google. |
Metody | |
---|---|
route |
route(request[, callback]) Parametry:
Zwracana wartość:
Promise<DirectionsResult> Wysyłanie zapytania o wskazówki dojazdu. |
Interfejs DirectionsRequest
google.maps.DirectionsRequest
interfejs
Zapytanie o wskazówki dojazdu, które ma zostać wysłane do DirectionsService
.
Właściwości | |
---|---|
destination |
Typ:
string|LatLng|Place|LatLngLiteral Lokalizacja miejsca docelowego. Może to być ciąg tekstowy do geokodowania, LatLng lub Place . Wymagane. |
origin |
Typ:
string|LatLng|Place|LatLngLiteral Miejsce pochodzenia. Może to być ciąg tekstowy do geokodowania, LatLng lub Place . Wymagane. |
travelMode |
Typ:
TravelMode Rodzaj żądanego routingu. Wymagane. |
avoidFerries optional |
Typ:
boolean optional Jeśli true , usługa Wskazówki dojazdu będzie unikać przepraw promowych, gdy tylko będzie to możliwe. Opcjonalnie. |
avoidHighways optional |
Typ:
boolean optional Jeśli true , usługa Wskazówki dojazdu będzie w miarę możliwości omijać autostrady. Opcjonalnie. |
avoidTolls optional |
Typ:
boolean optional Jeśli true , usługa Wskazówki dojazdu będzie w miarę możliwości omijać drogi płatne. Opcjonalnie. |
drivingOptions optional |
Typ:
DrivingOptions optional Ustawienia, które mają zastosowanie tylko do żądań, w których wartość parametru travelMode to DRIVING . W przypadku innych środków transportu ten obiekt nie będzie miał żadnego wpływu. |
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 wartość tego parametru to true , usługa DirectionsService spróbuje zmienić kolejność podanych pośrednich punktów trasy, aby zminimalizować całkowity koszt trasy. Jeśli punkty pośrednie 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. Opcjonalnie. |
region optional |
Typ:
string optional Kod regionu używany jako odchylenie w przypadku żądań geokodowania. Kod regionu akceptuje 2-znakową wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma istotnymi wyjątkami. Na przykład krajowa domena najwyższego poziomu Zjednoczonego Królestwa to „uk” ( .co.uk ), a 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. W przypadku innych środków transportu ten obiekt nie będzie miał żadnego wpływu. |
unitSystem optional |
Typ:
UnitSystem optional Domyślne: system jednostek używany w kraju pochodzenia.
Preferowany układ jednostek do wyświetlania odległości. |
waypoints optional |
Typ:
Array<DirectionsWaypoint> optional Tablica pośrednich punktów na trasie. Wskazówki dojazdu są obliczane od miejsca początkowego do miejsca docelowego przez każdy punkt pośredni w tej tablicy. Maksymalną dozwoloną 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. |
DirectionsStatus stałe
google.maps.DirectionsStatus
stałe
Stan zwrócony przez DirectionsService
po zakończeniu połączenia z numerem route()
. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'OK'
lub google.maps.DirectionsStatus.OK
.
Dostęp przez połączenie pod numer const {DirectionsStatus} = await google.maps.importLibrary("routes")
.
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
INVALID_REQUEST |
Podany plik DirectionsRequest jest nieprawidłowy. |
MAX_WAYPOINTS_EXCEEDED |
W elemencie DirectionsRequest podano zbyt wiele elementów DirectionsWaypoint . Maksymalną dozwoloną liczbę punktów pośrednich znajdziesz w przewodniku dla programistów. |
NOT_FOUND |
Nie udało się określić współrzędnych geograficznych co najmniej jednego z tych elementów: punkt początkowy, miejsce docelowe lub punkty pośrednie. |
OK |
Odpowiedź zawiera prawidłowy DirectionsResult . |
OVER_QUERY_LIMIT |
Strona internetowa przekroczyła limit żądań w zbyt krótkim czasie. |
REQUEST_DENIED |
Strona nie może korzystać z usługi wskazówek dojazdu. |
UNKNOWN_ERROR |
Nie udało się przetworzyć żądania dotyczącego wskazówek dojazdu 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 celem podróży. |
DirectionsResult interfejs
google.maps.DirectionsResult
interfejs
Odpowiedź z serwera wskazówek dojazdu. Możesz je renderować za pomocą DirectionsRenderer
lub samodzielnie przeanalizować ten obiekt i go wyrenderować. Musisz wyświetlać ostrzeżenia i informacje o prawach autorskich zgodnie z Warunkami korzystania z Google Maps Platform. Pamiętaj, że chociaż ten wynik jest „podobny do JSON”, nie jest to ściśle JSON, ponieważ pośrednio zawiera obiekty LatLng
.
Właściwości | |
---|---|
request |
Typ:
DirectionsRequest Obiekt DirectionsRequest, który zwrócił ten wynik. |
routes |
Typ:
Array<DirectionsRoute> Tablica obiektów DirectionsRoute , z których każdy zawiera informacje o odcinkach i krokach, z których się składa. Będzie tylko jedna trasa, chyba że DirectionsRequest została utworzona z ustawieniem provideRouteAlternatives na true . |
available_travel_modes optional |
Typ:
Array<TravelMode> optional Zawiera tablicę dostępnych trybów podróży. To pole jest zwracane, gdy żądanie określa tryb podróży i nie uzyskuje żadnych wyników. Tablica zawiera dostępne środki transportu w krajach, w których znajdują się podane punkty pośrednie. To pole nie jest zwracane, jeśli co najmniej jeden z punktów pośrednich jest punktem „via waypoint”. |
geocoded_waypoints optional |
Typ:
Array<DirectionsGeocodedWaypoint> optional Tablica obiektów DirectionsGeocodedWaypoint , z których każdy zawiera informacje o geokodowaniu punktu początkowego, miejsca docelowego i punktów pośrednich. |
DirectionsRenderer class
google.maps.DirectionsRenderer
zajęcia
Wyświetla wskazówki dojazdu uzyskane z usługi DirectionsService
.
Ta klasa rozszerza klasę MVCObject
.
Dostęp przez połączenie pod numer const {DirectionsRenderer} = await google.maps.importLibrary("routes")
.
Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) Parametry:
Tworzy moduł renderujący z podanymi opcjami. Wskazówki dojazdu mogą być wyświetlane na mapie (jako nakładki wizualne) lub dodatkowo w <div> panelu (jako instrukcje tekstowe). |
Metody | |
---|---|
getDirections |
getDirections() Parametry: brak
Zwracana wartość:
DirectionsResult Zwraca bieżący zestaw kierunków renderera. |
getMap |
getMap() Parametry: brak
Zwracana wartość:
Map Zwraca mapę, na której renderowany jest element DirectionsResult . |
getPanel |
getPanel() Parametry: brak
Zwracana wartość:
HTMLElement|null Zwraca panel <div> , w którym renderowany jest element DirectionsResult . |
getRouteIndex |
getRouteIndex() Parametry: brak
Zwracana wartość:
number Zwraca bieżący (liczony od zera) indeks trasy używany przez ten obiekt DirectionsRenderer . |
setDirections |
setDirections(directions) Parametry:
Zwracana wartość: brak
Ustaw moduł renderujący, aby używał wyniku z funkcji DirectionsService . Ustawienie w ten sposób prawidłowego zestawu wskazówek spowoduje wyświetlenie ich na wyznaczonej mapie i w panelu renderera. |
setMap |
setMap(map) Parametry:
Zwracana wartość: brak
Ta metoda określa mapę, na której będą renderowane wskazówki dojazdu. Przekaż null , aby usunąć wskazówki z mapy. |
setOptions |
setOptions(options) Parametry:
Zwracana wartość: brak
Zmień ustawienia opcji tego urządzenia DirectionsRenderer po inicjalizacji. |
setPanel |
setPanel(panel) Parametry:
Zwracana wartość: brak
Ta metoda renderuje wskazówki dojazdu w <div> . Kliknij null , aby usunąć treść z panelu. |
setRouteIndex |
setRouteIndex(routeIndex) Parametry:
Zwracana wartość: brak
Ustaw indeks (liczony od zera) trasy w obiekcie DirectionsResult , która ma być renderowana. Domyślnie renderowana jest pierwsza trasa w tablicy. |
Odziedziczone:
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 dojazdu, np. gdy ustawiona zostanie nowa wartość DirectionsResult lub gdy użytkownik skończy przeciągać zmianę ścieżki wskazówek dojazdu. |
DirectionsRendererOptions interfejs
google.maps.DirectionsRendererOptions
interfejs
Ten obiekt określa właściwości, które można ustawić w obiekcie DirectionsRenderer
.
Właściwości | |
---|---|
directions optional |
Typ:
DirectionsResult optional Wskazówki dojazdu, które mają być wyświetlane na mapie lub w panelu <div> , pobrane jako obiekt DirectionsResult z 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ść określa, czy moduł renderujący ma udostępniać listę tras, którą użytkownik może wybrać w panelu wskazówek dojazdu. |
infoWindow optional |
Typ:
InfoWindow optional InfoWindow , w którym mają być renderowane informacje tekstowe po kliknięciu znacznika. Dotychczasowa zawartość okna informacyjnego zostanie zastąpiona, a jego położenie ulegnie zmianie. Jeśli nie określono okna informacyjnego, DirectionsRenderer utworzy i użyje własnego okna informacyjnego. Ta właściwość jest ignorowana, jeśli wartość suppressInfoWindows to true . |
map optional |
Typ:
Map optional Mapa, na której mają być wyświetlane wskazówki dojazdu. |
markerOptions optional |
Typ:
MarkerOptions optional Opcje znaczników. Wszystkie znaczniki renderowane przez element DirectionsRenderer będą korzystać z tych opcji. |
panel optional |
Typ:
HTMLElement optional <div> , w którym mają być wyświetlane instrukcje dojazdu. |
polylineOptions optional |
Typ:
PolylineOptions optional Opcje polilinii. Wszystkie linie łamane renderowane przez DirectionsRenderer będą korzystać z tych opcji. |
preserveViewport optional |
Typ:
boolean optional Domyślnie:
false Jeśli ta opcja ma wartość true lub środek i powiększenie mapy nigdy nie zostały ustawione, mapa wejściowa jest wyśrodkowana i powiększona do ramki ograniczającej 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 Nie renderuj ikony BicyclingLayer , gdy użytkownik poprosi o wskazówki dojazdu rowerem. |
suppressInfoWindows optional |
Typ:
boolean optional Wyłącz renderowanie okien informacyjnych. |
suppressMarkers optional |
Typ:
boolean optional Blokowanie renderowania znaczników. |
suppressPolylines optional |
Typ:
boolean optional Wyłącz renderowanie linii łamanych. |
DirectionsWaypoint interface
google.maps.DirectionsWaypoint
interfejs
Symbol DirectionsWaypoint
oznacza lokalizację między miejscem początkowym a 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 znaków adresu, LatLng lub Place . Opcjonalnie. |
stopover optional |
Typ:
boolean optional Domyślnie:
true Jeśli true , oznacza to, że ten punkt pośredni jest przystankiem między miejscem początkowym a docelowym. Spowoduje to podzielenie trasy na 2 odcinki. Jeśli false , oznacza to, że trasa powinna być ukierunkowana na ten punkt pośredni, ale nie powinna być dzielona na 2 odcinki. Jest to przydatne, gdy chcesz utworzyć trasę w odpowiedzi na przeciąganie punktów trasy przez użytkownika na mapie. |
Interfejs DirectionsGeocodedWaypoint
google.maps.DirectionsGeocodedWaypoint
interfejs
Pojedynczy geokodowany punkt pośredni.
Właściwości | |
---|---|
partial_match optional |
Typ:
boolean optional Czy geokoder nie zwrócił dokładnego dopasowania do pierwotnego punktu pośredniego, ale udało mu się dopasować część żądanego adresu. |
place_id optional |
Typ:
string optional Identyfikator miejsca powiązany z punktem pośrednim. 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ących typ zwróconego elementu geokodowanego. Listę możliwych ciągów znaków znajdziesz w sekcji Typy komponentów adresu w przewodniku dla programistów. |
DirectionsRoute interfejs
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ż bezpośrednio i pośrednio zawiera 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 w przypadku tej trasy. |
legs |
Typ:
Array<DirectionsLeg> Tablica obiektów DirectionsLeg , z których każdy zawiera informacje o krokach, z których się składa. Każdy punkt pośredni lub miejsce docelowe będzie stanowiło jeden odcinek podróży. Trasa bez przystanków zawiera 1 DirectionsLeg , a trasa z 1 przystankiem zawiera 2 DirectionsLeg . |
overview_path |
Tablica obiektów LatLng reprezentujących całą trasę. Ścieżka jest uproszczona, aby można było jej używać w kontekstach, w których wymagana jest niewielka liczba wierzchołków (np. w adresach URL interfejsu Static Maps API). |
overview_polyline |
Typ:
string Zakodowana reprezentacja linii łamanej trasy w overview_path. Ta linia łamana to przybliżona (wygładzona) ścieżka wynikowych wskazówek. |
summary |
Typ:
string Zawiera krótki opis tekstowy trasy, który można wykorzystać do nadania jej nazwy i odróżnienia jej od alternatywnych tras. |
warnings |
Typ:
Array<string> Ostrzeżenia, które mają być wyświetlane podczas pokazywania tych wskazówek. |
waypoint_order |
Typ:
Array<number> Jeśli parametr optimizeWaypoints miał wartość true , to pole będzie zawierać zmienioną kolejność punktów pośrednich. Jeśli na przykład dane wejściowe to:Początek: Los Angeles Punkty pośrednie: Dallas, Bangor, Phoenix Koniec: Nowy Jork a zoptymalizowane dane wyjściowe są uporządkowane w ten sposób: Początek: Los Angeles Punkty pośrednie: Phoenix, Dallas, Bangor Koniec: Nowy Jork to to pole będzie zawierać wartość Array z wartościami [2, 0, 1]. Pamiętaj, że numeracja punktów pośrednich jest liczona od zera.Jeśli którykolwiek z punktów pośrednich ma wartość stopover ustawioną na false , to pole będzie puste, ponieważ optymalizacja trasy nie jest dostępna w przypadku takich zapytań. |
fare optional |
Typ:
TransitFare optional Łączna opłata za całą podróż transportem publicznym. Dotyczy to tylko żądań dotyczących transportu publicznego. |
DirectionsLeg interfejs
google.maps.DirectionsLeg
interfejs
Pojedynczy etap składający się z zestawu kroków w DirectionsResult
. Niektóre pola w segmencie mogą nie być zwracane w przypadku wszystkich żądań. Pamiętaj, że chociaż ten wynik jest „podobny do JSON”, nie jest to ściśle JSON, ponieważ bezpośrednio i pośrednio zawiera obiekty LatLng
.
Właściwości | |
---|---|
end_address |
Typ:
string Adres miejsca docelowego tego etapu podróży. Te treści należy odczytywać w takiej postaci, w jakiej są wyświetlane. Nie analizuj sformatowanego adresu automatycznie. |
end_location |
Typ:
LatLng DirectionsService oblicza wskazówki dojazdu między lokalizacjami, korzystając z najbliższej opcji transportu (zwykle drogi) w miejscu początkowym i końcowym. end_location oznacza rzeczywiste miejsce docelowe po geokodowaniu, które może się różnić od end_location ostatniego kroku, np. jeśli droga nie przebiega w pobliżu miejsca docelowego tego odcinka. |
start_address |
Typ:
string Adres początku tego odcinka. Te treści należy odczytywać w takiej postaci, w jakiej są wyświetlane. Nie analizuj sformatowanego adresu automatycznie. |
start_location |
Typ:
LatLng DirectionsService oblicza wskazówki dojazdu między lokalizacjami, korzystając z najbliższej opcji transportu (zwykle drogi) w miejscu początkowym i końcowym. start_location oznacza rzeczywiste geokodowane miejsce docelowe, które może się różnić od start_location pierwszego kroku, np. jeśli droga nie znajduje się w pobliżu miejsca docelowego tego etapu. |
steps |
Typ:
Array<DirectionsStep> Tablica DirectionsStep , z której każda zawiera informacje o poszczególnych etapach tego odcinka. |
|
Typ:
Array<?> Informacje o prędkości ruchu na danym odcinku. |
via_waypoints |
Tablica punktów pośrednich bez przystanków na tym odcinku, które zostały określone w pierwotnym żądaniu. Wycofane w przypadku tras alternatywnych. Wersja 3.27 będzie ostatnią wersją interfejsu API, która dodaje dodatkowe Jeśli używasz usługi Kierunki do implementowania kierunków, które można przeciągać, zalecamy wyłączenie przeciągania tras alternatywnych. Przeciągać można tylko główną trasę. Użytkownicy mogą przeciągnąć główną trasę, aż będzie pasować do trasy alternatywnej. |
arrival_time optional |
Typ:
Time optional Szacowany czas przybycia na tym etapie. Dotyczy tylko żądań TRANSIT. |
departure_time optional |
Typ:
Time optional Szacowany czas odjazdu z tego miejsca. Dotyczy tylko żądań TRANSIT. |
distance optional |
Typ:
Distance optional Całkowity dystans pokonany na tym etapie. Ta właściwość może być niezdefiniowana, ponieważ odległość może być nieznana. |
duration optional |
Typ:
Duration optional Całkowity czas trwania tego odcinka. Ta właściwość może mieć wartość undefined , ponieważ czas trwania może być nieznany. |
duration_in_traffic optional |
Typ:
Duration optional Całkowity czas trwania tego etapu podróży z uwzględnieniem warunków drogowych wskazanych przez właściwość trafficModel . Ta właściwość może mieć wartość undefined , ponieważ czas trwania może być nieznany. |
DirectionsStep interfejs
google.maps.DirectionsStep
interfejs
Pojedynczy znak DirectionsStep
w tagu DirectionsResult
. Niektóre pola mogą być undefined
. Pamiętaj, że chociaż ten obiekt jest „podobny do JSON”, nie jest to ściśle JSON, ponieważ zawiera bezpośrednio obiekty LatLng
.
Właściwości | |
---|---|
encoded_lat_lngs |
Typ:
string Zakodowana reprezentacja linii łamanej kroku. Jest 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 dotyczące tego kroku. |
|
Ciąg LatLng opisujący przebieg tego kroku. Jest to przybliżona (wygładzona) ścieżka kroku. |
maneuver |
Typ:
string Zawiera działanie, które należy wykonać w bieżącym kroku ( turn-left , merge , straight itp.). Wartości mogą ulec zmianie, a nowe wartości mogą zostać wprowadzone bez wcześniejszego powiadomienia. |
path |
Ciąg LatLng opisujący przebieg tego kroku. Jest 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óży użyty w tym kroku. |
distance optional |
Typ:
Distance optional Dystans pokonany w tym kroku. Ta właściwość może mieć wartość undefined , ponieważ odległość może być nieznana. |
duration optional |
Typ:
Duration optional Typowy czas potrzebny na wykonanie tego kroku w sekundach i w formie tekstowej. Ta właściwość może mieć wartość undefined , ponieważ czas trwania może być nieznany. |
|
Typ:
DirectionsPolyline optional Zawiera obiekt z jedną właściwością „points”, która zawiera zakodowaną linię łamaną reprezentującą krok. Linia ta jest przybliżoną (wygładzoną) ścieżką kroku. |
steps optional |
Typ:
Array<DirectionsStep> optional Podkroki tego kroku. Określone dla odcinków tras transportu publicznego, które nie są odcinkami transportu publicznego. |
transit optional |
Typ:
TransitDetails optional Szczegóły dotyczące tego etapu w przypadku transportu publicznego. Ta właściwość będzie niezdefiniowana, chyba że tryb podróży w tym kroku to TRANSIT . |
transit_details optional |
Typ:
TransitDetails optional Szczegóły dotyczące tego kroku, jeśli tryb podróży to TRANSIT . |
Interfejs DirectionsPolyline
google.maps.DirectionsPolyline
interfejs
Obiekt zawierający właściwość points
opisującą linię łamaną DirectionsStep
.
Właściwości | |
---|---|
points |
Typ:
string |
Interfejs Place
google.maps.Place
interfejs
Zawiera informacje potrzebne do zlokalizowania, zidentyfikowania lub opisania miejsca dla DirectionsRequest
lub DistanceMatrixRequest
. W tym kontekście „miejsce” oznacza firmę, ciekawe miejsce lub lokalizację geograficzną. Informacje o pobieraniu informacji o miejscu znajdziesz w sekcji 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 niepowtarzalny identyfikator miejsca w bazie danych Map Google. Pamiętaj, że placeId to najdokładniejszy sposób identyfikowania miejsca. Jeśli to możliwe, określ placeId zamiast query . Identyfikator miejsca można pobrać z dowolnego żądania do interfejsu Places API, np. z żądania 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: „Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW”. Jeśli to możliwe, określ placeId zamiast query . Interfejs API nie gwarantuje dokładności przekształcenia ciągu zapytania w miejsce. Jeśli podane są 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 parametrze DirectionsRequest
, oraz środki transportu zwracane w parametrze DirectionsStep
. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'BICYCLING'
lub google.maps.TravelMode.BICYCLING
.
Dostęp przez połączenie pod numer const {TravelMode} = await google.maps.importLibrary("routes")
.
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
BICYCLING |
Określa żądanie trasy rowerowej. |
DRIVING |
Określa żądanie trasy dojazdu. |
TRANSIT |
Określa żądanie wskazówek dojazdu transportem publicznym. |
WALKING |
Określa żądanie dotyczące trasy pieszej. |
DrivingOptions interfejs
google.maps.DrivingOptions
interfejs
Konfiguruje DirectionsRequest
, gdy tryb podróży jest ustawiony na DRIVING
.
Właściwości | |
---|---|
departureTime |
Typ:
Date Żądana godzina odjazdu na trasie określona jako obiekt Date . Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 r. Musi być określony, aby DrivingOptions był prawidłowy. Czas odjazdu musi być ustawiony na bieżący czas lub czas w przyszłości. Nie może przypadać w przeszłości. |
trafficModel optional |
Typ:
TrafficModel optional Preferowane założenie, które ma być używane podczas prognozowania czasu trwania w ruchu. Wartość domyślna to BEST_GUESS . |
TrafficModel stałe
google.maps.TrafficModel
stałe
Założenia, które należy uwzględnić podczas prognozowania czasu trwania w ruchu. Określony jako część DirectionsRequest
lub DistanceMatrixRequest
. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'bestguess'
lub google.maps.TrafficModel.BEST_GUESS
.
Dostęp przez połączenie pod numer const {TrafficModel} = await google.maps.importLibrary("routes")
.
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
BEST_GUESS |
Korzystaj z historycznych danych o ruchu, aby jak najdokładniej oszacować czas spędzony w korku. |
OPTIMISTIC |
Używaj historycznych danych o ruchu, aby optymistycznie oszacować czas trwania w ruchu. |
PESSIMISTIC |
Użyj historycznych danych o ruchu, aby pesymistycznie oszacować czas trwania podróży w ruchu. |
TransitOptions interfejs
google.maps.TransitOptions
interfejs
Obiekt TransitOptions, który ma być uwzględniony w DirectionsRequest
, gdy tryb podróży jest ustawiony na TRANSIT.
Właściwości | |
---|---|
arrivalTime optional |
Typ:
Date optional Pożądana godzina przyjazdu na trasie określona jako obiekt Date. Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 r. Jeśli określono czas przyjazdu, czas odjazdu jest ignorowany. |
departureTime optional |
Typ:
Date optional Żądana godzina odjazdu na trasie określona jako obiekt Date. Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 r. Jeśli nie podano ani godziny odjazdu, ani godziny przyjazdu, przyjmuje się, że jest to „teraz”. |
modes optional |
Typ:
Array<TransitMode> optional co najmniej jeden preferowany środek transportu publicznego, np. autobus lub pociąg; Jeśli nie podano preferencji, interfejs API zwraca domyślną najlepszą trasę. |
routingPreference optional |
Typ:
TransitRoutePreference optional Preferencja, która może wpływać na wybór trasy transportu publicznego, np. mniejsza odległość do przejścia pieszo. Jeśli nie podano preferencji, interfejs API zwraca domyślną najlepszą trasę. |
TransitMode stałe
google.maps.TransitMode
stałe
Prawidłowy środek transportu, np. autobus, który można określić w TransitOptions
. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'BUS'
lub google.maps.TransitMode.BUS
.
Dostęp przez połączenie pod numer const {TransitMode} = await google.maps.importLibrary("routes")
.
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
BUS |
Określa autobus jako preferowany środek transportu publicznego. |
RAIL |
Określa kolej jako preferowany środek transportu. |
SUBWAY |
Określa metro jako preferowany środek transportu publicznego. |
TRAIN |
Określa pociąg jako preferowany środek transportu publicznego. |
TRAM |
Określa tramwaj jako preferowany środek transportu publicznego. |
Stałe TransitRoutePreference
google.maps.TransitRoutePreference
stałe
Prawidłowy typ trasy transportu publicznego, który można określić w TransitOptions
. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'LESS_WALKING'
lub google.maps.TransitRoutePreference.LESS_WALKING
.
Dostęp przez połączenie pod numer const {TransitRoutePreference} = await google.maps.importLibrary("routes")
.
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
FEWER_TRANSFERS |
Określa, że obliczona trasa powinna mieć ograniczoną liczbę przesiadek. |
LESS_WALKING |
Określa, że obliczona trasa powinna wymagać ograniczonej ilości chodzenia. |
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. |
text |
Typ:
string Wartość opłaty za przejazd wyrażona w currency jako ciąg znaków. |
value |
Typ:
number Wartość liczbowa opłaty za przejazd wyrażona w podanej currency . |
TransitDetails interfejs
google.maps.TransitDetails
interfejs
Szczegóły dotyczące odjazdu, przyjazdu i środka transportu użytego na tym etapie.
Właściwości | |
---|---|
arrival_stop |
Typ:
TransitStop Przystanek docelowy tego etapu transportu publicznego. |
arrival_time |
Typ:
Time Czas przybycia na tym etapie określony jako obiekt Time. |
departure_stop |
Typ:
TransitStop Przystanek początkowy tego etapu transportu publicznego. |
departure_time |
Typ:
Time Godzina odjazdu na tym etapie określona jako obiekt Time. |
headsign |
Typ:
string Kierunek, w którym należy podróżować na tej linii, zgodnie z oznaczeniem na pojeździe lub na przystanku początkowym. |
headway |
Typ:
number Oczekiwana liczba sekund między równoważnymi pojazdami na tym przystanku. |
line |
Typ:
TransitLine Szczegóły dotyczące linii transportu publicznego 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 wyświetlany w rozkładach jazdy i na tablicach informacyjnych, który identyfikuje przejazd środkami transportu publicznego dla pasażerów, np. numery pociągów w przypadku przejazdów koleją podmiejską. Tekst jednoznacznie identyfikuje przejazd w ramach dnia obsługi. |
TransitStop interfejs
google.maps.TransitStop
interfejs
Szczegóły przystanku lub stacji.
Właściwości | |
---|---|
location |
Typ:
LatLng Lokalizacja tego przystanku. |
name |
Typ:
string Nazwa tego przystanku. |
TransitLine interfejs
google.maps.TransitLine
interfejs
Informacje o linii transportu publicznego, która obsługuje ten etap podróży.
Właściwości | |
---|---|
agencies |
Typ:
Array<TransitAgency> Przewoźnik obsługujący tę linię transportu publicznego. |
color |
Typ:
string Kolor powszechnie używany na znakach tej linii transportu publicznego, reprezentowany jako ciąg szesnastkowy. |
icon |
Typ:
string Adres URL ikony powiązanej z tym wierszem. |
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 powszechnie używany na znakach informacyjnych tej linii transportu publicznego, przedstawiony jako ciąg szesnastkowy. |
url |
Typ:
string Adres URL agencji, który jest specyficzny dla tej linii transportu publicznego. |
vehicle |
Typ:
TransitVehicle Rodzaj używanego pojazdu, np. pociąg lub autobus. |
Interfejs TransitAgency
google.maps.TransitAgency
interfejs
Informacje o agencji, która obsługuje linię transportu publicznego.
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. |
TransitVehicle interfejs
google.maps.TransitVehicle
interfejs
Informacje o pojeździe, który kursuje na linii transportu publicznego.
Właściwości | |
---|---|
icon |
Typ:
string Adres URL ikony odpowiadającej typowi pojazdu używanego na tej linii. |
local_icon |
Typ:
string Adres URL ikony, która odpowiada typowi pojazdu używanego w tym regionie, zamiast bardziej ogólnej ikony. |
name |
Typ:
string Nazwa tego typu TransitVehicle, np. „Pociąg” lub „Autobus”. |
type |
Typ:
VehicleType rodzaj używanego 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 pod numer const {VehicleType} = await google.maps.importLibrary("routes")
.
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
BUS |
autobus. |
CABLE_CAR |
Pojazd poruszający się po kablu, zwykle po ziemi. Koleje linowe mogą być typu GONDOLA_LIFT . |
COMMUTER_TRAIN |
Kolej podmiejska. |
FERRY |
promem, |
FUNICULAR |
Pojazd wciągany na strome wzniesienie za pomocą liny. |
GONDOLA_LIFT |
kolejka gondolowa, |
HEAVY_RAIL |
Kolej dużych prędkości. |
HIGH_SPEED_TRAIN |
Pociąg szybkobieżny. |
INTERCITY_BUS |
Autobus dalekobieżny. |
METRO_RAIL |
Kolej miejska. |
MONORAIL |
kolej jednoszynowa, |
OTHER |
Inne pojazdy. |
RAIL |
kolejową, |
SHARE_TAXI |
Taksówka współdzielona to rodzaj transportu autobusowego z możliwością wysadzania i zabierania pasażerów w dowolnym miejscu na trasie. Taksówki wspólne zwykle korzystają z minibusów. |
SUBWAY |
Podziemna kolej miejska. |
TRAM |
Kolej miejska naziemna. |
TROLLEYBUS |
Trolejbus. |
Stałe UnitSystem
google.maps.UnitSystem
stałe
Prawidłowe systemy jednostek, które można określić w DirectionsRequest
.
Dostęp przez połączenie pod numer const {UnitSystem} = await google.maps.importLibrary("core")
.
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
---|---|
IMPERIAL |
Określa, że odległości w DirectionsResult powinny być wyrażone w jednostkach imperialnych. |
METRIC |
Określa, że odległości w DirectionsResult powinny być wyrażone w jednostkach metrycznych. |
Interfejs Distance
google.maps.Distance
interfejs
Reprezentacja odległości jako wartości liczbowej i ciągu znaków do wyświetlania.
Właściwości | |
---|---|
text |
Typ:
string Ciąg znaków reprezentujący wartość odległości, w jednostkach UnitSystem określonych w żądaniu. |
value |
Typ:
number Odległość w metrach. |
Duration interfejs
google.maps.Duration
interfejs
Reprezentacja czasu trwania jako wartości liczbowej i ciągu znaków do wyświetlania.
Właściwości | |
---|---|
text |
Typ:
string Ciąg znaków reprezentujący wartość czasu trwania. |
value |
Typ:
number Czas trwania w sekundach. |
Interfejs Time
google.maps.Time
interfejs
Reprezentacja czasu jako obiektu Date, zlokalizowanego ciągu znaków i strefy czasowej.
Właściwości | |
---|---|
text |
Typ:
string Ciąg znaków reprezentujący wartość czasu. Godzina jest wyświetlana 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 Godzina odjazdu lub przyjazdu podana jako obiekt JavaScript Date. |
Stałe DirectionsTravelMode
google.maps.DirectionsTravelMode
stałe
Stałe DirectionsUnitSystem
google.maps.DirectionsUnitSystem
stałe