Distance Matrix

DistanceMatrixService class

google.maps.DistanceMatrixService zajęcia

Usługa obliczania odległości między wieloma punktami początkowymi i docelowymi.

Dostęp przez połączenie pod numer const {DistanceMatrixService} = await google.maps.importLibrary("routes").
 Zobacz Biblioteki w Maps JavaScript API.
DistanceMatrixService
DistanceMatrixService()
Parametry: brak
Tworzy nową instancję DistanceMatrixService, która wysyła zapytania o macierz odległości do serwerów Google.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parametry: 
Zwracana wartość:  Promise<DistanceMatrixResponse>
Wysyła żądanie macierzy odległości.

DistanceMatrixRequest interface

google.maps.DistanceMatrixRequestinterfejs

Zapytanie o macierz odległości wysłane przez DistanceMatrixService zawierające tablice lokalizacji początkowych i docelowych oraz różne opcje obliczania danych.
destinations
Tablica zawierająca ciągi adresów docelowych, obiekty LatLng lub Place, dla których należy obliczyć odległość i czas. Wymagane.
origins
Tablica zawierająca ciągi adresów początkowych, obiekty LatLng lub Place, na podstawie których mają być obliczane odległość i czas. Wymagane.
travelMode
Typ:  TravelMode
Rodzaj żądanego routingu. Wymagane.
avoidFerries optional
Typ:  boolean optional
Jeśli true, usługa macierzy odległości ma unikać przepraw promowych, gdy jest to możliwe. Opcjonalnie.
avoidHighways optional
Typ:  boolean optional
Jeśli true, usługa macierzy odległości będzie unikać autostrad, gdy tylko będzie to możliwe. Opcjonalnie.
avoidTolls optional
Typ:  boolean optional
Jeśli true, usługa macierzy odległości będzie unikać dróg płatnych, gdy będzie to możliwe. 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.
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
Preferowany układ jednostek do wyświetlania odległości. Opcjonalny; domyślnie ustawiony na system metryczny.

DistanceMatrixResponse interfejs

google.maps.DistanceMatrixResponseinterfejs

Odpowiedź na żądanie DistanceMatrixService, która zawiera sformatowane adresy początkowe i docelowe oraz sekwencję obiektów DistanceMatrixResponseRow, po jednym dla każdego odpowiedniego adresu początkowego.
destinationAddresses
Typ:  Array<string>
Sformatowane adresy miejsc docelowych.
originAddresses
Typ:  Array<string>
Sformatowane adresy źródłowe.
rows
Wiersze macierzy odpowiadające adresom początkowym.

DistanceMatrixResponseRow interfejs

google.maps.DistanceMatrixResponseRowinterfejs

Wiersz odpowiedzi na żądanie DistanceMatrixService, składający się z sekwencji DistanceMatrixResponseElement, po jednym dla każdego odpowiedniego adresu docelowego.
elements
Elementy wiersza odpowiadające adresom docelowym.

DistanceMatrixResponseElement interface

google.maps.DistanceMatrixResponseElementinterfejs

Pojedynczy element odpowiedzi na żądanie DistanceMatrixService, który zawiera czas trwania i odległość od jednego punktu początkowego do jednego punktu docelowego.
distance
Typ:  Distance
Odległość dla tej pary miejsc wylotu i docelowego. Ta właściwość może być niezdefiniowana, ponieważ odległość może być nieznana.
duration
Typ:  Duration
Czas trwania dla tej pary miejsc początkowych i docelowych. Ta właściwość może być niezdefiniowana, ponieważ czas trwania może być nieznany.
duration_in_traffic
Typ:  Duration
Czas trwania dla tej pary punktów początkowych i docelowych z uwzględnieniem warunków drogowych wskazanych przez właściwość trafficModel. Ta właściwość może mieć wartość undefined, ponieważ czas trwania może być nieznany. Dostępne tylko dla klientów korzystających z abonamentu Premium, gdy podczas przesyłania żądania zdefiniowano drivingOptions.
fare
Całkowita cena za tę parę miejsc docelowych. Dotyczy to tylko żądań dotyczących transportu publicznego.
status
Stan tej konkretnej pary miejsc docelowych.

Stałe DistanceMatrixStatus

google.maps.DistanceMatrixStatus stałe

Ogólny stan żądania zwrócony przez interfejs DistanceMatrixService po zakończeniu żądania macierzy odległości. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.DistanceMatrixStatus.OK.

Dostęp przez połączenie pod numer const {DistanceMatrixStatus} = await google.maps.importLibrary("routes").
 Zobacz Biblioteki w Maps JavaScript API.
INVALID_REQUEST Przesłane żądanie było nieprawidłowe.
MAX_DIMENSIONS_EXCEEDED Żądanie zawiera więcej niż 25 źródeł lub więcej niż 25 miejsc docelowych.
MAX_ELEMENTS_EXCEEDED Iloczyn liczby punktów początkowych i docelowych przekracza limit zapytań.
OK Odpowiedź zawiera prawidłowy wynik.
OVER_QUERY_LIMIT W dozwolonym okresie zażądano zbyt wielu elementów. Jeśli spróbujesz ponownie za jakiś czas, żądanie powinno się powieść.
REQUEST_DENIED Usługa odmówiła użycia usługi macierzy odległości przez Twoją stronę internetową.
UNKNOWN_ERROR Nie udało się przetworzyć żądania macierzy odległości z powodu błędu serwera. Jeśli spróbujesz ponownie, żądanie może się powieść.

Stałe DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus stałe

Stan na poziomie elementu dotyczący konkretnej pary miejsc docelowych i początkowych zwracany przez interfejs DistanceMatrixService po zakończeniu żądania macierzy odległości. Wartości te są podawane jako ciągi znaków, np. 'OK'.

Dostęp przez połączenie pod numer const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes").
 Zobacz Biblioteki w Maps JavaScript API.
NOT_FOUND Nie udało się określić współrzędnych geograficznych miejsca początkowego lub docelowego tej pary.
OK Odpowiedź zawiera prawidłowy wynik.
ZERO_RESULTS Nie udało się znaleźć trasy między miejscem wylotu a celem podróży.