Distance Matrix (deprecated)

Klasa DistanceMatrixService

google.maps.DistanceMatrixService klasa
biblioteka "routes" 

const {DistanceMatrixService} = await google.maps.importLibrary("routes");
DistanceMatrixService
DistanceMatrixService()
Parametry: brak
Tworzy nową instancję DistanceMatrixService, która wysyła zapytania dotyczące macierzy 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

Interfejs google.maps.DistanceMatrixRequest

Zapytanie dotyczące macierzy odległości wysłane przez DistanceMatrixService, zawierające tablice lokalizacji początkowych i docelowych oraz różne opcje obliczania danych.
destinations
Tablica zawierająca ciągi adresów docelowych lub obiekty LatLng lub Place, dla których ma zostać obliczona odległość i czas. Wymagane.
origins
Tablica zawierająca ciągi znaków adresów początkowych lub obiekty LatLng lub Place, na podstawie których obliczana jest odległość i czas. Wymagane.
travelMode
Typ żądanego routingu. Wymagane.
avoidFerries
opcjonalne
Typ: boolean optional
Jeśli ma wartość true, usługa Distance Matrix będzie w miarę możliwości unikać promów. Opcjonalnie:
avoidHighways
opcjonalne
Typ: boolean optional
Jeśli ma wartość true, usługa Distance Matrix będzie w miarę możliwości unikać autostrad. Opcjonalnie:
avoidTolls
opcjonalne
Typ: boolean optional
Jeśli ma wartość true, usługa Distance Matrix będzie w miarę możliwości unikać dróg płatnych. Opcjonalnie:
drivingOptions
opcjonalne
Typ: DrivingOptions optional
Ustawienia, które mają zastosowanie tylko do żądań, w przypadku których travelMode to DRIVING. Ten obiekt nie będzie miał wpływu na inne środki transportu.
language
opcjonalne
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
opcjonalne
Typ: string optional
Kod regionu używany jako preferencja w żądaniach geokodowania. Kod regionu akceptuje 2-znakową wartość ccTLD („domena najwyższego poziomu”). Większość kodów ccTLD jest identyczna z kodami ISO 3166-1, z kilkoma istotnymi wyjątkami. Na przykład domena 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
opcjonalne
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 środki transportu.
unitSystem
opcjonalne
Typ: UnitSystem optional
Preferowany układ jednostek do wyświetlania odległości. Opcjonalny, domyślnie: metric.

Interfejs DistanceMatrixResponse

Interfejs google.maps.DistanceMatrixResponse

Odpowiedź na żądanie DistanceMatrixService, składająca się ze sformatowanych adresów początkowych i docelowych oraz sekwencji DistanceMatrixResponseRow, po jednym dla każdego odpowiadającego adresu początkowego.
destinationAddresses
Typ: Array<string>
Sformatowane adresy docelowe.
originAddresses
Typ: Array<string>
Sformatowane adresy początkowe.
rows
Wiersze macierzy odpowiadające adresom początkowym.

Interfejs DistanceMatrixResponseRow

Interfejs google.maps.DistanceMatrixResponseRow

Wiersz odpowiedzi na żądanie DistanceMatrixService, składający się z sekwencji DistanceMatrixResponseElement, po jednym dla każdego odpowiadającego adresu docelowego.
elements
Elementy wiersza odpowiadające adresom docelowym.

Interfejs DistanceMatrixResponseElement

Interfejs google.maps.DistanceMatrixResponseElement

Pojedynczy element odpowiedzi na żądanie DistanceMatrixService, który zawiera czas trwania i odległość od jednego miejsca początkowego do jednego miejsca docelowego.
distance
Odległość między tym miejscem wylotu a celem podróży. Ta właściwość może być niezdefiniowana, ponieważ odległość może być nieznana.
duration
Czas trwania tej pary miejsce początkowe–cel podróży. Ta właściwość może być niezdefiniowana, ponieważ czas trwania może być nieznany.
duration_in_traffic
Czas trwania dla tej pary punktu początkowego i docelowego z uwzględnieniem warunków na drodze wskazanych przez właściwość trafficModel. Ta 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, gdy podczas wysyłania żądania określono parametr drivingOptions.
fare
Łączna opłata za przejazd na tej trasie. Dotyczy tylko żądań dotyczących transportu publicznego.
status
Stan tej konkretnej pary miejsce wylotu–miejsce docelowe.

Stałe DistanceMatrixStatus

google.maps.DistanceMatrixStatus stałe
biblioteka "routes"

Ogólny stan żądania najwyższego poziomu zwracany przez DistanceMatrixService po zakończeniu żądania macierzy odległości. Możesz je określić za pomocą wartości lub nazwy stałej. Na przykład 'OK' lub google.maps.DistanceMatrixStatus.OK.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ DistanceMatrixStatusString.

const {DistanceMatrixStatus} = await google.maps.importLibrary("routes");
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 Iloczyn liczby miejsc początkowych i docelowych przekracza limit na zapytanie.
OK Odpowiedź zawiera prawidłowy wynik.
OVER_QUERY_LIMIT W dozwolonym okresie zażądano zbyt wielu elementów. Jeśli spróbujesz ponownie po pewnym czasie, żądanie powinno zostać zrealizowane.
REQUEST_DENIED Usługa odmówiła stronie internetowej dostępu do usługi macierzy odległości.
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 zostać zrealizowane.

Stałe DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus stałe
biblioteka "routes"

Stan na poziomie elementu dotyczący konkretnej pary miejsce początkowe–miejsce docelowe zwracany przez DistanceMatrixService po zakończeniu żądania macierzy odległości. Te wartości są podawane jako ciągi znaków, na przykład 'OK'.

Te stałe mogą być też używane jako ciągi znaków. W języku TypeScript literały ciągów znaków są definiowane przez typ DistanceMatrixElementStatusString.

const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes");
NOT_FOUND Nie udało się określić kodu geograficznego miejsca początkowego lub miejsca docelowego tej pary.
OK Odpowiedź zawiera prawidłowy wynik.
ZERO_RESULTS Nie udało się znaleźć trasy między miejscem wyjazdu a miejscem docelowym.