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ść: