このページは Cloud Translation API によって翻訳されました。

Class DirectionFinder

地点間のルートを取得できます。
以下の例は、このクラスを使用して、タイムズスクエアからセントラルパークまでのルートを取得し、途中でリンカーンセンターに立ち寄り、地図上に場所と経路をプロットして、地図をメールで送信する方法を示しています。

// 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'),
      },
    },
);

メソッド

メソッド	戻り値の型	概要
`addWaypoint(latitude, longitude)`	`DirectionFinder`	地点（緯度/経度）を使用して、ルート経由するウェイポイントを追加します。
`addWaypoint(address)`	`DirectionFinder`	住所を使用して、ルート経由する必要があるウェイポイントを追加します。
`clearWaypoints()`	`DirectionFinder`	現在のウェイポイントセットを消去します。
`getDirections()`	`Object`	設定された出発地、目的地、その他のオプションを使用してルートを取得します。
`setAlternatives(useAlternatives)`	`DirectionFinder`	最もランクの高いルートのみを返すのではなく、代替ルートを返すかどうかを設定します（デフォルトは false）。
`setArrive(time)`	`DirectionFinder`	希望する到着時間を設定します（該当する場合）。
`setAvoid(avoid)`	`DirectionFinder`	特定の種類の制限を回避するかどうかを設定します。
`setDepart(time)`	`DirectionFinder`	ご希望の出発時刻を設定します（該当する場合）。
`setDestination(latitude, longitude)`	`DirectionFinder`	地点（緯度/経度）を使用して、ルートの計算先となる終点の場所を設定します。
`setDestination(address)`	`DirectionFinder`	住所を使用して、ルートを計算する目的地を設定します。
`setLanguage(language)`	`DirectionFinder`	ルートに使用する言語を設定します。
`setMode(mode)`	`DirectionFinder`	移動手段を設定します（デフォルトは運転）。
`setOptimizeWaypoints(optimizeOrder)`	`DirectionFinder`	指定されたルートを最適化するため、ウェイポイントをより効率的な順序に並べ替えるかどうかを設定します（デフォルトは false）。
`setOrigin(latitude, longitude)`	`DirectionFinder`	地点（緯度/経度）を使用して、ルートの計算を開始する出発地を設定します。
`setOrigin(address)`	`DirectionFinder`	住所を使用して、ルートの計算を開始する出発地を設定します。
`setRegion(region)`	`DirectionFinder`	場所の名前の解釈に使用するリージョンを設定します。

詳細なドキュメント

`addWaypoint(latitude, longitude)`

地点（緯度/経度）を使用して、ルート経由するウェイポイントを追加します。

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

パラメータ

名前	型	説明
`latitude`	`Number`	ウェイポイントの緯度。
`longitude`	`Number`	ウェイポイントの経度。

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト。

`addWaypoint(address)`

住所を使用して、ルート経由する必要があるウェイポイントを追加します。

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

パラメータ

名前	型	説明
`address`	`String`	住所。

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト。

`clearWaypoints()`

現在のウェイポイントセットを消去します。

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

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト

`getDirections()`

設定された出発地、目的地、その他のオプションを使用してルートを取得します。

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

戻る

Object - こちらで説明されているように、ルートのセットを含む JSON オブジェクト。

`setAlternatives(useAlternatives)`

最もランクの高いルートのみを返すのではなく、代替ルートを返すかどうかを設定します（デフォルトは false）。true の場合、結果のオブジェクトの routes 配列に複数のエントリが含まれることがあります。

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

パラメータ

名前	型	説明
`useAlternatives`	`Boolean`	代替ルートを返す場合は true、それ以外の場合は false

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト

`setArrive(time)`

希望する到着時間を設定します（該当する場合）。

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

パラメータ

名前	型	説明
`time`	`Date`	到着時刻

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト

`setAvoid(avoid)`

特定の種類の制限を回避するかどうかを設定します。

// Creates a DirectionFinder that avoid highways.
const directionFinder = Maps.newDirectionFinder().setAvoid(
    Maps.DirectionFinder.Avoid.HIGHWAYS,
);

パラメータ

名前	型	説明
`avoid`	`String`	`Avoid` の定数値

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト

`setDepart(time)`

ご希望の出発時刻を設定します（該当する場合）。

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

パラメータ

名前	型	説明
`time`	`Date`	出発時間

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト。

`setDestination(latitude, longitude)`

地点（緯度/経度）を使用して、ルートの計算先となる終点の場所を設定します。

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

パラメータ

名前	型	説明
`latitude`	`Number`	目的地の緯度
`longitude`	`Number`	終点の経度

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト

`setDestination(address)`

住所を使用して、ルートを計算する目的地を設定します。

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

パラメータ

名前	型	説明
`address`	`String`	最終的な住所

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト

`setLanguage(language)`

ルート案内で使用する言語を設定します。

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

パラメータ

名前	型	説明
`language`	`String`	BCP-47 言語識別子

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト

`setMode(mode)`

移動手段を設定します（デフォルトは運転）。

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

パラメータ

名前	型	説明
`mode`	`String`	`Mode` の定数値

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト

`setOptimizeWaypoints(optimizeOrder)`

ウェイポイントをより効率的な順序に並べ替えて、指定されたルートを最適化するかどうかを設定します（デフォルトは false）。

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

パラメータ

名前	型	説明
`optimizeOrder`	`Boolean`	順序を最適化する場合 true、それ以外の場合は false

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト

`setOrigin(latitude, longitude)`

地点（緯度/経度）を使用して、ルートの計算を開始する出発地を設定します。

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

パラメータ

名前	型	説明
`latitude`	`Number`	出発地の緯度
`longitude`	`Number`	出発地の経度

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト

`setOrigin(address)`

住所を使用して、ルートの計算を開始する出発地を設定します。

// Creates a DirectionFinder with the origin set to Times Square.
const directionFinder = Maps.newDirectionFinder().setOrigin(
    'Times Square, New York, NY',
);

パラメータ

名前	型	説明
`address`	`String`	開始アドレス

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder インスタンス

`setRegion(region)`

場所の名前の解釈に使用するリージョンを設定します。サポートされている地域コードは、Google マップでサポートされている ccTLD に対応しています。たとえば、地域コード「uk」は「maps.google.co.uk」に対応しています。

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

パラメータ

名前	型	説明
`region`	`String`	使用する地域コード

戻る

DirectionFinder - 呼び出しの連結を容易にする DirectionFinder オブジェクト

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)

パラメータ

戻る

関連情報

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