Distance Matrix

DistanceMatrixService-Klasse

google.maps.DistanceMatrixService Klasse

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

Zugriff durch Anrufen 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 von DistanceMatrixService, die Distanzmatrix-Anfragen an Google-Server sendet.

Methoden
getDistanceMatrix	getDistanceMatrix(request[, callback]) Parameter: request:  DistanceMatrixRequest callback:  function(DistanceMatrixResponse optional, DistanceMatrixStatus): void optional Rückgabewert:Promise<DistanceMatrixResponse> Erstellt eine Distance Matrix-Anfrage.

DistanceMatrixRequest-Schnittstelle

google.maps.DistanceMatrixRequest-Schnittstelle

Eine „Distance Matrix“-Anfrage, die von DistanceMatrixService gesendet wird und Arrays mit Start- und Zielorten sowie verschiedene Optionen zum Berechnen von Messwerten enthält.

Attribute
destinations	Typ:Array<string|LatLng|LatLngLiteral|Place> Ein Array mit Zieladressstrings, LatLng- oder Place-Objekten, auf deren Grundlage Strecke und Reisezeit berechnet werden. Erforderlich.
origins	Typ:Array<string|LatLng|LatLngLiteral|Place> Ein Array mit Adressstrings für den Startort oder LatLng- oder Place-Objekten, auf deren Grundlage Strecke und Reisezeit berechnet werden. Erforderlich.
travelMode	Typ:TravelMode Typ der angeforderten Route. Erforderlich.
avoidFerries optional	Typ:boolean optional Wenn true, wird der „Distance Matrix“-Dienst angewiesen, Fähren nach Möglichkeit zu vermeiden. Optional.
avoidHighways optional	Typ:boolean optional Ist true festgelegt, wird der „Distance Matrix“-Dienst angewiesen, Autobahnen nach Möglichkeit zu vermeiden. Optional.
avoidTolls optional	Typ:boolean optional Wenn true, wird der „Distance Matrix“-Dienst angewiesen, Mautstraßen nach Möglichkeit zu vermeiden. Optional.
drivingOptions optional	Typ:DrivingOptions optional Einstellungen, die nur für Anfragen gelten, bei denen travelMode gleich DRIVING ist. Dieses Objekt hat keine Auswirkungen auf andere Transportmittel.
language optional	Typ:string optional Eine Sprach-ID 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 ist ein zweistelliger Ländercode der Top-Level-Domain (ccTLD) zulässig. 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 das Land „Vereinigtes Königreich Großbritannien 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 Transportmittel.
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 und einer Folge von DistanceMatrixResponseRows besteht, eine für jede entsprechende Startadresse.

Attribute
destinationAddresses	Typ:Array<string> Die formatierten Zieladressen.
originAddresses	Typ:Array<string> Die formatierten Adressen des Ursprungsorts.
rows	Typ:Array<DistanceMatrixResponseRow> 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, eines für jede entsprechende Zieladresse.

Attribute
elements	Typ:Array<DistanceMatrixResponseElement> 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 Startort zu einem Zielort 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 Start-Ziel-Paar unter Berücksichtigung der Verkehrsbedingungen, die durch das Attribut trafficModel angegeben werden. 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 angegeben wird.
fare	Typ:TransitFare Der Gesamtpreis für diese Kombination aus Start- und Zielort. Gilt nur für Anfragen zu öffentlichen Verkehrsmitteln.
status	Typ:DistanceMatrixElementStatus Der Status von diesem bestimmten Ursprungs-/Zielortpaar.

DistanceMatrixStatus-Konstanten

google.maps.DistanceMatrixStatus Konstanten

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

Zugriff durch Anrufen 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 lang genug warten und es dann 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.

DistanceMatrixElementStatus-Konstanten

google.maps.DistanceMatrixElementStatus Konstanten

Der Status auf Elementebene für ein bestimmtes Ausgangs-/Zielstandort-Paar, der von DistanceMatrixService nach Abschluss einer Distance Matrix-Anfrage zurückgegeben wird. Diese Werte werden als Strings angegeben, z. B. 'OK'.

Zugriff durch Anrufen 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.