DirectionsService
google.maps.DirectionsService
klasa
biblioteka "routes"
const {DirectionsService} = await google.maps.importLibrary("routes");
Zespół | |
|---|---|
DirectionsService |
DirectionsService()Parametry: brak
Tworzy nową instancję DirectionsService, która wysyła zapytania o wskazówki dojazdu do serwerów Google. |
Metody | |
|---|---|
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.
Właściwości | |
|---|---|
destination |
Typ:
string|LatLng|Place|LatLngLiteralLokalizacja miejsca docelowego. Można go określić jako ciąg znaków do geokodowania, LatLng lub Place. Wymagane. |
origin |
Typ:
string|LatLng|Place|LatLngLiteralLokalizacja pochodzenia. Można go określić jako ciąg znaków do geokodowania, LatLng lub Place. Wymagane. |
travelMode |
Typ:
TravelModeTyp żądanego routingu. Wymagane. |
avoidFerries
opcjonalne |
Typ:
boolean optionalJeśli ma wartość true, usługa wskazówek dojazdu będzie w miarę możliwości unikać promów. Opcjonalnie: |
avoidHighways
opcjonalne |
Typ:
boolean optionalJeśli ma wartość true, usługa Directions będzie w miarę możliwości unikać autostrad. Opcjonalnie: |
avoidTolls
opcjonalne |
Typ:
boolean optionalJeśli ma wartość true, usługa Directions będzie w miarę możliwości unikać dróg płatnych. Opcjonalnie: |
drivingOptions
opcjonalne |
Typ:
DrivingOptions optionalUstawienia, 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 optionalIdentyfikator 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 optionalJeś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 optionalOkreśla, czy mają być podawane alternatywne trasy. Opcjonalnie: |
region
opcjonalne |
Typ:
string optionalKod 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 optionalUstawienia, 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 optionalDomyślny: system jednostek używany w kraju pochodzenia.
Preferowany układ jednostek do wyświetlania odległości. |
waypoints
opcjonalne |
Typ:
Array<DirectionsWaypoint> optionalTablica 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");
Stałe | |
|---|---|
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.
Właściwości | |
|---|---|
request |
Typ:
DirectionsRequestŻądanie DirectionsRequest, które zwróciło ten wynik. |
routes |
Typ:
Array<DirectionsRoute>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> optionalZawiera 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 |
Typ:
Array<DirectionsGeocodedWaypoint> optionalTablica 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");
Zespół | |
|---|---|
DirectionsRenderer |
DirectionsRenderer([opts])Parametry:
Tworzy moduł renderujący z podanymi opcjami. Wskazówki dojazdu mogą być wyświetlane na mapie (jako nakładki wizualne) lub dodatkowo w panelu <div> (jako instrukcje tekstowe). |
Metody | |
|---|---|
getDirections |
getDirections()Parametry: brak
Wartość zwracana:
DirectionsResult|nullZwraca bieżący zestaw wskazówek dojazdu renderera. |
getMap |
getMap()Parametry: brak
Wartość zwracana:
Map|nullZwraca mapę, na której jest renderowany obiekt DirectionsResult. |
getPanel |
getPanel()Parametry: brak
Wartość zwracana:
HTMLElement|nullZwraca panel <div>, w którym jest renderowany element DirectionsResult. |
getRouteIndex |
getRouteIndex()Parametry: brak
Wartość zwracana:
numberZwraca 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:
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:
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
| |
Wydarzenia | |
|---|---|
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.
Właściwości | |
|---|---|
directions
opcjonalne |
Typ:
DirectionsResult optionalWskazówki dojazdu do wyświetlenia na mapie lub w panelu <div>, pobrane jako obiekt DirectionsResult z DirectionsService. |
draggable
opcjonalne |
Typ:
boolean optionalJeśli ma wartość true, umożliwia użytkownikowi przeciąganie i modyfikowanie ścieżek tras renderowanych przez ten element DirectionsRenderer. |
hideRouteList
opcjonalne |
Typ:
boolean optionalDomyślnie:
falseTa 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 optionalInfoWindow, 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 optionalMapa, na której mają być wyświetlane wskazówki dojazdu. |
markerOptions
opcjonalne |
Typ:
MarkerOptions optionalOpcje 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 optionalOpcje linii łamanych. Wszystkie linie łamane renderowane przez DirectionsRenderer będą używać tych opcji. |
preserveViewport
opcjonalne |
Typ:
boolean optionalDomyślnie:
falseJeś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 optionalIndeks trasy w obiekcie DirectionsResult. Wartość domyślna to 0. |
suppressBicyclingLayer
opcjonalne |
Typ:
boolean optionalUkryj renderowanie BicyclingLayer, gdy użytkownik prosi o wskazówki dojazdu rowerem. |
suppressInfoWindows
opcjonalne |
Typ:
boolean optionalZablokuj renderowanie okien informacyjnych. |
suppressMarkers
opcjonalne |
Typ:
boolean optionalZablokuj renderowanie znaczników. |
suppressPolylines
opcjonalne |
Typ:
boolean optionalPomiń 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.
Właściwości | |
|---|---|
location
opcjonalne |
Typ:
string|LatLng|LatLngLiteral|Place optionalLokalizacja punktu pośredniego. Może to być ciąg znaków adresu, LatLng lub Place. Opcjonalnie: |
stopover
opcjonalne |
Typ:
boolean optionalDomyślnie:
trueJeś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.
Właściwości | |
|---|---|
partial_match
opcjonalne |
Typ:
boolean optionalCzy 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 optionalIdentyfikator 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> optionalTablica 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.
Właściwości | |
|---|---|
bounds |
Typ:
LatLngBoundsGranice tej trasy. |
copyrights |
Typ:
stringTekst dotyczący praw autorskich, który ma być wyświetlany w przypadku tej trasy. |
legs |
Typ:
Array<DirectionsLeg>Tablica obiektów DirectionsLeg, z których każdy zawiera informacje o krokach, z których się składa. 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:
stringZakodowana reprezentacja linii łamanej trasy w overview_path. Ta linia łamana to przybliżona (wygładzona) ścieżka wynikowych wskazówek dojazdu. |
summary |
Typ:
stringZawiera 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.
Właściwości | |
|---|---|
end_address |
Typ:
stringAdres miejsca docelowego tego odcinka. Te treści powinny być odczytywane w takiej postaci, w jakiej są. Nie analizuj sformatowanego adresu automatycznie. |
end_location |
Typ:
LatLngDirectionsService oblicza wskazówki dojazdu między lokalizacjami, korzystając z najbliższej opcji transportu (zwykle drogi) w 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:
stringAdres 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:
LatLngDirectionsService 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 |
Typ:
Array<DirectionsStep>Tablica obiektów DirectionsStep, z których każdy zawiera informacje o poszczególnych krokach na tym odcinku. |
|
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 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 optionalSzacowany czas przyjazdu na tym odcinku. Dotyczy tylko żądań TRANSIT. |
departure_time
opcjonalne |
Typ:
Time optionalSzacowany czas odjazdu na tym odcinku. Dotyczy tylko żądań TRANSIT. |
distance
opcjonalne |
Typ:
Distance optionalCał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.
Właściwości | |
|---|---|
encoded_lat_lngs |
Typ:
stringZakodowana reprezentacja linii łamanej kroku. To jest przybliżona (wygładzona) ścieżka kroku. |
end_location |
Typ:
LatLngLokalizacja końcowa tego kroku. |
|
Typ:
LatLngLokalizacja końcowa tego kroku. |
instructions |
Typ:
stringInstrukcje dotyczące tego kroku. |
|
Sekwencja elementów LatLng opisujących przebieg tego kroku. To jest przybliżona (wygładzona) ścieżka kroku. |
maneuver |
Typ:
stringZawiera 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:
LatLngLokalizacja początkowa tego kroku. |
|
Typ:
LatLngLokalizacja początkowa tego kroku. |
travel_mode |
Typ:
TravelModeŚrodek transportu użyty w tym kroku. |
distance
opcjonalne |
Typ:
Distance optionalDystans 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 optionalTypowy czas potrzebny na wykonanie tego kroku w sekundach i w formie tekstowej. Ta właściwość może mieć wartość undefined, ponieważ czas trwania może być nieznany. |
opcjonalne |
Typ:
DirectionsPolyline optionalZawiera 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> optionalPodetapy tego etapu. Określone dla odcinków tras transportu publicznego, które nie są obsługiwane przez transport publiczny. |
transit
opcjonalne |
Typ:
TransitDetails optionalSzczegół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 optionalSzczegół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.
Właściwości | |
|---|---|
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.
Właściwości | |
|---|---|
location
opcjonalne |
Typ:
LatLng|LatLngLiteral optionalLatLng elementu opisanego przez to miejsce. |
placeId
opcjonalne |
Typ:
string optionalIdentyfikator 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 optionalWyszukiwane 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");
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. |
|
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.
Właściwości | |
|---|---|
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 optionalPreferowane 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");
Stałe | |
|---|---|
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.
Właściwości | |
|---|---|
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> optionalco 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 |
Typ:
TransitRoutePreference optionalUstawienie, 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");
Stałe | |
|---|---|
BUS |
Określa autobus jako preferowany środek transportu. |
|
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");
Stałe | |
|---|---|
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.
Właściwości | |
|---|---|
currency |
Typ:
stringKod waluty w formacie ISO 4217 wskazujący walutę, w której wyrażona jest opłata. |
text |
Typ:
stringWartość opłaty za przejazd wyrażona w podanej walucie ( currency) jako ciąg znaków. |
value |
Typ:
numberWartość 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.
Właściwości | |
|---|---|
arrival_stop |
Typ:
TransitStopPrzystanek docelowy tego etapu transportu publicznego. |
arrival_time |
Typ:
TimeCzas przybycia na ten etap, określony jako obiekt Time. |
departure_stop |
Typ:
TransitStopPrzystanek początkowy tego etapu podróży transportem publicznym. |
departure_time |
Typ:
TimeCzas rozpoczęcia tego kroku określony jako obiekt Time. |
headsign |
Typ:
stringKierunek, w którym należy jechać tą linią, zgodnie z oznaczeniem na pojeździe lub na przystanku początkowym. |
headway |
Typ:
numberOczekiwana liczba sekund między równoważnymi pojazdami na tym przystanku. |
line |
Typ:
TransitLineSzczegóły dotyczące linii transportu publicznego używanej na tym etapie. |
num_stops |
Typ:
numberLiczba przystanków na tym etapie. Obejmuje przystanek docelowy, ale nie przystanek początkowy. |
trip_short_name |
Typ:
stringTekst, 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.
Właściwości | |
|---|---|
location |
Typ:
LatLngLokalizacja tego przystanku. |
name |
Typ:
stringNazwa tego przystanku. |
Interfejs TransitLine
Interfejs
google.maps.TransitLine
Informacje o linii transportu publicznego, która obsługuje ten etap podróży.
Właściwości | |
|---|---|
agencies |
Typ:
Array<TransitAgency>Przewoźnik, który obsługuje tę linię transportu publicznego. |
color |
Typ:
stringKolor powszechnie używany w oznakowaniu tej linii transportu publicznego, reprezentowany jako ciąg szesnastkowy. |
icon |
Typ:
stringAdres URL ikony powiązanej z tą linią. |
name |
Typ:
stringPełna nazwa tej linii transportu publicznego, np. „8 Avenue Local”. |
short_name |
Typ:
stringKrótka nazwa tej linii transportu publicznego, np. „E”. |
text_color |
Typ:
stringKolor tekstu powszechnie używany na znakach tej linii transportu publicznego, reprezentowany jako ciąg szesnastkowy. |
url |
Typ:
stringAdres URL agencji, który jest powiązany z tą linią transportu publicznego. |
vehicle |
Typ:
TransitVehiclerodzaj 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.
Właściwości | |
|---|---|
name |
Typ:
stringNazwa przewoźnika. |
phone |
Typ:
stringNumer telefonu przewoźnika. |
url |
Typ:
stringAdres URL przewoźnika. |
Interfejs TransitVehicle
Interfejs
google.maps.TransitVehicle
Informacje o pojeździe, który obsługuje linię transportu publicznego.
Właściwości | |
|---|---|
icon |
Typ:
stringAdres URL ikony odpowiadającej typowi pojazdu używanego na tej linii. |
local_icon |
Typ:
stringAdres URL ikony odpowiadającej typowi pojazdu używanego w tym regionie zamiast bardziej ogólnej ikony. |
name |
Typ:
stringNazwa tego typu pojazdu transportu publicznego, np. „Pociąg” lub „Autobus”. |
type |
Typ:
VehicleTypeTyp 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");
Stałe | |
|---|---|
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");
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ści
Interfejs
google.maps.Distance
Reprezentacja odległości jako wartości liczbowej i ciągu znaków do wyświetlenia.
Właściwości | |
|---|---|
text |
Typ:
stringCiąg tekstowy reprezentujący wartość odległości, używający parametru UnitSystem określonego w żądaniu. |
value |
Typ:
numberOdległość w metrach. |
Interfejs Duration
Interfejs
google.maps.Duration
Reprezentacja czasu trwania jako wartości liczbowej i ciągu znaków.
Właściwości | |
|---|---|
text |
Typ:
stringCiąg znaków reprezentujący wartość czasu trwania. |
value |
Typ:
numberCzas trwania w sekundach. |
Interfejs Time
Interfejs
google.maps.Time
Reprezentacja czasu jako obiektu Date, zlokalizowanego ciągu znaków i strefy czasowej.
Właściwości | |
|---|---|
text |
Typ:
stringCiąg znaków reprezentujący wartość czasu. Godzina jest wyświetlana w strefie czasowej przystanku. |
time_zone |
Typ:
stringStrefa czasowa, w której znajduje się ten przystanek. Wartość to nazwa strefy czasowej zdefiniowana w bazie danych stref czasowych IANA, np. „America/New_York”. |
value |
Typ:
DateGodzina odjazdu lub przyjazdu określona jako obiekt Date w JavaScripcie. |