Distance Matrix

DistanceMatrixService-Klasse

google.maps.DistanceMatrixService Kurs

Ein Dienst zur Berechnung von Entfernungen zwischen mehreren Ursprungsorten und Zielen.

Rufe const {DistanceMatrixService} = await google.maps.importLibrary("routes") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
DistanceMatrixService
DistanceMatrixService()
Parameter:Keine
Erstellt eine neue Instanz eines DistanceMatrixService, das Distance Matrix-Abfragen an Google-Server sendet.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parameter: 
Rückgabewert:Promise<DistanceMatrixResponse>
Erstellt eine Distance Matrix-Anfrage.

DistanceMatrixRequest-Schnittstelle

google.maps.DistanceMatrixRequest Benutzeroberfläche

Eine vom DistanceMatrixService gesendete Distance Matrix-Abfrage mit Arrays von Start- und Zielorten sowie verschiedenen Optionen zur Berechnung von Messwerten.
destinations
Ein Array mit Zieladressen, LatLng- oder Place-Objekten, auf deren Grundlage Strecke und Reisezeit berechnet werden. Erforderlich.
origins
Ein Array mit Startadressen, LatLng- oder Place-Objekten, auf deren Grundlage Strecke und Reisezeit berechnet werden. Erforderlich.
travelMode
Typ der angeforderten Route. Erforderlich.
avoidFerries optional
Typ:boolean optional
Wenn true, weist der Distance Matrix-Dienst an, Fähren nach Möglichkeit zu vermeiden. Optional.
avoidHighways optional
Typ:boolean optional
Wenn true festgelegt ist, wird der „Distance Matrix“-Dienst angewiesen, nach Möglichkeit Autobahnen zu vermeiden. Optional.
avoidTolls optional
Typ:boolean optional
Wenn true festgelegt ist, wird der Distance Matrix-Dienst angewiesen, nach Möglichkeit Mautstraßen 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 Verkehrsmittel.
language optional
Typ:string optional
Eine Sprachkennzeichnung für die Sprache, in der die Ergebnisse zurückgegeben werden sollen, sofern möglich. Hier finden Sie eine Liste der unterstützten Sprachen.
region optional
Typ:string optional
Regionscode für die Gewichtung von Geocodierungsanfragen. Der Regionscode kann ein zweistelliger Wert für eine Länderspezifische Top-Level-Domain (ccTLD) sein. Die meisten ccTLD-Codes entsprechen den ISO 3166-1-Codes, mit folgenden Ausnahmen. So lautet beispielsweise die ccTLD des Vereinigten Königreichs „uk“ (.co.uk), der ISO 3166-1-Code dagegen „gb“ (technisch für die Entität „Vereinigtes Königreich von Großbritannien und Nordirland“).
transitOptions optional
Typ:TransitOptions optional
Einstellungen, die nur für Anfragen gelten, bei denen travelMode „ÖPNV“ ist. Dieses Objekt hat keine Auswirkungen auf andere Verkehrsmittel.
unitSystem optional
Typ:UnitSystem optional
Bevorzugtes Maßeinheitensystem für die Anzeige der Entfernung. Optional; der Standardwert ist metrisch.

DistanceMatrixResponse-Schnittstelle

google.maps.DistanceMatrixResponse Benutzeroberfläche

Die Antwort auf eine DistanceMatrixService-Anfrage, bestehend aus den formatierten Quell- und Zieladressen und einer Sequenz von DistanceMatrixResponseRows, eine für jede entsprechende Quelladresse.
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.

DistanceMatrixResponseRow-Schnittstelle

google.maps.DistanceMatrixResponseRow Benutzeroberfläche

Eine Zeile der Antwort auf eine DistanceMatrixService-Anfrage, die aus einer Sequenz von DistanceMatrixResponseElements besteht, eine für jede entsprechende Zieladresse.
elements
Die Elemente der Zeile, die den Zieladressen zugeordnet sind.

DistanceMatrixResponseElement-Schnittstelle

google.maps.DistanceMatrixResponseElement Benutzeroberfläche

Ein einzelnes Element einer Antwort auf eine DistanceMatrixService-Anfrage, das die Dauer und Entfernung von einem Start- zu einem Zielort enthält.
distance
Die Entfernung für dieses Ursprungs-/Zielortpaar. Diese Eigenschaft ist möglicherweise nicht definiert, falls die Entfernung nicht bekannt ist.
duration
Die Dauer für dieses Ursprungs-/Zielortpaar. Diese Eigenschaft ist möglicherweise nicht definiert, falls die Dauer nicht bekannt ist.
duration_in_traffic
Die Dauer für diese Start-/Zielanfahrt unter Berücksichtigung der Verkehrslage, die in der Property trafficModel angegeben ist. Diese Property kann undefined sein, da die Dauer möglicherweise nicht bekannt ist. Nur für Premium-Kunden verfügbar, wenn drivingOptions bei der Anfrage definiert ist.
fare
Der Gesamtpreis für diese Kombination aus Start- und Zielort. Gilt nur für Anfragen zu öffentlichen Verkehrsmitteln.
status
Der Status von diesem bestimmten Ursprungs-/Zielortpaar.

Konstanten für DistanceMatrixStatus

google.maps.DistanceMatrixStatus constants

Der Status der Anfrage auf oberster Ebene, der vom DistanceMatrixService nach Abschluss einer Anfrage für eine Entfernungsmatrix zurückgegeben wird. Geben Sie diese Werte anhand des Werts oder des Namens der Konstante an. Beispiel: 'OK'oder google.maps.DistanceMatrixStatus.OK

Rufe const {DistanceMatrixStatus} = await google.maps.importLibrary("routes") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
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 nach einiger Zeit 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 es erneut versuchen.

Konstanten für DistanceMatrixElementStatus

google.maps.DistanceMatrixElementStatus constants

Der Status auf Elementebene für eine bestimmte Kombination aus Start- und Zielort, der vom DistanceMatrixService nach Abschluss einer Anfrage für die Entfernungsmatrix zurückgegeben wird. Diese Werte werden als Strings angegeben, z. B. 'OK'.

Rufe const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes") auf, um auf die Daten zuzugreifen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
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.