Directions

DirectionsService-Klasse

google.maps.DirectionsService Klasse

Dienst zur Berechnung der Route zwischen zwei oder mehr Orten.

Zugriff durch Anrufen von const {DirectionsService} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
DirectionsService
DirectionsService()
Parameter:Keine
Erstellt eine neue Instanz von DirectionsService, die Anfragen für Wegbeschreibungen an Google-Server sendet.
route
route(request[, callback])
Parameter:
Rückgabewert:Promise<DirectionsResult>
Sendet eine Suchanfrage für eine Route.

DirectionsRequest-Schnittstelle

google.maps.DirectionsRequest-Schnittstelle

Eine Anfrage für eine Wegbeschreibung, die an DirectionsService gesendet werden soll.
destination
Zielstandort. Dies kann entweder als String, der geocodiert werden soll, als LatLng oder als Place angegeben werden. Erforderlich.
origin
Ursprungsort. Dies kann entweder als String, der geocodiert werden soll, als LatLng oder als Place angegeben werden. Erforderlich.
travelMode
Typ der angeforderten Route. Erforderlich.
avoidFerries optional
Typ:boolean optional
Wenn true festgelegt ist, wird der Directions-Dienst angewiesen, Fähren nach Möglichkeit zu vermeiden. Optional.
avoidHighways optional
Typ:boolean optional
Wenn true festgelegt ist, wird der „Directions“-Dienst angewiesen, Autobahnen nach Möglichkeit zu vermeiden. Optional.
avoidTolls optional
Typ:boolean optional
Ist true festgelegt, wird der Directions-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.
optimizeWaypoints optional
Typ:boolean optional
Wenn der Wert auf true festgelegt ist, versucht DirectionsService, die angegebenen Zwischenziele neu anzuordnen, um die Gesamtkosten der Route zu minimieren. Wenn Wegpunkte optimiert werden, sehen Sie sich DirectionsRoute.waypoint_order in der Antwort an, um die neue Reihenfolge zu ermitteln.
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 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
Standard:Das im Herkunftsland verwendete Einheitensystem.
Bevorzugtes Maßeinheitensystem für die Anzeige der Entfernung.
waypoints optional
Array mit Wegzwischenpunkten. Die Wegbeschreibung wird vom Start- zum Zielort über jeden Wegpunkt in diesem Array berechnet. Die maximal zulässige Anzahl von Wegpunkten finden Sie im Entwicklerleitfaden. 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 nach Wert oder mit dem Namen der Konstante an. Beispiel: 'OK' oder google.maps.DirectionsStatus.OK.

Zugriff durch Anrufen von const {DirectionsStatus} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
INVALID_REQUEST Der angegebene DirectionsRequest war ungültig.
MAX_WAYPOINTS_EXCEEDED In der DirectionsRequest wurden zu viele DirectionsWaypoint angegeben. Die maximal zulässige Anzahl von Wegpunkten finden Sie im Entwicklerleitfaden.
NOT_FOUND Mindestens einer der Orte (Ursprungsort, Zielort oder Wegpunkte) konnte nicht geocodiert werden.
OK Die Antwort enthält ein gültiges 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 es erneut versuchen.
ZERO_RESULTS Zwischen Ursprungsort und Zielort konnte keine Route gefunden werden.

Schnittstelle DirectionsResult

google.maps.DirectionsResult-Schnittstelle

Die vom Routenserver abgerufene Routenantwort. Sie können diese mit einem DirectionsRenderer rendern oder das Objekt parsen und selbst rendern. Sie müssen die Warnungen und Urheberrechtshinweise gemäß den Nutzungsbedingungen für die Google Maps Platform anzeigen. Dieses Ergebnis ist zwar „JSON-ähnlich“, aber nicht streng JSON, da es indirekt LatLng-Objekte enthält.
request
Der DirectionsRequest, der dieses Ergebnis geliefert hat.
routes
Ein Array von DirectionsRoute-Objekten, die jeweils Informationen zu den Abschnitten und Schritten enthalten, aus denen sie bestehen. Es gibt nur eine Route, es sei denn, die 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 in einer Anfrage eine Mobilitätsform angegeben ist 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
Ein Array mit DirectionsGeocodedWaypoint-Objekten, von denen jedes Informationen zum Geocoding von Startort, Zielort und Wegpunkten enthält.

Klasse DirectionsRenderer

google.maps.DirectionsRenderer Klasse

Rendert Wegbeschreibungen, die von DirectionsService abgerufen wurden.

Diese Klasse erweitert MVCObject.

Zugriff durch Anrufen von const {DirectionsRenderer} = await google.maps.importLibrary("routes").
Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
DirectionsRenderer
DirectionsRenderer([opts])
Parameter:
Erstellt den Renderer mit den angegebenen Optionen. Routen können auf einer Karte (als visuelle Overlays) oder zusätzlich in einem <div>-Bereich (als Textanweisungen) gerendert werden.
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 die DirectionsResult gerendert wird.
getPanel
getPanel()
Parameter:Keine
Rückgabewert:HTMLElement|null
Gibt den Bereich <div> zurück, in dem der 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:Keiner
Legen Sie den Renderer so fest, dass das Ergebnis aus DirectionsService verwendet wird. 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:Keiner
Mit dieser Methode wird die Karte angegeben, auf der die Route angezeigt werden soll. Übergeben Sie null, um die Wegbeschreibung aus der Karte zu entfernen.
setOptions
setOptions(options)
Parameter:
Rückgabewert:Keiner
Ändern Sie die Options-Einstellungen dieses DirectionsRenderer nach der Initialisierung.
setPanel
setPanel(panel)
Parameter:
Rückgabewert:Keiner
Mit dieser Methode wird die Wegbeschreibung in einem <div> gerendert. Übergeben Sie null, um den Inhalt aus dem Bereich zu entfernen.
setRouteIndex
setRouteIndex(routeIndex)
Parameter:
  • routeIndex:  number
Rückgabewert:Keiner
Legen Sie den (nullbasierten) Index der zu rendernden Route im DirectionsResult-Objekt fest. Standardmäßig wird die erste Route im Array zurückgegeben.
Geerbt:addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
directions_changed
function()
Argumente:Keine
Dieses Ereignis wird ausgelöst, wenn sich die gerenderte Wegbeschreibung ändert, entweder wenn ein neues DirectionsResult festgelegt wird oder wenn der Nutzer das Ziehen einer Änderung am Wegbeschreibungs-Pfad beendet.

DirectionsRendererOptions interface

google.maps.DirectionsRendererOptions-Schnittstelle

Dieses Objekt definiert die Eigenschaften, die für ein DirectionsRenderer-Objekt festgelegt werden können.
directions optional
Typ:DirectionsResult optional
Die Wegbeschreibung, die auf der Karte und/oder in einem <div>-Bereich angezeigt werden soll. Sie wird als DirectionsResult-Objekt aus DirectionsService abgerufen.
draggable optional
Typ:boolean optional
Wenn true, kann der Nutzer die Pfade von Routen, die von diesem DirectionsRenderer gerendert werden, ziehen und ändern.
hideRouteList optional
Typ:boolean optional
Standard:false
Mit dieser Eigenschaft wird angegeben, ob der Renderer eine vom Nutzer auswählbare Liste von Routen im Bereich für die Wegbeschreibung bereitstellen soll.
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 ist, wird ein eigenes Infofenster von DirectionsRenderer erstellt und verwendet. Diese Property 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 von DirectionsRenderer gerendert werden.
panel optional
Typ:HTMLElement optional
Das <div>, in dem die einzelnen Schritte der Wegbeschreibung angezeigt werden sollen.
polylineOptions optional
Typ:PolylineOptions optional
Optionen für die Polylinien. Alle Polylinien, die mit DirectionsRenderer gerendert werden, verwenden diese Optionen.
preserveViewport optional
Typ:boolean optional
Standard:false
Wenn diese Option auf true gesetzt ist oder die Mitte und der Zoom der Karte nie festgelegt wurden, wird die Eingabekarte auf den Begrenzungsrahmen dieser Wegbeschreibung zentriert und gezoomt.
routeIndex optional
Typ:number optional
Der Index der Route im DirectionsResult-Objekt. Der Standardwert ist 0.
suppressBicyclingLayer optional
Typ:boolean optional
Die Darstellung von BicyclingLayer unterdrücken, wenn Fahrradrouten angefordert 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

Ein DirectionsWaypoint steht für einen Ort zwischen Start- und Zielort, über den die Fahrt verlaufen soll.
location optional
Typ:string|LatLng|LatLngLiteral|Place optional
Standort des Wegpunktes. Kann ein Adressstring, ein LatLng oder ein Place sein. Optional.
stopover optional
Typ:boolean optional
Standard:true
Wenn true, gibt dies an, dass dieser Wegpunkt ein Stopp zwischen Start- und Zielort ist. Die Route wird dann in zwei Abschnitte unterteilt. Wenn false, wird die Route so berechnet, dass sie diesen Wegpunkt durchläuft, aber nicht in zwei Abschnitte unterteilt wird. Das ist nützlich, wenn Sie eine Route erstellen möchten, nachdem der Nutzer Wegpunkte auf einer Karte gezogen hat.

DirectionsGeocodedWaypoint-Schnittstelle

google.maps.DirectionsGeocodedWaypoint-Schnittstelle

Ein einzelner geocodierter Wegpunkt.
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 mit dem Wegpunkt verknüpft 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 Entwicklerleitfaden für die Places API.
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 Typen von Adresskomponenten im Entwicklerhandbuch.

DirectionsRoute-Schnittstelle

google.maps.DirectionsRoute-Schnittstelle

Eine einzelne Route mit einer Reihe von Abschnitten in einem DirectionsResult. Dieses Objekt ist zwar „JSON-ähnlich“, aber nicht streng JSON, da es direkt und indirekt LatLng-Objekte enthält.
bounds
Die Grenzen für diese Route.
copyrights
Typ:string
Der Text zu den Urheberrechten, der für diese Route angezeigt werden soll.
legs
Ein Array von DirectionsLeg-Elementen, die jeweils Informationen zu den Schritten enthalten, aus denen sie bestehen. Für jeden angegebenen Zwischenstopp-Wegpunkt oder Zielort ist ein separater Routenabschnitt vorhanden. Eine Route ohne Wegpunkte mit Aufenthalt enthält also ein DirectionsLeg und eine Route mit einem Wegpunkt mit 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.