DistanceMatrixService
google.maps.DistanceMatrixService
-Klasse
Ein Dienst zur Berechnung von Entfernungen zwischen mehreren Ursprungsorten und Zielen.
Zugriff durch Aufrufen von const {DistanceMatrixService} = await google.maps.importLibrary("routes")
. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
DistanceMatrixService |
DistanceMatrixService() Parameter:Keine
Erstellt eine neue Instanz einer DistanceMatrixService , die Distance Matrix-Anfragen an Google-Server sendet. |
Methoden | |
---|---|
getDistanceMatrix |
getDistanceMatrix(request[, callback]) Parameter:
Rückgabewert:
Promise<DistanceMatrixResponse> Erstellt eine Distance Matrix-Anfrage. |
DistanceMatrixRequest
google.maps.DistanceMatrixRequest
-Schnittstelle
Eine von der DistanceMatrixService
gesendete Entfernungsmatrix-Abfrage mit Arrays von Start- und Zielorten sowie verschiedenen Optionen zum Berechnen von Messwerten.
Attribute | |
---|---|
destinations |
Typ:
Array<string|LatLng|LatLngLiteral|Place> Ein Array, das Strings der Zieladresse oder LatLng - oder Place -Objekte enthält, zu denen hin die Entfernung und Zeit berechnet werden. Erforderlich. |
origins |
Typ:
Array<string|LatLng|LatLngLiteral|Place> Ein Array, das Strings der Ursprungsadresse oder LatLng - oder Place -Objekte enthält, von denen ausgehend Entfernung und Zeit berechnet werden. Erforderlich. |
travelMode |
Typ:
TravelMode Typ der angeforderten Route. Erforderlich. |
avoidFerries optional |
Typ:
boolean optional Mit true wird der Distance Matrix-Dienst angewiesen, Fähren nach Möglichkeit zu vermeiden. Optional. |
avoidHighways optional |
Typ:
boolean optional Falls true , wird der „Distance Matrix“-Dienst angewiesen, Autobahnen wo möglich zu vermeiden. Optional. |
avoidTolls optional |
Typ:
boolean optional Falls true , wird der „Distance Matrix“-Dienst angewiesen, mautpflichtige Straßen wo möglich zu vermeiden. Optional. |
drivingOptions optional |
Typ:
DrivingOptions optional Einstellungen, die nur für Anfragen gelten, bei denen travelMode DRIVING ist. Dieses Objekt hat keine Auswirkungen auf andere Mobilitätsformen. |
language optional |
Typ:
string optional Eine Sprachkennzeichnung für die Sprache, in der die Ergebnisse zurückgegeben werden sollen, falls möglich. Hier finden Sie eine Liste der unterstützten Sprachen. |
region optional |
Typ:
string optional Regionscode für die Gewichtung von Geocodierungsanfragen. Für den Regionscode ist ein zweistelliger ccTLD-Wert zulässig. Die meisten ccTLD-Codes stimmen mit den ISO 3166-1-Codes überein, wobei es einige Ausnahmen gibt. So lautet beispielsweise der ccTLD-Code für das Vereinigte Königreich „uk“ ( .co.uk ), während der ISO 3166-1-Code „gb“ ist (technisch für die Rechtspersönlichkeit „Vereinigtes Königreich im Vereinigten Königreich und Nordirland“). |
transitOptions optional |
Typ:
TransitOptions optional Einstellungen, die nur für Anfragen gelten, bei denen travelMode TRANSIT ist. Dieses Objekt hat keine Auswirkungen auf andere Mobilitätsformen. |
unitSystem optional |
Typ:
UnitSystem optional Bevorzugtes Maßeinheitensystem für die Anzeige der Entfernung. Optional; der Standardwert ist metrisch. |
DistanceMatrixResponse
google.maps.DistanceMatrixResponse
-Schnittstelle
Die Antwort auf eine DistanceMatrixService
-Anfrage, die aus den formatierten Ursprungs- und Zieladressen und einer Sequenz von DistanceMatrixResponseRow
s besteht, jeweils eine für jede zugehörige Ursprungsadresse.
Attribute | |
---|---|
destinationAddresses |
Typ:
Array<string> Die formatierten Zieladressen. |
originAddresses |
Typ:
Array<string> Die formatierten Adressen des Ursprungsorts. |
rows |
Die Zeilen der Matrix, die den Ursprungsadressen entsprechen. |
Schnittstelle DistanceMatrixResponseRow
google.maps.DistanceMatrixResponseRow
-Schnittstelle
Eine Zeile der Antwort auf eine DistanceMatrixService
-Anfrage mit einer Sequenz von DistanceMatrixResponseElement
s, eine für jede entsprechende Zieladresse.
Attribute | |
---|---|
elements |
Die Elemente der Zeile, die den Zieladressen zugeordnet sind. |
Schnittstelle DistanceMatrixResponseElement
google.maps.DistanceMatrixResponseElement
-Schnittstelle
Ein einzelnes Element einer Antwort auf eine DistanceMatrixService
-Anfrage, das die Dauer und Entfernung von einem Ursprungsort zu einem Ziel enthält.
Attribute | |
---|---|
distance |
Typ:
Distance Die Entfernung für dieses Ursprungs-/Zielortpaar. Diese Eigenschaft ist möglicherweise nicht definiert, falls die Entfernung nicht bekannt ist. |
duration |
Typ:
Duration Die Dauer für dieses Ursprungs-/Zielortpaar. Diese Eigenschaft ist möglicherweise nicht definiert, falls die Dauer nicht bekannt ist. |
duration_in_traffic |
Typ:
Duration Die Dauer für dieses Ursprungs-/Zielortpaar unter Berücksichtigung der in der Eigenschaft trafficModel angegebenen Verkehrsbedingungen. Diese Property kann undefined sein, da die Dauer möglicherweise unbekannt ist. Nur für Premiumoption-Kunden verfügbar, wenn drivingOptions beim Erstellen der Anfrage definiert wird. |
fare |
Typ:
TransitFare Der Gesamtpreis für dieses Ursprungs-/Zielortpaar. Gilt nur für Anfragen für öffentliche Verkehrsmittel. |
status |
Der Status von diesem bestimmten Ursprungs-/Zielortpaar. |
DistanceMatrixStatus-Konstanten
google.maps.DistanceMatrixStatus
-Konstanten
Der übergeordnete Status der Anfrage im Allgemeinen, der von DistanceMatrixService
nach Abschluss einer Distance Matrix-Anfrage zurückgegeben wird. Geben Sie diese nach Wert oder mit dem Namen der Konstante an. Beispiel: 'OK'
oder google.maps.DistanceMatrixStatus.OK
Zugriff durch Aufrufen von const {DistanceMatrixStatus} = await google.maps.importLibrary("routes")
. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
INVALID_REQUEST |
Die eingegebene Anfrage ist ungültig. |
MAX_DIMENSIONS_EXCEEDED |
Die Anfrage enthält mehr als 25 Ursprungsorte oder mehr als 25 Ziele. |
MAX_ELEMENTS_EXCEEDED |
Das Produkt der Ursprungs- und Zielorte überschreitet den Grenzwert pro Abfrage. |
OK |
Die Antwort enthält ein gültiges Ergebnis. |
OVER_QUERY_LIMIT |
Innerhalb des zulässigen Zeitraums wurden zu viele Elemente angefragt. Die Anfrage sollte erfolgreich sein, wenn Sie es später noch einmal versuchen. |
REQUEST_DENIED |
Die Verwendung des Distance Matrix-Dienstes durch Ihre Webpage wurde abgelehnt. |
UNKNOWN_ERROR |
Eine Distance Matrix-Anfrage konnte aufgrund eines Serverfehlers nicht verarbeitet werden. Die Anfrage ist möglicherweise erfolgreich, wenn Sie sie noch einmal ausführen. |
DistanceMatrixElementStatus-Konstanten
google.maps.DistanceMatrixElementStatus
-Konstanten
Der Status auf Elementebene für ein bestimmtes Ursprungs-/Zielortpaar, der nach Abschluss einer Distance Matrix-Anfrage von DistanceMatrixService
zurückgegeben wird. Diese Werte werden als Strings angegeben, z. B. 'OK'
.
Zugriff durch Aufrufen von const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes")
. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
NOT_FOUND |
Der Ursprungs- und/oder Zielort dieses Paares konnte nicht geocodiert werden. |
OK |
Die Antwort enthält ein gültiges Ergebnis. |
ZERO_RESULTS |
Zwischen Ursprungsort und Zielort konnte keine Route gefunden werden. |