DirectionsService-Klasse
google.maps.DirectionsService
Klasse
Dienst zur Berechnung der Route zwischen zwei oder mehr Orten.
Zugriff durch Aufrufen von const {DirectionsService} = await google.maps.importLibrary("routes")
. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
DirectionsService |
DirectionsService() Parameter:Keine
Erstellt eine neue Instanz eines DirectionsService -Objekts, das Routenanfragen an Google-Server sendet. |
Methoden | |
---|---|
route |
route(request[, callback]) Parameter:
Rückgabewert:
Promise<DirectionsResult> Sendet eine Suchanfrage für eine Route. |
DirectionsRequest-Schnittstelle
google.maps.DirectionsRequest
-Schnittstelle
Eine Routenanfrage, die an DirectionsService
gesendet werden soll.
Attribute | |
---|---|
destination |
Typ:
string|LatLng|Place|LatLngLiteral Zielstandort. Dies kann entweder als zu geocodierender String, als LatLng oder Place angegeben werden. Erforderlich. |
origin |
Typ:
string|LatLng|Place|LatLngLiteral Ursprungsort. Dies kann entweder als zu geocodierender String, als LatLng oder Place angegeben werden. Erforderlich. |
travelMode |
Typ:
TravelMode Typ der angeforderten Route. Erforderlich. |
avoidFerries optional |
Typ:
boolean optional Bei true wird der Directions-Dienst angewiesen, Fähren wo möglich zu vermeiden. Optional. |
avoidHighways optional |
Typ:
boolean optional Bei true wird der Routendienst angewiesen, Autobahnen wo möglich zu vermeiden. Optional. |
avoidTolls optional |
Typ:
boolean optional Bei true wird der Routendienst angewiesen, mautpflichtige Straßen wo möglich zu vermeiden. Optional. |
drivingOptions optional |
Typ:
DrivingOptions optional Einstellungen gelten nur für Anfragen, bei denen travelMode den Wert DRIVING hat. Dieses Objekt hat keine Auswirkungen auf andere Mobilitätsformen. |
language optional |
Typ:
string optional Eine Sprachkennung für die Sprache, in der die Ergebnisse zurückgegeben werden sollen, falls möglich. Hier finden Sie eine Liste der unterstützten Sprachen. |
optimizeWaypoints optional |
Typ:
boolean optional Wenn true festgelegt ist, versucht DirectionsService , die bereitgestellten Wegzwischenpunkte neu zu ordnen, um die Gesamtkosten der Route zu minimieren. Wenn die Wegpunkte optimiert sind, prüfen Sie DirectionsRoute.waypoint_order in der Antwort, um die neue Reihenfolge zu bestimmen. |
provideRouteAlternatives optional |
Typ:
boolean optional Legt fest, ob alternative Routen bereitgestellt werden sollen oder nicht. Optional. |
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 ), der ISO 3166-1-Code lautet „gb“ (technisch für die Rechtspersönlichkeit „The United Kingdom of Great Britain and Nordirland“). |
transitOptions optional |
Typ:
TransitOptions optional Einstellungen, die nur für Anfragen gelten, bei denen travelMode den Wert TRANSIT hat. Dieses Objekt hat keine Auswirkungen auf andere Mobilitätsformen. |
unitSystem optional |
Typ:
UnitSystem optional Standard:Das im Herkunftsland verwendete Einheitensystem.
Bevorzugtes Maßeinheitensystem für die Anzeige der Entfernung. |
waypoints optional |
Typ:
Array<DirectionsWaypoint> optional Array mit Wegzwischenpunkten. Routen werden vom Start- zum Zielort durch jeden Wegpunkt in diesem Array berechnet. Die maximal zulässige Anzahl von Wegpunkten finden Sie im Entwicklerhandbuch. Für Routen mit öffentlichen Verkehrsmitteln werden Wegpunkte nicht unterstützt. Optional. |
DirectionsStatus-Konstanten
google.maps.DirectionsStatus
-Konstanten
Der Status, der von DirectionsService
nach Abschluss eines Aufrufs von route()
zurückgegeben wird. Geben Sie diese als Wert oder mit dem Namen der Konstante an. Beispiel: 'OK'
oder google.maps.DirectionsStatus.OK
.
Zugriff durch Aufrufen von const {DirectionsStatus} = await google.maps.importLibrary("routes")
. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
INVALID_REQUEST |
Die angegebene DirectionsRequest ist ungültig. |
MAX_WAYPOINTS_EXCEEDED |
In DirectionsRequest wurden zu viele DirectionsWaypoint angegeben. Die maximal zulässige Anzahl von Wegpunkten finden Sie im Entwicklerhandbuch. |
NOT_FOUND |
Mindestens einer der Orte (Ursprungsort, Zielort oder Wegpunkte) konnte nicht geocodiert werden. |
OK |
Die Antwort enthält eine gültige DirectionsResult . |
OVER_QUERY_LIMIT |
Die Anfragebeschränkungen wurden von der Webseite in einem zu geringen Zeitraum überschritten. |
REQUEST_DENIED |
Es ist der Webpage nicht gestattet, den Routendienst zu verwenden. |
UNKNOWN_ERROR |
Eine Routenanfrage konnte aufgrund eines Serverfehlers nicht verarbeitet werden. Die Anfrage ist möglicherweise erfolgreich, wenn Sie sie noch einmal ausführen. |
ZERO_RESULTS |
Zwischen Ursprungsort und Zielort konnte keine Route gefunden werden. |
DirectionsResult-Schnittstelle
google.maps.DirectionsResult
-Schnittstelle
Die vom Routenserver abgerufene Routenantwort. Sie können diese mit einem DirectionsRenderer
rendern oder das Objekt selbst parsen und rendern. Warnungen und urheberrechtliche Hinweise müssen entsprechend den Nutzungsbedingungen für die Google Maps Platform eingeblendet werden. Beachten Sie, dass dieses Ergebnis "JSON-ähnlich" ist, aber nicht ganz genau JSON entspricht, da es indirekt LatLng
-Objekte enthält.
Attribute | |
---|---|
request |
Die DirectionsRequest , die dieses Ergebnis geliefert hat. |
routes |
Typ:
Array<DirectionsRoute> Ein Array mit DirectionsRoute -Werten, von denen jede Informationen zu den darin enthaltenen Streckenabschnitten und Schritten enthält. Es gibt nur eine Route, es sei denn, DirectionsRequest wurde mit provideRouteAlternatives auf true festgelegt. |
available_travel_modes optional |
Typ:
Array<TravelMode> optional Enthält ein Array mit verfügbaren Mobilitätsformen. Dieses Feld wird zurückgegeben, wenn bei einer Anfrage eine Mobilitätsform angegeben wird und keine Ergebnisse zurückgegeben werden. Das Array enthält die verfügbaren Verkehrsmittel in den Ländern der vorgegebenen Gruppe von Wegpunkten. Dieses Feld wird nicht zurückgegeben, wenn einer oder mehrere der Wegpunkte "über Wegpunkte" sind. |
geocoded_waypoints optional |
Typ:
Array<DirectionsGeocodedWaypoint> optional Ein Array mit DirectionsGeocodedWaypoint s, von denen jede Informationen zum Geocoding von Startort, Zielort und Wegpunkten enthält. |
DirectionsRenderer-Klasse
google.maps.DirectionsRenderer
Klasse
Gibt Routen wieder, die von DirectionsService
abgerufen wurden.
Diese Klasse erweitert MVCObject
.
Zugriff durch Aufrufen von const {DirectionsRenderer} = await google.maps.importLibrary("routes")
. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
DirectionsRenderer |
DirectionsRenderer([opts]) Parameter:
Erstellt den Renderer mit den angegebenen Optionen. Routen können als visuelle Overlays auf einer Karte oder zusätzlich in Form von Textanweisungen in einem <div> -Bereich gerendert werden. |
Methoden | |
---|---|
getDirections |
getDirections() Parameter:Keine
Rückgabewert:
DirectionsResult Gibt die aktuellen Routeninformationen des Renderers wieder. |
getMap |
getMap() Parameter:Keine
Rückgabewert:
Map Gibt die Karte zurück, auf der das DirectionsResult gerendert wird. |
getPanel |
getPanel() Parameter:Keine
Rückgabewert:
HTMLElement|null Gibt das Feld <div> zurück, in dem das DirectionsResult gerendert wird. |
getRouteIndex |
getRouteIndex() Parameter:Keine
Rückgabewert:
number Gibt den aktuellen (nullbasierten) Routenindex zurück, der von diesem DirectionsRenderer -Objekt verwendet wird. |
setDirections |
setDirections(directions) Parameter:
Rückgabewert:Keine
Legt fest, dass der Renderer das Ergebnis aus DirectionsService verwendet. Wenn auf diese Weise gültige Routeninformationen festgelegt werden, wird die Route in der dafür vorgesehenen Karte und Bereich des Renderers angezeigt. |
setMap |
setMap(map) Parameter:
Rückgabewert:Keine
Mit dieser Methode wird die Karte angegeben, auf der die Route angezeigt werden soll. Übergeben Sie null , um die Route von der Karte zu entfernen. |
setOptions |
setOptions(options) Parameter:
Rückgabewert:Keine
Ändere die Optionseinstellungen von DirectionsRenderer nach der Initialisierung. |
setPanel |
setPanel(panel) Parameter:
Rückgabewert:Keine
Diese Methode rendert die Route als <div> . Übergeben Sie null , um den Inhalt aus dem Bereich zu entfernen. |
setRouteIndex |
setRouteIndex(routeIndex) Parameter:
Rückgabewert:Keine
Legt den (nullbasierten) Index der Route im zu rendernden DirectionsResult -Objekt fest. Standardmäßig wird die erste Route im Array zurückgegeben. |
Übernommen:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Veranstaltungen | |
---|---|
directions_changed |
function() Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die gerenderten Richtungen ändern, entweder wenn ein neuer DirectionsResult festgelegt wird oder wenn der Nutzer eine Änderung in den Routenpfad gezogen hat. |
DirectionsRendererOptions-Schnittstelle
google.maps.DirectionsRendererOptions
-Schnittstelle
Dieses Objekt definiert die Eigenschaften, die für ein DirectionsRenderer
-Objekt festgelegt werden können.
Attribute | |
---|---|
directions optional |
Typ:
DirectionsResult optional Die Route, die auf der Karte und/oder in einem <div> -Bereich angezeigt werden soll und als DirectionsResult -Objekt von DirectionsService abgerufen wird. |
draggable optional |
Typ:
boolean optional Bei true kann der Nutzer die Pfade der von diesem DirectionsRenderer gerenderten Routen ziehen und ändern. |
hideRouteList optional |
Typ:
boolean optional Standard:
false Diese Eigenschaft gibt an, ob der Renderer eine vom Nutzer auswählbare Liste von Routen bereitstellen soll, die im Routenfeld angezeigt werden. |
infoWindow optional |
Typ:
InfoWindow optional Das InfoWindow , in dem Textinformationen gerendert werden, wenn auf eine Markierung geklickt wird. Vorhandene Inhalte des Infofensters werden überschrieben und seine Position wird entfernt. Wenn kein Infofenster angegeben wird, erstellt und verwendet DirectionsRenderer ein eigenes Infofenster. Dieses Attribut wird ignoriert, wenn suppressInfoWindows auf true gesetzt ist. |
map optional |
Typ:
Map optional Karte, auf der die Route angezeigt werden soll. |
markerOptions optional |
Typ:
MarkerOptions optional Optionen für die Markierungen. Diese Optionen werden für alle Markierungen verwendet, die vom DirectionsRenderer gerendert werden. |
panel optional |
Typ:
HTMLElement optional Der <div> , in dem die Routenschritte angezeigt werden sollen. |
polylineOptions optional |
Typ:
PolylineOptions optional Optionen für die Polylinien. Diese Optionen werden für alle Polylinien verwendet, die vom DirectionsRenderer gerendert werden. |
preserveViewport optional |
Typ:
boolean optional Standard:
false Wenn diese Option auf true gesetzt ist oder der Mittelpunkt und der Zoom der Karte nie festgelegt wurden, wird die Eingabekarte zentriert und auf den Markierungsrahmen dieses Routensatzes gezoomt. |
routeIndex optional |
Typ:
number optional Der Index der Route innerhalb des DirectionsResult -Objekts. Der Standardwert ist 0. |
suppressBicyclingLayer optional |
Typ:
boolean optional Unterdrückt das Rendern von BicyclingLayer , wenn Routen für Fahrräder angefragt werden. |
suppressInfoWindows optional |
Typ:
boolean optional Unterdrückt die Wiedergabe von Infofenstern. |
suppressMarkers optional |
Typ:
boolean optional Unterdrückt die Wiedergabe von Markierungen. |
suppressPolylines optional |
Typ:
boolean optional Unterdrückt die Wiedergabe von Polylinien. |
DirectionsWaypoint-Schnittstelle
google.maps.DirectionsWaypoint
-Schnittstelle
Eine DirectionsWaypoint
stellt einen Ort zwischen Start- und Zielort dar, über den die Fahrt verlaufen soll.
Attribute | |
---|---|
location optional |
Typ:
string|LatLng|LatLngLiteral|Place optional Standort des Wegpunktes. Kann ein Adressstring, LatLng oder Place sein. Optional. |
stopover optional |
Typ:
boolean optional Standard:
true Falls true , gibt dieser Wert an, dass dieser Wegpunkt ein Zwischenstopp zwischen Start- und Zielort ist. Dadurch wird die Route in zwei Streckenabschnitte aufgeteilt. Falls false , gibt an, dass die Route so gewichtet werden soll, dass sie über diesen Wegpunkt verläuft, aber nicht in zwei Streckenabschnitte aufgeteilt werden soll. Dies ist nützlich, wenn Sie eine Route als Reaktion darauf erstellen möchten, wenn der Nutzer Wegpunkte auf einer Karte zieht. |
Schnittstelle DirectionsGeoencodedWaypoint
google.maps.DirectionsGeocodedWaypoint
-Schnittstelle
Ein einzelner geocodierter Wegpunkt.
Attribute | |
---|---|
partial_match optional |
Typ:
boolean optional Gibt an, ob der Geocoder keine genaue Übereinstimmung für den ursprünglichen Wegpunkt zurückgegeben hat, obwohl ein Teil der angeforderten Adresse zugeordnet werden konnte. |
place_id optional |
Typ:
string optional Die Orts-ID, die dem Wegpunkt zugeordnet ist. Mit einer Orts-ID wird ein Ort in der Google Places-Datenbank und in Google Maps eindeutig identifiziert. Weitere Informationen zu Orts-IDs finden Sie im Places API-Entwicklerhandbuch. |
types optional |
Typ:
Array<string> optional Ein Array mit Zeichenfolgen, die die Typen der zurückgegebenen geocodierten Elemente bezeichnen. Eine Liste der möglichen Strings finden Sie im Abschnitt Adresskomponententypen im Entwicklerhandbuch. |
DirectionsRoute-Schnittstelle
google.maps.DirectionsRoute
-Schnittstelle
Eine einzelne Route mit einer Reihe von Streckenabschnitten in einem DirectionsResult
. Beachten Sie, dass dieses Objekt "JSON-ähnlich" ist, jedoch nicht ganz genau JSON entspricht, da es direkt und indirekt LatLng
-Objekte enthält.
Attribute | |
---|---|
bounds |
Typ:
LatLngBounds Die Grenzen für diese Route. |
copyrights |
Typ:
string Der Text zu den Urheberrechten, der für diese Route angezeigt werden soll. |
legs |
Typ:
Array<DirectionsLeg> Ein Array mit DirectionsLeg s, von denen jede Informationen zu den darin enthaltenen Schritten enthält. Für jeden angegebenen Wegpunkt oder Zielort mit Aufenthalt gibt es einen Abschnitt. Eine Route ohne Wegpunkte mit Aufenthalt enthält also ein DirectionsLeg und eine Route mit einem Wegpunkt mit einem Aufenthalt enthält zwei. |
overview_path |
Ein Array mit LatLng -Werten, die den gesamten Verlauf dieser Route darstellen. Der Pfad ist vereinfacht, damit er für Kontexte geeignet ist, in denen eine geringe Anzahl von Scheitelpunkten erforderlich ist, beispielsweise in Static Maps API-URLs. |
overview_polyline |
Typ:
string Eine codierte Polyliniendarstellung der Route in „overview_path“. Die Polylinie ist der annähernde (geglättete) Pfad der ermittelten Wegbeschreibung. |
summary |
Typ:
string Enthält eine kurze Beschreibung der Route in Textform und eignet sich, um die Route zu benennen und von Alternativen zu unterscheiden. |
warnings |
Typ:
Array<string> Warnungen, die angezeigt werden sollen, wenn diese Route angezeigt wird. |
waypoint_order |
Typ:
Array<number> Wenn optimizeWaypoints auf true gesetzt wurde, enthält dieses Feld die neue Anordnung der Eingabe-Wegpunkte. Wenn die Eingabe beispielsweiseStart: Los Angeles Wegpunkte: Dallas, Bangor, Phoenix Ziel: New York und die optimierte Ausgabe so geordnet war: Start: Los Angeles Wegpunkte: Phoenix, Dallas, Bangor Ziel: New York ist dieses Feld ein Array mit den Werten [2, 0, 1]. Beachten Sie, dass die Nummerierung der Wegpunkte auf Null basiert.Wenn bei einem der Eingabe-Wegpunkte stopover auf false gesetzt ist, ist dieses Feld leer, da die Routenoptimierung für solche Anfragen nicht verfügbar ist. |
fare optional |
Typ:
TransitFare optional Der Gesamtpreis für die gesamte Fahrt mit öffentlichen Verkehrsmitteln. Gilt nur für Anfragen für öffentliche Verkehrsmittel. |
DirectionsLeg-Schnittstelle
google.maps.DirectionsLeg
-Schnittstelle
Ein einzelner Streckenabschnitt ("leg") in einem DirectionsResult
, der aus einer Reihe von Schritten besteht. Einige Felder im Streckenabschnitt werden möglicherweise nicht für alle Anfragen zurückgegeben. Beachten Sie, dass dieses Ergebnis "JSON-ähnlich" ist, aber nicht ganz genau JSON entspricht, da es direkt und indirekt LatLng
-Objekte enthält.
Attribute | |
---|---|
end_address |
Typ:
string Die Zieladresse dieses Streckenabschnitts. Dieser Inhalt ist so zu lesen, wie er ist. Die formatierte Adresse darf nicht programmatisch geparst werden. |
end_location |
Typ:
LatLng DirectionsService berechnet die Route zwischen Standorten unter Verwendung der nächstgelegenen Transportoption (normalerweise einer Straße) am Start- und Endpunkt. end_location gibt das tatsächliche geocodierte Ziel an. Dieses kann sich vom end_location des letzten Schritts unterscheiden, beispielsweise wenn sich die Straße nicht in der Nähe des Ziels dieses Abschnitts befindet. |
start_address |
Typ:
string Die Ursprungsadresse dieses Streckenabschnitts. Dieser Inhalt ist so zu lesen, wie er ist. Die formatierte Adresse darf nicht programmatisch geparst werden. |
start_location |
Typ:
LatLng DirectionsService berechnet die Route zwischen Standorten unter Verwendung der nächstgelegenen Transportoption (normalerweise einer Straße) am Start- und Endpunkt. start_location gibt den tatsächlichen geocodierten Ursprung an. Dieser kann sich vom start_location des ersten Schritts unterscheiden, beispielsweise wenn sich die Straße nicht in der Nähe des Ursprungs dieses Abschnitts befindet. |
steps |
Typ:
Array<DirectionsStep> Ein Array mit DirectionsStep s, von denen jede Informationen zu den einzelnen Schritten in diesem Abschnitt enthält. |
|
Typ:
Array<?> Informationen zur Verkehrsgeschwindigkeit auf dieser Strecke. |
via_waypoints |
Ein Array von Wegpunkten ohne Zwischenstopps entlang dieses Abschnitts, die in der ursprünglichen Anfrage angegeben wurden. In alternativen Routen verworfen. Version 3.27 ist die letzte Version der API, die zusätzliche Wenn Sie den „Directions“-Dienst verwenden, um frei verschiebbare Routen zu implementieren, wird empfohlen, das Ziehen alternativer Routen zu deaktivieren. Nur die Hauptroute sollte ziehbar sein. Nutzer können die Hauptroute ziehen, bis sie einer alternativen Route entspricht. |
arrival_time optional |
Typ:
Time optional Eine voraussichtliche Ankunftszeit für diesen Abschnitt. Gilt nur für TRANSIT-Anfragen. |
departure_time optional |
Typ:
Time optional Die geschätzte Abfahrtszeit für diesen Abschnitt. Gilt nur für TRANSIT-Anfragen. |
distance optional |
Typ:
Distance optional Die Gesamtstrecke, die durch diesen Streckenabschnitt zurückgelegt wird. Diese Eigenschaft ist möglicherweise nicht definiert, falls die Entfernung nicht bekannt ist. |
duration optional |
Typ:
Duration optional Die Gesamtdauer für diesen Streckenabschnitt. Dieses Attribut kann undefined sein, da die Dauer möglicherweise nicht bekannt ist. |
duration_in_traffic optional |
Typ:
Duration optional Die Gesamtdauer dieses Abschnitts. Dabei wird die Verkehrslage berücksichtigt, die in der Property trafficModel angegeben ist. Dieses Attribut kann undefined sein, da die Dauer möglicherweise nicht bekannt ist. |
DirectionsStep-Schnittstelle
google.maps.DirectionsStep
-Schnittstelle
Ein einzelnes DirectionsStep
in einem DirectionsResult
. Einige Felder können undefined
sein. Beachten Sie, dass dieses Objekt "JSON-ähnlich" ist, jedoch nicht ganz genau JSON entspricht, da es direkt LatLng
-Objekte enthält.
Attribute | |
---|---|
encoded_lat_lngs |
Typ:
string Eine codierte Polyliniendarstellung des Schritts. Dies ist der annähernde (geglättete) Pfad des Schritts. |
end_location |
Typ:
LatLng Der Endstandort dieses Schrittes. |
|
Typ:
LatLng Der Endstandort dieses Schrittes. |
instructions |
Typ:
string Anweisungen für diesen Schritt. |
|
Eine Folge von LatLng -Werten, die den Verlauf dieses Schritts beschreiben. Dies ist der annähernde (geglättete) Pfad des Schritts. |
maneuver |
Typ:
string Enthält die Aktion, die für den aktuellen Schritt ausgeführt werden soll ( turn-left , merge , straight usw.). Die Werte können sich ändern und es können ohne vorherige Ankündigung neue Werte eingeführt werden. |
path |
Eine Folge von LatLng -Werten, die den Verlauf dieses Schritts beschreiben. Dies ist der annähernde (geglättete) Pfad des Schritts. |
start_location |
Typ:
LatLng Der Startstandort dieses Schrittes. |
|
Typ:
LatLng Der Startstandort dieses Schrittes. |
travel_mode |
Typ:
TravelMode Die in diesem Schritt verwendete Fortbewegungsmethode. |
distance optional |
Typ:
Distance optional Die Entfernung, die durch diesen Schritt zurückgelegt wird. Diese Eigenschaft kann undefined sein, da die Strecke möglicherweise nicht bekannt ist. |
duration optional |
Typ:
Duration optional Die normalerweise zum Durchführen dieses Schrittes erforderliche Zeit, angegeben in Sekunden und Textform. Dieses Attribut kann undefined sein, da die Dauer möglicherweise nicht bekannt ist. |
|
Typ:
DirectionsPolyline optional Enthält ein Objekt mit der einzelnen Eigenschaft 'points' und einer codierten Polylinie, die den Schritt darstellt. Die Polylinie ist der annähernde (geglättete) Pfad des Schritts. |
steps optional |
Typ:
Array<DirectionsStep> optional Teilschritte dieses Schritts. Angegeben für Nicht-Transit-Abschnitte von Routen mit öffentlichen Verkehrsmitteln. |
transit optional |
Typ:
TransitDetails optional Details zu öffentlichen Verkehrsmitteln zu diesem Schritt. Dieses Attribut ist nicht definiert, es sei denn, die Mobilitätsform dieses Schritts ist TRANSIT . |
transit_details optional |
Typ:
TransitDetails optional Details zu diesem Schritt, wenn als Mobilitätsform TRANSIT ausgewählt ist. |
DirectionsPolyline-Schnittstelle
google.maps.DirectionsPolyline
-Schnittstelle
Ein Objekt, das eine points
-Eigenschaft zur Beschreibung der Polylinie eines DirectionsStep
-Elements enthält.
Attribute | |
---|---|
points |
Typ:
string Eine codierte Polylinie. |
Place-Schnittstelle
google.maps.Place
-Schnittstelle
Enthält Informationen zum Auffinden, Identifizieren oder Beschreiben eines Ortes für DirectionsRequest
oder DistanceMatrixRequest
. In diesem Zusammenhang bezieht sich der Begriff "Ort" auf ein Geschäft, einen POI oder einen geografischen Standort. Informationen zu einem Ort finden Sie unter PlacesService
.
Attribute | |
---|---|
location optional |
Typ:
LatLng|LatLngLiteral optional Die LatLng der durch diesen Ort beschriebenen Entität. |
placeId optional |
Typ:
string optional Die Orts-ID des Ortes, z. B. ein Geschäft oder ein POI. Die Orts-ID ist eine eindeutige Kennung für einen Ort in der Google Maps-Datenbank. placeId ist die genaueste Methode, um einen Ort zu identifizieren. Wenn möglich, solltest du placeId anstelle von query angeben. Eine Orts-ID kann aus jeder Anfrage an die Places API abgerufen werden, z. B. durch eine TextSearch. Orts-IDs können auch aus Anfragen an die Geocoding API abgerufen werden. Weitere Informationen finden Sie in der Übersicht über Orts-IDs. |
query optional |
Typ:
string optional Eine Suchanfrage, die den Ort beschreibt (z. B. ein Geschäft oder einen POI). Eine Beispielabfrage ist "Quay, Upper Level, Overseas Passenger Terminal 5 Hickson Road, The Rocks NSW". Wenn möglich, solltest du placeId anstelle von query angeben. Die API garantiert nicht die Genauigkeit beim Auflösen des Abfragestrings in einen Ort. Wenn sowohl placeId als auch query angegeben sind, tritt ein Fehler auf. |
TravelMode-Konstanten
google.maps.TravelMode
-Konstanten
Die gültigen Mobilitätsformen, die in einem DirectionsRequest
angegeben werden können, sowie die Mobilitätsformen, die in einem DirectionsStep
zurückgegeben werden. Geben Sie diese als Wert oder mit dem Namen der Konstante an. Beispiel: 'BICYCLING'
oder google.maps.TravelMode.BICYCLING
.
Zugriff durch Aufrufen von const {TravelMode} = await google.maps.importLibrary("routes")
. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
BICYCLING |
Kennzeichnet eine Routenanfrage für Fahrräder. |
DRIVING |
Kennzeichnet eine Routenanfrage für motorisierte Fahrzeuge. |
TRANSIT |
Gibt eine Routenanfrage für öffentliche Verkehrsmittel an. |
WALKING |
Kennzeichnet eine Routenanfrage für Fußgänger. |
DrivingOptions.
google.maps.DrivingOptions
-Schnittstelle
Konfiguriert die DirectionsRequest
, wenn die Mobilitätsform auf DRIVING
festgelegt ist.
Attribute | |
---|---|
departureTime |
Typ:
Date Die gewünschte Abfahrtszeit für die Route, angegeben als Date -Objekt. Das Objekt Date misst die Zeit in Millisekunden seit dem 1. Januar 1970. Dieser Wert muss angegeben werden, damit ein DrivingOptions gültig ist. Die Abfahrtszeit muss auf die aktuelle oder eine Zeit in der Zukunft festgelegt werden. Der Wert darf nicht in der Vergangenheit liegen. |
trafficModel optional |
Typ:
TrafficModel optional Die bevorzugte Annahme, die bei der Vorhersage der Dauer im Traffic verwendet werden soll. Der Standardwert ist BEST_GUESS . |
TrafficModel-Konstanten
google.maps.TrafficModel
-Konstanten
Die Annahmen, die bei der Vorhersage der Dauer im Traffic zu verwenden sind. Wird als Teil von DirectionsRequest
oder DistanceMatrixRequest
angegeben. Geben Sie diese als Wert oder mit dem Namen der Konstante an. Beispiel: 'bestguess'
oder google.maps.TrafficModel.BEST_GUESS
.
Zugriff durch Aufrufen von const {TrafficModel} = await google.maps.importLibrary("routes")
. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
BEST_GUESS |
Sie können bisherige Traffic-Daten verwenden, um die im Traffic aufgewendete Zeit bestmöglich abzuschätzen. |
OPTIMISTIC |
Sie können bisherige Traffic-Daten verwenden, um eine optimistische Schätzung der Traffic-Dauer zu erstellen. |
PESSIMISTIC |
Sie können bisherige Traffic-Daten verwenden, um eine pessimistische Schätzung der Traffic-Dauer zu erstellen. |
TransitOptions-Schnittstelle
google.maps.TransitOptions
-Schnittstelle
Das TransitOptions-Objekt, das in ein DirectionsRequest
aufgenommen werden soll, wenn die Mobilitätsform auf TRANSIT festgelegt ist.
Attribute | |
---|---|
arrivalTime optional |
Typ:
Date optional Die gewünschte Ankunftszeit für die Route, angegeben als Datumsobjekt. Das Objekt „Date“ misst die Zeit in Millisekunden seit dem 1. Januar 1970. Wenn die Ankunftszeit angegeben ist, wird die Abreisezeit ignoriert. |
departureTime optional |
Typ:
Date optional Die gewünschte Abfahrtszeit für die Route, angegeben als Datumsobjekt. Das Objekt „Date“ misst die Zeit in Millisekunden seit dem 1. Januar 1970. Wenn weder die Abfahrtszeit noch die Ankunftszeit angegeben ist, wird angenommen, dass die Zeit „jetzt“ ist. |
modes optional |
Typ:
Array<TransitMode> optional Eine oder mehrere bevorzugte Mobilitätsformen, z. B. Bus oder Zug. Wenn keine Präferenz angegeben ist, gibt die API die standardmäßig beste Route zurück. |
routingPreference optional |
Typ:
TransitRoutePreference optional Eine Präferenz, die die Auswahl der Route mit öffentlichen Verkehrsmitteln beeinflussen kann, z. B. kürzere Fußwege. Wenn keine Präferenz angegeben ist, gibt die API die standardmäßig beste Route zurück. |
TransitMode-Konstanten
google.maps.TransitMode
-Konstanten
Die gültige Mobilitätsform, z.B. Bus, die in einem TransitOptions
angegeben werden kann. Geben Sie diese als Wert oder mit dem Namen der Konstante an. Beispiel: 'BUS'
oder google.maps.TransitMode.BUS
.
Zugriff durch Aufrufen von const {TransitMode} = await google.maps.importLibrary("routes")
. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
BUS |
Gibt den Bus als bevorzugte Mobilitätsform an. |
RAIL |
Gibt Bahn als bevorzugtes Verkehrsmittel an. |
SUBWAY |
Gibt die U-Bahn als bevorzugtes Verkehrsmittel an. |
TRAIN |
Gibt Zug als bevorzugte Mobilitätsform an. |
TRAM |
Gibt Straßenbahn als bevorzugte Mobilitätsform an. |
TransitRoutePreferred-Konstanten
google.maps.TransitRoutePreference
-Konstanten
Der gültige Routentyp für öffentliche Verkehrsmittel, der in einer TransitOptions
angegeben werden kann. Geben Sie diese als Wert oder mit dem Namen der Konstante an. Beispiel: 'LESS_WALKING'
oder google.maps.TransitRoutePreference.LESS_WALKING
.
Zugriff durch Aufrufen von const {TransitRoutePreference} = await google.maps.importLibrary("routes")
. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
FEWER_TRANSFERS |
Gibt an, dass für die berechnete Route eine begrenzte Anzahl von Umstiegen bevorzugt werden soll. |
LESS_WALKING |
Gibt an, dass die berechnete Route möglichst wenige Gehstrecken enthalten soll. |
TransitFare-Schnittstelle
google.maps.TransitFare
-Schnittstelle
Preis eines DirectionsRoute
, bestehend aus Wert und Währung.
Attribute | |
---|---|
currency |
Typ:
string Ein Währungscode nach ISO 4217 für die Währung des Fahrpreises. |
value |
Typ:
number Der numerische Wert des Fahrpreises, ausgedrückt in der gegebenen currency . |
TransitDetails-Schnittstelle
google.maps.TransitDetails
-Schnittstelle
Details zu Abfahrt, Ankunft und Mobilitätsform, die in diesem Schritt verwendet wird.
Attribute | |
---|---|
arrival_stop |
Typ:
TransitStop Die Ankunftshaltestelle dieser ÖPNV-Stufe. |
arrival_time |
Typ:
Time Die Ankunftszeit dieses Schritts, angegeben als Time-Objekt. |
departure_stop |
Typ:
TransitStop Die Haltestelle dieses Abschnitts mit öffentlichen Verkehrsmitteln. |
departure_time |
Typ:
Time Die Abfahrtszeit dieses Schritts, angegeben als Time-Objekt. |
headsign |
Typ:
string Die Fahrtrichtung dieser Linie, wie sie auf dem Fahrzeug oder an der Abfahrtshaltestelle angegeben ist. |
headway |
Typ:
number Die erwartete Anzahl von Sekunden zwischen gleichwertigen Fahrzeugen an dieser Haltestelle. |
line |
Typ:
TransitLine Details zur ÖPNV-Linie, die in diesem Schritt verwendet wird. |
num_stops |
Typ:
number Die Anzahl der Zwischenstopps bei diesem Schritt. Dabei wird die Zielhaltestelle mitgezählt, die Starthaltestelle aber nicht. |
trip_short_name |
Typ:
string Der Text, der in Fahrplänen und auf Anzeigetafeln erscheint, um Fahrgäste mit öffentlichen Verkehrsmitteln zu kennzeichnen, z. B. Bahnnummern für Pendlerzugfahrten mit der Bahn. Mit dem Text wird eine Fahrt innerhalb eines Betriebstages eindeutig identifiziert. |
TransitStop-Schnittstelle
google.maps.TransitStop
-Schnittstelle
Details zu einer Haltestelle oder einem Bahnhof.
Attribute | |
---|---|
location |
Typ:
LatLng Die Position dieser Haltestelle. |
name |
Typ:
string Der Name dieser Haltestelle. |
TransitLine-Schnittstelle
google.maps.TransitLine
-Schnittstelle
Informationen zu der ÖPNV-Linie, die diesen ÖPNV-Schritt betreibt.
Attribute | |
---|---|
agencies |
Typ:
Array<TransitAgency> Der Betreiber, der diese ÖPNV-Linie betreibt. |
color |
Typ:
string Die Farbe, die häufig für die Beschilderung dieser ÖPNV-Linie verwendet wird, angegeben als Hexadezimalwert. |
icon |
Typ:
string Die URL für ein Symbol, das mit dieser Linie verknüpft ist. |
name |
Typ:
string Der vollständige Name dieser ÖPNV-Linie, z.B. „8 Avenue Local“. |
short_name |
Typ:
string Der Kurzname der ÖPNV-Linie, z.B. „E“. |
text_color |
Typ:
string Die Textfarbe, die normalerweise für die Beschilderung dieser ÖPNV-Linie verwendet wird, angegeben als Hexadezimalwert. |
url |
Typ:
string Die URL des Betreibers, die für diese ÖPNV-Linie spezifisch ist. |
vehicle |
Typ:
TransitVehicle Der Typ des verwendeten Fahrzeugs, z.B. Zug oder Bus. |
TransitAgency-Schnittstelle
google.maps.TransitAgency
-Schnittstelle
Informationen zu einem Betreiber, der eine ÖPNV-Linie betreibt.
Attribute | |
---|---|
name |
Typ:
string Der Name dieses Betreibers. |
phone |
Typ:
string Die Telefonnummer des Verkehrsverbunds. |
url |
Typ:
string Die URL des Verkehrsverbunds. |
TransitVehicle-Schnittstelle
google.maps.TransitVehicle
-Schnittstelle
Informationen zu dem Fahrzeug, das auf einer ÖPNV-Linie eingesetzt wird.
Attribute | |
---|---|
icon |
Typ:
string Eine URL für ein Symbol, das dem auf dieser Linie eingesetzten Fahrzeugtyp entspricht. |
local_icon |
Typ:
string Eine URL für ein Symbol, das anstelle des allgemeineren Symbols dem in dieser Region verwendeten Fahrzeugtyp entspricht. |
name |
Typ:
string Ein Name für diesen Fahrzeugtyp, z.B. „Zug“ oder „Bus“. |
type |
Typ:
VehicleType Der Typ des verwendeten Fahrzeugs, z.B. Zug, Bus oder Fähre. |
VehicleType-Konstanten
google.maps.VehicleType
-Konstanten
Mögliche Werte für Fahrzeugtypen.
Zugriff durch Aufrufen von const {VehicleType} = await google.maps.importLibrary("routes")
. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
BUS |
Bus |
CABLE_CAR |
Ein Fahrzeug, das über Kabel betrieben wird, normalerweise am Boden. Luftseilbahnen haben den Typ GONDOLA_LIFT . |
COMMUTER_TRAIN |
Schnellbahn |
FERRY |
Fähre |
FUNICULAR |
Ein Fahrzeug, das mit einem Kabel eine starke Steigung hinaufgezogen wird. |
GONDOLA_LIFT |
Eine Luftseilbahn. |
HEAVY_RAIL |
Eisenbahn |
HIGH_SPEED_TRAIN |
Schnellzug |
INTERCITY_BUS |
Fernbus |
METRO_RAIL |
Stadtbahn |
MONORAIL |
Einschienenbahn |
OTHER |
Andere Fahrzeuge. |
RAIL |
Bahn |
SHARE_TAXI |
Sammeltaxis sind eine Art Busverkehr, bei dem Fahrgäste überall auf der Strecke ein- und aussteigen können. In der Regel werden Sammeltaxis Kleinbusse genutzt. |
SUBWAY |
U-Bahn |
TRAM |
Straßenbahn |
TROLLEYBUS |
Oberleitungsbus |
UnitSystem-Konstanten
google.maps.UnitSystem
-Konstanten
Die gültigen Einheitensysteme, die in einer DirectionsRequest
angegeben werden können.
Zugriff durch Aufrufen von const {UnitSystem} = await google.maps.importLibrary("core")
. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstanten | |
---|---|
IMPERIAL |
Gibt an, dass Entfernungen im DirectionsResult in imperialen Einheiten angegeben werden sollen. |
METRIC |
Gibt an, dass Entfernungen im DirectionsResult in metrischen Einheiten angegeben werden sollen. |
Distance-Schnittstelle
google.maps.Distance
-Schnittstelle
Eine Darstellung der Entfernung als numerischer Wert und Anzeigezeichenfolge.
Attribute | |
---|---|
text |
Typ:
string Eine Stringdarstellung des Entfernungswerts mit dem in der Anfrage angegebenen UnitSystem . |
value |
Typ:
number Die Entfernung in Metern. |
Duration
google.maps.Duration
-Schnittstelle
Eine Darstellung der Dauer als numerischer Wert und Anzeigezeichenfolge.
Attribute | |
---|---|
text |
Typ:
string Eine Zeichenfolgendarstellung des Wertes für die Dauer. |
value |
Typ:
number Die Dauer in Sekunden. |
Time-Schnittstelle
google.maps.Time
-Schnittstelle
Eine Darstellung der Uhrzeit als Datumsobjekt, als lokalisierter String und als Zeitzone.
Attribute | |
---|---|
text |
Typ:
string Ein String, der den Wert der Zeit darstellt. Die Zeit wird in der Zeitzone des Zielorts angegeben. |
time_zone |
Typ:
string Die Zeitzone, in der diese Haltestelle liegt. Der Wert ist der Name der Zeitzone gemäß Definition in der IANA-Zeitzonendatenbank, z.B. "America/New_York". |
value |
Typ:
Date Die Uhrzeit dieser Abfahrt oder Ankunft, angegeben als JavaScript Date-Objekt. |
DirectionsTravelMode-Konstanten
google.maps.DirectionsTravelMode
-Konstanten
DirectionsUnitSystem-Konstanten
google.maps.DirectionsUnitSystem
-Konstanten