Distance Matrix

Klasa DistanceMatrixService

google.maps.DistanceMatrixService zajęcia

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

Aby uzyskać dostęp, zadzwoń pod numer const {DistanceMatrixService} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

DistanceMatrixService
DistanceMatrixService()
Parametry: brak
Tworzy nową instancję obiektu DistanceMatrixService, który wysyła do serwerów Google zapytania macierzy odległości.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parametry: 
Wartość zwrotu:  Promise<DistanceMatrixResponse>
Wysyła żądanie macierzy odległości.

Interfejs DistanceMatrixRequest

google.maps.DistanceMatrixRequest interfejs

Zapytanie dotyczące macierzy odległości wysyłane przez DistanceMatrixService, zawierające tablice lokalizacji miejsca wylotu i docelowego oraz różne opcje obliczania danych.

destinations
Tablica zawierająca ciągi adresów docelowych, obiekty LatLng lub Place, dla których obliczane jest odległość i czas. To pole jest wymagane.
origins
Tablica zawierająca ciągi adresu punktu początkowego, obiekty LatLng lub Place, na podstawie których oblicza się odległość i czas. To pole jest wymagane.
travelMode
Typ:  TravelMode
Żądany typ routingu. To pole jest wymagane.
avoidFerries optional
Typ:  boolean optional
Jeśli true, instruuje usługę macierzy odległości, aby w miarę możliwości unikała przepraw promowych. Opcjonalnie.
avoidHighways optional
Typ:  boolean optional
Jeśli true, instruuje usługę Macierz odległości, aby w miarę możliwości unikać autostrad. Opcjonalnie.
avoidTolls optional
Typ:  boolean optional
Jeśli true, instruuje usługę Macierz odległości, aby unikała dróg płatnych, gdy to możliwe. Opcjonalnie.
drivingOptions optional
Typ:  DrivingOptions optional
Ustawienia, które mają zastosowanie tylko do żądań, w których travelMode to DRIVING. Ten obiekt nie ma wpływu na inne środki transportu.
language optional
Typ:  string optional
Identyfikator języka, w którym powinny być zwracane wyniki, jeśli to możliwe. Zobacz listę obsługiwanych języków.
region optional
Typ:  string optional
Kod regionu używany do promowania żądań geokodowania. Kod regionu akceptuje dwuznaczną wartość ccTLD („domena najwyższego poziomu”). Większość kodów domen ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma wyjątkami. Na przykład domena ccTLD w Wielkiej Brytanii to „uk” (.co.uk), a kod ISO 3166-1 to „gb” (technicznie oznacza to „Wielka Brytania i Irlandia Północna”).
transitOptions optional
Typ:  TransitOptions optional
Ustawienia, które mają zastosowanie tylko do żądań, w przypadku których travelMode to TRANSIT. Ten obiekt nie ma wpływu na inne środki transportu.
unitSystem optional
Typ:  UnitSystem optional
Preferowany system jednostek do wyświetlania odległości. Opcjonalny; domyślnie przyjmuje wartość wskaźnika.

Interfejs DistanceMatrixResponse

google.maps.DistanceMatrixResponse interfejs

Odpowiedź na żądanie DistanceMatrixService, która składa się ze sformatowanych adresów miejsca wylotu i docelowego oraz sekwencji DistanceMatrixResponseRow, po jednym dla każdego adresu miejsca wylotu.

destinationAddresses
Typ:  Array<string>
Sformatowane adresy docelowe.
originAddresses
Typ:  Array<string>
Sformatowane adresy punktu początkowego.
rows
Wiersze macierzy odpowiadające adresom początkowym.

Interfejs DistanceMatrixResponseRow

google.maps.DistanceMatrixResponseRow interfejs

Wiersz odpowiedzi na żądanie DistanceMatrixService, który składa się z sekwencji DistanceMatrixResponseElement, po jednym dla każdego adresu docelowego.

elements
Elementy wiersza odpowiadające adresom docelowym.

Interfejs DistanceMatrixResponseElement

google.maps.DistanceMatrixResponseElement interfejs

Pojedynczy element odpowiedzi na żądanie DistanceMatrixService, który zawiera informacje o czasie trwania i odległości od miejsca wylotu do jednego miejsca docelowego.

distance
Typ:  Distance
Odległość w parach tych miejsc odjazdu i miejsca docelowego. Ta właściwość może być nieokreślona, ponieważ odległość może być nieznana.
duration
Typ:  Duration
Czas trwania tej pary miejsca odjazdu z miejscem docelowym. Ta właściwość może być nieokreślona, ponieważ czas trwania może być nieznany.
duration_in_traffic
Typ:  Duration
Czas trwania tej pary miejsca wylotu i miejsca docelowego z uwzględnieniem warunków na drodze wskazanych przez właściwość trafficModel. 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, jeśli podczas przesyłania żądania określono drivingOptions.
fare
Łączna cena za tę parę wylotu i miejsca docelowego. Dotyczy tylko próśb o transport.
status
Stan tej konkretnej pary miejsca odjazdu z miejscem docelowym.

stałe DistanceMatrixStatus

google.maps.DistanceMatrixStatus stałe

Stan najwyższego poziomu dotyczący żądania ogólnie zwracany przez funkcję DistanceMatrixService po zakończeniu żądania macierzy odległości. Określ je według wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.DistanceMatrixStatus.OK.

Aby uzyskać dostęp, zadzwoń pod numer const {DistanceMatrixStatus} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

INVALID_REQUEST Podane żądanie było nieprawidłowe.
MAX_DIMENSIONS_EXCEEDED Żądanie zawiera więcej niż 25 punktów początkowych lub ponad 25 miejsc docelowych.
MAX_ELEMENTS_EXCEEDED Iloczyn punktów początkowych i miejsc docelowych przekracza limit przypadający na zapytanie.
OK Odpowiedź zawiera prawidłowy wynik.
OVER_QUERY_LIMIT Zażądano zbyt wielu elementów w dozwolonym okresie. Żądanie powinno się powieść, jeśli spróbujesz ponownie za jakiś czas.
REQUEST_DENIED Usługa odmówiła wykorzystania usługi Macierz 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 określonej pary punktu początkowego i docelowego zwrócony przez DistanceMatrixService po zakończeniu żądania macierzy odległości. Wartości te są określane za pomocą ciągów, np. 'OK'.

Aby uzyskać dostęp, zadzwoń pod numer const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes"). Zobacz Biblioteki w interfejsie Maps JavaScript API.

NOT_FOUND Nie udało się geokodować miejsca wylotu lub miejsca docelowego tej pary.
OK Odpowiedź zawiera prawidłowy wynik.
ZERO_RESULTS Nie znaleziono trasy między miejscem wylotu a celem podróży.