Klasa OdległośćMatrixService
google.maps.DistanceMatrixService
klasa
Usługa obliczania odległości między wieloma źródłami i miejscami docelowymi.
Zadzwoń pod numer const {DistanceMatrixService} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Zespół | |
---|---|
DistanceMatrixService |
DistanceMatrixService() Parametry: brak
Tworzy nowe wystąpienie DistanceMatrixService , które wysyła zapytania macierzy odległości do serwerów Google. |
Metody | |
---|---|
getDistanceMatrix |
getDistanceMatrix(request[, callback]) Parametry:
Zwrócona wartość:
Promise<DistanceMatrixResponse> Wysyła żądanie macierzy odległości. |
Interfejs OdległośćMatrix
google.maps.DistanceMatrixRequest
interfejs
Zapytanie o macierz odległości wysłane przez DistanceMatrixService
z tablicami z miejscami docelowymi i docelowymi oraz różnymi opcjami dotyczącymi danych obliczeniowych.
Właściwości | |
---|---|
destinations |
Typ:
Array<string|LatLng|LatLngLiteral|Place> Tablica zawierająca ciągi adresów docelowych, obiekty LatLng lub Place , do których oblicza się dystans i czas. Wymagany. |
origins |
Typ:
Array<string|LatLng|LatLngLiteral|Place> Tablica zawierająca ciągi znaków adresu początkowego lub obiekty LatLng lub Place , od których oblicza się dystans i czas. Wymagany. |
travelMode |
Typ:
TravelMode Żądany typ routingu. Wymagany. |
avoidFerries optional |
Typ:
boolean optional Jeśli true , w miarę możliwości usługa matrycy odległości ma unikać przepraw. Opcjonalnie. |
avoidHighways optional |
Typ:
boolean optional Jeśli true , w miarę możliwości usługa matrycy odległości ma unikać autostrad. Opcjonalnie. |
avoidTolls optional |
Typ:
boolean optional Jeśli true , w miarę możliwości unika usługi płatnych, tamto. Opcjonalnie. |
drivingOptions optional |
Typ:
DrivingOptions optional Ustawienia stosowane tylko do żądań, w których travelMode to DRIVING . Nie będzie to miało wpływu na inne środki transportu. |
language optional |
Typ:
string optional Identyfikator języka, w którym jest zwracany wynik (jeśli to możliwe). Zobacz listę obsługiwanych języków. |
region optional |
Typ:
string optional Kod regionu używany jako odchylenie w żądaniach geokodowania. Kod regionu może mieć wartość 2-znakową ccTLD („domena 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 kod ISO 3166-1 to „gb” (technicznie dla podmiotu „Wielka Brytania i Irlandia Północna”). |
transitOptions optional |
Typ:
TransitOptions optional Ustawienia stosowane tylko do żądań, w przypadku których travelMode to TRANSPORT. Nie będzie to miało wpływu na inne środki transportu. |
unitSystem optional |
Typ:
UnitSystem optional Preferowany system jednostek podczas wyświetlania odległości. Opcjonalny; wartość domyślna to dane. |
Interfejs OdległośćMatrixResponse
google.maps.DistanceMatrixResponse
interfejs
Odpowiedź na żądanie DistanceMatrixService
, która zawiera sformatowany adres punktu początkowego i adresu docelowego, oraz sekwencję DistanceMatrixResponseRow
– po jednej dla każdego odpowiadającego mu adresu punktu początkowego.
Właściwości | |
---|---|
destinationAddresses |
Typ:
Array<string> Sformatowane adresy docelowe. |
originAddresses |
Typ:
Array<string> Sformatowany adres punktu początkowego. |
rows |
Wiersze macierzy odpowiadające adresom źródła. |
Interfejs OdległośćMatrixResponseRow
google.maps.DistanceMatrixResponseRow
interfejs
Wiersz odpowiedzi na żądanie DistanceMatrixService
składający się z sekwencji DistanceMatrixResponseElement
– po jednej dla każdego adresu docelowego.
Właściwości | |
---|---|
elements |
Elementy wiersza odpowiadające adresom docelowym. |
OdległośćMatrixResponseElement
google.maps.DistanceMatrixResponseElement
interfejs
Pojedynczy element odpowiedzi na żądanie DistanceMatrixService
, który zawiera czas trwania i odległość od jednego miejsca docelowego do jednego.
Właściwości | |
---|---|
distance |
Typ:
Distance Odległość dla tej pary miejsca wylotu do miejsca docelowego. Ta właściwość może być nieokreślona, ponieważ odległość może być nieznana. |
duration |
Typ:
Duration Czas parowania miejsca docelowego z miejscem docelowym. Może ona być nieokreślona, ponieważ czas trwania może być nieznany. |
duration_in_traffic |
Typ:
Duration Czas parowania miejsca docelowego z uwzględnieniem warunków ruchu określonych przez właściwość trafficModel . Może to być undefined , bo czas trwania może być nieznany. Dostępne tylko dla klientów korzystających z abonamentu Premium, jeśli określono żądanie drivingOptions . |
fare |
Typ:
TransitFare Łączne ceny parowania miejsca docelowego z miejscem docelowym. Dotyczy tylko żądań o transport publiczny. |
status |
Stan tej parowania miejsca docelowego z miejscem docelowym. |
stałe OdległośćMatrycy
google.maps.DistanceMatrixStatus
stałe
Ogólny stan żądania zwróconego ogólnie przez DistanceMatrixService
po zakończeniu żądania macierzy odległości. Określ je za pomocą wartości lub używając stałej wartości. na przykład 'OK'
lub google.maps.DistanceMatrixStatus.OK
.
Zadzwoń pod numer const {DistanceMatrixStatus} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
INVALID_REQUEST |
Podane żądanie było nieprawidłowe. |
MAX_DIMENSIONS_EXCEEDED |
Żądanie zawiera ponad 25 źródeł lub więcej niż 25 miejsc docelowych. |
MAX_ELEMENTS_EXCEEDED |
Usługa źródeł 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. Jeśli po jakimś czasie spróbujesz jeszcze raz, prośba powinna się wyświetlić. |
REQUEST_DENIED |
Usługa odmówiła dostępu do usługi macierzy odległości. |
UNKNOWN_ERROR |
Nie udało się przetworzyć żądania macierzy macierzystej z powodu błędu serwera. Jeśli spróbujesz ponownie, prośba może się nie powieść. |
stałe OdległośćMatrixElementStatus
google.maps.DistanceMatrixElementStatus
stałe
Stan na poziomie elementu związany z konkretną parą cel-miejsce docelowe zwrócony przez DistanceMatrixService
po zakończeniu żądania macierzy odległości. Wartości te są określane jako ciągi znaków, na przykład 'OK'
.
Zadzwoń pod numer const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes")
. Zobacz Biblioteki w interfejsie Maps JavaScript API.
Stałe | |
---|---|
NOT_FOUND |
Nie można przetworzyć danych geograficznych źródła ani miejsca docelowego tej pary. |
OK |
Odpowiedź zawiera prawidłowy wynik. |
ZERO_RESULTS |
Nie znaleziono trasy między miejscem początkowym a miejscem docelowym. |