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.DirectionsRequestinterfejs
Zapytanie o wskazówki dojazdu, które ma zostać wysłane do DirectionsService.
Właściwości | |
|---|---|
destination |
Typ:
string|LatLng|Place|LatLngLiteralLokalizacja miejsca docelowego. Może to być ciąg tekstowy do geokodowania, LatLng lub Place. Wymagane. |
origin |
Typ:
string|LatLng|Place|LatLngLiteralMiejsce pochodzenia. Może to być ciąg tekstowy do geokodowania, LatLng lub Place. Wymagane. |
travelMode |
Typ:
TravelModeRodzaj żądanego routingu. Wymagane. |
avoidFerries optional |
Typ:
boolean optionalJeśli true, usługa Wskazówki dojazdu będzie unikać przepraw promowych, gdy tylko będzie to możliwe. Opcjonalnie. |
avoidHighways optional |
Typ:
boolean optionalJeśli true, usługa Wskazówki dojazdu będzie w miarę możliwości omijać autostrady. Opcjonalnie. |
avoidTolls optional |
Typ:
boolean optionalJeśli true, usługa Wskazówki dojazdu będzie w miarę możliwości omijać drogi płatne. Opcjonalnie. |
drivingOptions optional |
Typ:
DrivingOptions optionalUstawienia, 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 optionalIdentyfikator 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 optionalJeś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 optionalOkreśla, czy należy podać alternatywne trasy. Opcjonalnie. |
region optional |
Typ:
string optionalKod 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 optionalUstawienia, 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 optionalDomyślne: system jednostek używany w kraju pochodzenia.
Preferowany układ jednostek do wyświetlania odległości. |
waypoints optional |
Typ:
Array<DirectionsWaypoint> optionalTablica 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.DirectionsResultinterfejs
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:
DirectionsRequestObiekt 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> optionalZawiera 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> optionalTablica 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ść:
DirectionsResultZwraca bieżący zestaw kierunków renderera. |
getMap |
getMap()Parametry: brak
Zwracana wartość:
MapZwraca mapę, na której renderowany jest element DirectionsResult. |
getPanel |
getPanel()Parametry: brak
Zwracana wartość:
HTMLElement|nullZwraca panel <div>, w którym renderowany jest element DirectionsResult. |
getRouteIndex |
getRouteIndex()Parametry: brak
Zwracana wartość:
numberZwraca 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.DirectionsRendererOptionsinterfejs
Ten obiekt określa właściwości, które można ustawić w obiekcie DirectionsRenderer.
Właściwości | |
|---|---|
directions optional |
Typ:
DirectionsResult optionalWskazówki dojazdu, które mają być wyświetlane na mapie lub w panelu <div>, pobrane jako obiekt DirectionsResult z DirectionsService. |
draggable optional |
Typ:
boolean optionalJeśli true, użytkownik może przeciągać i modyfikować ścieżki tras renderowanych przez ten DirectionsRenderer. |
hideRouteList optional |
Typ:
boolean optionalDomyślnie:
falseTa 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 optionalInfoWindow, 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 optionalMapa, na której mają być wyświetlane wskazówki dojazdu. |
markerOptions optional |
Typ:
MarkerOptions optionalOpcje 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 optionalOpcje polilinii. Wszystkie linie łamane renderowane przez DirectionsRenderer będą korzystać z tych opcji. |
preserveViewport optional |
Typ:
boolean optionalDomyślnie:
falseJeś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 optionalIndeks trasy w obiekcie DirectionsResult. Wartością domyślną jest 0. |
suppressBicyclingLayer optional |
Typ:
boolean optionalNie renderuj ikony BicyclingLayer, gdy użytkownik poprosi o wskazówki dojazdu rowerem. |
suppressInfoWindows optional |
Typ:
boolean optionalWyłącz renderowanie okien informacyjnych. |
suppressMarkers optional |
Typ:
boolean optionalBlokowanie renderowania znaczników. |
suppressPolylines optional |
Typ:
boolean optionalWyłącz renderowanie linii łamanych. |
DirectionsWaypoint interface
google.maps.DirectionsWaypointinterfejs
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 optionalLokalizacja punktu na trasie. Może to być ciąg znaków adresu, LatLng lub Place. Opcjonalnie. |
stopover optional |
Typ:
boolean optionalDomyślnie:
trueJeś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.DirectionsGeocodedWaypointinterfejs
Pojedynczy geokodowany punkt pośredni.
Właściwości | |
|---|---|
partial_match optional |
Typ:
boolean optionalCzy 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 optionalIdentyfikator 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> optionalTablica 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.DirectionsRouteinterfejs
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:
LatLngBoundsGranice tej trasy. |
copyrights |
Typ:
stringTekst 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:
stringZakodowana reprezentacja linii łamanej trasy w overview_path. Ta linia łamana to przybliżona (wygładzona) ścieżka wynikowych wskazówek. |
summary |
Typ:
stringZawiera 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.DirectionsLeginterfejs
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:
stringAdres 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:
LatLngDirectionsService 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:
stringAdres 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:
LatLngDirectionsService 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 optionalSzacowany czas przybycia na tym etapie. Dotyczy tylko żądań TRANSIT. |
departure_time optional |
Typ:
Time optionalSzacowany czas odjazdu z tego miejsca. Dotyczy tylko żądań TRANSIT. |
distance optional |
Typ:
Distance optionalCał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 optionalCał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 optionalCał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.DirectionsStepinterfejs
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:
stringZakodowana reprezentacja linii łamanej kroku. Jest to przybliżona (wygładzona) ścieżka kroku. |
end_location |
Typ:
LatLngLokalizacja końcowa tego kroku. |
|
Typ:
LatLngLokalizacja końcowa tego kroku. |
instructions |
Typ:
stringInstrukcje dotyczące tego kroku. |
|
Ciąg LatLng opisujący przebieg tego kroku. Jest to przybliżona (wygładzona) ścieżka kroku. |
maneuver |
Typ:
stringZawiera 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:
LatLngLokalizacja początkowa tego kroku. |
|
Typ:
LatLngLokalizacja początkowa tego kroku. |
travel_mode |
Typ:
TravelModeTryb podróży użyty w tym kroku. |
distance optional |
Typ:
Distance optionalDystans pokonany w tym kroku. Ta właściwość może mieć wartość undefined, ponieważ odległość może być nieznana. |
duration optional |
Typ:
Duration optionalTypowy 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 optionalZawiera 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> optionalPodkroki tego kroku. Określone dla odcinków tras transportu publicznego, które nie są odcinkami transportu publicznego. |
transit optional |
Typ:
TransitDetails optionalSzczegół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 optionalSzczegóły dotyczące tego kroku, jeśli tryb podróży to TRANSIT. |
Interfejs DirectionsPolyline
google.maps.DirectionsPolylineinterfejs
Obiekt zawierający właściwość points opisującą linię łamaną DirectionsStep.
Właściwości | |
|---|---|
points |
Typ:
string |
Interfejs Place
google.maps.Placeinterfejs
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 optionalLatLng elementu opisanego przez to miejsce. |
placeId optional |
Typ:
string optionalIdentyfikator 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 optionalZapytanie 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. |
|
Określa żądanie trasy dojazdu motocyklem. |
WALKING |
Określa żądanie dotyczące trasy pieszej. |
DrivingOptions interfejs
google.maps.DrivingOptionsinterfejs
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 optionalPreferowane 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.TransitOptionsinterfejs
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 optionalPożą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> optionalco 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 optionalPreferencja, 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. |
|
Określa tramwaj jako preferowany środek transportu. |
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.TransitFareinterfejs
Cena DirectionsRoute składająca się z wartości i waluty.
Właściwości | |
|---|---|
currency |
Typ:
stringKod waluty w formacie ISO 4217 wskazujący walutę, w której wyrażona jest cena. |
text |
Typ:
stringWartość opłaty za przejazd wyrażona w currency jako ciąg znaków. |
value |
Typ:
numberWartość liczbowa opłaty za przejazd wyrażona w podanej currency. |
TransitDetails interfejs
google.maps.TransitDetailsinterfejs
Szczegóły dotyczące odjazdu, przyjazdu i środka transportu użytego na tym etapie.
Właściwości | |
|---|---|
arrival_stop |
Typ:
TransitStopPrzystanek docelowy tego etapu transportu publicznego. |
arrival_time |
Typ:
TimeCzas przybycia na tym etapie określony jako obiekt Time. |
departure_stop |
Typ:
TransitStopPrzystanek początkowy tego etapu transportu publicznego. |
departure_time |
Typ:
TimeGodzina odjazdu na tym etapie określona jako obiekt Time. |
headsign |
Typ:
stringKierunek, w którym należy podróżować na tej linii, zgodnie z oznaczeniem na pojeździe lub na przystanku początkowym. |
headway |
Typ:
numberOczekiwana liczba sekund między równoważnymi pojazdami na tym przystanku. |
line |
Typ:
TransitLineSzczegóły dotyczące linii transportu publicznego użytej na tym etapie. |
num_stops |
Typ:
numberLiczba przystanków na tym etapie. Obejmuje przystanek docelowy, ale nie przystanek początkowy. |
trip_short_name |
Typ:
stringTekst 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.TransitStopinterfejs
Szczegóły przystanku lub stacji.
Właściwości | |
|---|---|
location |
Typ:
LatLngLokalizacja tego przystanku. |
name |
Typ:
stringNazwa tego przystanku. |
TransitLine interfejs
google.maps.TransitLineinterfejs
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:
stringKolor powszechnie używany na znakach tej linii transportu publicznego, reprezentowany jako ciąg szesnastkowy. |
icon |
Typ:
stringAdres URL ikony powiązanej z tym wierszem. |
name |
Typ:
stringPełna nazwa tej linii transportu publicznego, np. „8 Avenue Local”. |
short_name |
Typ:
stringKrótka nazwa tej linii transportu publicznego, np. „E”. |
text_color |
Typ:
stringKolor tekstu powszechnie używany na znakach informacyjnych tej linii transportu publicznego, przedstawiony jako ciąg szesnastkowy. |
url |
Typ:
stringAdres URL agencji, który jest specyficzny dla tej linii transportu publicznego. |
vehicle |
Typ:
TransitVehicleRodzaj używanego pojazdu, np. pociąg lub autobus. |
Interfejs TransitAgency
google.maps.TransitAgencyinterfejs
Informacje o agencji, która obsługuje linię transportu publicznego.
Właściwości | |
|---|---|
name |
Typ:
stringNazwa tego przewoźnika. |
phone |
Typ:
stringNumer telefonu przewoźnika. |
url |
Typ:
stringAdres URL przewoźnika. |
TransitVehicle interfejs
google.maps.TransitVehicleinterfejs
Informacje o pojeździe, który kursuje na linii transportu publicznego.
Właściwości | |
|---|---|
icon |
Typ:
stringAdres URL ikony odpowiadającej typowi pojazdu używanego na tej linii. |
local_icon |
Typ:
stringAdres URL ikony, która odpowiada typowi pojazdu używanego w tym regionie, zamiast bardziej ogólnej ikony. |
name |
Typ:
stringNazwa tego typu TransitVehicle, np. „Pociąg” lub „Autobus”. |
type |
Typ:
VehicleTyperodzaj 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.Distanceinterfejs
Reprezentacja odległości jako wartości liczbowej i ciągu znaków do wyświetlania.
Właściwości | |
|---|---|
text |
Typ:
stringCiąg znaków reprezentujący wartość odległości, w jednostkach UnitSystem określonych w żądaniu. |
value |
Typ:
numberOdległość w metrach. |
Duration interfejs
google.maps.Durationinterfejs
Reprezentacja czasu trwania jako wartości liczbowej i ciągu znaków do wyświetlania.
Właściwości | |
|---|---|
text |
Typ:
stringCiąg znaków reprezentujący wartość czasu trwania. |
value |
Typ:
numberCzas trwania w sekundach. |
Interfejs Time
google.maps.Timeinterfejs
Reprezentacja czasu jako obiektu Date, zlokalizowanego ciągu znaków i strefy czasowej.
Właściwości | |
|---|---|
text |
Typ:
stringCiąg znaków reprezentujący wartość czasu. Godzina jest wyświetlana w strefie czasowej przystanku. |
time_zone |
Typ:
stringStrefa 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:
DateGodzina odjazdu lub przyjazdu podana jako obiekt JavaScript Date. |
Stałe DirectionsTravelMode
google.maps.DirectionsTravelMode
stałe
Stałe DirectionsUnitSystem
google.maps.DirectionsUnitSystem
stałe