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.

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:  request:  DistanceMatrixRequest callback:  function(DistanceMatrixResponse optional, DistanceMatrixStatus): void optional 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	Typ:  Array<DistanceMatrixResponseRow> 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	Typ:  Array<DistanceMatrixResponseElement> 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	Typ:  DistanceMatrixElementStatus 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.