Distance Matrix

DistanceMatrixService-Klasse

google.maps.DistanceMatrixService Klasse

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

Zugriff über const {DistanceMatrixService} = await google.maps.importLibrary("routes") aufrufen. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.

DistanceMatrixService
DistanceMatrixService()
Parameter:Keine
Erstellt eine neue Instanz eines DistanceMatrixService-Objekts, das Distance Matrix-Abfragen an Google-Server sendet.
getDistanceMatrix
getDistanceMatrix(request[, callback])
Parameter:
Erstellt eine Distance Matrix-Anfrage.

DistanceMatrixRequest-Schnittstelle

google.maps.DistanceMatrixRequest-Schnittstelle

Eine vom DistanceMatrixService gesendete Distance Matrix-Abfrage mit Arrays von Start- und Zielorten sowie verschiedenen Optionen für die Messwertberechnung.

destinations
Ein Array, das Strings der Zieladresse oder LatLng- oder Place-Objekte enthält, zu denen hin 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
Wenn true, wird der „Distance Matrix“-Dienst angewiesen, Fähren wo möglich 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
Wenn 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 den Wert DRIVING hat. Dieses Objekt hat keine Auswirkungen auf andere Mobilitätsformen.
language optional
Typ:string optional
Ein Sprachbezeichner für die Sprache, in der Ergebnisse nach Möglichkeit zurückgegeben werden sollen. 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 kann ein zweistelliger ccTLD-Wert („Top-Level-Domain“) verwendet werden. Die meisten ccTLD-Codes stimmen mit den ISO 3166-1-Codes überein, wobei es einige Ausnahmen gibt. Die ccTLD des Vereinigten Königreichs lautet beispielsweise „uk“ (.co.uk), während der ISO 3166-1-Code „gb“ lautet (technisch für die Rechtspersönlichkeit „The United Kingdom of Great Britain and Northern Ireland“).
transitOptions optional
Typ:TransitOptions optional
Einstellungen, die nur für Anfragen mit TRANSIT für travelMode gelten. 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-Schnittstelle

google.maps.DistanceMatrixResponse-Schnittstelle

Die Antwort auf eine DistanceMatrixService-Anfrage, die aus den formatierten Start- und Zieladressen sowie einer Sequenz von DistanceMatrixResponseRows besteht, 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.

DistanceMatrixResponseRow-Schnittstelle

google.maps.DistanceMatrixResponseRow-Schnittstelle

Eine Zeile der Antwort auf eine DistanceMatrixService-Anfrage, die aus einer Sequenz von DistanceMatrixResponseElements besteht, eine für jede zugehörige Zieladresse.

elements
Die Elemente der Zeile, die den Zieladressen zugeordnet sind.

DistanceMatrixResponseElement-Schnittstelle

google.maps.DistanceMatrixResponseElement-Schnittstelle

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 dieses Ursprungs-/Zielortpaar unter Berücksichtigung der durch die Property trafficModel angegebenen Verkehrslage. Dieses Attribut kann undefined sein, da die Dauer nicht bekannt ist. Nur für Kunden mit der Premiumoption verfügbar, wenn bei der Anfrage drivingOptions angegeben ist.
fare
Der Gesamtpreis für dieses Paar aus Start- und Zielort. Gilt nur für Anfragen für öffentliche Verkehrsmittel.
status
Der Status von diesem bestimmten Ursprungs-/Zielortpaar.

DistanceMatrixStatus-Konstanten

google.maps.DistanceMatrixStatus-Konstanten

Der Status der obersten Ebene für die Anfrage, der im Allgemeinen nach Abschluss einer Distance Matrix-Anfrage von DistanceMatrixService zurückgegeben wird. Geben Sie diese mit dem Wert oder dem Namen der Konstante an. Beispiel: 'OK'oder google.maps.DistanceMatrixStatus.OK

Zugriff über const {DistanceMatrixStatus} = await google.maps.importLibrary("routes") aufrufen. 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 über const {DistanceMatrixElementStatus} = await google.maps.importLibrary("routes") aufrufen. 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.