Distance Matrix

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.

DistanceMatrixService
DistanceMatrixService()
Parameter:Keine
Erstellt eine neue Instanz einer DistanceMatrixService, die Distance Matrix-Anfragen an Google-Server sendet.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parameter:
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.

destinations
Ein Array, das Strings der Zieladresse oder LatLng- oder Place-Objekte enthält, zu denen hin die Entfernung und Zeit berechnet werden. Erforderlich.
origins
Ein Array, das Strings der Ursprungsadresse oder LatLng- oder Place-Objekte enthält, von denen ausgehend Entfernung und Zeit berechnet werden. Erforderlich.
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 DistanceMatrixResponseRows besteht, jeweils eine für jede zugehörige Ursprungsadresse.

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 DistanceMatrixResponseElements, eine für jede entsprechende Zieladresse.

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.

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 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
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.

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.

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.