Diese Seite wurde von der Cloud Translation API übersetzt.

Class DirectionFinder

Ermöglicht das Abrufen von Routen zwischen Standorten.
Das folgende Beispiel zeigt, wie Sie diese Klasse verwenden können, um die Route vom Times Square nach Central Park an, halten zuerst am Lincoln Center, zeichnen die Standorte und den Weg auf einer Karte ein und senden der Karte in einer E-Mail.

// 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

Google Directions API

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
`addWaypoint(latitude, longitude)`	`DirectionFinder`	Fügt mithilfe eines Punkts (lat/lng) einen Wegpunkt hinzu, den die Route passieren muss.
`addWaypoint(address)`	`DirectionFinder`	Fügt mithilfe einer Adresse einen Wegpunkt hinzu, den die Route passieren muss.
`clearWaypoints()`	`DirectionFinder`	Löscht den aktuellen Satz von Wegpunkten.
`getDirections()`	`Object`	Ruft die Route unter Verwendung des Startorts, des Zielorts und anderer festgelegter Optionen ab.
`setAlternatives(useAlternatives)`	`DirectionFinder`	Legt fest, ob alternative Routen anstatt nur der mit dem höchsten Rang zurückgegeben werden sollen route (der Standardwert 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, für den die Route mithilfe eines Punkts (lat/lng) berechnet werden soll.
`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 Routen verwendet werden soll.
`setMode(mode)`	`DirectionFinder`	Legt die Mobilitätsform fest (standardmäßig Auto).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	Legt fest, ob die angegebene Route optimiert werden soll, indem die Wegpunkte in einer effiziente Reihenfolge (standardmäßig „false“).
`setOrigin(latitude, longitude)`	`DirectionFinder`	Legt den Ausgangspunkt für die Berechnung der Route mithilfe eines Punkts (lat/lng) fest.
`setOrigin(address)`	`DirectionFinder`	Legt den Startort für die Berechnung der Route anhand einer Adresse fest.
`setRegion(region)`	`DirectionFinder`	Legt eine Region fest, die beim Interpretieren von Standortnamen verwendet werden soll.

Detaillierte Dokumentation

`addWaypoint(latitude, longitude)`

Fügt mithilfe eines Punkts (lat/lng) einen Wegpunkt hinzu, den die Route passieren muss.

// 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`	Der Längengrad des Wegpunkts.

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere 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.

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung von Aufrufen.

`clearWaypoints()`

Löscht den aktuellen Satz von Wegpunkten.

var directionFinder = Maps.newDirectionFinder()
// ...
// Do something interesting here ...
// ...
// Remove all waypoints added with addWaypoint().
directionFinder.clearWaypoints();

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung von Aufrufen

`getDirections()`

Ruft die Route unter Verwendung 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);

Rückflug

Object: Ein JSON-Objekt, das die Routen für die Routen enthält, wie hier beschrieben.

Weitere Informationen

Google Directions API

`setAlternatives(useAlternatives)`

Legt fest, ob alternative Routen anstatt nur der mit dem höchsten Rang zurückgegeben werden sollen route (der Standardwert ist false). Falls wahr, 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, "false", andernfalls "false".

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung 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

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung von Aufrufen

Weitere Informationen

Google Directions API

`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`

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung von Aufrufen

Weitere Informationen

Google Directions API

`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 Abreisezeit

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung von Aufrufen.

Weitere Informationen

Google Directions API

`setDestination(latitude, longitude)`

Legt den Zielort fest, für den die Route mithilfe eines Punkts (lat/lng) berechnet werden soll.

// 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 Zielorts
`longitude`	`Number`	Längengrad des Zielorts

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung 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

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung von Aufrufen

`setLanguage(language)`

Legt die Sprache fest, die für die Routen 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-Sprachkennzeichnung

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung von Aufrufen

Weitere Informationen

Sprachunterstützung in Google Maps APIs

`setMode(mode)`

Legt die Mobilitätsform fest (standardmäßig Auto).

// 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`

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung von Aufrufen

Weitere Informationen

Google Directions API

`setOptimizeWaypoints(optimizeOrder)`

Legt fest, ob die angegebene Route optimiert werden soll, indem die Wegpunkte in einer effiziente Reihenfolge (standardmäßig „false“).

// Creates a DirectionFinder with wapoint optimization enabled.
var directionFinder = Maps.newDirectionFinder().setOptimizeWaypoints(true);

Parameter

Name	Typ	Beschreibung
`optimizeOrder`	`Boolean`	„true“, um den Auftrag zu optimieren, andernfalls „false“

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung von Aufrufen

Weitere Informationen

Google Directions API

`setOrigin(latitude, longitude)`

Legt den Ausgangspunkt für die Berechnung der Route mithilfe eines Punkts (lat/lng) 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 Startorts
`longitude`	`Number`	Längengrad des Startorts

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung von Aufrufen

`setOrigin(address)`

Legt den Startort für die Berechnung der 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

Rückflug

DirectionFinder: Die DirectionFinder-Instanz für die einfachere Verkettung von Aufrufen

`setRegion(region)`

Legt eine Region fest, die beim Interpretieren von Standortnamen verwendet werden soll. Die unterstützten Regionscodes entsprechen die von Google Maps unterstützten ccTLDs. Beispiel: Der Regionscode „uk“ entspricht "maps.google.co.uk" an.

// 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

Rückflug

DirectionFinder: Das DirectionFinder-Objekt für die einfachere Verkettung von Aufrufen

Weitere Informationen

Google Directions API