Klasa DirectionsService
google.maps.DirectionsService
zajęcia
Usługa służąca do wyznaczania tras między dwoma lub większą liczbą miejsc.
Uzyskaj dostęp, dzwoniąc pod numer const {DirectionsService} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
DirectionsService |
DirectionsService() Parametry: brak
Tworzy nowe wystąpienie obiektu DirectionsService , które wysyła zapytania o trasę do serwerów Google. |
Metody | |
---|---|
route |
route(request[, callback]) Parametry:
Zwracana wartość:
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 przetworzenia na dane geograficzne, właściwości LatLng lub Place . Wymagany. |
origin |
Typ:
string|LatLng|Place|LatLngLiteral Lokalizacja pochodzenia. Wartość tę można podać w postaci ciągu znaków do przetworzenia na dane geograficzne, właściwości LatLng lub Place . Wymagany. |
travelMode |
Typ:
TravelMode Typ żądanego routingu. Wymagany. |
avoidFerries optional |
Typ:
boolean optional Jeśli true , instruuje usługę Directions, aby unikać przepraw promowych, gdy to możliwe. Opcjonalnie. |
avoidHighways optional |
Typ:
boolean optional Jeśli true , nakazuje usłudze Trasa dojazdu unikanie autostrad, gdy to możliwe. Opcjonalnie. |
avoidTolls optional |
Typ:
boolean optional Jeśli jest ustawiona wartość true , usługa wyznaczania trasy będzie unikać dróg płatnych, gdy to możliwe. Opcjonalnie. |
drivingOptions optional |
Typ:
DrivingOptions optional Ustawienia dotyczące tylko żądań, w przypadku których travelMode to DRIVING . Ten obiekt nie będzie działać w przypadku innych środków 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 ma wartość true , DirectionsService spróbuje zmienić kolejność podanych pośrednich punktów na trasie, aby zminimalizować całkowity koszt trasy. Jeśli punkty na drodze są zoptymalizowane, sprawdź właściwość DirectionsRoute.waypoint_order w odpowiedzi, aby określić nową kolejność. |
provideRouteAlternatives optional |
Typ:
boolean optional Określa, czy należy podać alternatywne trasy. Opcjonalnie. |
region optional |
Typ:
string optional Kod regionu używany jako odchylenie w żądaniach geokodowania. Kod regionu może zawierać wartość dwuznakową ccTLD („domena najwyższego poziomu”). Większość kodów domen ccTLD jest taka sama jak kody ISO 3166-1, z pewnymi wyjątkami. Na przykład nazwa domeny ccTLD Wielkiej Brytanii to „uk” ( .co.uk ), a kod ISO 3166-1 to „gb” (czyli dla podmiotu „Wielka Brytania i Irlandia Północna”). |
transitOptions optional |
Typ:
TransitOptions optional Ustawienia dotyczące tylko żądań, w przypadku których travelMode to TRANSIT. Ten obiekt nie będzie działać w przypadku innych środków transportu. |
unitSystem optional |
Typ:
UnitSystem optional Domyślny: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. Trasa dojazdu od miejsca wylotu do miejsca docelowego są obliczane dla 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 w przypadku wskazówek dojazdu transportem publicznym. Opcjonalnie. |
Stałe DirectionsStatus
google.maps.DirectionsStatus
stałe
Stan zwrócony przez interfejs DirectionsService
po zakończeniu wywołania do route()
. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'OK'
lub google.maps.DirectionsStatus.OK
.
Uzyskaj dostęp, dzwoniąc 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 |
W DirectionsRequest podano zbyt wiele elementów DirectionsWaypoint . Informacje o maksymalnej dozwolonej liczbie punktów pośrednich znajdziesz w przewodniku dla programistów. |
NOT_FOUND |
Nie można przetworzyć geograficznie co najmniej jednego miejsca wylotu, celu podróży lub punktu pośredniego. |
OK |
Odpowiedź zawiera prawidłowy atrybut DirectionsResult . |
OVER_QUERY_LIMIT |
Strona przekroczyła limit żądań w zbyt krótkim czasie. |
REQUEST_DENIED |
Strona nie może korzystać z usługi wyznaczania trasy. |
UNKNOWN_ERROR |
Nie udało się przetworzyć zapytania o trasę dojazdu z powodu błędu serwera. Jeśli spróbujesz ponownie, prośba może zostać zrealizowana. |
ZERO_RESULTS |
Nie znaleziono trasy między miejscem wylotu a celem podróży. |
Interfejs DirectionsResult
google.maps.DirectionsResult
interfejs
Odpowiedź o trasach została pobrana z serwera wskazówek. Możesz je wyrenderować za pomocą DirectionsRenderer
lub przeanalizować i wyrenderować samodzielnie. Musisz wyświetlać ostrzeżenia i informacje o prawach autorskich, zgodnie z Warunkami korzystania z usługi Google Maps Platform. Zwróć uwagę, że chociaż ten wynik jest „podobny do JSON”, nie jest to tylko format 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 odnogach i krokach, z których składa się element. Będzie tylko 1 trasa, chyba że DirectionsRequest został utworzony z provideRouteAlternatives ustawioną na true . |
available_travel_modes optional |
Typ:
Array<TravelMode> optional Zawiera tablicę dostępnych środków transportu. To pole jest zwracane, gdy żądanie określa tryb podróży i nie zwraca żadnych wyników. Tablica zawiera informacje o środkach transportu w krajach, w których znajduje się dany zbiór punktów pośrednich. To pole nie jest zwracane, jeśli co najmniej jeden punkt 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 miejsca wylotu, celu podróży i punktu pośredniego. |
Klasa DirectionsRenderer
google.maps.DirectionsRenderer
zajęcia
Renderuje kierunki uzyskane z DirectionsService
.
Ta klasa stanowi rozszerzenie MVCObject
.
Uzyskaj dostęp, dzwoniąc 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 mogą być renderowane na mapie (jako nakładki wizualne) lub dodatkowo na panelu <div> (jako instrukcje tekstowe). |
Metody | |
---|---|
getDirections |
getDirections() Parametry: brak
Zwracana wartość:
DirectionsResult Zwraca bieżący zestaw kierunków mechanizmu renderowania. |
getMap |
getMap() Parametry: brak
Zwracana wartość:
Map Zwraca mapę, na której renderowany jest element DirectionsResult . |
getPanel |
getPanel() Parametry: brak
Zwracana wartość:
HTMLElement|null Zwraca panel <div> , w którym renderowany jest element DirectionsResult . |
getRouteIndex |
getRouteIndex() Parametry: brak
Zwracana wartość:
number Zwraca bieżący (liczony od zera) indeks trasy używany przez ten obiekt DirectionsRenderer . |
setDirections |
setDirections(directions) Parametry:
Zwracana wartość: brak
Ustaw mechanizm renderowania, aby korzystał z wyników z komponentu DirectionsService . Ustawienie prawidłowego zestawu wskazówek dojazdu w ten sposób powoduje ich wyświetlanie na mapie i panelu mechanizmu renderowania. |
setMap |
setMap(map) Parametry:
Zwracana wartość: brak
Ta metoda określa mapę, na której będą wyświetlane wskazówki dojazdu. Aby usunąć trasę z mapy, miń null . |
setOptions |
setOptions(options) Parametry:
Zwracana wartość: brak
Zmień ustawienia opcji tego urządzenia DirectionsRenderer po zainicjowaniu. |
setPanel |
setPanel(panel) Parametry:
Zwracana wartość: brak
Ta metoda renderuje wskazówki w elemencie <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 będzie pierwsza trasa w tablicy. |
Dziedziczone:
addListener , bindTo , get , notify , set , setValues , unbind , unbindAll
|
Wydarzenia | |
---|---|
directions_changed |
function() Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienią się renderowane wskazówki, czyli gdy zostanie ustawiony nowy 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 i/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ć w panelu wskazówek listę tras wybieraną przez użytkownika. |
infoWindow optional |
Typ:
InfoWindow optional Pole InfoWindow , w którym są renderowane informacje tekstowe po kliknięciu znacznika. Zawartość istniejącego okna informacyjnego zostanie zastąpiona, a jej położenie przeniesione. Jeśli nie określisz 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 należy wyświetlić 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 mają być wyświetlane wskazówki dojazdu. |
polylineOptions optional |
Typ:
PolylineOptions optional Opcje linii łamanych. Wszystkie linie łamane renderowane przez interfejs 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 powiększenia i środkowej części mapy, mapa wejściowa zostanie wyśrodkowana i powiększona do ramki ograniczającej ten zestaw wskazówek. |
routeIndex optional |
Typ:
number optional Indeks trasy w obiekcie DirectionsResult . Wartością domyślną jest 0. |
suppressBicyclingLayer optional |
Typ:
boolean optional Wyłącz renderowanie BicyclingLayer , gdy zostanie wyświetlone zapytanie o trasę dojazdu rowerem. |
suppressInfoWindows optional |
Typ:
boolean optional Blokuj renderowanie okien informacyjnych. |
suppressMarkers optional |
Typ:
boolean optional Blokuj renderowanie znaczników. |
suppressPolylines optional |
Typ:
boolean optional Blokuj renderowanie linii łamanych. |
Interfejs DirectionsWaypoint
google.maps.DirectionsWaypoint
interfejs
DirectionsWaypoint
wskazuje lokalizację między miejscem wylotu a celem podróży, przez którą ma zostać przekierowana podróż.
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 ma wartość true , oznacza to, że ten punkt pośredni znajduje się między miejscem wylotu a celem podróży. W ten sposób trasa zostanie podzielona na 2 etapy. Jeśli false , wskazuje, że trasa powinna być stronnicza podczas przejścia przez ten punkt, ale nie powinna być podzielona na 2 etapy. Jest to przydatne, gdy chcesz utworzyć trasę w odpowiedzi na przeciąganie punktów pośrednich na mapie przez użytkownika. |
Interfejs DirectionsGeocodedWaypoint
google.maps.DirectionsGeocodedWaypoint
interfejs
Jeden geokodowany punkt pośredni.
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 pośrednim. Identyfikatory miejsc jednoznacznie identyfikują dane miejsce w bazie danych Miejsc Google i na Mapach Google. Więcej informacji o identyfikatorach miejsc znajdziesz w przewodniku dla programistów dotyczącym interfejsu API Miejsc Google. |
types optional |
Typ:
Array<string> optional Tablica ciągów tekstowych oznaczających typ zwróconego elementu geokodu. Listę możliwych ciągów tekstowych 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 DirectionsResult
odcinków. Pamiętaj, że chociaż ten obiekt jest „podobny do formatu JSON”, nie jest to tylko format JSON, ponieważ pośrednio i bezpoś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 jest złożona. Każdy określony punkt pośredni lub miejsce docelowe ma jeden odcinek. Dlatego trasa bez punktów pośrednich będzie mieć jeden DirectionsLeg , a trasa z jednym punktem pośrednim – 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 Static Maps API). |
overview_polyline |
Typ:
string Zakodowana linia łamana oznaczająca trasę w parametrze overview_path. Ta linia łamana jest przybliżoną (wygładzoną) ścieżką wynikowych kierunków. |
summary |
Typ:
string zawiera krótki opis trasy, który ułatwia nazewnictwo i umożliwia odróżnienie trasy od alternatywnych rozwiązań; |
warnings |
Typ:
Array<string> Ostrzeżenia, które mają być wyświetlane podczas pokazywania tych wskazówek. |
waypoint_order |
Typ:
Array<number> Jeśli optimizeWaypoints ma wartość true , to pole zawiera zmienioną kolejność wejściowych punktów pośrednich. Jeśli dane wejściowe to na przykład:Punkt początkowy: Los Angeles Waypoints: Dallas, Bangor, Phoenix Cel: Nowy Jork , a dane wyjściowe zostały uporządkowane w następujący sposób: Punkt początkowy: Los Angeles Waypoints: Phoenix, Dallas, Bangor Cel: Nowy Jork to pole będzie wartością Array z wartościami [2]. Zwróć uwagę, że numerowanie punktów na trasie jest liczone od zera.Jeśli dowolny z wprowadzonych punktów pośrednich ma wartość stopover ustawioną na false , to pole będzie puste, ponieważ optymalizacja trasy nie jest dostępna dla takich zapytań. |
fare optional |
Typ:
TransitFare optional Łączna cena za całą podróż środkami transportu publicznego. Dotyczy tylko próśb o transport. |
Interfejs DirectionsLeg
google.maps.DirectionsLeg
interfejs
1 etap składający się z zestawu kroków w DirectionsResult
. Niektóre pola etapu mogą nie zostać zwrócone w przypadku wszystkich żądań. Zwróć uwagę, że chociaż ten wynik jest „podobny do JSON”, nie jest to tylko format JSON, ponieważ pośrednio i bezpośrednio zawiera obiekty LatLng
.
Właściwości | |
---|---|
end_address |
Typ:
string Adres miejsca docelowego tego etapu. Treść powinna być odczytywana w niezmienionej postaci. Nie analizuj automatycznie sformatowanego adresu. |
end_location |
Typ:
LatLng DirectionsService oblicza wskazówki dojazdu między lokalizacjami, korzystając z najbliższego środka transportu (zwykle drogi) na punkcie początkowym i końcowym. end_location wskazuje miejsce docelowe wpisane na podstawie geokodu. Może się różnić od wartości end_location z ostatniego kroku, jeśli na przykład droga nie znajduje się w pobliżu tego etapu. |
start_address |
Typ:
string Adres punktu początkowego tego odcinka. Treść powinna być odczytywana w niezmienionej postaci. Nie analizuj automatycznie sformatowanego adresu. |
start_location |
Typ:
LatLng DirectionsService oblicza wskazówki dojazdu między lokalizacjami, korzystając z najbliższego środka transportu (zwykle drogi) na punkcie początkowym i końcowym. Pole start_location wskazuje rzeczywisty początek geokodu, który może być inny niż start_location pierwszego etapu, jeśli na przykład droga nie znajduje się w pobliżu punktu początkowego danego odcinka. |
steps |
Typ:
Array<DirectionsStep> Tablica DirectionsStep , z których każdy zawiera informacje o poszczególnych krokach danego etapu. |
|
Typ:
Array<?> Informacje o prędkości ruchu na trasie. |
via_waypoints |
Tablica punktów pośrednich na tym odcinku bez przesiadek, które zostały określone w pierwotnym żądaniu. Wycofane w trasach alternatywnych. Wersja 3.27 jest ostatnią wersją interfejsu API, która dodaje dodatkowe Podczas korzystania z usługi wyznaczania trasy przy implementowaniu 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ć trasę główną tak, aby pasowała do trasy alternatywnej. |
arrival_time optional |
Typ:
Time optional Szacowany czas dotarcia na ten etap. Dotyczy tylko wniosków TRANSIT. |
departure_time optional |
Typ:
Time optional Szacowany czas odjazdu na tym etapie. Dotyczy tylko wniosków 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. Wartość tej właściwości może wskazywać 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 . Wartość tej właściwości może wskazywać undefined , ponieważ czas trwania może być nieznany. |
Interfejs DirectionsStep
google.maps.DirectionsStep
interfejs
Pojedyncze DirectionsStep
w okresie DirectionsResult
. Niektóre pola mogą zawierać wartość undefined
. Zwróć uwagę, że chociaż ten obiekt jest „podobny do 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 reprezentująca krok. Jest to przybliżona (wygładzona) ścieżka kroku. |
end_location |
Typ:
LatLng Lokalizacja końcowa tego kroku. |
|
Typ:
LatLng Lokalizacja końcowa tego kroku. |
instructions |
Typ:
string Instrukcje dotyczące tego kroku |
|
Sekwencja sekwencji LatLng opisujących przebieg tego kroku. Jest to przybliżona (wygładzona) ścieżka kroku. |
maneuver |
Typ:
string Zawiera działanie do wykonania w bieżącym kroku ( turn-left , merge , straight itd.). Wartości mogą się zmienić, a nowe mogą być wprowadzane bez wcześniejszego powiadomienia. |
path |
Sekwencja sekwencji LatLng opisujących przebieg tego kroku. Jest to przybliżona (wygładzona) ścieżka kroku. |
start_location |
Typ:
LatLng Lokalizacja początkowa tego kroku. |
|
Typ:
LatLng Lokalizacja początkowa tego kroku. |
travel_mode |
Typ:
TravelMode Środki transportu użyte w tym kroku. |
distance optional |
Typ:
Distance optional Odległość przebyta podczas tego kroku. Wartość właściwości to 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. Wartość tej właściwości może wskazywać undefined , ponieważ czas trwania może być nieznany. |
|
Typ:
DirectionsPolyline optional Zawiera obiekt z pojedynczą właściwością („punktami”) zawierającym zakodowaną linię łamaną reprezentującą krok. Ta linia łamana jest przybliżoną (wygładzoną) ścieżką kroku. |
steps optional |
Typ:
Array<DirectionsStep> optional Kroki podrzędne tego kroku. Określana dla odcinków tras transportu publicznego nieprzeznaczonych dla transportu publicznego. |
transit optional |
Typ:
TransitDetails optional Szczegółowe informacje o transporcie publicznym w tym kroku. 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
opisującą linię łamaną elementu DirectionsStep
.
Właściwości | |
---|---|
points |
Typ:
string |
Interfejs Place
google.maps.Place
interfejs
Zawiera informacje potrzebne do zlokalizowania, zidentyfikowania lub opisania miejsca, do którego należy DirectionsRequest
lub DistanceMatrixRequest
. W tym kontekście „miejsce” oznacza firmę, ciekawe miejsce lub lokalizację geograficzną. Aby uzyskać informacje o miejscu, zobacz PlacesService
.
Właściwości | |
---|---|
location optional |
Typ:
LatLng|LatLngLiteral optional Wartość LatLng podmiotu opisanego w tym miejscu. |
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 jest najdokładniejszym sposobem na określenie miejsca. Jeśli to możliwe, podaj właściwość placeId zamiast query . Identyfikator miejsca można pobrać z dowolnego żądania wysyłanego do interfejsu Places API, takiego jak 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 Wyszukiwane hasło opisujące dane miejsce (np. firma 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 właściwość placeId zamiast query . Interfejs API nie gwarantuje dokładności rozpoznawania miejsca. Jeśli podano zarówno placeId , jak i query , wystąpi błąd. |
Stałe TravelMode
google.maps.TravelMode
stałe
Prawidłowe środki transportu, które można podać w polu DirectionsRequest
, oraz środki transportu zwrócone w zasadzie DirectionsStep
. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'BICYCLING'
lub google.maps.TravelMode.BICYCLING
.
Uzyskaj dostęp, dzwoniąc 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 żądanie trasy pieszej. |
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 z trasy 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 być ustawiona na aktualną godzinę 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 w ruchu. Wartość domyślna to BEST_GUESS . |
Stałe TrafficModel
google.maps.TrafficModel
stałe
Założenia wykorzystywane do prognozowania czasu trwania w ruchu. Określona w atrybucie DirectionsRequest
lub DistanceMatrixRequest
. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'bestguess'
lub google.maps.TrafficModel.BEST_GUESS
.
Uzyskaj dostęp, dzwoniąc 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 szacuj czas trwania tego ruchu w optymalny sposób. |
PESSIMISTIC |
Na podstawie historycznych danych o ruchu szacuj czas trwania ruchu w sposób pesymistyczny. |
interfejs TransitOptions
google.maps.TransitOptions
interfejs
Obiekt TransitOptions powinien być uwzględniony w obiekcie DirectionsRequest
, gdy tryb podróży jest ustawiony na TRANSIT.
Właściwości | |
---|---|
arrivalTime optional |
Typ:
Date optional Żądany czas przyjazdu na trasę, określony jako obiekt Data. Obiekt Data mierzy czas w milisekundach od 1 stycznia 1970 roku. Jeśli podasz godzinę przyjazdu, godzina odjazdu zostanie zignorowana. |
departureTime optional |
Typ:
Date optional Żądany czas odjazdu z trasy określony w elemencie Date (Data). Obiekt Data mierzy czas w milisekundach od 1 stycznia 1970 roku. Jeśli nie podasz 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 zniekształcić wybór trasy transportu publicznego, na przykład mniej chodzenia pieszo. 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 za pomocą wartości lub nazwy stałej. Na przykład 'BUS'
lub google.maps.TransitMode.BUS
.
Uzyskaj dostęp, dzwoniąc 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 TransitRoutePrefer
google.maps.TransitRoutePreference
stałe
Prawidłowy typ trasy transportu publicznego, który można określić w polu TransitOptions
. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'LESS_WALKING'
lub google.maps.TransitRoutePreference.LESS_WALKING
.
Uzyskaj dostęp, dzwoniąc 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 pieszego. |
Interfejs TransitFare
google.maps.TransitFare
interfejs
Cena w wysokości DirectionsRoute
, składająca się z wartości i waluty.
Właściwości | |
---|---|
currency |
Typ:
string Kod waluty w formacie ISO 4217 wskazujący walutę, w której podana jest cena. |
value |
Typ:
number Wartość liczbowa ceny podana 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 Stacja przyjazdu na tym etapie transportu publicznego. |
arrival_time |
Typ:
Time Godzina przyjścia tego kroku określona jako obiekt Time. |
departure_stop |
Typ:
TransitStop Przystanek odjazdu na tym etapie 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 ze wskazaniem na pojeździe lub na przystanku odjazdu. |
headway |
Typ:
number Spodziewana liczba sekund między równoważnymi pojazdami na tym przystanku. |
line |
Typ:
TransitLine Szczegółowe informacje o linii transportu publicznego użytej w tym kroku. |
num_stops |
Typ:
number Liczba przystanków na tym etapie. Obejmuje przystanek, ale nie przystanek odjazdu. |
trip_short_name |
Typ:
string Tekst, który pojawia się w rozkładach jazdy i na tablicach informacyjnych, by wskazywać pasażerom transport publiczny, na przykład w celu identyfikacji numeru pociągu dla podróży pociągiem podmiejskim. Tekst jednoznacznie identyfikuje podróż w ramach dnia świadczenia usługi. |
interfejs TransitStop
google.maps.TransitStop
interfejs
Szczegółowe informacje o przystanku lub stacji transportu publicznego.
Właściwości | |
---|---|
location |
Typ:
LatLng Lokalizacja tego przystanku. |
name |
Typ:
string Nazwa tego przystanku. |
interfejs TransitLine
google.maps.TransitLine
interfejs
Informacje o linii transportu publicznego, która obsługuje ten etap transportu.
Właściwości | |
---|---|
agencies |
Typ:
Array<TransitAgency> Przewoźnik obsługujący daną linię transportu publicznego. |
color |
Typ:
string Kolor często używany na szyldu tego linii transportu publicznego, reprezentowany 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 Aleja 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 tablicy tranzytowej, reprezentowany w postaci ciągu szesnastkowego. |
url |
Typ:
string Adres URL przewoźnika, który jest związany z tą linią transportu publicznego. |
vehicle |
Typ:
TransitVehicle Typ użytego pojazdu, np. pociąg lub autobus. |
Interfejs TransitCarrier
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 transportu publicznego, np. „Pociąg” lub „Autobus”. |
type |
Typ:
VehicleType Typ 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.
Uzyskaj dostęp, dzwoniąc pod numer const {VehicleType} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
BUS |
Autobus. |
CABLE_CAR |
Pojazd poruszający się po kablu, zazwyczaj na ziemi. Kolejki linowe mogą należeć do typu GONDOLA_LIFT . |
COMMUTER_TRAIN |
Kolej podmiejska. |
FERRY |
Prom. |
FUNICULAR |
Pojazd ściągnięty liną po stromym wzniesieniu. |
GONDOLA_LIFT |
Kolejka linowa. |
HEAVY_RAIL |
Kolej ciężka. |
HIGH_SPEED_TRAIN |
Szybki pociąg. |
INTERCITY_BUS |
Autobus krajowy. |
METRO_RAIL |
Tramwaj. |
MONORAIL |
Kolej jednoszynowa. |
OTHER |
Inne pojazdy. |
RAIL |
Kolej. |
SHARE_TAXI |
Taksówka zbiorowa to rodzaj transportu autobusowego, który umożliwia wysyłkę i podwiezienie pasażerów w dowolnym miejscu na trasie. Taksówka zbiorowa korzysta zwykle z mikrobusów. |
SUBWAY |
Podziemna kolej miejska. |
TRAM |
Tramwaj nad ziemią. |
TROLLEYBUS |
Trolejbus. |
Stałe UnitSystem
google.maps.UnitSystem
stałe
Prawidłowe systemy jednostek, które można określić w elemencie DirectionsRequest
.
Uzyskaj dostęp, dzwoniąc 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 DirectionsResult powinny być wyrażone w jednostkach metrycznych. |
Interfejs Odległość
google.maps.Distance
interfejs
Odległość jako wartość liczbowa i wyświetlany ciąg.
Właściwości | |
---|---|
text |
Typ:
string Ciąg 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
Czas trwania w postaci wartości liczbowej i wyświetlanego ciągu.
Właściwości | |
---|---|
text |
Typ:
string Wartość czasu trwania w postaci ciągu. |
value |
Typ:
number Czas trwania w sekundach. |
Interfejs Time
google.maps.Time
interfejs
Czas w postaci obiektu Date (Data), zlokalizowanego ciągu znaków i strefy czasowej.
Właściwości | |
---|---|
text |
Typ:
string Ciąg 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. Wartość jest nazwą strefy czasowej zdefiniowanej 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
stałe DirectionsUnitSystem,
google.maps.DirectionsUnitSystem
stałe