Routes API

前回までにBing Maps REST ServicesのLocation API，Imagery APIを紹介しました。今回は最後のAPI，Routes APIについてです。また，最後にトランザクションレポートについても少しふれています。

Routes APIを利用すると次のふたつのことができます。

• 出発地から到着地までの経路探索
• 到着地への主要道路からの経路探索

車または徒歩での経路探索が選択でき，所要時間・距離の取得や，交通情報を利用した探索，交通事故情報や目印となる建物の表示などもサポートしています。

ただし，日本はサポート範囲に一応入っていますが，実質的には日本語で住所を指定できないうえに，探索結果は有用とはいえません。米国のBing Mapsでは，実際に車・徒歩での経路探索がサービスとして提供されていますが（図1），日本のBing Mapsでは提供されていません（※1）。

※1

路線検索は提供されています。路線検索はAPIには含まれていません。

今のところ日本では実質的に利用できないため，Routes APIについては，参考までに紹介しておきます。とはいえ図1のように到着地までの道案内を可能にするAPIのため，APIのレスポンスは前回までの内容と比べ複雑なものとなっています。

出発・到着地を指定した経路探索

まず，出発地と到着地を指定して経路を探索する場合です。中継する地点も指定でき，出発・到着地含めて25点まで指定可能です。場所は，住所や建物の名前または経緯度を指定します。

URLの書式

APIのURLの書式は次のようになります。

• http://dev.virtualearth.net/REST/version/Routes/travelMode?
    wayPoint.1=wayPoint1&
    waypoint.2=wayPoint2&
    wayPoint.n=wayPointn&
    optimize=optimize&
    avoid=avoidOptions&
    routePathOutput=routePathOutput&
    distanceUnit=distanceUnit&
    key=BingMapsKey

Bing Maps Services共通のURLは次の通りでした。Routes APIの場合，restApi部分にRoutesを指定します。

• http://dev.virtualearth.net/REST/version/restApi/resourcePath?queryParameters&key=BingMapsKey

各パラメーターの内容は次の通りです。前回紹介したImagery APIでは経路の描画もサポートしていたため，いくつかのパラメーターは同じ内容です。また，versionとBingMapKeyについても前回までと同様に，「v1」とBing Maps Keyを指定します。

上記のうちwaypoint.nのみ必須のパラメーターです。travelModeを省略する場合は次のように /Routes の後にすぐクエリーを付けてURLを表記します。

• http://dev.virtualearth.net/REST/version/Routes?
    wayPoint.1=wayPoint1&...

経路探索の例

実際に経路探索をしてみましょう。以下は，建物の名前を出発・到着地点に指定した場合の徒歩による経路探索です。

• http://dev.virtualearth.net/REST/v1/Routes/Walking?
    wp.1=Eiffel%20Tower&
    wp.2=louvre%20museum&
    optmz=distance&
    key=BingMapsKey&o=xml

リクエスト結果をみる（※2）

※2

リクエストURLには実際のBing Maps Keyが指定してありますが，実際のアプリケーションでは必ず開発者自身が取得したKeyに置き換えてください。

次の例は経緯度を指定した場合です。また経路の経緯度情報も取得しています。レスポンスをみると複数の経緯度情報が含まれているのがわかります。

• http://dev.virtualearth.net/REST/v1/Routes?
    wp.1=40,-120&
    wp.2=40.5,-120.5&
    rpo=points&
    key=BingMapsKey&o=xml

リクエスト結果をみる

主要道路からの経路探索

Routes APIのもうひとつの機能は到着地点を指定し，そこまでの東西南北の主要な道路からの経路探索です。日本はサポートされていません。

URLの書式

メタデータ取得のURL書式には次の通りです。

• http://dev.virtualearth.net/REST/version/Routes/FromMajorRoads?
    destination=destination&
    exclude=routes&
    rpo=routePathOutput&
    du=distanceUnit&
    key=BingMapsKey

各パラメーターは次の通りです。出発・到着地から経路探索と同じパラメーターは省略しています。

経路探索の例

実際の例は次のようになります。

• http://dev.virtualearth.net/REST/v1/Routes/FromMajorRoads?
    destination=1%20Microsoft%20Way%20Redmond%20WA&
    excl=routes&
    key=BingMapsKey&o=xml

リクエスト結果をみる

結果をみると，到着地に対して東西南北の道路が出発地となっています。