Diese Seite wurde von der Cloud Translation API übersetzt.

Class DirectionFinder

Ermöglicht das Abrufen von Wegbeschreibungen zwischen Orten.
Im folgenden Beispiel wird gezeigt, wie Sie mit dieser Klasse die Wegbeschreibung vom Times Square zum Central Park mit Zwischenstopp am Lincoln Center abrufen, die Orte und den Weg auf einer Karte einzeichnen und die Karte per E-Mail 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ügen Sie mithilfe eines Punkts (Breiten-/Längengrad) einen Wegpunkt hinzu, den die Route passieren muss.
`addWaypoint(address)`	`DirectionFinder`	Fügen Sie mithilfe einer Adresse einen Wegpunkt hinzu, den die Route passieren muss.
`clearWaypoints()`	`DirectionFinder`	Die aktuellen Wegpunkte werden gelöscht.
`getDirections()`	`Object`	Ruft die Wegbeschreibung mit dem Start- und Zielort sowie den anderen festgelegten Optionen ab.
`setAlternatives(useAlternatives)`	`DirectionFinder`	Legt fest, ob alternative Routen anstelle der Route mit der höchsten Bewertung zurückgegeben werden sollen (Standardeinstellung: „false“).
`setArrive(time)`	`DirectionFinder`	Legt die gewünschte Ankunftszeit fest (falls zutreffend).
`setAvoid(avoid)`	`DirectionFinder`	Hier legen Sie 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 Wegbeschreibung berechnet werden soll, mit einem Punkt (Breiten-/Längengrad).
`setDestination(address)`	`DirectionFinder`	Hiermit wird der Zielort festgelegt, für den eine Wegbeschreibung berechnet werden soll. Geben Sie dazu eine Adresse ein.
`setLanguage(language)`	`DirectionFinder`	Legt die Sprache fest, die für die Routenbeschreibung verwendet werden soll.
`setMode(mode)`	`DirectionFinder`	Legt die Mobilitätsform fest (standardmäßig „Autofahren“).
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	Gibt an, ob die Route optimiert werden soll, indem die Wegpunkte in eine effizientere Reihenfolge gebracht werden (Standardeinstellung: „false“).
`setOrigin(latitude, longitude)`	`DirectionFinder`	Legt den Startort fest, von dem aus die Route berechnet werden soll, mit einem Punkt (Breiten-/Längengrad).
`setOrigin(address)`	`DirectionFinder`	Legt den Startpunkt fest, von dem aus die Route berechnet werden soll, und verwendet dazu eine Adresse.
`setRegion(region)`	`DirectionFinder`	Hier legen Sie eine Region fest, die bei der Interpretation von Ortsnamen verwendet werden soll.

Detaillierte Dokumentation

`addWaypoint(latitude, longitude)`

Fügen Sie mithilfe eines Punkts (Breiten-/Längengrad) einen Wegpunkt hinzu, den die Route passieren muss.

// 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 zur Verknüpfung von Aufrufen.

`addWaypoint(address)`

Fügen Sie mithilfe einer Adresse einen Wegpunkt hinzu, den die Route passieren 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 zur Verknüpfung von Aufrufen.

`clearWaypoints()`

Die aktuellen Wegpunkte werden gelöscht.

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

Rückflug

DirectionFinder – das DirectionFinder-Objekt zur Vereinfachung der Aufrufabfolge

`getDirections()`

Ruft die Wegbeschreibung mit dem Start- und Zielort sowie den anderen festgelegten Optionen ab.

// Logs how long it would take 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 mit den Routen für die Wegbeschreibung, wie hier beschrieben

Weitere Informationen

Google Directions API

`setAlternatives(useAlternatives)`

Legt fest, ob alternative Routen anstelle der Route mit der höchsten Bewertung zurückgegeben werden sollen (Standardeinstellung: „false“). Wenn „wahr“ ist, 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, das die Verkettung von Aufrufen vereinfacht

`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, das die Verkettung von Aufrufen vereinfacht

Weitere Informationen

Google Directions API

`setAvoid(avoid)`

Hier legen Sie 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`	einen konstanten Wert aus `Avoid`

Rückflug

DirectionFinder – das DirectionFinder-Objekt zur Vereinfachung der Aufrufabfolge

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

Rückflug

DirectionFinder: Das DirectionFinder-Objekt zur Verknüpfung von Aufrufen.

Weitere Informationen

Google Directions API

`setDestination(latitude, longitude)`

Legt den Zielort fest, für den die Wegbeschreibung berechnet werden soll, mit einem Punkt (Breiten-/Längengrad).

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

Rückflug

DirectionFinder: das DirectionFinder-Objekt, das die Verkettung von Aufrufen vereinfacht

`setDestination(address)`

Hiermit wird der Zielort festgelegt, für den eine Wegbeschreibung berechnet werden soll. Geben Sie dazu eine Adresse ein.

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

Rückflug

DirectionFinder: das DirectionFinder-Objekt, das die Verkettung von Aufrufen vereinfacht

`setLanguage(language)`

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

Rückflug

DirectionFinder – das DirectionFinder-Objekt zur Vereinfachung der Aufrufabfolge

Weitere Informationen

Sprachunterstützung in Google Maps APIs

`setMode(mode)`

Legt die Mobilitätsform fest (standardmäßig „Autofahren“).

// Creates a DirectionFinder with the mode set to walking.
const directionFinder = Maps.newDirectionFinder().setMode(
    Maps.DirectionFinder.Mode.WALKING,
);

Parameter

Name	Typ	Beschreibung
`mode`	`String`	einen konstanten Wert aus `Mode`

Rückflug

DirectionFinder: das DirectionFinder-Objekt, das die Verkettung von Aufrufen vereinfacht

Weitere Informationen

Google Directions API

`setOptimizeWaypoints(optimizeOrder)`

Gibt an, ob die Route optimiert werden soll, indem die Wegpunkte in eine effizientere Reihenfolge gebracht werden (Standardeinstellung: „false“).

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

Parameter

Name	Typ	Beschreibung
`optimizeOrder`	`Boolean`	„true“, um die Reihenfolge zu optimieren, andernfalls „false“

Rückflug

DirectionFinder: das DirectionFinder-Objekt, das die Verkettung von Aufrufen vereinfacht

Weitere Informationen

Google Directions API

`setOrigin(latitude, longitude)`

Legt den Startort fest, von dem aus die Route berechnet werden soll, mit einem Punkt (Breiten-/Längengrad).

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

Rückflug

DirectionFinder: das DirectionFinder-Objekt, das die Verkettung von Aufrufen vereinfacht

`setOrigin(address)`

Legt den Startpunkt fest, von dem aus die Route berechnet werden soll, und verwendet dazu eine Adresse.

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

Rückflug

DirectionFinder – die DirectionFinder-Instanz, die die Verkettung von Aufrufen vereinfacht

`setRegion(region)`

Hier legen Sie eine Region fest, die bei der Interpretation von Ortsnamen verwendet werden soll. Die unterstützten Regionscodes entsprechen den von Google Maps unterstützten länderspezifischen Top-Level-Domains. Der Regionscode „de“ entspricht beispielsweise „maps.google.de“.

// Creates a DirectionFinder with the region set to France.
const directionFinder = Maps.newDirectionFinder().setRegion('fr');

Parameter

Name	Typ	Beschreibung
`region`	`String`	den zu verwendenden Regionscode

Rückflug

DirectionFinder: das DirectionFinder-Objekt, das die Verkettung von Aufrufen vereinfacht

Weitere Informationen

Google Directions API