Google Maps JavaScript API v3 の ルート検索(DirectionsService) の結果のDirectionsResultにどのような情報が格納されているかを確認できるデモを作りました。
調査結果は、以下のページにまとめています。
  1. ルート検索 DirectionsService 調査

操作方法

  1. 住所、地名を入力してボタンで地図が表示されます
  2. ルート検索の開始位置を指定します
    1. 地図に中のルート検索を開始する位置をクリックします。その位置にマーカー()が表示されます
    2. 「Point」メニューの「set origin point」を選択します。開始位置のアイコン()が表示されます
      開始位置は、DirectionsRequest のプロパティの origin (lat,lng)フィールドに反映されます。
      アイコンをドラッグすることで位置を変えることができます。
  3. ルート検索の目的位置を指定します
    1. 地図に中のルート検索を開始する位置をクリックして、「Point」メニューの「set destination point」を選択します。目的位置のアイコン()が表示されます
      目的位置は、DirectionsRequest のプロパティの destination (lat,lng)フィールドに反映されます。
  4. DirectionsRequest のプロパティの入力フィールドでその他のプロパティを入力します。
    1. waypoint1,waypoint2は、開始位置、目的位置と同じように、地図上で、位置をクリックして、「Point」メニューの「set waypont 1」「set waypoint 2」を選択して位置を指定します。
      waypoint1()、waypoint2()アイコンが表示されます。
      waypointは、このデモでは、2つまでしか指定できません。
    2. 「Point」メニューの「clear all point」で、開始位置、目的位置、waypoint1、waypoint2の指定を消去することができます。
  5. 「Search」メニューの「serach route」または、ボタンで、ルートの検索を開始します。
    1. DirectionsRequest欄に検索で指定したDirectionRequestのプロパティが表示されます。
    2. DirectionsStatus欄に検索結果のDirectionsStatusの値が表示されます。
    3. DirectionsResult欄に検索結果のDirectionsResultのプロパティが表示されます。
    4. Directions Panel欄に検索結果のDirectionsResultDirectionsRendererのsetDirectionsメソッドによるルート情報が表示されます。
  6. 地図上の検索結果のマーカー()をドラッグすると、ルートが変わります。
    この時、各検索結果のDirectionsResult欄、Directions Panel欄も更新されます。
  7. DirectionsResultには、緯度経度の配列としてルートのパスが格納されています。
    overview_path は、全体のルートです。
    DirectionsStapには、DorectionsStap毎のルートパスが格納されています。
    をクリックすると、各ルートパスを地図上で確認できます。(赤色のラインで表示されます)

parameter




DirectionsRequest property



,


,


transitOptions :






waypoints :
,

,