Directions (deprecated)

DirectionsService

google.maps.DirectionsService klasa
biblioteka "routes"

const {DirectionsService} = await google.maps.importLibrary("routes");
DirectionsService
DirectionsService()
Parametry: brak
Tworzy nową instancję DirectionsService, która wysyła zapytania o wskazówki dojazdu do serwerów Google.
route
route(request[, callback])
Parametry:
Wartość zwracana: Promise<DirectionsResult>
Wyślij żądanie wyszukiwania trasy.

Interfejs DirectionsRequest

Interfejs google.maps.DirectionsRequest

Zapytanie o trasę, które zostanie wysłane do DirectionsService.

destination
Lokalizacja miejsca docelowego. Można go określić jako ciąg znaków do geokodowania, LatLng lub Place. Wymagane.
origin
Lokalizacja pochodzenia. Można go określić jako ciąg znaków do geokodowania, LatLng lub Place. Wymagane.
travelMode
Typ żądanego routingu. Wymagane.
avoidFerries
opcjonalne
Typ: boolean optional
Jeśli ma wartość true, usługa wskazówek dojazdu będzie w miarę możliwości unikać promów. Opcjonalnie:
avoidHighways
opcjonalne
Typ: boolean optional
Jeśli ma wartość true, usługa Directions będzie w miarę możliwości unikać autostrad. Opcjonalnie:
avoidTolls
opcjonalne
Typ: boolean optional
Jeśli ma wartość true, usługa Directions będzie w miarę możliwości unikać dróg płatnych. Opcjonalnie:
drivingOptions
opcjonalne
Typ: DrivingOptions optional
Ustawienia, które mają zastosowanie tylko do żądań, w przypadku których travelMode to DRIVING. Ten obiekt nie będzie miał wpływu na inne środki transportu.
language
opcjonalne
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
opcjonalne
Typ: boolean optional
Jeśli ustawisz wartość true, DirectionsService spróbuje zmienić kolejność podanych pośrednich punktów orientacyjnych, 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
opcjonalne
Typ: boolean optional
Określa, czy mają być podawane alternatywne trasy. Opcjonalnie:
region
opcjonalne
Typ: string optional
Kod regionu używany jako preferencja w żądaniach 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 domena ccTLD Wielkiej Brytanii to „uk” (.co.uk), a jej kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”).
transitOptions
opcjonalne
Typ: TransitOptions optional
Ustawienia, które mają zastosowanie tylko do żądań, w których travelMode to TRANSIT. Ten obiekt nie będzie miał wpływu na inne środki transportu.
unitSystem
opcjonalne
Typ: UnitSystem optional
Domyślny: system jednostek używany w kraju pochodzenia.
Preferowany układ jednostek do wyświetlania odległości.
waypoints
opcjonalne
Typ: Array<DirectionsWaypoint> optional
Tablica punktów pośrednich. Wskazówki dojazdu są obliczane od miejsca początkowego do miejsca docelowego przez każdy punkt na 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:

Stałe DirectionsStatus

google.maps.DirectionsStatus stałe
biblioteka "routes"

Stan zwracany przez DirectionsService po zakończeniu wywołania route(). Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.DirectionsStatus.OK.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ DirectionsStatusString.

const {DirectionsStatus} = await google.maps.importLibrary("routes");
INVALID_REQUEST Podany parametr DirectionsRequest jest nieprawidłowy.
MAX_WAYPOINTS_EXCEEDED W polu DirectionsRequest podano zbyt wiele wartości DirectionsWaypoint. Maksymalną dozwoloną liczbę punktów pośrednich znajdziesz w  przewodniku dla programistów.
NOT_FOUND Nie udało się wygenerować kodu geograficznego dla co najmniej jednego z miejsc: miejsca początkowego, miejsca docelowego lub punktu na trasie.
OK Odpowiedź zawiera prawidłowy element DirectionsResult.
OVER_QUERY_LIMIT Strona internetowa przekroczyła limit żądań w zbyt krótkim czasie.
REQUEST_DENIED Strona internetowa 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 zostać zrealizowane.
ZERO_RESULTS Nie udało się znaleźć trasy między miejscem wyjazdu a miejscem docelowym.

Interfejs DirectionsResult

Interfejs google.maps.DirectionsResult

Odpowiedź dotycząca wskazówek dojazdu pobrana z serwera wskazówek dojazdu. Możesz je renderować 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 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.

request
Żądanie DirectionsRequest, które zwróciło ten wynik.
routes
Tablica obiektów DirectionsRoute, z których każdy zawiera informacje o etapach i krokach, z których się składa. Będzie tylko jedna trasa, chyba że parametr DirectionsRequest został utworzony z parametrem provideRouteAlternatives ustawionym na true.
available_travel_modes
opcjonalne
Typ: Array<TravelMode> optional
Zawiera tablicę dostępnych środków transportu. To pole jest zwracane, gdy żądanie określa środek transportu i nie zwraca żadnych wyników. Tablica zawiera dostępne środki transportu w krajach danego zestawu punktów pośrednich. To pole nie jest zwracane, jeśli co najmniej 1 punkt pośredni jest punktem pośrednim typu „via”.
geocoded_waypoints
opcjonalne
Tablica obiektów DirectionsGeocodedWaypoint, z których każdy zawiera informacje o geokodowaniu miejsca rozpoczęcia, miejsca docelowego i punktów pośrednich.

Klasa DirectionsRenderer

google.maps.DirectionsRenderer class
extends MVCObject
library "routes"

const {DirectionsRenderer} = await google.maps.importLibrary("routes");
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 panelu <div> (jako instrukcje tekstowe).
getDirections
getDirections()
Parametry: brak
Wartość zwracana: DirectionsResult|null
Zwraca bieżący zestaw wskazówek dojazdu renderera.
getMap
getMap()
Parametry: brak
Wartość zwracana: Map|null
Zwraca mapę, na której jest renderowany obiekt DirectionsResult.
getPanel
getPanel()
Parametry: brak
Wartość zwracana: HTMLElement|null
Zwraca panel <div>, w którym jest renderowany element DirectionsResult.
getRouteIndex
getRouteIndex()
Parametry: brak
Wartość zwracana: number
Zwraca bieżący indeks trasy (liczony od zera) używany przez ten obiekt DirectionsRenderer.
setDirections
setDirections(directions)
Parametry:
Zwracana wartość: brak
Ustaw renderer tak, aby używał wyniku z DirectionsService. Ustawienie prawidłowego zestawu wskazówek dojazdu w ten sposób spowoduje wyświetlenie wskazówek na wyznaczonej mapie i w panelu modułu renderującego.
setMap
setMap(map)
Parametry:
  • map: Map optional
Zwracana wartość: brak
Ta metoda określa mapę, na której będą renderowane wskazówki dojazdu. Przejdź przez null, aby usunąć wskazówki dojazdu z mapy.
setOptions
setOptions(options)
Parametry:
Zwracana wartość: brak
Zmień ustawienia opcji tego elementu DirectionsRenderer po inicjalizacji.
setPanel
setPanel(panel)
Parametry:
Zwracana wartość: brak
Ta metoda renderuje wskazówki dojazdu w elemencie <div>. Przekaż null, aby usunąć treści z panelu.
setRouteIndex
setRouteIndex(routeIndex)
Parametry:
  • routeIndex: number
Zwracana wartość: brak
Ustaw indeks (liczony od zera) trasy w obiekcie DirectionsResult, który ma zostać wyrenderowany. Domyślnie renderowana jest pierwsza trasa w tablicy.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy zmieniają się wyrenderowane wskazówki dojazdu, gdy ustawiony jest nowy obiekt DirectionsResult lub gdy użytkownik zakończy przeciąganie zmiany na ścieżce wskazówek dojazdu.

DirectionsRendererOptions interface

Interfejs google.maps.DirectionsRendererOptions

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

directions
opcjonalne
Typ: DirectionsResult optional
Wskazówki dojazdu do wyświetlenia na mapie lub w panelu <div>, pobrane jako obiekt DirectionsResult z DirectionsService.
draggable
opcjonalne
Typ: boolean optional
Jeśli ma wartość true, umożliwia użytkownikowi przeciąganie i modyfikowanie ścieżek tras renderowanych przez ten element DirectionsRenderer.
hideRouteList
opcjonalne
Typ: boolean optional
Domyślnie: false
Ta właściwość określa, czy moduł renderujący powinien udostępniać listę tras do wyboru przez użytkownika w panelu wskazówek dojazdu.
infoWindow
opcjonalne
Typ: InfoWindow optional
InfoWindow, w którym mają być wyświetlane informacje tekstowe po kliknięciu znacznika. Istniejąca zawartość okna informacyjnego zostanie zastąpiona, a jego pozycja zostanie zmieniona. Jeśli nie określono okna informacyjnego, DirectionsRenderer utworzy i użyje własnego okna informacyjnego. Ta właściwość zostanie zignorowana, jeśli właściwość suppressInfoWindows ma wartość true.
map
opcjonalne
Typ: Map optional
Mapa, na której mają być wyświetlane wskazówki dojazdu.
markerOptions
opcjonalne
Typ: MarkerOptions optional
Opcje znaczników. Wszystkie znaczniki renderowane przez DirectionsRenderer będą używać tych opcji.
panel
opcjonalne
Typ: HTMLElement optional
<div>, w którym mają być wyświetlane kroki trasy.
polylineOptions
opcjonalne
Typ: PolylineOptions optional
Opcje linii łamanych. Wszystkie linie łamane renderowane przez DirectionsRenderer będą używać tych opcji.
preserveViewport
opcjonalne
Typ: boolean optional
Domyślnie: false
Jeśli ta opcja jest ustawiona na true lub środek i powiększenie mapy nie zostały ustawione, mapa wejściowa jest wyśrodkowana i powiększona do ramki ograniczającej tego zestawu wskazówek dojazdu.
routeIndex
opcjonalne
Typ: number optional
Indeks trasy w obiekcie DirectionsResult. Wartość domyślna to 0.
suppressBicyclingLayer
opcjonalne
Typ: boolean optional
Ukryj renderowanie BicyclingLayer, gdy użytkownik prosi o wskazówki dojazdu rowerem.
suppressInfoWindows
opcjonalne
Typ: boolean optional
Zablokuj renderowanie okien informacyjnych.
suppressMarkers
opcjonalne
Typ: boolean optional
Zablokuj renderowanie znaczników.
suppressPolylines
opcjonalne
Typ: boolean optional
Pomiń renderowanie linii łamanych.

Interfejs DirectionsWaypoint

Interfejs google.maps.DirectionsWaypoint

DirectionsWaypoint reprezentuje lokalizację między miejscem początkowym a docelowym, przez którą ma przebiegać trasa.

location
opcjonalne
Typ: string|LatLng|LatLngLiteral|Place optional
Lokalizacja punktu pośredniego. Może to być ciąg znaków adresu, LatLng lub Place. Opcjonalnie:
stopover
opcjonalne
Typ: boolean optional
Domyślnie: true
Jeśli wartość to true, oznacza to, że ten punkt pośredni jest przystankiem między miejscem wylotu a miejscem docelowym. Spowoduje to podzielenie trasy na 2 odcinki. Jeśli wartość to false, oznacza to, że trasa powinna być wyznaczona tak, aby przechodziła przez ten punkt pośredni, ale nie powinna być podzielona na 2 odcinki. Jest to przydatne, jeśli chcesz utworzyć trasę w odpowiedzi na przeciąganie przez użytkownika punktów na mapie.

Interfejs DirectionsGeocodedWaypoint

Interfejs google.maps.DirectionsGeocodedWaypoint

Pojedynczy punkt na trasie z kodem geograficznym.

partial_match
opcjonalne
Typ: boolean optional
Czy geokoder nie zwrócił dopasowania ścisłego do pierwotnego punktu na trasie, mimo że udało mu się dopasować część żądanego adresu.
place_id
opcjonalne
Typ: string optional
Identyfikator miejsca powiązany z punktem na trasie. Identyfikatory miejsc jednoznacznie identyfikują miejsce w bazie danych Miejsc Google i w Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów korzystających z Places API.
types
opcjonalne
Typ: Array<string> optional
Tablica ciągów znaków określających typ zwróconego elementu z kodem geograficznym. Listę możliwych ciągów znaków znajdziesz w sekcji Typy komponentów adresu w Przewodniku dla programistów.

Interfejs DirectionsRoute

Interfejs google.maps.DirectionsRoute

Pojedyncza trasa zawierająca zestaw odcinków w obiekcie 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.

bounds
Granice tej trasy.
copyrights
Typ: string
Tekst dotyczący praw autorskich, który ma być wyświetlany w przypadku tej trasy.
legs
Tablica obiektów DirectionsLeg, z których każdy zawiera informacje o krokach, z których się składa. Dla każdego określonego punktu pośredniego lub miejsca docelowego będzie dostępny 1 odcinek. Trasa bez punktów pośrednich będzie zawierać jeden element DirectionsLeg, a trasa z jednym punktem pośrednim – 2.
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. adresy 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 dojazdu.
summary
Typ: string
Zawiera krótki opis tekstowy trasy, który nadaje się do nadania jej nazwy i odróżnienia jej od innych tras.
warnings
Typ: Array<string>
Ostrzeżenia, które mają być wyświetlane podczas pokazywania tych wskazówek dojazdu.
waypoint_order
Typ: Array<number>
Jeśli parametr optimizeWaypoints został ustawiony na true, to pole będzie zawierać zmienioną kolejność punktów pośrednich. Jeśli na przykład dane wejściowe to:
  Miejsce początkowe: Los Angeles
  Punkty pośrednie: Dallas, Bangor, Phoenix
  Miejsce docelowe: Nowy Jork
a zoptymalizowane dane wyjściowe zostały uporządkowane w ten sposób:
  Miejsce początkowe: Los Angeles
  Punkty pośrednie: Phoenix, Dallas, Bangor
  Miejsce docelowe: Nowy Jork
to pole będzie obiektem Array zawierającym wartości [2, 0, 1]. Pamiętaj, że numeracja punktów orientacyjnych zaczyna się od 0.
Jeśli którykolwiek z wejściowych punktów pośrednich ma parametr stopover ustawiony na false, to pole będzie puste, ponieważ optymalizacja trasy nie jest dostępna w przypadku takich zapytań.
fare
opcjonalne
Typ: TransitFare optional
Łączna opłata za całą podróż transportem publicznym. Dotyczy tylko żądań dotyczących transportu publicznego.

Interfejs DirectionsLeg

Interfejs google.maps.DirectionsLeg

Pojedynczy odcinek składający się z zestawu kroków w DirectionsResult. Niektóre pola w odcinku 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.

end_address
Typ: string
Adres miejsca docelowego tego odcinka. Te treści powinny być odczytywane w takiej postaci, w jakiej są. 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 lokalizacji początkowej i końcowej. end_location wskazuje rzeczywiste miejsce docelowe objęte geokodowaniem, które może się różnić od 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 miejsca rozpoczęcia tego odcinka. Te treści powinny być odczytywane w takiej postaci, w jakiej są. 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 lokalizacji początkowej i końcowej. start_location wskazuje rzeczywiste miejsce rozpoczęcia trasy, które może się różnić od start_location pierwszego kroku, jeśli na przykład droga nie znajduje się w pobliżu miejsca rozpoczęcia tego odcinka.
steps
Tablica obiektów DirectionsStep, z których każdy zawiera informacje o poszczególnych krokach na tym odcinku.
traffic_speed_entry
Typ: Array<*>
Informacje o prędkości ruchu na danym odcinku.
via_waypoints
Tablica punktów na trasie bez postoju na tym odcinku, które zostały określone w pierwotnym żądaniu.

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

Jeśli używasz usługi wskazówek dojazdu do implementacji wskazówek dojazdu z możliwością przeciągania, zalecamy wyłączenie przeciągania tras alternatywnych. Można przeciągać tylko główną trasę. Użytkownicy mogą przeciągać główną trasę, aż będzie ona zgodna z trasą alternatywną.

arrival_time
opcjonalne
Typ: Time optional
Szacowany czas przyjazdu na tym odcinku. Dotyczy tylko żądań TRANSIT.
departure_time
opcjonalne
Typ: Time optional
Szacowany czas odjazdu na tym odcinku. Dotyczy tylko żądań TRANSIT.
distance
opcjonalne
Typ: Distance optional
Całkowita odległość pokonana na tym odcinku. Ta właściwość może być niezdefiniowana, ponieważ odległość może być nieznana.
duration
opcjonalne
Typ: Duration optional
Łączny czas trwania tego etapu. Ta właściwość może mieć wartość undefined, ponieważ czas trwania może być nieznany.
duration_in_traffic
opcjonalne
Typ: Duration optional
Łączny czas trwania tego etapu z uwzględnieniem warunków na drodze wskazanych przez właściwość trafficModel. Ta właściwość może mieć wartość undefined, ponieważ czas trwania może być nieznany.

Interfejs DirectionsStep

Interfejs google.maps.DirectionsStep

Pojedynczy element DirectionsStep w elemencie DirectionsResult. Niektóre pola mogą być undefined. Pamiętaj, że chociaż ten obiekt jest „podobny do JSON”, nie jest to ściśle JSON, ponieważ bezpośrednio zawiera obiekty LatLng.

encoded_lat_lngs
Typ: string
Zakodowana reprezentacja linii łamanej kroku. To jest 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
Sekwencja elementów LatLng opisujących przebieg tego kroku. To jest przybliżona (wygładzona) ścieżka kroku.
maneuver
Typ: string
Zawiera działanie, które należy wykonać w ramach bieżącego kroku (turn-left, merge, straight itd.). Wartości mogą ulec zmianie, a nowe wartości mogą zostać wprowadzone bez wcześniejszego powiadomienia.
path
Sekwencja elementów LatLng opisujących przebieg tego kroku. To jest 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
Środek transportu użyty w tym kroku.
distance
opcjonalne
Typ: Distance optional
Dystans pokonany w ramach tego kroku. Ta właściwość może mieć wartość undefined, ponieważ odległość może być nieznana.
duration
opcjonalne
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.
polyline
opcjonalne
Typ: DirectionsPolyline optional
Zawiera obiekt z pojedynczą właściwością „points”, która zawiera zakodowaną linię łamaną reprezentującą krok. Ta łamana to przybliżona (wygładzona) ścieżka kroku.
steps
opcjonalne
Typ: Array<DirectionsStep> optional
Podetapy tego etapu. Określone dla odcinków tras transportu publicznego, które nie są obsługiwane przez transport publiczny.
transit
opcjonalne
Typ: TransitDetails optional
Szczegóły dotyczące transportu publicznego na tym etapie. Ta właściwość będzie niezdefiniowana, chyba że tryb podróży na tym etapie to TRANSIT.
transit_details
opcjonalne
Typ: TransitDetails optional
Szczegóły dotyczące tego kroku, jeśli środek transportu to TRANSIT.

Interfejs DirectionsPolyline

Interfejs google.maps.DirectionsPolyline

Obiekt zawierający właściwość points opisującą polilinię DirectionsStep.

points
Typ: string

Interfejs Place

Interfejs google.maps.Place

Zawiera informacje potrzebne do zlokalizowania, zidentyfikowania lub opisania miejsca dla DirectionsRequest lub DistanceMatrixRequest. W tym kontekście „miejsce” oznacza firmę, ciekawe miejsce lub położenie geograficzne. Informacje o pobieraniu informacji o miejscu znajdziesz w artykule PlacesService.

location
opcjonalne
Typ: LatLng|LatLngLiteral optional
LatLng elementu opisanego przez to miejsce.
placeId
opcjonalne
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 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
opcjonalne
Typ: string optional
Wyszukiwane hasło 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, podaj placeId zamiast query. Interfejs API nie gwarantuje dokładności rozpoznawania ciągu zapytania jako miejsca. Jeśli podasz zarówno placeId, jak i query, wystąpi błąd.

Stałe TravelMode

google.maps.TravelMode stałe
biblioteka "routes"

Prawidłowe środki transportu, które można określić w obiekcie DirectionsRequest, oraz środki transportu zwracane w obiekcie DirectionsStep. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'BICYCLING' lub google.maps.TravelMode.BICYCLING.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ TravelModeString.

const {TravelMode} = await google.maps.importLibrary("routes");
BICYCLING Określa żądanie wskazówek dojazdu rowerem.
DRIVING Określa żądanie wskazówek dojazdu.
TRANSIT Określa żądanie wskazówek dojazdu transportem publicznym.
BetaTWO_WHEELER Określa żądanie wskazówek dojazdu dla motocykli.
WALKING Określa żądanie trasy pieszej.

Interfejs DrivingOptions

Interfejs google.maps.DrivingOptions

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

departureTime
Typ: Date
Żądany czas rozpoczęcia podróży na trasie, określony jako obiekt Date. Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 r. Aby DrivingOptions był prawidłowy, musisz podać tę wartość. Czas wyjazdu musi być ustawiony na bieżącą godzinę lub na godzinę w przyszłości. Nie może przypadać w przeszłości.
trafficModel
opcjonalne
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.

Stałe TrafficModel

google.maps.TrafficModel stałe
biblioteka "routes"

Założenia, które należy stosować podczas prognozowania czasu trwania w ruchu. Określone w ramach 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.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ TrafficModelString.

const {TrafficModel} = await google.maps.importLibrary("routes");
BEST_GUESS korzystać z historycznych danych o natężeniu ruchu, aby jak najlepiej oszacować czas spędzony w korkach;
OPTIMISTIC Użyj historycznych danych o natężeniu ruchu, aby oszacować optymistyczny czas trwania podróży w ruchu ulicznym.
PESSIMISTIC Użyj historycznych danych o natężeniu ruchu, aby oszacować pesymistyczny czas trwania podróży w ruchu ulicznym.

TransitOptions interface

Interfejs google.maps.TransitOptions

Obiekt TransitOptions, który ma zostać uwzględniony w DirectionsRequest, gdy tryb podróży jest ustawiony na TRANSIT.

arrivalTime
opcjonalne
Typ: Date optional
Żądany czas przybycia na trasę, określony jako obiekt Date. Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 r. Jeśli podano czas przyjazdu, czas odjazdu jest ignorowany.
departureTime
opcjonalne
Typ: Date optional
Żądany czas wyjazdu na trasę, określony jako obiekt Date. Obiekt Date mierzy czas w milisekundach od 1 stycznia 1970 r. Jeśli nie podano godziny odjazdu ani przyjazdu, przyjmuje się, że godzina to „teraz”.
modes
opcjonalne
Typ: Array<TransitMode> optional
co najmniej 1 preferowany środek transportu, np. autobus lub pociąg; Jeśli nie podasz preferencji, interfejs API zwróci domyślną najlepszą trasę.
routingPreference
opcjonalne
Ustawienie, które może wpłynąć na wybór trasy transportu publicznego, np. mniej chodzenia. Jeśli nie podasz preferencji, interfejs API zwróci domyślną najlepszą trasę.

Stałe TransitMode

google.maps.TransitMode stałe
biblioteka "routes"

Prawidłowy środek transportu publicznego, np. autobus, który można określić w obiekcie TransitOptions. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'BUS' lub google.maps.TransitMode.BUS.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ TransitModeString.

const {TransitMode} = await google.maps.importLibrary("routes");
BUS Określa autobus jako preferowany środek transportu.
BetaLIGHT_RAIL Określa kolej miejską jako preferowany środek transportu.
RAIL Określa kolej jako preferowany środek transportu.
SUBWAY Określa metro jako preferowany środek transportu.
TRAIN Określa pociąg jako preferowany środek transportu.
TRAM Określa tramwaj jako preferowany środek transportu.

TransitRoutePreference stałe

google.maps.TransitRoutePreference stałe
biblioteka "routes"

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.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ TransitRoutePreferenceString.

const {TransitRoutePreference} = await google.maps.importLibrary("routes");
FEWER_TRANSFERS Określa, że obliczona trasa powinna preferować ograniczoną liczbę przesiadek.
LESS_WALKING Określa, że obliczona trasa powinna preferować ograniczone ilości chodzenia.

TransitFare

Interfejs google.maps.TransitFare

Opłata za przejazd DirectionsRoute , która składa się z wartości i waluty.

currency
Typ: string
Kod waluty w formacie ISO 4217 wskazujący walutę, w której wyrażona jest opłata.
text
Typ: string
Wartość opłaty za przejazd wyrażona w podanej walucie (currency) jako ciąg znaków.
value
Typ: number
Wartość liczbowa opłaty za przejazd wyrażona w podanej walucie (currency).

Interfejs TransitDetails

Interfejs google.maps.TransitDetails

Szczegóły dotyczące odjazdu, przyjazdu i środka transportu użytego na tym etapie.

arrival_stop
Przystanek docelowy tego etapu transportu publicznego.
arrival_time
Typ: Time
Czas przybycia na ten etap, określony jako obiekt Time.
departure_stop
Przystanek początkowy tego etapu podróży transportem publicznym.
departure_time
Typ: Time
Czas rozpoczęcia tego kroku określony jako obiekt Time.
headsign
Typ: string
Kierunek, w którym należy jechać tą linią, 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
Szczegóły dotyczące linii transportu publicznego używanej na tym etapie.
num_stops
Typ: number
Liczba przystanków na tym etapie. Obejmuje przystanek docelowy, ale nie przystanek początkowy.
trip_short_name
Typ: string
Tekst, który pojawia się w harmonogramach i na tablicach informacyjnych, aby ułatwić pasażerom identyfikację przejazdu, np. numery pociągów podmiejskich. Tekst jednoznacznie identyfikuje przejazd w ciągu dnia obsługi.

Interfejs TransitStop

Interfejs google.maps.TransitStop

Szczegóły dotyczące przystanku lub stacji.

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

Interfejs TransitLine

Interfejs google.maps.TransitLine

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

agencies
Przewoźnik, który obsługuje tę linię transportu publicznego.
color
Typ: string
Kolor powszechnie używany w oznakowaniu tej linii transportu publicznego, reprezentowany jako ciąg szesnastkowy.
icon
Typ: string
Adres URL ikony powiązanej z tą linią.
name
Typ: string
Pełna nazwa tej linii transportu publicznego, np. „8 Avenue Local”.
short_name
Typ: string
Krótka nazwa tej linii transportu publicznego, np. „E”.
text_color
Typ: string
Kolor tekstu powszechnie używany na znakach tej linii transportu publicznego, reprezentowany jako ciąg szesnastkowy.
url
Typ: string
Adres URL agencji, który jest powiązany z tą linią transportu publicznego.
vehicle
rodzaj użytego pojazdu, np. pociąg lub autobus;

Interfejs TransitAgency

Interfejs google.maps.TransitAgency

Informacje o przewoźniku, który obsługuje linię transportu publicznego.

name
Typ: string
Nazwa przewoźnika.
phone
Typ: string
Numer telefonu przewoźnika.
url
Typ: string
Adres URL przewoźnika.

Interfejs TransitVehicle

Interfejs google.maps.TransitVehicle

Informacje o pojeździe, który obsługuje linię 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 zamiast bardziej ogólnej ikony.
name
Typ: string
Nazwa tego typu pojazdu transportu publicznego, np. „Pociąg” lub „Autobus”.
type
Typ używanego pojazdu, np. pociąg, autobus lub prom.

Stałe VehicleType

google.maps.VehicleType stałe
biblioteka "routes"

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

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ VehicleTypeString.

const {VehicleType} = await google.maps.importLibrary("routes");
BUS Autobus.
CABLE_CAR Pojazd poruszający się po kablu, zwykle na ziemi. Kolejki linowe mogą być typu GONDOLA_LIFT.
COMMUTER_TRAIN Kolej podmiejska.
FERRY Prom.
FUNICULAR Pojazd, który jest wciągany na strome zbocze za pomocą liny.
GONDOLA_LIFT Kolejka linowa.
HEAVY_RAIL Kolej naziemna.
HIGH_SPEED_TRAIN Pociąg szybkobieżny.
INTERCITY_BUS Autobus krajowy.
METRO_RAIL Kolej miejska.
MONORAIL Kolej jednoszynowa.
OTHER Inne pojazdy.
RAIL Kolej.
SHARE_TAXI Taksówka zbiorowa to rodzaj transportu autobusowego z możliwością wysadzania i odbierania pasażerów w dowolnym miejscu na trasie. Zazwyczaj są to minibusy.
SUBWAY Podziemna kolej miejska.
TRAM Naziemna kolej miejska.
TROLLEYBUS Trolejbus.

Stałe UnitSystem

google.maps.UnitSystem stałe
biblioteka "core"

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

const {UnitSystem} = await google.maps.importLibrary("core");
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 odległości

Interfejs google.maps.Distance

Reprezentacja odległości jako wartości liczbowej i ciągu znaków do wyświetlenia.

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

Interfejs Duration

Interfejs google.maps.Duration

Reprezentacja czasu trwania jako wartości liczbowej i ciągu znaków.

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

Interfejs Time

Interfejs google.maps.Time

Reprezentacja czasu jako obiektu Date, 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.
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 określona jako obiekt Date w JavaScripcie.