Class DirectionFinder

DirectionFinder

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

MethodeRückgabetypKurzbeschreibung
addWaypoint(latitude, longitude)DirectionFinderFügt einen Wegpunkt hinzu, den die Route passieren muss. Dazu wird ein Punkt (lat/lng) verwendet.
addWaypoint(address)DirectionFinderFügt mithilfe einer Adresse einen Wegpunkt hinzu, den die Route passieren muss.
clearWaypoints()DirectionFinderLöscht die aktuelle Gruppe von Wegpunkten.
getDirections()ObjectRuft die Route anhand des Startorts, des Zielorts und anderer festgelegter Optionen ab.
setAlternatives(useAlternatives)DirectionFinderLegt fest, ob anstelle der Route mit dem höchsten Rang alternative Routen zurückgegeben werden sollen (Standardeinstellung ist "false").
setArrive(time)DirectionFinderLegt die gewünschte Ankunftszeit fest (falls zutreffend).
setAvoid(avoid)DirectionFinderLegt fest, ob bestimmte Arten von Einschränkungen vermieden werden sollen.
setDepart(time)DirectionFinderLegt die gewünschte Abfahrtszeit fest (falls zutreffend).
setDestination(latitude, longitude)DirectionFinderLegt den Zielort fest, zu dem die Route mithilfe eines Punkts (Breiten-/Längengrad) berechnet wird.
setDestination(address)DirectionFinderLegt den Zielort fest, für den die Route anhand einer Adresse berechnet werden soll.
setLanguage(language)DirectionFinderLegt die Sprache fest, die für die Route verwendet werden soll.
setMode(mode)DirectionFinderLegt die Mobilitätsform fest (Standardeinstellung für das Autofahren).
setOptimizeWaypoints(optimizeOrder)DirectionFinderLegt fest, ob die angegebene Route optimiert werden soll, indem die Wegpunkte in eine effizientere Reihenfolge gebracht werden (standardmäßig „false“).
setOrigin(latitude, longitude)DirectionFinderLegt den Startpunkt für die Berechnung der Route unter Verwendung eines Punkts (Breiten-/Breitengrad) fest.
setOrigin(address)DirectionFinderLegt den Startpunkt für die Berechnung einer Route anhand einer Adresse fest.
setRegion(region)DirectionFinderLegt 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

NameTypBeschreibung
latitudeNumberBreitengrad des Wegpunkts.
longitudeNumberLä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

NameTypBeschreibung
addressStringEine 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

NameTypBeschreibung
useAlternativesBoolean"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

NameTypBeschreibung
timeDatedie 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

NameTypBeschreibung
avoidStringein 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

NameTypBeschreibung
timeDatedie 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

NameTypBeschreibung
latitudeNumberBreitengrad des Zielstandorts
longitudeNumberden 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

NameTypBeschreibung
addressStringdie 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

NameTypBeschreibung
languageStringeine 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

NameTypBeschreibung
modeStringein 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

NameTypBeschreibung
optimizeOrderBoolean„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

NameTypBeschreibung
latitudeNumberBreitengrad des Ausgangsorts
longitudeNumberden 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

NameTypBeschreibung
addressStringdie 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

NameTypBeschreibung
regionStringden zu verwendenden Regionscode

Return

DirectionFinder: Das DirectionFinder-Objekt zum Verketten von Aufrufen

Weitere Informationen