Directions

DirectionsService class

google.maps.DirectionsService zajęcia

Usługa do obliczania trasy między co najmniej 2 miejscami.

Dostęp przez połączenie pod numer const {DirectionsService} = await google.maps.importLibrary("routes").
 Zobacz Biblioteki w Maps JavaScript API.
DirectionsService
DirectionsService()
Parametry: brak
Tworzy nową instancję klasy DirectionsService, która wysyła zapytania o wskazówki dojazdu na serwery Google.
route
route(request[, callback])
Parametry: 
Zwracana wartość:  Promise<DirectionsResult>
Wysyłanie zapytania o wskazówki dojazdu.

Interfejs DirectionsRequest

google.maps.DirectionsRequestinterfejs

Zapytanie o wskazówki dojazdu, które ma zostać wysłane do DirectionsService.
destination
Typ:  string|LatLng|Place|LatLngLiteral
Lokalizacja miejsca docelowego. Może to być ciąg tekstowy do geokodowania, LatLng lub Place. Wymagane.
origin
Typ:  string|LatLng|Place|LatLngLiteral
Miejsce pochodzenia. Może to być ciąg tekstowy do geokodowania, LatLng lub Place. Wymagane.
travelMode
Typ:  TravelMode
Rodzaj żądanego routingu. Wymagane.
avoidFerries optional
Typ:  boolean optional
Jeśli true, usługa Wskazówki dojazdu będzie unikać przepraw promowych, gdy tylko będzie to możliwe. Opcjonalnie.
avoidHighways optional
Typ:  boolean optional
Jeśli true, usługa Wskazówki dojazdu będzie w miarę możliwości omijać autostrady. Opcjonalnie.
avoidTolls optional
Typ:  boolean optional
Jeśli true, usługa Wskazówki dojazdu będzie w miarę możliwości omijać drogi płatne. Opcjonalnie.
drivingOptions optional
Typ:  DrivingOptions optional
Ustawienia, które mają zastosowanie tylko do żądań, w których wartość parametru travelMode to DRIVING. W przypadku innych środków transportu ten obiekt nie będzie miał żadnego wpływu.
language optional
Typ:  string optional
Identyfikator języka, w którym mają być zwracane wyniki (jeśli to możliwe). Zobacz listę obsługiwanych języków.
optimizeWaypoints optional
Typ:  boolean optional
Jeśli wartość tego parametru to true, usługa DirectionsService spróbuje zmienić kolejność podanych pośrednich punktów trasy, 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 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 przypadku żądań 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 krajowa domena najwyższego poziomu Zjednoczonego Królestwa to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Zjednoczone Królestwo Wielkiej Brytanii i Irlandii Północnej”).
transitOptions optional
Typ:  TransitOptions optional
Ustawienia, które mają zastosowanie tylko do żądań, w których travelMode to TRANSIT. W przypadku innych środków transportu ten obiekt nie będzie miał żadnego wpływu.
unitSystem optional
Typ:  UnitSystem optional
Domyślne: system jednostek używany w kraju pochodzenia.
Preferowany układ jednostek do wyświetlania odległości.
waypoints optional
Typ:  Array<DirectionsWaypoint> optional
Tablica pośrednich punktów na trasie. Wskazówki dojazdu są obliczane od miejsca początkowego do miejsca docelowego przez każdy punkt pośredni w 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.

DirectionsStatus stałe

google.maps.DirectionsStatus stałe

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

Dostęp przez połączenie pod numer const {DirectionsStatus} = await google.maps.importLibrary("routes").
 Zobacz Biblioteki w Maps JavaScript API.
INVALID_REQUEST Podany plik DirectionsRequest jest nieprawidłowy.
MAX_WAYPOINTS_EXCEEDED W elemencie DirectionsRequest podano zbyt wiele elementów DirectionsWaypoint. Maksymalną dozwoloną liczbę punktów pośrednich znajdziesz w  przewodniku dla programistów.
NOT_FOUND Nie udało się określić współrzędnych geograficznych co najmniej jednego z tych elementów: punkt początkowy, miejsce docelowe lub punkty pośrednie.
OK Odpowiedź zawiera prawidłowy 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 dotyczącego wskazówek dojazdu z powodu błędu serwera. Jeśli spróbujesz ponownie, żądanie może się powieść.
ZERO_RESULTS Nie udało się znaleźć trasy między miejscem wylotu a celem podróży.

DirectionsResult interfejs

google.maps.DirectionsResultinterfejs

Odpowiedź z serwera wskazówek dojazdu. Możesz je renderować za pomocą DirectionsRenderer lub samodzielnie przeanalizować ten obiekt i go wyrenderować. Musisz wyświetlać ostrzeżenia i informacje o prawach autorskich zgodnie z Warunkami korzystania z Google Maps Platform. Pamiętaj, że chociaż ten wynik jest „podobny do JSON”, nie jest to ściśle JSON, ponieważ pośrednio zawiera obiekty LatLng.
request
Obiekt DirectionsRequest, który zwrócił ten wynik.
routes
Tablica obiektów DirectionsRoute, z których każdy zawiera informacje o odcinkach i krokach, z których się składa. Będzie tylko jedna trasa, chyba że DirectionsRequest została utworzona z ustawieniem provideRouteAlternatives na true.
available_travel_modes optional
Typ:  Array<TravelMode> optional
Zawiera tablicę dostępnych trybów podróży. To pole jest zwracane, gdy żądanie określa tryb podróży i nie uzyskuje żadnych wyników. Tablica zawiera dostępne środki transportu w krajach, w których znajdują się podane punkty pośrednie. To pole nie jest zwracane, jeśli co najmniej jeden z punktów pośrednich jest punktem „via waypoint”.
geocoded_waypoints optional
Tablica obiektów DirectionsGeocodedWaypoint, z których każdy zawiera informacje o geokodowaniu punktu początkowego, miejsca docelowego i punktów pośrednich.

DirectionsRenderer class

google.maps.DirectionsRenderer zajęcia

Wyświetla wskazówki dojazdu uzyskane z usługi DirectionsService.

Ta klasa rozszerza klasę MVCObject.

Dostęp przez połączenie pod numer const {DirectionsRenderer} = await google.maps.importLibrary("routes").
 Zobacz Biblioteki w Maps JavaScript API.
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 <div> panelu (jako instrukcje tekstowe).
getDirections
getDirections()
Parametry: brak
Zwracana wartość:  DirectionsResult
Zwraca bieżący zestaw kierunków renderera.
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 moduł renderujący, aby używał wyniku z funkcji DirectionsService. Ustawienie w ten sposób prawidłowego zestawu wskazówek spowoduje wyświetlenie ich na wyznaczonej mapie i w panelu renderera.
setMap
setMap(map)
Parametry: 
Zwracana wartość: brak
Ta metoda określa mapę, na której będą renderowane wskazówki dojazdu. Przekaż null, aby usunąć wskazówki z mapy.
setOptions
setOptions(options)
Parametry: 
Zwracana wartość: brak
Zmień ustawienia opcji tego urządzenia DirectionsRenderer po inicjalizacji.
setPanel
setPanel(panel)
Parametry: 
Zwracana wartość: brak
Ta metoda renderuje wskazówki dojazdu w <div>. Kliknij null, aby usunąć treść z panelu.
setRouteIndex
setRouteIndex(routeIndex)
Parametry: 
  • routeIndex:  number
Zwracana wartość: brak
Ustaw indeks (liczony od zera) trasy w obiekcie DirectionsResult, która ma być renderowana. Domyślnie renderowana jest pierwsza trasa w tablicy.
Odziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
Argumenty: brak
To zdarzenie jest wywoływane, gdy zmieniają się wyrenderowane wskazówki dojazdu, np. gdy ustawiona zostanie nowa wartość DirectionsResult lub gdy użytkownik skończy przeciągać zmianę ścieżki wskazówek dojazdu.

DirectionsRendererOptions interfejs

google.maps.DirectionsRendererOptionsinterfejs

Ten obiekt określa właściwości, które można ustawić w obiekcie DirectionsRenderer.
directions optional
Typ:  DirectionsResult optional
Wskazówki dojazdu, które mają być wyświetlane na mapie lub w panelu <div>, pobrane jako obiekt DirectionsResult z DirectionsService.
draggable optional
Typ:  boolean optional
Jeśli true, użytkownik może przeciągać i modyfikować ścieżki tras renderowanych przez ten DirectionsRenderer.
hideRouteList optional
Typ:  boolean optional
Domyślnie: false
Ta właściwość określa, czy moduł renderujący ma udostępniać listę tras, którą użytkownik może wybrać w panelu wskazówek dojazdu.
infoWindow optional
Typ:  InfoWindow optional
InfoWindow, w którym mają być renderowane informacje tekstowe po kliknięciu znacznika. Dotychczasowa zawartość okna informacyjnego zostanie zastąpiona, a jego położenie ulegnie zmianie. Jeśli nie określono okna informacyjnego, DirectionsRenderer utworzy i użyje własnego okna informacyjnego. Ta właściwość jest ignorowana, jeśli wartość suppressInfoWindows to 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. Wszystkie znaczniki renderowane przez element DirectionsRenderer będą korzystać z tych opcji.
panel optional
Typ:  HTMLElement optional
<div>, w którym mają być wyświetlane instrukcje dojazdu.
polylineOptions optional
Typ:  PolylineOptions optional
Opcje polilinii. Wszystkie linie łamane renderowane przez DirectionsRenderer będą korzystać z tych opcji.
preserveViewport optional
Typ:  boolean optional
Domyślnie: false
Jeśli ta opcja ma wartość true lub środek i powiększenie mapy nigdy nie zostały ustawione, mapa wejściowa jest wyśrodkowana i powiększona do ramki ograniczającej tego zestawu wskazówek.
routeIndex optional
Typ:  number optional
Indeks trasy w obiekcie DirectionsResult. Wartością domyślną jest 0.
suppressBicyclingLayer optional
Typ:  boolean optional
Nie renderuj ikony BicyclingLayer, gdy użytkownik poprosi o wskazówki dojazdu rowerem.
suppressInfoWindows optional
Typ:  boolean optional
Wyłącz renderowanie okien informacyjnych.
suppressMarkers optional
Typ:  boolean optional
Blokowanie renderowania znaczników.
suppressPolylines optional
Typ:  boolean optional
Wyłącz renderowanie linii łamanych.

DirectionsWaypoint interface

google.maps.DirectionsWaypointinterfejs

Symbol DirectionsWaypoint oznacza lokalizację między miejscem początkowym a docelowym, przez którą powinna przebiegać trasa.
location optional
Typ:  string|LatLng|LatLngLiteral|Place optional
Lokalizacja punktu na trasie. Może to być ciąg znaków adresu, LatLng lub Place. Opcjonalnie.
stopover optional
Typ:  boolean optional
Domyślnie: true
Jeśli true, oznacza to, że ten punkt pośredni jest przystankiem między miejscem początkowym a docelowym. Spowoduje to podzielenie trasy na 2 odcinki. Jeśli false, oznacza to, że trasa powinna być ukierunkowana na ten punkt pośredni, ale nie powinna być dzielona na 2 odcinki. Jest to przydatne, gdy chcesz utworzyć trasę w odpowiedzi na przeciąganie punktów trasy przez użytkownika na mapie.

Interfejs DirectionsGeocodedWaypoint

google.maps.DirectionsGeocodedWaypointinterfejs

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

DirectionsRoute interfejs

google.maps.DirectionsRouteinterfejs

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