Directions

Klasa DirectionsService

google.maps.DirectionsService zajęcia

Usługa obliczania wskazówek dojazdu między co najmniej 2 miejscami.

Aby uzyskać dostęp, zadzwoń pod numer const {DirectionsService} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

DirectionsService
DirectionsService()
Parametry: brak
Tworzy nową instancję obiektu DirectionsService, która wysyła zapytania o trasę do serwerów Google.
route
route(request[, callback])
Parametry: 
Wartość zwrotu:  Promise<DirectionsResult>
Wyślij żądanie wyszukiwania wskazówek dojazdu.

Interfejs DirectionsRequest

google.maps.DirectionsRequest interfejs

Zapytanie o trasę dojazdu do: DirectionsService.

destination
Typ:  string|LatLng|Place|LatLngLiteral
Lokalizacja miejsca docelowego. Wartość tę można podać w postaci ciągu znaków do geokodowania, pola LatLng lub Place. To pole jest wymagane.
origin
Typ:  string|LatLng|Place|LatLngLiteral
Lokalizacja pochodzenia. Wartość tę można podać w postaci ciągu znaków do geokodowania, pola LatLng lub Place. To pole jest wymagane.
travelMode
Typ:  TravelMode
Żądany typ routingu. To pole jest wymagane.
avoidFerries optional
Typ:  boolean optional
Jeśli true, instruuje usługę Direction, aby w miarę możliwości unikała przepraw promowych. Opcjonalnie.
avoidHighways optional
Typ:  boolean optional
Jeśli true, instruuje usługę Trasa dojazdu, by w miarę możliwości unikała autostrad. Opcjonalnie.
avoidTolls optional
Typ:  boolean optional
Jeśli true, usługa Wyznacz trasę dojazdu, by w miarę możliwości unikała dróg płatnych. Opcjonalnie.
drivingOptions optional
Typ:  DrivingOptions optional
Ustawienia, które mają zastosowanie tylko do żądań, w których travelMode to DRIVING. Ten obiekt nie ma wpływu na inne środki transportu.
language optional
Typ:  string optional
Identyfikator języka, w którym powinny być zwracane wyniki, jeśli to możliwe. Zobacz listę obsługiwanych języków.
optimizeWaypoints optional
Typ:  boolean optional
Jeśli zasada ma wartość true, DirectionsService spróbuje zmienić kolejność dostarczonych pośrednich punktów pośrednich, aby zminimalizować całkowity koszt trasy. Jeśli punkty na trasie są zoptymalizowane, sprawdź DirectionsRoute.waypoint_order w odpowiedzi, aby określić nową kolejność.
provideRouteAlternatives optional
Typ:  boolean optional
Określa, czy należy podać alternatywną trasę. Opcjonalnie.
region optional
Typ:  string optional
Kod regionu używany do promowania żądań geokodowania. Kod regionu akceptuje dwuznaczną wartość ccTLD („domena najwyższego poziomu”). Większość kodów domen ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład domena ccTLD w Wielkiej Brytanii to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie oznacza to „Wielka Brytania i Irlandia Północna”).
transitOptions optional
Typ:  TransitOptions optional
Ustawienia, które mają zastosowanie tylko do żądań, w przypadku których travelMode to TRANSIT. Ten obiekt nie ma wpływu na inne środki transportu.
unitSystem optional
Typ:  UnitSystem optional
Domyślne:system jednostek używany w kraju pochodzenia.
Preferowany system jednostek do wyświetlania odległości.
waypoints optional
Typ:  Array<DirectionsWaypoint> optional
Tablica pośrednich punktów pośrednich. Wskazówki dojazdu są obliczane od miejsca wylotu do miejsca docelowego według poszczególnych punktów pośrednich w tej tablicy. Informacje o maksymalnej dozwolonej liczbie punktów pośrednich znajdziesz w przewodniku dla programistów. Punkty pośrednie nie są obsługiwane we wskazówkach dojazdu transportem publicznym. Opcjonalnie.

DirectionsStatus – wartości stałe

google.maps.DirectionsStatus stałe

Stan zwrócony przez DirectionsService po zakończeniu wywołania do route(). Określ je według wartości lub nazwy stałej. np. 'OK' lub google.maps.DirectionsStatus.OK.

Aby uzyskać dostęp, zadzwoń pod numer const {DirectionsStatus} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

INVALID_REQUEST Podana wartość DirectionsRequest jest nieprawidłowa.
MAX_WAYPOINTS_EXCEEDED DirectionsRequest zawiera zbyt wiele elementów DirectionsWaypoint. Informacje o maksymalnej dozwolonej liczbie punktów pośrednich znajdziesz w przewodniku dla programistów.
NOT_FOUND Nie udało się geokodować co najmniej jednego punktu wylotu, celu podróży lub punktu pośredniego.
OK Odpowiedź zawiera prawidłowy atrybut 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 wskazówek dojazdu z powodu błędu serwera. Jeśli spróbujesz ponownie, żądanie może się powieść.
ZERO_RESULTS Nie znaleziono trasy między miejscem wylotu a celem podróży.

Interfejs DirectionsResult

google.maps.DirectionsResult interfejs

Odpowiedź dotycząca wskazówek dojazdu została pobrana z serwera wskazówek dojazdu. Możesz wyrenderować je za pomocą DirectionsRenderer lub przeanalizować ten obiekt i wyrenderować go samodzielnie. Musisz wyświetlać ostrzeżenia i informacje o prawach autorskich zgodnie z Warunkami korzystania z usługi Google Maps Platform. Pamiętaj, że chociaż ten wynik jest „podobny do JSON”, nie jest to tylko kod JSON, ponieważ pośrednio zawiera obiekty LatLng.

request
Żądanie DirectionsRequest, które zwróciło ten wynik.
routes
Tablica elementów DirectionsRoute, z których każdy zawiera informacje o etapach i krokach, z których się składa. Będzie tylko 1 trasa, chyba że DirectionsRequest to trasa, której provideRouteAlternatives ustawiono na: true.
available_travel_modes optional
Typ:  Array<TravelMode> optional
Tablica dostępnych środków transportu. To pole jest zwracane, gdy żądanie określa tryb podróży i nie uzyskuje żadnych wyników. Tablica zawiera informacje o środkach transportu dostępnych w krajach objętych danym zestawem punktów na trasie. To pole nie jest zwracane, jeśli co najmniej jeden punkt na trasie jest „przez punkty na trasie”.
geocoded_waypoints optional
Tablica elementów DirectionsGeocodedWaypoint, z których każdy zawiera informacje o geokodowaniu punktu początkowego, docelowego i punktu pośredniego.

Klasa DirectionsRenderer

google.maps.DirectionsRenderer zajęcia

Renderuje wskazówki dojazdu uzyskane z drogi DirectionsService.

Te zajęcia są rozszerzone na MVCObject.

Aby uzyskać dostęp, zadzwoń pod numer const {DirectionsRenderer} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

DirectionsRenderer
DirectionsRenderer([opts])
Parametry: 
Tworzy mechanizm renderowania z podanymi opcjami. Wskazówki dojazdu mogą być renderowane na mapie (jako nakładki wizualne) lub dodatkowo na panelu <div> (jako instrukcje tekstowe).
getDirections
getDirections()
Parametry: brak
Wartość zwrotu:  DirectionsResult
Zwraca bieżący zestaw kierunków mechanizmu renderowania.
getMap
getMap()
Parametry: brak
Wartość zwrotu:  Map
Zwraca mapę, na której renderowany jest element DirectionsResult.
getPanel
getPanel()
Parametry: brak
Wartość zwrotu:  HTMLElement|null
Zwraca panel <div>, w którym renderowany jest element DirectionsResult.
getRouteIndex
getRouteIndex()
Parametry: brak
Wartość zwrotu:  number
Zwraca bieżący (liczony od zera) indeks trasy używany przez ten obiekt DirectionsRenderer.
setDirections
setDirections(directions)
Parametry: 
Zwracana wartość: brak
Ustaw mechanizm renderowania tak, aby używał wyniku z DirectionsService. Ustawienie prawidłowego zestawu wskazówek w ten sposób spowoduje ich wyświetlenie na wyznaczonej mapie i panelu mechanizmu renderowania.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
Ta metoda określa mapę, na której będą renderowane wskazówki dojazdu. Aby usunąć trasę z mapy, miń null.
setOptions
setOptions(options)
Parametry: 
Zwracana wartość: brak
Po zainicjowaniu tego urządzenia DirectionsRenderer zmień ustawienia opcji.
setPanel
setPanel(panel)
Parametry: 
Zwracana wartość: brak
Ta metoda renderuje wskazówki dojazdu w polu <div>. Przekaż null, aby usunąć treść z panelu.
setRouteIndex
setRouteIndex(routeIndex)
Parametry: 
  • routeIndexnumber
Zwracana wartość: brak
Ustaw indeks trasy (liczony od zera) do renderowania w obiekcie DirectionsResult. Domyślnie renderowana jest pierwsza trasa w tablicy.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
Argumenty: brak
Zdarzenie to jest wywoływane, gdy zmieniają się renderowane wskazówki, czyli gdy ustawiony jest nowy element DirectionsResult lub gdy użytkownik zakończy przeciąganie zmiany na ścieżkę wskazówek.

Interfejs DirectionsRendererOptions

google.maps.DirectionsRendererOptions interfejs

Ten obiekt określa właściwości, które można ustawić w obiekcie DirectionsRenderer.

directions optional
Typ:  DirectionsResult optional
Wskazówki dojazdu do wyświetlenia na mapie lub w panelu <div>, pobrane jako obiekt DirectionsResult z DirectionsService.
draggable optional
Typ:  boolean optional
Jeśli true, umożliwia użytkownikowi przeciąganie i modyfikowanie ścieżek tras renderowanych przez ten element DirectionsRenderer.
hideRouteList optional
Typ:  boolean optional
Wartość domyślna: false
Ta właściwość wskazuje, czy mechanizm renderowania powinien udostępniać listę tras wyświetlanych w panelu wskazówek, którą może wybrać użytkownik.
infoWindow optional
Typ:  InfoWindow optional
Pole InfoWindow, w którym są renderowane informacje tekstowe po kliknięciu znacznika. Zawartość okna informacyjnego zostanie zastąpiona, a jej położenie zostanie przeniesione. Jeśli nie podasz żadnego okna informacyjnego, DirectionsRenderer utworzy własne okno informacyjne i będzie z niego korzystać. Ta właściwość będzie ignorowana, jeśli suppressInfoWindows ma wartość 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. Z tych opcji będą korzystać wszystkie znaczniki renderowane przez: DirectionsRenderer.
panel optional
Typ:  HTMLElement optional
Pole <div>, w którym wyświetlane są wskazówki dojazdu.
polylineOptions optional
Typ:  PolylineOptions optional
Opcje linii łamanych. Wszystkie linie łamane renderowane przez obiekt DirectionsRenderer będą korzystać z tych opcji.
preserveViewport optional
Typ:  boolean optional
Wartość domyślna: false
Jeśli ta opcja jest ustawiona na true lub nie ustawiono środkowego i powiększenia mapy, mapa wejściowa jest wyśrodkowana i powiększona zgodnie z ramką ograniczającą ten zestaw wskazówek dojazdu.
routeIndex optional
Typ:  number optional
Indeks trasy w obiekcie DirectionsResult. Wartość domyślna to 0.
suppressBicyclingLayer optional
Typ:  boolean optional
Blokuj renderowanie tekstu BicyclingLayer, gdy wymagane jest wskazówki dojazdu rowerem.
suppressInfoWindows optional
Typ:  boolean optional
Ogranicz renderowanie okien informacyjnych.
suppressMarkers optional
Typ:  boolean optional
Ogranicz renderowanie znaczników.
suppressPolylines optional
Typ:  boolean optional
Ogranicz renderowanie linii łamanych.

Interfejs DirectionsWaypoint

google.maps.DirectionsWaypoint interfejs

DirectionsWaypoint określa lokalizację między miejscem wylotu a celem podróży, przez który ma być trasa.

location optional
Typ:  string|LatLng|LatLngLiteral|Place optional
Lokalizacja punktu pośredniego. Może to być ciąg adresu, LatLng lub Place. Opcjonalnie.
stopover optional
Typ:  boolean optional
Wartość domyślna: true
Jeśli true, wskazuje, że ten punkt pośredni jest przystankiem między miejscem wylotu a celem podróży. W ten sposób powstaje droga podzielona na dwie części. Jeśli false, wskazuje, że trasa powinna być promowana, aby przejść przez ten punkt na trasie, ale nie zostać podzielona na dwie części. Jest to przydatne, gdy chcesz tworzyć trasę na podstawie przeciągania przez użytkownika punktów pośrednich na mapie.

Interfejs DirectionsGeocodedWaypoint

google.maps.DirectionsGeocodedWaypoint interfejs

Pojedynczy geokodowany punkt na trasie.

partial_match optional
Typ:  boolean optional
Wskazuje, czy geokoder nie zwrócił dokładnego dopasowania do pierwotnego punktu pośredniego, mimo że udało się dopasować część żądanego adresu.
place_id optional
Typ:  string optional
Identyfikator miejsca powiązany z punktem na trasie. Identyfikatory miejsc jednoznacznie identyfikują dane miejsce w bazie danych Miejsc Google i w Mapach Google. Więcej informacji na temat identyfikatorów miejsc znajdziesz w przewodniku dla programistów interfejsu Places API.
types optional
Typ:  Array<string> optional
Tablica ciągów oznaczających typ zwróconego geokodowanego elementu. Listę możliwych ciągów znaków znajdziesz w sekcji Typy komponentów adresu w przewodniku dla programistów.

Interfejs DirectionsRoute

google.maps.DirectionsRoute interfejs

Pojedyncza trasa składająca się z takich odcinków – DirectionsResult. Pamiętaj, że chociaż ten obiekt jest typu „JSON”, nie jest to tylko format JSON, ponieważ bezpośrednio i pośrednio zawiera obiekty LatLng.

bounds
Granice tej trasy.
copyrights
Typ:  string
Tekst dotyczący praw autorskich do wyświetlenia na tej trasie.
legs
Tablica elementów DirectionsLeg, z których każdy zawiera informacje o krokach, z których się składa. Każdy określony punkt pośredni lub cel podróży będzie mieć jeden etap. Oznacza to, że trasa bez punktów pośrednich będzie zawierać jeden punkt pośredni DirectionsLeg, a trasa z jednym punktem pośrednim będzie zawierać dwa.
overview_path
Typ:  Array<LatLng>
Tablica LatLng reprezentująca 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 (takich jak adresy URL statycznego interfejsu API Map Google).
overview_polyline
Typ:  string
Zakodowana linia łamana trasy w parametrze review_path. Ta linia łamana to przybliżona (wygładzona) ścieżka powstałych kierunków.
summary
Typ:  string
Zawiera krótki opis trasy, odpowiedni do nadania nazwy i odróżnienia trasy od alternatywnych rozwiązań.
warnings
Typ:  Array<string>
Ostrzeżenia, które będą wyświetlane podczas wskazywania tych wskazówek.
waypoint_order
Typ:  Array<number>
Jeśli zasada optimizeWaypoints ma wartość true, to pole zawiera nową uporządkowaną permutację wejściowych punktów pośrednich. Jeśli dane wejściowe to na przykład:
Pochodzenie: Los Angeles
Waypoints: Dallas, Bangor, Phoenix
Miejsce docelowe: Nowy Jork
, a dane wyjściowe zoptymalizowane zostały uporządkowane w następujący sposób:
Pochodzenie: Los Angeles
Waypoints: Phoenix, Dallas, Bangor
Miejsce docelowe: Nowy Jork
, to pole będzie zawierało Array zawierające wartości [2] Pamiętaj, że numeracja punktów na drodze jest liczona od zera.
Jeśli dowolny z wejściowych punktów na trasie ma wartość stopover ustawioną na false, to pole jest puste, ponieważ optymalizacja trasy jest niedostępna w przypadku takich zapytań.
fare optional
Typ:  TransitFare optional
Łączna cena za całą podróż. Dotyczy tylko próśb o transport.

Interfejs DirectionsLeg

google.maps.DirectionsLeg interfejs

Pojedynczy etap składający się z zestawu kroków w elemencie DirectionsResult. Niektóre pola w danym etapie mogą nie zostać zwrócone w przypadku niektórych żądań. Pamiętaj, że chociaż ten wynik jest „podobny do JSON”, nie jest to tylko format JSON, ponieważ bezpośrednio i pośrednio zawiera obiekty LatLng.

end_address
Typ:  string
Adres miejsca docelowego tego etapu. Treść powinna być odczytywana w niezmienionej formie. Nie analizuj automatycznie sformatowanego adresu.
end_location
Typ:  LatLng
DirectionsService oblicza wskazówki dojazdu między lokalizacjami, korzystając z najbliższej opcji transportu (zwykle drogi) na początku i na końcu lokalizacji. end_location wskazuje miejsce docelowe oznaczone geokodem. Może się ono różnić od wartości end_location ostatniego kroku, jeśli na przykład droga nie znajduje się w pobliżu miejsca docelowego tego etapu.
start_address
Typ:  string
Adres początkowy tego etapu. Treść powinna być odczytywana w niezmienionej formie. Nie analizuj automatycznie sformatowanego adresu.
start_location
Typ:  LatLng
DirectionsService oblicza wskazówki dojazdu między lokalizacjami, korzystając z najbliższej opcji transportu (zwykle drogi) na początku i na końcu lokalizacji. start_location wskazuje rzeczywiste pochodzenie geokodowane. Może się on różnić od wartości start_location pierwszego kroku, jeśli na przykład droga nie znajduje się w pobliżu rozpoczęcia tego etapu.
steps
Tablica DirectionsStep, z których każdy zawiera informacje o poszczególnych krokach w danej części.
traffic_speed_entry
Typ:  Array<?>
Informacje o prędkości na drodze.
via_waypoints
Typ:  Array<LatLng>
Tablica punktów pośrednich na tym odcinku bez przesiadek, które zostały określone w pierwotnym żądaniu.

Wycofane w alternatywnych trasach. Wersja 3.27 będzie ostatnią wersją interfejsu API, która dodaje via_waypoints w trasach alternatywnych.

Gdy korzystasz z usługi Trasa dojazdu do implementacji wskazówek, które można przeciągać, zalecamy wyłączenie przeciągania tras alternatywnych. Przeciągać powinna być tylko trasa główna. Użytkownicy mogą przeciągać główną trasę, tak aby pasowała do trasy alternatywnej.

arrival_time optional
Typ:  Time optional
Szacowany czas dotarcia na ten etap. Dotyczy tylko żądań TRANSIT.
departure_time optional
Typ:  Time optional
Szacowany czas odjazdu na tym etapie. Dotyczy tylko żądań TRANSIT.
distance optional
Typ:  Distance optional
Całkowity dystans pokonany przez ten etap. Ta właściwość może być nieokreślona, ponieważ odległość może być nieznana.
duration optional
Typ:  Duration optional
Całkowity czas trwania tego etapu. Właściwość może mieć wartość undefined, ponieważ czas trwania może być nieznany.
duration_in_traffic optional
Typ:  Duration optional
Łączny czas trwania tego etapu z uwzględnieniem warunków na drodze wskazanych przez właściwość trafficModel. Właściwość może mieć wartość undefined, ponieważ czas trwania może być nieznany.

Interfejs DirectionsStep

google.maps.DirectionsStep interfejs

Pojedynczy DirectionsStep w DirectionsResult. Niektóre pola mogą mieć wartość undefined. Pamiętaj, że chociaż jest to obiekt typu „JSON”, nie jest to tylko format JSON, ponieważ bezpośrednio zawiera obiekty LatLng.

encoded_lat_lngs
Typ:  string
Zakodowana linia łamana kroku. To przybliżona (wygładzona) ścieżka kroku.
end_location
Typ:  LatLng
Lokalizacja końcowa tego kroku.
end_point
Typ:  LatLng
Lokalizacja końcowa tego kroku.
instructions
Typ:  string
Instrukcje dotyczące tego kroku
lat_lngs
Typ:  Array<LatLng>
Sekwencja LatLng opisująca przebieg tego kroku. To przybliżona (wygładzona) ścieżka kroku.
maneuver
Typ:  string
Zawiera działanie do wykonania 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
Typ:  Array<LatLng>
Sekwencja LatLng opisująca przebieg tego kroku. To przybliżona (wygładzona) ścieżka kroku.
start_location
Typ:  LatLng
Lokalizacja początkowa tego kroku.
start_point
Typ:  LatLng
Lokalizacja początkowa tego kroku.
travel_mode
Typ:  TravelMode
Środki transportu użyte w tym kroku.
distance optional
Typ:  Distance optional
Dystans pokonany w ramach tego kroku. Właściwość może wskazywać 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. Właściwość może mieć wartość undefined, ponieważ czas trwania może być nieznany.
polyline optional
Typ:  DirectionsPolyline optional
Zawiera obiekt o pojedynczej właściwości – „points”, który zawiera zakodowaną linię łamaną reprezentującą krok. Ta linia łamana to przybliżona (wygładzona) ścieżka kroku.
steps optional
Typ:  Array<DirectionsStep> optional
Kroki podrzędne tego kroku. Określany dla odcinków tras transportu publicznego nieprzeznaczonych do transportu publicznego.
transit optional
Typ:  TransitDetails optional
Informacje o tym kroku związane z transportem publicznym. Ta właściwość będzie nieokreślona, 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 służącą do opisania linii łamanej elementu DirectionsStep.

points
Typ:  string

Interfejs Place

google.maps.Place interfejs

Zawiera informacje potrzebne do znalezienia, zidentyfikowania lub opisania miejsca dla: DirectionsRequest lub DistanceMatrixRequest. W tym kontekście „miejsce” oznacza firmę, ciekawe miejsce lub lokalizację geograficzną. Aby pobrać informacje o miejscu, zobacz PlacesService.

location optional
Typ:  LatLng|LatLngLiteral optional
LatLng podmiotu opisanego przez to miejsce.
placeId optional
Typ:  string optional
Identyfikator miejsca (np. firmy lub ciekawego miejsca). 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, podaj placeId zamiast query. Identyfikator miejsca można pobrać z dowolnego żądania wysyłanego do interfejsu Places API, np. TextSearch. Identyfikatory miejsc można też pobierać z żądań wysyłanych do interfejsu Geocoding API. Więcej informacji znajdziesz w omówieniu identyfikatorów miejsc.
query optional
Typ:  string optional
Zapytanie opisujące miejsce (np. firmę lub ciekawe miejsce). Przykładowe zapytanie to „Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW”. Jeśli to możliwe, podaj placeId zamiast query. Interfejs API nie gwarantuje poprawności rozpoznania ciągu zapytania w konkretnym miejscu. Jeśli podasz zarówno placeId, jak i query, wystąpi błąd.

TravelMode, wartości stałe

google.maps.TravelMode stałe

Prawidłowe środki transportu, które można określić w polu DirectionsRequest, oraz środki transportu zwrócone w polu DirectionsStep. Określ je według wartości lub nazwy stałej. np. 'BICYCLING' lub google.maps.TravelMode.BICYCLING.

Aby uzyskać dostęp, zadzwoń pod numer const {TravelMode} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

BICYCLING Określa żądanie wskazówek dojazdu rowerem.
DRIVING Określa żądanie wskazówek dojazdu.
TRANSIT Określa żądanie wskazówek dojazdu transportem publicznym.
WALKING Określa prośbę o trasę pieszą.

Interfejs DrivingOptions

google.maps.DrivingOptions interfejs

Konfiguruje DirectionsRequest, gdy tryb podróży jest ustawiony na DRIVING.

departureTime
Typ:  Date
Żądany czas odjazdu na trasie, określony jako obiekt Date. Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 roku. Ta wartość musi być określona, aby DrivingOptions była poprawna. Godzina odjazdu musi przypadać na godzinę bieżącą lub godzinę w przyszłości. Nie może przypadać w przeszłości.
trafficModel optional
Typ:  TrafficModel optional
Preferowane założenie przy przewidywaniu czasu trwania natężenia ruchu. Wartość domyślna to BEST_GUESS.

Stałe TrafficModel

google.maps.TrafficModel stałe

Założenia używane przy prognozowaniu czasu trwania natężenia ruchu. Określana jako część DirectionsRequest lub DistanceMatrixRequest. Określ je według wartości lub nazwy stałej. np. 'bestguess' lub google.maps.TrafficModel.BEST_GUESS.

Aby uzyskać dostęp, zadzwoń pod numer const {TrafficModel} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

BEST_GUESS Użyj historycznych danych o natężeniu ruchu, aby jak najlepiej oszacować czas spędzany w ruchu.
OPTIMISTIC Na podstawie historycznych danych o ruchu możesz oszacować czas trwania tego ruchu w optymalny sposób.
PESSIMISTIC Na podstawie historycznych danych o ruchu wyznacz pesymistyczne oszacowanie czasu trwania ruchu.

Interfejs TransitOptions

google.maps.TransitOptions interfejs

Obiekt TransitOptions zostanie umieszczony w obiekcie DirectionsRequest, gdy tryb podróży jest ustawiony na TRANSIT.

arrivalTime optional
Typ:  Date optional
Żądany czas przyjazdu na trasie, określony jako obiekt Date. Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 roku. Jeśli podasz godzinę przyjazdu, zostanie ona zignorowana.
departureTime optional
Typ:  Date optional
Żądany czas odjazdu na trasie, określony jako obiekt Data. Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 roku. Jeśli nie podasz ani godziny wyjazdu, ani przyjazdu, przyjmuje się, że godzina jest „teraz”.
modes optional
Typ:  Array<TransitMode> optional
Co najmniej jeden preferowany środek transportu, np. autobus lub pociąg. Jeśli nie określisz preferencji, interfejs API zwróci domyślną najlepszą trasę.
routingPreference optional
Typ:  TransitRoutePreference optional
Ustawienie, które może zniechęcić do wyboru trasy dojazdu transportem publicznym, na przykład mniej chodzenia. Jeśli nie określisz 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 według wartości lub nazwy stałej. np. 'BUS' lub google.maps.TransitMode.BUS.

Aby uzyskać dostęp, zadzwoń pod numer const {TransitMode} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

BUS Określa autobus jako preferowany środek transportu.
RAIL Określa pociąg 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 określić w obiekcie TransitOptions. Określ je według wartości lub nazwy stałej. np. 'LESS_WALKING' lub google.maps.TransitRoutePreference.LESS_WALKING.

Aby uzyskać dostęp, zadzwoń pod numer const {TransitRoutePreference} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

FEWER_TRANSFERS Określa, że obliczona trasa powinna preferować ograniczoną liczbę przesiadek.
LESS_WALKING Określa, że obliczona trasa powinna preferować ograniczoną ilość ruchu.

Interfejs TransitFare

google.maps.TransitFare interfejs

Cena o wartości DirectionsRoute , zawierająca wartość i walutę.

currency
Typ:  string
Kod waluty w formacie ISO 4217 wskazujący walutę, w której podana jest cena.
value
Typ:  number
Wartość numeryczna ceny, wyrażona w polu currency.

Interfejs TransitDetails

google.maps.TransitDetails interfejs

Szczegóły dotyczące odjazdu, przyjazdu i środka transportu użyte w tym kroku.

arrival_stop
Przyjazd na tym etapie transportu publicznego.
arrival_time
Typ:  Time
Godzina przybycia tego kroku, określona jako obiekt Time.
departure_stop
Przystanek odjazdu z tego etapu transportu publicznego.
departure_time
Typ:  Time
Czas rozpoczęcia tego kroku, określony 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 odjazdu.
headway
Typ:  number
Oczekiwana liczba sekund między równoważnymi pojazdami na tym przystanku.
line
Informacje o linii transportu publicznego użytej w tym kroku.
num_stops
Typ:  number
Liczba przystanków na tym etapie. Obejmuje przystanek na przylot, ale nie przystanek odlotu.
trip_short_name
Typ:  string
Tekst pojawiający się w rozkładach jazdy i na tablicach informacyjnych do identyfikowania podróży transportem publicznym do pasażerów, na przykład w celu identyfikacji numerów pociągów w przypadku podróży pociągiem podmiejskim. Ten tekst jednoznacznie identyfikuje podróż w ramach dnia usługi.

Interfejs TransitStop

google.maps.TransitStop interfejs

Informacje o przystankach lub stacjach transportu publicznego.

location
Typ:  LatLng
Lokalizacja tego przystanku.
name
Typ:  string
Nazwa tego przystanku transportu publicznego.

Interfejs TransitLine

google.maps.TransitLine interfejs

Informacje o linii transportu publicznego, która obsługuje ten etap.

agencies
Przewoźnik, który obsługuje tę linię transportu publicznego.
color
Typ:  string
Kolor często używany na sygnalizacji świetlnej tej linii transportu publicznego, podawany w postaci ciągu szesnastkowego.
icon
Typ:  string
Adres URL ikony powiązanej z tą linią.
name
Typ:  string
Pełna nazwa tej linii transportu publicznego, np. „8 Alea Lokalna”.
short_name
Typ:  string
Krótka nazwa tej linii transportu publicznego, np. „E”.
text_color
Typ:  string
Kolor tekstu często używany w oznakowaniu tej linii transportu publicznego, podany jako ciąg szesnastkowy.
url
Typ:  string
Adres URL przewoźnika, który dotyczy tej linii transportu publicznego.
vehicle
Typ używanego pojazdu, np. pociąg lub autobus.

Interfejs TransitAgency

google.maps.TransitAgency interfejs

Informacje o przewoźniku obsługującym linię transportu publicznego.

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 poruszającym się na linii transportu publicznego.

icon
Typ:  string
Adres URL ikony odpowiadającej typowi pojazdu używanego na tej linii.
local_icon
Typ:  string
Adres URL ikony odpowiadającej typowi pojazdu używanego w tym regionie, a nie bardziej ogólnej.
name
Typ:  string
Nazwa tego typu pojazdu transportowego, np. „Pociąg” lub „Autobus”.
type
Rodzaj użytego pojazdu, np. pociąg, autobus lub prom.

VehicleType, stałe

google.maps.VehicleType stałe

Możliwe wartości typów pojazdów.

Aby uzyskać dostęp, zadzwoń pod numer const {VehicleType} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

BUS Autobus.
CABLE_CAR Pojazd na kablu, zazwyczaj znajdujący się na ziemi. Kolejki linowe mogą należeć do typu GONDOLA_LIFT.
COMMUTER_TRAIN Kolej podmiejska.
FERRY Promem
FUNICULAR Pojazd ciągnięty linią po stromym wzniesieniu.
GONDOLA_LIFT Kolejka linowa.
HEAVY_RAIL Ciężka kolej.
HIGH_SPEED_TRAIN Szybki pociąg.
INTERCITY_BUS Autobus dalekobieżny.
METRO_RAIL Kolej miejska.
MONORAIL Kolej jednoszynowa.
OTHER Inne pojazdy.
RAIL Kolej.
SHARE_TAXI Taksówka zbiorowa to rodzaj transportu autobusowego, który umożliwia zatrzymywanie i zabieranie pasażerów w dowolnym miejscu na trasie. Przeważnie taksówki zbiorowe korzystają z minibusów.
SUBWAY Podziemna kolejka.
TRAM Kolej linowa naziemna.
TROLLEYBUS Trolejbus.

UnitSystem

google.maps.UnitSystem stałe

Prawidłowe systemy jednostek, które można określić w obiekcie DirectionsRequest.

Aby uzyskać dostęp, zadzwoń pod numer const {UnitSystem} = await google.maps.importLibrary("core"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

IMPERIAL Określa, że odległości w DirectionsResult powinny być wyrażone w jednostkach imperialnych.
METRIC Określa, że odległości w polu DirectionsResult powinny być wyrażone w jednostkach metrycznych.

Interfejs odległości

google.maps.Distance interfejs

Reprezentacja odległości w postaci wartości liczbowej i wyświetlanego ciągu znaków.

text
Typ:  string
Ciąg znaków reprezentujący wartość odległości przy użyciu parametru UnitSystem określonego w żądaniu.
value
Typ:  number
Odległość w metrach.

Interfejs czasu trwania

google.maps.Duration interfejs

Reprezentacja czasu trwania w postaci wartości liczbowej i wyświetlanego ciągu znaków.

text
Typ:  string
Ciąg reprezentujący wartość czasu trwania.
value
Typ:  number
Czas trwania w sekundach.

Interfejs czasu

google.maps.Time interfejs

Reprezentacja godziny w postaci obiektu daty, zlokalizowanego ciągu znaków i strefy czasowej.

text
Typ:  string
Ciąg znaków reprezentujący wartość czasu. Godzina jest wyświetlana w strefie czasowej przystanku transportu publicznego.
time_zone
Typ:  string
Strefa czasowa, w której znajduje się ten przystanek. Ta wartość to nazwa strefy czasowej zdefiniowana w bazie danych stref czasowych IANA, np. „America/New_York”.
value
Typ:  Date
Godzina tego odjazdu lub przyjazdu określona jako obiekt daty w języku JavaScript.

Stałe DirectionsTravelMode

google.maps.DirectionsTravelMode stałe

DirectionsUnitSystem

google.maps.DirectionsUnitSystem stałe