Distance Matrix

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.
DistanceMatrixService
DistanceMatrixService()
Parametry: brak
Tworzy nowe wystąpienie DistanceMatrixService, które wysyła zapytania macierzy odległości do serwerów Google.
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.
destinations
Tablica zawierająca ciągi adresów docelowych, obiekty LatLng lub Place, do których oblicza się dystans i czas. Wymagany.
origins
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.
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.
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.
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
Łą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.
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.
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.