道順

表 1. Get Travel Directions 道順オプション

パラメータ

説明

ShowDistance

ルートの距離を返すかどうかを指定します。

Y
ルートの距離を返します。こちらがデフォルトです。
N
ルートの距離を返しません。

ReturnRouteDirections

ルートの道順を進路変更ごとに示すかどうかを指定します。このオプションは、デフォルトで有効になっています。

Y
進路変更ごとのテキスト表示の道順を返します。こちらがデフォルトです。
N
進路変更ごとのテキスト表示の道順を返しません。

ReturnSegmentGeometry

ルート内のセグメントのジオメトリを表す緯度/経度ポイントの集合を返すかどうかを指定します。セグメント ジオメトリは、ルート ジオメトリを作成するために使用します。このフィールドの出力は、RouteDirections 出力フィールド内に表示されます。ルート ジオメトリの詳細については、ルート ジオメトリとはを参照してください。

ReturnRouteGeometry

ルート ジオメトリを表す緯度/経度ポイントの集合を返すかどうかを指定します。ルート ジオメトリは、ルート マップの作成およびルートに関する分析の実行に使用できます。

次のいずれかです。

All
ルート ジオメトリのすべてのポイントを返します。
End
各ルート セグメント ジオメトリの終点のみを返します。
None
ルート ジオメトリを返しません。こちらがデフォルトです。

DefaultLanguage

GetTravelDirections が道順を返す言語を指定します。

次のいずれかです。

sq
アルバニア語で道順を返します。
zh_CN
中国語で道順を返します。
zh_TW
中国語 (台湾) で道順を返します。
hr
クロアチア語で道順を返します。
cs
チェコ語で道順を返します。
da
デンマーク語で道順を返します。
nl
オランダ語で道順を返します。
en
英語で道順を返します。デフォルト
en-US
アメリカ英語で道順を返します。
et
エストニア語で道順を返します。
fi
フィンランド語で道順を返します。
fr
フランス語で道順を返します。
de
ドイツ語で道順を返します。
hu
ハンガリー語で道順を返します。
it
イタリア語で道順を返します。
ja
日本語で道順を返します。
lv
ラトビア語で道順を返します。
lt
リトアニア語で道順を返します。
no
ノルウェー語で道順を返します。
pt
ポルトガル語で道順を返します。
ro
ルーマニア語で道順を返します。
sk
スロバキア語で道順を返します。
sl
スロベニア語で道順を返します。
es
スペイン語で道順を返します。
sv
スウェーデン語で道順を返します。
ru
ロシア語で道順を返します。
tr
トルコ語で道順を返します。

ShowTime

GetTravelDirections がルート内で道順をたどるのに要する時間を返すかどうかを指定します。

Y
ルートの時間を返します。こちらがデフォルトです。
N
ルートの時間を返しません。

ShowPrimaryNameOnly

GetTravelDirections が道順の中の任意のストリートのすべての名前を返すか、ストリートの主要名のみを返すかを指定します。

Y
主要名のみを返します。
N
ストリートのすべての名前を返します。こちらがデフォルトです。

ルート ジオメトリとは

ルート ジオメトリは、ルートを形成する一連の緯度/経度ポイントです。最も単純なルート ジオメトリは、単一のポイントです。同じストリートセグメント上で始まって終わるルートなどがこれに該当します。

始点は常に既知の場所なので、このように非常に単純なルート ジオメトリはすなわち終点に等しくなります。したがって、A が始点だとすると、ルート ジオメトリはポイント B の緯度/経度です。

複数のルート セグメントを含む、もっと複雑なルート ジオメトリの場合は、複数のポイントがルート ジオメトリ内に存在することがあります。以下に強調して示したようなルートがあると仮定します。ポイント A に始まり、交差点 X、Y、および B を経由してポイント C が終点となります。

このルートでは、完全なルート ジオメトリはポイント A、X、Y、B、および C の緯度/経度から構成されます。ただし、どのポイントを実際に返すかは、任意に制御できます。ルート ジオメトリのすべてのポイントを含めるのか、各ルート セグメントの終点のみを含めるのか、任意に選択できます。上記の例では、終点は B と C です。A から B は 1 つのルート セグメントであり、B から C は別のルート セグメントだからです。