Route Matrix (beta)

RouteMatrix-Klasse

google.maps.routes.RouteMatrix Klasse

Eine Matrix von Routen, die für eine Reihe von Start-/Zielpaaren von RouteMatrix.computeRouteMatrix berechnet wurden

Zugriff durch Anrufen von const {RouteMatrix} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
computeRouteMatrix
computeRouteMatrix(request)
Parameter:
Rückgabewert:Promise<{matrix:RouteMatrix}>
Akzeptiert eine Liste von Start- und Zielorten und gibt eine Matrix mit Routeninformationen für jede Kombination aus Start- und Zielort zurück.

Hinweis: Bei dieser Methode müssen Sie eine Antwortfeldmaske in der Anfrage angeben, indem Sie das Attribut ComputeRouteMatrixRequest.fields festlegen. Der Wert ist eine Liste von Feldpfaden.

Beispiel:
  • Feldmaske aller verfügbaren Felder: fields: ['*']
  • Feldmaske für Dauer und Entfernung auf Routenebene: fields: ['durationMillis', 'distanceMeters']

 Die Verwendung der Platzhalter-Antwortfeldmaske fields: ['*'] wird aus folgenden Gründen nicht empfohlen:
  • Wenn Sie nur die benötigten Felder auswählen, kann unser Server Rechenzyklen sparen und wir können Ihnen das Ergebnis mit einer geringeren Latenz zurückgeben.
  • Wenn Sie nur die Felder auswählen, die Sie für Ihren Produktionsjob benötigen, wird eine stabile Latenzleistung gewährleistet. Möglicherweise fügen wir in Zukunft weitere Antwortfelder hinzu. Diese neuen Felder erfordern möglicherweise zusätzliche Rechenzeit. Wenn Sie alle Felder oder alle Felder auf der obersten Ebene auswählen, kann es zu Leistungseinbußen kommen, da jedes neue Feld, das wir hinzufügen, automatisch in die Antwort aufgenommen wird.
  • Wenn Sie nur die Felder auswählen, die Sie benötigen, ist die Antwortgröße kleiner und die Daten werden schneller über das Netzwerk geladen.
rows
Die Zeilen der Matrix. Jede Zeile entspricht einem Startort und enthält ein Array von RouteMatrixItem-Elementen, die jeweils eine Route zu einem Zielort darstellen.
toJSON
toJSON()
Parameter:Keine
Rückgabewert:Object
Wird in ein Objekt konvertiert.

Klasse RouteMatrixRow

google.maps.routes.RouteMatrixRow Klasse

Entspricht einem Ursprung, der an RouteMatrix.computeRouteMatrix übergeben wird. Enthält eine Liste von RouteMatrixItem-Objekten, wobei jedes Element eine Route zu einem Ziel darstellt.

Zugriff durch Anrufen von const {RouteMatrixRow} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
items
Die Routeninformationen für jedes Ziel.
toJSON
toJSON()
Parameter:Keine
Rückgabewert:Object
Wird in ein Objekt konvertiert.

Klasse RouteMatrixItem

google.maps.routes.RouteMatrixItem Klasse

Enthält Routeninformationen, die für ein Start-/Zielort-Paar berechnet wurden, das an RouteMatrix.computeRouteMatrix übergeben wurde.

Zugriff durch Anrufen von const {RouteMatrixItem} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
condition
Gibt an, ob die Route gefunden wurde.
distanceMeters
Typ:number optional
Die zurückzulegende Strecke der Route in Metern.
durationMillis
Typ:number optional
Die Zeit, die zum Zurücklegen der Route benötigt wird, in Millisekunden. Wenn Sie ComputeRouteMatrixRequest.routingPreference auf TRAFFIC_UNAWARE festlegen, entspricht dieser Wert RouteMatrixItem.staticDurationMillis. Wenn Sie ComputeRouteMatrixRequest.routingPreference auf TRAFFIC_AWARE oder TRAFFIC_AWARE_OPTIMAL festlegen, wird dieser Wert unter Berücksichtigung der Verkehrsbedingungen berechnet.

Hinweis: Wenn die Dauer 2^53 Millisekunden überschreitet, ist dieser Wert Number.POSITIVE_INFINITY.
error
Fehler, der bei der Berechnung der Route aufgetreten ist.
fallbackInfo
Typ:FallbackInfo optional
In einigen Fällen, in denen der Server die Route mit den angegebenen Einstellungen für dieses bestimmte Start-/Zielpaar nicht berechnen kann, wird möglicherweise auf einen anderen Berechnungsmodus zurückgegriffen. Wenn ein Fallback verwendet wird, enthält dieses Feld detaillierte Informationen zur Fallback-Antwort. Andernfalls ist dieses Feld nicht festgelegt.
localizedValues
Textdarstellungen von Attributen der RouteMatrixItem.
staticDurationMillis
Typ:number optional
Die Dauer der Fahrt auf der Route ohne Berücksichtigung der Verkehrslage.

Hinweis: Wenn die Dauer 2^53 Millisekunden überschreitet, ist dieser Wert Number.POSITIVE_INFINITY.
travelAdvisory
Typ:RouteTravelAdvisory optional
Zusätzliche Informationen zur Route.

ComputeRouteMatrixRequest-Schnittstelle

google.maps.routes.ComputeRouteMatrixRequest-Schnittstelle

Anfrage für eine Routenmatrix.
destinations
Array von Zielvorhaben, das die Spalten der Antwortmatrix bestimmt. Ein als String übergebener Wert kann eine Adresse, ein Plus Code oder ein Ressourcenname für einen Ort sein. Höhenwerte werden nicht berücksichtigt.
fields
Typ:Iterable<string>
Sammlung der abzurufenden Felder. Geben Sie für alle Felder ["*"] an.
origins
Array von Ursprüngen, das die Zeilen der Antwortmatrix bestimmt. Ein als String übergebener Wert kann eine Adresse, ein Plus Code oder ein Ressourcenname für einen Ort sein. Höhenwerte werden nicht berücksichtigt.

Für die Kardinalität von Herkünften und Zielorten gelten mehrere Größenbeschränkungen:
  • Die Gesamtzahl der als string oder Place angegebenen Start- und Zielorte darf 50 nicht überschreiten.
  • Das Produkt aus der Anzahl der Start- und Zielorte darf 625 nicht überschreiten.
  • Das Produkt aus der Anzahl der Start- und Zielorte darf nicht größer als 100 sein, wenn ComputeRouteMatrixRequest.routingPreference auf TRAFFIC_AWARE_OPTIMAL festgelegt ist.
  • Das Produkt aus der Anzahl der Start- und Zielorte darf nicht größer als 100 sein, wenn ComputeRouteMatrixRequest.travelMode auf TRANSIT festgelegt ist.
arrivalTime optional
Typ:Date optional
Die Ankunftszeit.

Hinweis: Kann nur festgelegt werden, wenn ComputeRouteMatrixRequest.travelMode auf TRANSIT gesetzt ist. Sie können entweder ComputeRouteMatrixRequest.departureTime oder ComputeRouteMatrixRequest.arrivalTime angeben, aber nicht beides. Öffentliche Verkehrsmittel sind für bis zu 7 Tage in der Vergangenheit oder 100 Tage in der Zukunft verfügbar.
departureTime optional
Typ:Date optional
Die Abfahrtszeit. Wenn Sie diesen Wert nicht festlegen, wird standardmäßig die Zeit verwendet, zu der Sie die Anfrage gestellt haben.

Hinweis: Sie können nur eine Zeit in der Vergangenheit angeben, wenn ComputeRouteMatrixRequest.travelMode auf TRANSIT festgelegt ist. Öffentliche Verkehrsmittel sind für bis zu 7 Tage in der Vergangenheit oder 100 Tage in der Zukunft verfügbar.
extraComputations optional
Eine Liste zusätzlicher Berechnungen, die zum Ausführen der Anfrage verwendet werden können.

Hinweis: Durch diese zusätzlichen Berechnungen können zusätzliche Felder in der Antwort zurückgegeben werden. Diese zusätzlichen Felder müssen auch in ComputeRouteMatrixRequest.fields angegeben werden, damit sie in der Antwort zurückgegeben werden.
language optional
Typ:string optional
Der BCP-47-Sprachcode, z. B. "en-US" oder "sr-Latn" Weitere Informationen finden Sie unter Unicode-Sprachkennzeichnung. Eine Liste der unterstützten Sprachen finden Sie unter Sprachunterstützung. Wenn Sie diesen Wert nicht angeben, wird die Sprache aus Ihren Lokalisierungseinstellungen für die Google Maps JavaScript API abgeleitet. Andernfalls wird die Sprache aus dem Standort des ersten Ursprungs abgeleitet.
region optional
Typ:string optional
Der Regionscode, angegeben als zweistelliger Ländercode der Top-Level-Domain (ccTLD). Weitere Informationen finden Sie unter Ländercode-Top-Level-Domains. Wenn Sie diesen Wert nicht angeben, wird die Region aus Ihren Lokalisierungseinstellungen für die Google Maps JavaScript API abgeleitet. Andernfalls wird die Region aus dem Standort des ersten Ursprungs abgeleitet.
routingPreference optional
Typ:RoutingPreference optional
Gibt an, wie die Routenmatrix berechnet werden soll. Der Server versucht, die Routenmatrix anhand der ausgewählten Routing-Einstellung zu berechnen. Wenn die Routing-Einstellung zu einem Fehler oder einer besonders langen Latenz führt, wird ein Fehler zurückgegeben. Sie können diese Option nur angeben, wenn ComputeRouteMatrixRequest.travelMode den Wert DRIVING oder TWO_WHEELER hat. Andernfalls schlägt die Anfrage fehl.
trafficModel optional
Typ:TrafficModel optional
Gibt die Annahmen an, die bei der Berechnung der Reisezeit verwendet werden sollen. Diese Einstellung wirkt sich auf den Wert aus, der in RouteMatrixItem.durationMillis zurückgegeben wird und die voraussichtliche Reisezeit im Verkehr basierend auf historischen Durchschnittswerten enthält. ComputeRouteMatrixRequest.trafficModel ist nur für Anfragen verfügbar, bei denen ComputeRouteMatrixRequest.routingPreference auf TRAFFIC_AWARE_OPTIMAL und ComputeRouteMatrixRequest.travelMode auf DRIVING festgelegt ist. Die Standardeinstellung ist BEST_GUESS.
transitPreference optional
Typ:TransitPreference optional
Gibt Einstellungen an, die die für TRANSIT-Routen zurückgegebene Route beeinflussen.

Hinweis: Kann nur angegeben werden, wenn ComputeRouteMatrixRequest.travelMode auf TRANSIT gesetzt ist.
travelMode optional
Typ:TravelMode optional
Gibt die Mobilitätsform an.
units optional
Typ:UnitSystem optional
Gibt die Maßeinheiten für die Anzeigefelder an. Wenn Sie diesen Wert nicht angeben, werden die Anzeigeeinheiten aus dem Standort des ersten Ursprungs abgeleitet.

ComputeRouteMatrixExtraComputation-Konstanten

google.maps.routes.ComputeRouteMatrixExtraComputation Konstanten

Zusätzliche Berechnungen, die für eine RouteMatrix.computeRouteMatrix-Anfrage ausgeführt werden sollen.

Zugriff durch Anrufen von const {ComputeRouteMatrixExtraComputation} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
TOLLS Mautinformationen für die Matrixelemente.

RouteMatrixItemCondition-Konstanten

google.maps.routes.RouteMatrixItemCondition Konstanten

Der Zustand einer Route für ein bestimmtes Start-/Zielpaar.

Zugriff durch Anrufen von const {RouteMatrixItemCondition} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
ROUTE_EXISTS Es wurde eine Route gefunden.
ROUTE_NOT_FOUND Es konnte keine Route gefunden werden.

RouteMatrixItemError-Klasse

google.maps.routes.RouteMatrixItemError Klasse

Ein Fehler, der während RouteMatrix.computeRouteMatrix für ein bestimmtes Quell-/Zielpaar aufgetreten ist.

Diese Klasse erweitert Error.

Zugriff durch Anrufen von const {RouteMatrixItemError} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
toJSON
toJSON()
Parameter:Keine
Rückgabewert:Object
Wird in ein Objekt konvertiert.

Klasse RouteMatrixItemLocalizedValues

google.maps.routes.RouteMatrixItemLocalizedValues Klasse

Textdarstellungen von RouteMatrixItem.

Zugriff durch Anrufen von const {RouteMatrixItemLocalizedValues} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
distance
Typ:string optional
Die Reiseentfernung des Routenmatrixelements in Textform.
distanceLanguage
Typ:string optional
Der BCP-47-Sprachcode für den Distanztext, z. B. „en-US“ oder „sr-Latn“.

Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
duration
Typ:string optional
Die Dauer in Textform, lokalisiert für die Region der Anfrage. Berücksichtigt die Verkehrslage.

Hinweis: Wenn Sie keine Verkehrsinformationen angefordert haben, entspricht dieser Wert dem Wert von RouteMatrixItemLocalizedValues.staticDuration.
durationLanguage
Typ:string optional
Der BCP-47-Sprachcode des Dauertexts, z. B. „en-US“ oder „sr-Latn“.

Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
staticDuration
Typ:string optional
Dauer ohne Berücksichtigung der Verkehrslage in Textform.
staticDurationLanguage
Typ:string optional
Der BCP-47-Sprachcode des statischen Dauertexts, z. B. „en-US“ oder „sr-Latn“.
transitFare
Typ:string optional
Fahrpreis für öffentliche Verkehrsmittel in Textform.
transitFareLanguage
Typ:string optional
Der BCP-47-Sprachcode des Textes für den Fahrpreis, z. B. „en-US“ oder „sr-Latn“.

Weitere Informationen finden Sie unter http://www.unicode.org/reports/tr35/#Unicode_locale_identifier.
toJSON
toJSON()
Parameter:Keine
Rückgabewert:Object
Wird in ein Objekt konvertiert.

RouteMatrixOrigin-Schnittstelle

google.maps.routes.RouteMatrixOrigin-Schnittstelle

Ein einzelner Ursprung für ein ComputeRouteMatrixRequest.
waypoint
Der Standort des Ursprungs. Ein als String übergebener Wert kann eine Adresse oder ein Plus Code sein. Höhenwerte werden nicht berücksichtigt.
routeModifiers optional
Typ:RouteModifiers optional
Modifikatoren für jede Route, die diesen Ort als Ausgangspunkt verwendet.