Class DirectionFinder

Ermöglicht das Abrufen von Wegbeschreibungen zwischen Orten.
Im folgenden Beispiel wird gezeigt, wie Sie diese Klasse verwenden können, um die Wegbeschreibung vom Times Square zum Central Park zu erhalten, zuerst am Lincoln Center anzuhalten, die Orte und den Pfad auf einer Karte darzustellen und die Karte in einer E-Mail zu senden.

// Get the directions.
const 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();
const route = directions.routes[0];

// Set up marker styles.

let markerLetterCode = 'A'.charCodeAt();

// Add markers to the map.
const map = Maps.newStaticMap();
for (let i = 0; i < route.legs.length; i++) {
  const leg = route.legs[i];
  if (i === 0) {
    // Add a marker for the start location of the first leg only.
    map.setMarkerStyle(
        Maps.StaticMap.MarkerSize.MID,
        Maps.StaticMap.Color.GREEN,
        String.fromCharCode(markerLetterCode),
    );
    map.addMarker(leg.start_location.lat, leg.start_location.lng);
    markerLetterCode++;
  }
  map.setMarkerStyle(
      Maps.StaticMap.MarkerSize.MID,
      Maps.StaticMap.Color.GREEN,
      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.
const 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 einen Wegpunkt hinzu, den die Route durchlaufen muss. Dazu wird ein Punkt (Breitengrad/Längengrad) verwendet.
`addWaypoint(address)`	`DirectionFinder`	Fügt einen Wegpunkt hinzu, den die Route über eine Adresse durchlaufen muss.
`clearWaypoints()`	`DirectionFinder`	Löscht die aktuelle Gruppe von Wegpunkten.
`getDirections()`	`Object`	Ruft die Wegbeschreibung anhand des Start- und Zielorts sowie anderer festgelegter Optionen ab.
`setAlternatives(useAlternatives)`	`DirectionFinder`	Legt fest, ob alternative Routen zurückgegeben werden sollen, anstatt nur die am höchsten eingestufte Route (Standardwert: `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 Endpunkt fest, für den die Wegbeschreibung berechnet werden soll, indem ein Punkt (Breitengrad/Längengrad) verwendet wird.
`setDestination(address)`	`DirectionFinder`	Legt den Endpunkt fest, für den die Route berechnet werden soll, und verwendet dazu eine Adresse.
`setLanguage(language)`	`DirectionFinder`	Legt die Sprache fest, die für die Wegbeschreibung verwendet werden soll.
`setMode(mode)`	`DirectionFinder`	Legt die Mobilitätsform fest (Standardeinstellung ist „Auto“).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	Legt fest, ob die angegebene Route optimiert werden soll, indem die Wegpunkte in eine effizientere Reihenfolge gebracht werden (Standardwert: `false`).
`setOrigin(latitude, longitude)`	`DirectionFinder`	Legt den Startort für die Berechnung der Wegbeschreibung mithilfe eines Punktes (Breitengrad/Längengrad) 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 Ortsnamen verwendet werden soll.

Detaillierte Dokumentation

`addWaypoint(latitude, longitude)`

Fügt einen Wegpunkt hinzu, den die Route durchlaufen muss. Dazu wird ein Punkt (Breitengrad/Längengrad) verwendet.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
const directionFinder = Maps.newDirectionFinder().addWaypoint(
    40.772628,
    -73.984243,
);

Parameter

Name	Typ	Beschreibung
`latitude`	`Number`	Breitengrad des Wegpunkts.
`longitude`	`Number`	Längengrad des Wegpunkts.

Rückflug

DirectionFinder: Das DirectionFinder-Objekt zum Verketten von Aufrufen.

`addWaypoint(address)`

Fügt einen Wegpunkt hinzu, den die Route über eine Adresse durchlaufen muss.

// Creates a DirectionFinder with a wapoint at Lincoln Center.
const directionFinder = Maps.newDirectionFinder().addWaypoint(
    'Lincoln Center, New York, NY',
);

Parameter

Name	Typ	Beschreibung
`address`	`String`	Eine Adresse.

Rückflug

DirectionFinder: Das DirectionFinder-Objekt zum Verketten von Aufrufen.

`clearWaypoints()`

Löscht die aktuelle Gruppe von Wegpunkten.

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

Rückflug

DirectionFinder: Das DirectionFinder-Objekt zum Verketten von Aufrufen.

`getDirections()`

Ruft die Wegbeschreibung anhand des Start- und Zielorts sowie anderer festgelegter Optionen ab.

// Logs how long it takes to walk from Times Square to Central Park.
const 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 Wegbeschreibung enthält, wie hier beschrieben.

Weitere Informationen

Google Directions API

`setAlternatives(useAlternatives)`

Legt fest, ob alternative Routen zurückgegeben werden sollen (Standardeinstellung: false). Wenn true, kann das routes-Array des resultierenden Objekts mehrere Einträge enthalten.

// Creates a DirectionFinder with alternative routes enabled.
const directionFinder = Maps.newDirectionFinder().setAlternatives(true);

Parameter

Name	Typ	Beschreibung
`useAlternatives`	`Boolean`	`true`, um alternative Routen zurückzugeben, andernfalls `false`.

Rückflug

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.
const now = new Date();
const arrive = new Date(now.getTime() + 2 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setArrive(arrive);

Parameter

Name	Typ	Beschreibung
`time`	`Date`	Die Ankunftszeit.

Rückflug

DirectionFinder: Das DirectionFinder-Objekt zum Verketten 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.
const 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 zum Verketten 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.
const now = new Date();
const depart = new Date(now.getTime() + 1 * 60 * 60 * 1000);
const directionFinder = Maps.newDirectionFinder().setDepart(depart);

Parameter

Name	Typ	Beschreibung
`time`	`Date`	Die Abfahrtszeit.

Rückflug

DirectionFinder: Das DirectionFinder-Objekt zum Verketten von Aufrufen.

Weitere Informationen

Google Directions API

`setDestination(latitude, longitude)`

Legt den Endpunkt fest, für den die Wegbeschreibung berechnet werden soll, indem ein Punkt (Breitengrad/Längengrad) verwendet wird.

// Creates a DirectionFinder with the destination set to Central Park.
const directionFinder = Maps.newDirectionFinder().setDestination(
    40.777052,
    -73.975464,
);

Parameter

Name	Typ	Beschreibung
`latitude`	`Number`	Der Breitengrad des Endstandorts.
`longitude`	`Number`	Der Längengrad des Endpunkts.

Rückflug

DirectionFinder: Das DirectionFinder-Objekt zum Verketten von Aufrufen.

`setDestination(address)`

Legt den Endpunkt fest, für den die Route berechnet werden soll, und verwendet dazu eine Adresse.

// Creates a DirectionFinder with the destination set to Central Park.
const directionFinder = Maps.newDirectionFinder().setDestination(
    'Central Park, New York, NY',
);

Parameter

Name	Typ	Beschreibung
`address`	`String`	Die Endadresse.

Rückflug

DirectionFinder: Das DirectionFinder-Objekt zum Verketten von Aufrufen.

`setLanguage(language)`

Legt die Sprache fest, die für die Wegbeschreibung verwendet werden soll.

// Creates a DirectionFinder with the language set to French.
const directionFinder = Maps.newDirectionFinder().setLanguage('fr');

Parameter

Name	Typ	Beschreibung
`language`	`String`	Eine BCP-47-Sprachkennung.

Rückflug

DirectionFinder: Das DirectionFinder-Objekt zum Verketten von Aufrufen.

Weitere Informationen

Sprachunterstützung in Google Maps APIs

`setMode(mode)`

Legt die Mobilitätsform fest (Standardeinstellung ist „Auto“).

// Creates a DirectionFinder with the mode set to walking.
const 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 zum Verketten von Aufrufen.

Weitere Informationen

Google Directions API

`setOptimizeWaypoints(optimizeOrder)`

Legt fest, ob die angegebene Route optimiert werden soll, indem die Wegpunkte in eine effizientere Reihenfolge gebracht werden (Standardwert: false).

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

Parameter

Name	Typ	Beschreibung
`optimizeOrder`	`Boolean`	`true`, um die Bestellung zu optimieren, andernfalls `false`.

Rückflug

DirectionFinder: Das DirectionFinder-Objekt zum Verketten von Aufrufen.

Weitere Informationen

Google Directions API

`setOrigin(latitude, longitude)`

Legt den Startort für die Berechnung der Wegbeschreibung mithilfe eines Punktes (Breitengrad/Längengrad) fest.

// Creates a DirectionFinder with the origin set to Times Square.
const directionFinder = Maps.newDirectionFinder().setOrigin(
    40.759011,
    -73.984472,
);

Parameter

Name	Typ	Beschreibung
`latitude`	`Number`	Der Breitengrad des Startpunkts.
`longitude`	`Number`	Der Längengrad des Startpunkts.

Rückflug

DirectionFinder: Das DirectionFinder-Objekt zum Verketten 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.
const directionFinder = Maps.newDirectionFinder().setOrigin(
    'Times Square, New York, NY',
);

Parameter

Name	Typ	Beschreibung
`address`	`String`	Die Startadresse.

Rückflug

DirectionFinder: Die DirectionFinder-Instanz, um das Verketten von Aufrufen zu ermöglichen.

`setRegion(region)`

Legt eine Region fest, die beim Interpretieren von Ortsnamen 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.
const directionFinder = Maps.newDirectionFinder().setRegion('fr');

Parameter

Name	Typ	Beschreibung
`region`	`String`	Der zu verwendende Regionscode.

Rückflug

DirectionFinder: Das DirectionFinder-Objekt zum Verketten von Aufrufen.

Weitere Informationen

Google Directions API

Class DirectionFinder Mit Sammlungen den Überblick behalten Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.

Weitere Informationen

Methoden

Detaillierte Dokumentation

addWaypoint(latitude, longitude)

Parameter

Rückflug

addWaypoint(address)

Parameter

Rückflug

clearWaypoints()

Rückflug

getDirections()

Rückflug

Weitere Informationen

setAlternatives(useAlternatives)

Parameter

Rückflug

setArrive(time)

Parameter

Rückflug

Weitere Informationen

setAvoid(avoid)

Parameter

Rückflug

Weitere Informationen

setDepart(time)

Parameter

Rückflug

Weitere Informationen

setDestination(latitude, longitude)

Parameter

Rückflug

setDestination(address)

Parameter

Rückflug

setLanguage(language)

Parameter

Rückflug

Weitere Informationen

setMode(mode)

Parameter

Rückflug

Weitere Informationen

setOptimizeWaypoints(optimizeOrder)

Parameter

Rückflug

Weitere Informationen

setOrigin(latitude, longitude)

Parameter

Rückflug

setOrigin(address)

Parameter

Rückflug

setRegion(region)

Parameter

Rückflug

Weitere Informationen

Class DirectionFinder

`addWaypoint(latitude, longitude)`

`addWaypoint(address)`

`clearWaypoints()`

`getDirections()`

`setAlternatives(useAlternatives)`

`setArrive(time)`

`setAvoid(avoid)`

`setDepart(time)`

`setDestination(latitude, longitude)`

`setDestination(address)`

`setLanguage(language)`

`setMode(mode)`

`setOptimizeWaypoints(optimizeOrder)`

`setOrigin(latitude, longitude)`

`setOrigin(address)`

`setRegion(region)`