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.
Zespół | |
---|---|
DirectionsService |
DirectionsService() Parametry: brak
Tworzy nową instancję obiektu DirectionsService , która wysyła zapytania o trasę do serwerów Google. |
Metody | |
---|---|
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
.
Właściwości | |
---|---|
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.
Stałe | |
---|---|
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
.
Właściwości | |
---|---|
request |
Typ:
DirectionsRequest Żądanie DirectionsRequest, które zwróciło ten wynik. |
routes |
Typ:
Array<DirectionsRoute> Tablica elementów DirectionsRoute , z których każdy zawiera informacje o 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 |
Typ:
Array<DirectionsGeocodedWaypoint> 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.
Zespół | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) Parametry:
Tworzy mechanizm renderowania z podanymi opcjami. Wskazówki dojazdu mogą być renderowane na mapie (jako nakładki wizualne) lub dodatkowo na panelu <div> (jako instrukcje tekstowe). |
Metody | |
---|---|
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:
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
|
Wydarzenia | |
---|---|
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
.
Właściwości | |
---|---|
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.
Właściwości | |
---|---|
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.
Właściwości | |
---|---|
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
.
Właściwości | |
---|---|
bounds |
Typ:
LatLngBounds Granice tej trasy. |
copyrights |
Typ:
string Tekst dotyczący praw autorskich do wyświetlenia na tej trasie. |
legs |
Typ:
Array<DirectionsLeg> 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 |
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
.
Właściwości | |
---|---|
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 |
Typ:
Array<DirectionsStep> Tablica DirectionsStep , z których każdy zawiera informacje o poszczególnych krokach w danej części. |
|
Typ:
Array<?> Informacje o prędkości na drodze. |
via_waypoints |
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 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
.
Właściwości | |
---|---|
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. |
|
Typ:
LatLng Lokalizacja końcowa tego kroku. |
instructions |
Typ:
string Instrukcje dotyczące tego kroku |
|
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 |
Sekwencja LatLng opisująca przebieg tego kroku. To przybliżona (wygładzona) ścieżka kroku. |
start_location |
Typ:
LatLng Lokalizacja początkowa tego kroku. |
|
Typ:
LatLng Lokalizacja początkowa tego kroku. |
travel_mode |
Typ:
TravelMode Ś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. |
|
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
.
Właściwości | |
---|---|
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
.
Właściwości | |
---|---|
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.
Stałe | |
---|---|
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
.
Właściwości | |
---|---|
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.
Stałe | |
---|---|
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.
Właściwości | |
---|---|
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.
Stałe | |
---|---|
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.
Stałe | |
---|---|
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ę.
Właściwości | |
---|---|
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.
Właściwości | |
---|---|
arrival_stop |
Typ:
TransitStop Przyjazd na tym etapie transportu publicznego. |
arrival_time |
Typ:
Time Godzina przybycia tego kroku, określona jako obiekt Time. |
departure_stop |
Typ:
TransitStop 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 |
Typ:
TransitLine 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.
Właściwości | |
---|---|
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.
Właściwości | |
---|---|
agencies |
Typ:
Array<TransitAgency> 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:
TransitVehicle 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.
Właściwości | |
---|---|
name |
Typ:
string Nazwa tego przewoźnika. |
phone |
Typ:
string Numer telefonu przewoźnika. |
url |
Typ:
string Adres URL przewoźnika. |
Interfejs TransitVehicle
google.maps.TransitVehicle
interfejs
Informacje o pojeździe poruszającym się na linii transportu publicznego.
Właściwości | |
---|---|
icon |
Typ:
string Adres URL ikony odpowiadającej typowi pojazdu używanego na tej linii. |
local_icon |
Typ:
string Adres URL ikony 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 |
Typ:
VehicleType 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.
Stałe | |
---|---|
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.
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 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.
Właściwości | |
---|---|
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.
Właściwości | |
---|---|
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.
Właściwości | |
---|---|
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