Ermöglicht das Abrufen von Routen zwischen Orten.
Im Beispiel unten sehen Sie, wie Sie mit dieser Klasse die Route vom Times Square zum Central Park abrufen, zuerst am Lincoln Center halten, die Standorte und den Pfad auf einer Karte darstellen und die Karte dann per E-Mail versenden können.
// Get the directions. var directions = Maps.newDirectionFinder() .setOrigin('Times Square, New York, NY') .addWaypoint('Lincoln Center, New York, NY') .setDestination('Central Park, New York, NY') .setMode(Maps.DirectionFinder.Mode.DRIVING) .getDirections(); var route = directions.routes[0]; // Set up marker styles. var markerSize = Maps.StaticMap.MarkerSize.MID; var markerColor = Maps.StaticMap.Color.GREEN var markerLetterCode = 'A'.charCodeAt(); // Add markers to the map. var map = Maps.newStaticMap(); for (var i = 0; i < route.legs.length; i++) { var leg = route.legs[i]; if (i == 0) { // Add a marker for the start location of the first leg only. map.setMarkerStyle(markerSize, markerColor, String.fromCharCode(markerLetterCode)); map.addMarker(leg.start_location.lat, leg.start_location.lng); markerLetterCode++; } map.setMarkerStyle(markerSize, markerColor, String.fromCharCode(markerLetterCode)); map.addMarker(leg.end_location.lat, leg.end_location.lng); markerLetterCode++; } // Add a path for the entire route. map.addPath(route.overview_polyline.points); // Send the map in an email. var toAddress = Session.getActiveUser().getEmail(); MailApp.sendEmail( toAddress, 'Directions', 'Please open: ' + map.getMapUrl() + '&key=YOUR_API_KEY', { htmlBody: 'See below.<br/><img src="cid:mapImage">', inlineImages: { mapImage: Utilities.newBlob(map.getMapImage(), 'image/png') } } );
Weitere Informationen
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
addWaypoint(latitude, longitude) | DirectionFinder | Fügt einen Wegpunkt hinzu, den die Route passieren muss. Dazu wird ein Punkt (lat/lng) verwendet. |
addWaypoint(address) | DirectionFinder | Fügt mithilfe einer Adresse einen Wegpunkt hinzu, den die Route passieren muss. |
clearWaypoints() | DirectionFinder | Löscht die aktuelle Gruppe von Wegpunkten. |
getDirections() | Object | Ruft die Route anhand des Startorts, des Zielorts und anderer festgelegter Optionen ab. |
setAlternatives(useAlternatives) | DirectionFinder | Legt fest, ob anstelle der Route mit dem höchsten Rang alternative Routen zurückgegeben werden sollen (Standardeinstellung ist "false"). |
setArrive(time) | DirectionFinder | Legt die gewünschte Ankunftszeit fest (falls zutreffend). |
setAvoid(avoid) | DirectionFinder | Legt fest, ob bestimmte Arten von Einschränkungen vermieden werden sollen. |
setDepart(time) | DirectionFinder | Legt die gewünschte Abfahrtszeit fest (falls zutreffend). |
setDestination(latitude, longitude) | DirectionFinder | Legt den Zielort fest, zu dem die Route mithilfe eines Punkts (Breiten-/Längengrad) berechnet wird. |
setDestination(address) | DirectionFinder | Legt den Zielort fest, für den die Route anhand einer Adresse berechnet werden soll. |
setLanguage(language) | DirectionFinder | Legt die Sprache fest, die für die Route verwendet werden soll. |
setMode(mode) | DirectionFinder | Legt die Mobilitätsform fest (Standardeinstellung für das Autofahren). |
setOptimizeWaypoints(optimizeOrder) | DirectionFinder | Legt fest, ob die angegebene Route optimiert werden soll, indem die Wegpunkte in eine effizientere Reihenfolge gebracht werden (standardmäßig „false“). |
setOrigin(latitude, longitude) | DirectionFinder | Legt den Startpunkt für die Berechnung der Route unter Verwendung eines Punkts (Breiten-/Breitengrad) fest. |
setOrigin(address) | DirectionFinder | Legt den Startpunkt für die Berechnung einer Route anhand einer Adresse fest. |
setRegion(region) | DirectionFinder | Legt eine Region fest, die bei der Interpretation von Standortnamen verwendet werden soll. |
Detaillierte Dokumentation
addWaypoint(latitude, longitude)
Fügt einen Wegpunkt hinzu, den die Route passieren muss. Dazu wird ein Punkt (lat/lng) verwendet.
// Creates a DirectionFinder with a wapoint at Lincoln Center. var directionFinder = Maps.newDirectionFinder().addWaypoint(40.772628, -73.984243);
Parameter
Name | Typ | Beschreibung |
---|---|---|
latitude | Number | Breitengrad des Wegpunkts. |
longitude | Number | Längengrad des Wegpunkts. |
Return
DirectionFinder
: Das DirectionFinder-Objekt zur einfacheren Verkettung von Aufrufen.
addWaypoint(address)
Fügt mithilfe einer Adresse einen Wegpunkt hinzu, den die Route passieren muss.
// Creates a DirectionFinder with a wapoint at Lincoln Center. var directionFinder = Maps.newDirectionFinder().addWaypoint('Lincoln Center, New York, NY');
Parameter
Name | Typ | Beschreibung |
---|---|---|
address | String | Eine Adresse. |
Return
DirectionFinder
: Das DirectionFinder-Objekt zur einfacheren Verkettung von Aufrufen.
clearWaypoints()
Löscht die aktuelle Gruppe von Wegpunkten.
var directionFinder = Maps.newDirectionFinder() // ... // Do something interesting here ... // ... // Remove all waypoints added with addWaypoint(). directionFinder.clearWaypoints();
Return
DirectionFinder
: Das DirectionFinder-Objekt zum Verketten von Aufrufen
getDirections()
Ruft die Route anhand des Startorts, des Zielorts und anderer festgelegter Optionen ab.
// Logs how long it would take to walk from Times Square to Central Park. var directions = Maps.newDirectionFinder() .setOrigin('Times Square, New York, NY') .setDestination('Central Park, New York, NY') .setMode(Maps.DirectionFinder.Mode.WALKING) .getDirections(); Logger.log(directions.routes[0].legs[0].duration.text);
Return
Object
: Ein JSON-Objekt, das die Gruppe von Routen für die Route enthält, wie hier beschrieben.
Weitere Informationen
setAlternatives(useAlternatives)
Legt fest, ob anstelle der Route mit dem höchsten Rang alternative Routen zurückgegeben werden sollen (Standardeinstellung ist "false"). Bei „true“ kann das routes
-Array des resultierenden Objekts mehrere Einträge enthalten.
// Creates a DirectionFinder with alernative routes enabled. var directionFinder = Maps.newDirectionFinder().setAlternatives(true);
Parameter
Name | Typ | Beschreibung |
---|---|---|
useAlternatives | Boolean | "true", um alternative Routen zurückzugeben, andernfalls "false" |
Return
DirectionFinder
: Das DirectionFinder-Objekt zum Verketten von Aufrufen
setArrive(time)
Legt die gewünschte Ankunftszeit fest (falls zutreffend).
// Creates a DirectionFinder with an arrival time of 2 hours from now. var now = new Date(); var arrive = new Date(now.getTime() + (2 * 60 * 60 * 1000)); var directionFinder = Maps.newDirectionFinder().setArrive(arrive);
Parameter
Name | Typ | Beschreibung |
---|---|---|
time | Date | die Ankunftszeit |
Return
DirectionFinder
: Das DirectionFinder-Objekt zum Verketten von Aufrufen
Weitere Informationen
setAvoid(avoid)
Legt fest, ob bestimmte Arten von Einschränkungen vermieden werden sollen.
// Creates a DirectionFinder that avoid highways. var directionFinder = Maps.newDirectionFinder().setAvoid(Maps.DirectionFinder.Avoid.HIGHWAYS);
Parameter
Name | Typ | Beschreibung |
---|---|---|
avoid | String | ein konstanter Wert aus Avoid |
Return
DirectionFinder
: Das DirectionFinder-Objekt zum Verketten von Aufrufen
Weitere Informationen
setDepart(time)
Legt die gewünschte Abfahrtszeit fest (falls zutreffend).
// Creates a DirectionFinder with a departure time of 1 hour from now. var now = new Date(); var depart = new Date(now.getTime() + (1 * 60 * 60 * 1000)); var directionFinder = Maps.newDirectionFinder().setDepart(depart);
Parameter
Name | Typ | Beschreibung |
---|---|---|
time | Date | die Abfahrtszeit |
Return
DirectionFinder
: Das DirectionFinder-Objekt zur einfacheren Verkettung von Aufrufen.
Weitere Informationen
setDestination(latitude, longitude)
Legt den Zielort fest, zu dem die Route mithilfe eines Punkts (Breiten-/Längengrad) berechnet wird.
// Creates a DirectionFinder with the destination set to Central Park. var directionFinder = Maps.newDirectionFinder().setDestination(40.777052, -73.975464);
Parameter
Name | Typ | Beschreibung |
---|---|---|
latitude | Number | Breitengrad des Zielstandorts |
longitude | Number | den Längengrad des Zielstandorts |
Return
DirectionFinder
: Das DirectionFinder-Objekt zum Verketten von Aufrufen
setDestination(address)
Legt den Zielort fest, für den die Route anhand einer Adresse berechnet werden soll.
// Creates a DirectionFinder with the destination set to Central Park. var directionFinder = Maps.newDirectionFinder().setDestination('Central Park, New York, NY');
Parameter
Name | Typ | Beschreibung |
---|---|---|
address | String | die Zieladresse |
Return
DirectionFinder
: Das DirectionFinder-Objekt zum Verketten von Aufrufen
setLanguage(language)
Legt die Sprache fest, die für die Route verwendet werden soll.
// Creates a DirectionFinder with the language set to French. var directionFinder = Maps.newDirectionFinder().setLanguage('fr');
Parameter
Name | Typ | Beschreibung |
---|---|---|
language | String | eine BCP-47-Sprachkennung |
Return
DirectionFinder
: Das DirectionFinder-Objekt zum Verketten von Aufrufen
Weitere Informationen
setMode(mode)
Legt die Mobilitätsform fest (Standardeinstellung für das Autofahren).
// Creates a DirectionFinder with the mode set to walking. var directionFinder = Maps.newDirectionFinder().setMode(Maps.DirectionFinder.Mode.WALKING);
Parameter
Name | Typ | Beschreibung |
---|---|---|
mode | String | ein konstanter Wert aus Mode |
Return
DirectionFinder
: Das DirectionFinder-Objekt zum Verketten von Aufrufen
Weitere Informationen
setOptimizeWaypoints(optimizeOrder)
Legt fest, ob die angegebene Route optimiert werden soll, indem die Wegpunkte in eine effizientere Reihenfolge gebracht werden (standardmäßig „false“).
// Creates a DirectionFinder with wapoint optimization enabled. var directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);
Parameter
Name | Typ | Beschreibung |
---|---|---|
optimizeOrder | Boolean | „true“, um die Reihenfolge zu optimieren, oder „false“, |
Return
DirectionFinder
: Das DirectionFinder-Objekt zum Verketten von Aufrufen
Weitere Informationen
setOrigin(latitude, longitude)
Legt den Startpunkt für die Berechnung der Route unter Verwendung eines Punkts (Breiten-/Breitengrad) fest.
// Creates a DirectionFinder with the origin set to Times Square. var directionFinder = Maps.newDirectionFinder().setOrigin(40.759011, -73.984472);
Parameter
Name | Typ | Beschreibung |
---|---|---|
latitude | Number | Breitengrad des Ausgangsorts |
longitude | Number | den Längengrad des Ausgangsorts |
Return
DirectionFinder
: Das DirectionFinder-Objekt zum Verketten von Aufrufen
setOrigin(address)
Legt den Startpunkt für die Berechnung einer Route anhand einer Adresse fest.
// Creates a DirectionFinder with the origin set to Times Square. var directionFinder = Maps.newDirectionFinder().setOrigin('Times Square, New York, NY');
Parameter
Name | Typ | Beschreibung |
---|---|---|
address | String | die Startadresse |
Return
DirectionFinder
: DirectionFinder-Instanz für die Verkettung von Aufrufen
setRegion(region)
Legt eine Region fest, die bei der Interpretation von Standortnamen verwendet werden soll. Die unterstützten Regionscodes entsprechen den von Google Maps unterstützten ccTLDs. Der Regionscode „uk“ entspricht beispielsweise „maps.google.co.uk“.
// Creates a DirectionFinder with the region set to France. var directionFinder = Maps.newDirectionFinder().setRegion('fr');
Parameter
Name | Typ | Beschreibung |
---|---|---|
region | String | den zu verwendenden Regionscode |
Return
DirectionFinder
: Das DirectionFinder-Objekt zum Verketten von Aufrufen