Distance Matrix

DistanceMatrixService class

google.maps.DistanceMatrixService class

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

Dostęp przez połączenie telefoniczne 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: 
Wartość zwracana:  Promise<DistanceMatrixResponse>
wysyła żądanie macierzy odległości;

Interfejs DistanceMatrixRequest

google.maps.DistanceMatrixRequestinterfejs

Zapytanie dotyczące macierzy odległości wysłane przez DistanceMatrixService zawierające tablice lokalizacji źródłowej i docelowej oraz różne opcje obliczania danych.
destinations
Tablica zawierająca ciągi znaków adresu docelowego lub obiekty LatLng lub Place, dla których ma zostać obliczona odległość i czas. Wymagane.
origins
Tablica zawierająca ciągi znaków adresu źródłowego lub obiekty LatLng lub Place, na podstawie których można obliczyć odległość i czas. Wymagane.
travelMode
Typ:  TravelMode
Typ routingu. Wymagane.
avoidFerries optional
Typ:  boolean optional
Jeśli true, usługa Distance Matrix instruuje, aby w miarę możliwości unikać przepraw promowych. Opcjonalnie:
avoidHighways optional
Typ:  boolean optional
Jeśli true, usługa Distance Matrix instruuje, aby w miarę możliwości omijać autostrady. Opcjonalnie:
avoidTolls optional
Typ:  boolean optional
Jeśli true, usługa Distance Matrix instruuje, aby w miarę możliwości unikać dróg płatnych. Opcjonalnie:
drivingOptions optional
Typ:  DrivingOptions optional
Ustawienia, które mają zastosowanie tylko do żądań, w których travelMode to DRIVING. Ten obiekt nie będzie miał wpływu na inne tryby podróży.
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 preferencja w przypadku żądań geokodowania. Kod regionu może mieć 2-znakową wartość domeny krajowej najwyższego poziomu. Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład 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 optional
Typ:  TransitOptions optional
Ustawienia, które mają zastosowanie tylko do żądań, w których travelMode to TRANSIT. Ten obiekt nie będzie miał wpływu na inne tryby podróży.
unitSystem optional
Typ:  UnitSystem optional
Preferowany układ jednostek do wyświetlania odległości. Opcjonalnie; domyślnie „metric”.

Interfejs DistanceMatrixResponse

google.maps.DistanceMatrixResponseinterfejs

Odpowiedź na żądanie DistanceMatrixService, która zawiera sformatowane adresy źródłowy i docelowy oraz sekwencję DistanceMatrixResponseRow, po jednej dla każdego odpowiadającego adresu źródłowego.
destinationAddresses
Typ:  Array<string>
Sformatowane adresy docelowe.
originAddresses
Typ:  Array<string>
Sformatowane adresy źródłowe.
rows
Wiersze macierzy odpowiadające adresom źródłowym.

Interfejs DistanceMatrixResponseRow

google.maps.DistanceMatrixResponseRowinterfejs

Wiersz odpowiedzi na żądanie DistanceMatrixService, który składa się z sekwencji wartości DistanceMatrixResponseElement, po jednej dla każdego odpowiedniego adresu docelowego.
elements
Elementy wiersza odpowiadające adresom docelowym.

Interfejs DistanceMatrixResponseElement

google.maps.DistanceMatrixResponseElementinterfejs

Pojedynczy element odpowiedzi na żądanie DistanceMatrixService, który zawiera czas trwania i odległość od jednego miejsca pochodzenia do jednego miejsca docelowego.
distance
Typ:  Distance
Odległość między parą miejsc: miejsce wylotu i miejsce docelowe. Ta właściwość może być niezdefiniowana, ponieważ odległość może być nieznana.
duration
Typ:  Duration
Czas trwania pary „miejsce początkowe – miejsce docelowe”. Ta właściwość może być niezdefiniowana, ponieważ czas trwania może być nieznany.
duration_in_traffic
Typ:  Duration
Czas trwania pary „punkt początkowy–punkt docelowy”, uwzględniający warunki ruchu wskazane przez usługę trafficModel. Ta wartość może być undefined, ponieważ czas trwania może być nieznany. Dostępne tylko dla klientów z abonamentem Premium, gdy drivingOptions jest zdefiniowany w momencie wysyłania żądania.
fare
Łączna cena za połączenie między miejscem wyjazdu a miejscem docelowym. Dotyczy tylko próśb o przejazd.
status
Stan tego konkretnego połączenia między miejscem wylotu a miejscem docelowym.

stałe DistanceMatrixStatus

google.maps.DistanceMatrixStatus stałe

Ogólny stan żądania z poziomu najwyższego zwracany przez usługę DistanceMatrixService po zakończeniu przetwarzania żądania dotyczącego macierzy odległości. Określ je za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.DistanceMatrixStatus.OK.

Dostęp przez połączenie telefoniczne const {DistanceMatrixStatus} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w Maps JavaScript API.
INVALID_REQUEST Podane żądanie było nieprawidłowe.
MAX_DIMENSIONS_EXCEEDED Żądanie zawiera więcej niż 25 miejsc początkowych lub więcej niż 25 miejsc docelowych.
MAX_ELEMENTS_EXCEEDED Wynik mnożenia liczby miejsc początkowych i celowych przekracza limit na zapytanie.
OK Odpowiedź zawiera prawidłowy wynik.
OVER_QUERY_LIMIT W dozwolonym czasie wysłano żądanie dotyczące zbyt wielu elementów. Jeśli spróbujesz ponownie po jakimś czasie, żądanie powinno się powieść.
REQUEST_DENIED Usługa odmówiła stronie internetowej korzystania z usługi Distance Matrix.
UNKNOWN_ERROR Nie udało się zrealizować żądania dotyczącego odległości z powodu błędu serwera. Jeśli spróbujesz ponownie, żądanie może się powieść.

DistanceMatrixElementStatus: stałe

google.maps.DistanceMatrixElementStatus stałe

Stan na poziomie elementu dotyczący konkretnego połączenia źródło–cel zwrócony przez DistanceMatrixService po zakończeniu przetwarzania żądania dotyczącego macierzy odległości. Te wartości są podawane jako ciągi znaków, np. 'OK'.

Dostęp przez połączenie telefoniczne const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w Maps JavaScript API.
NOT_FOUND Nie udało się zgeokodować miejsca początkowego lub docelowego tego połączenia.
OK Odpowiedź zawiera prawidłowy wynik.
ZERO_RESULTS Nie udało się znaleźć trasy między miejscem wylotu a miejscem docelowym.