前回は経由地も複数選択して地図上に徒歩ルートを表示しました。今回は、ルート計算の結果をテキストでも表示するようにしました。
デモとコードサンプルはこちら。
サンプルコードの内容
DirectionsServiceオブジェクトのrouteメソッドを使ってルート計算するところまでは前回と同じです。
ルート計算の実行結果はDirectionsResultオブジェクト（サンプルコードではresponse変数）に保持され、前回まではこのオブジェクトをDirectionsRenderer オブジェクトのsetDirections()を使って地図上にルートを表示していました。
今回は、DirectionsResultオブジェクトからルート計算結果をテキストデータで取得します。
１）ルート計算の結果：DirectionsResultオブジェクト（サンプルコード：response）
・DirectionsResultは、routes[]フィールドのみ持ち、DirectionsRequestで指定された出発地点から到着地点に至る経路を示します。
・routes[]フィールドには、DirectionsRouteオブジェクトの配列が格納が格納されます。
原則として、1つのリクエストに対して返されるルートは1つだけですが、リクエスト（DirectionsRequest）のprovideRouteAlternatives属性true に設定されている場合は、複数のルートが返されることがあります。
サンプルコードでは、以下の箇所で使用しています。
var route = response.routes[0];
２）ルート全体の情報：DirectionsRouteオブジェクト（サンプルコード：route）
指定された出発地点と到着地点からの結果が格納され、以下の属性を持ちます。
①legs[]:
・DirectionsLegオブジェクトの配列が格納。
・各オブジェクトには、ルート内の2つの地点に基づくルート内区間に関する情報が格納。
・区間は、指定された経由地または目的地ごとに1つずつ存在。
詳細は３）参照
②waypoint_order:
計算されたルート内のウェイポイントの順序が格納
③overview_path:
ルート結果のおよその（なめらかな）パスを表すLatLngの配列が格納。
④bounds:
ルートのポリラインの境界を示すLatLngBoundsが格納
⑤copyrights:
ルートと一緒に表示される著作権表示のテキストが格納
⑥warnings[]:
ルートと一緒に表示される警告の配列が格納
サンプルコードでは、legs[]属性から各区間の情報を取得して表示しています。
３）ルートの各区間の情報：DirectionsLeg（サンプルコード：route.legs）
DirectionsLeg は、計算されたルート内の出発地点から到着地点までの行程内の1つの区間を定義し、以下の属性を持ちます。
サンプルコードでは、start_address、end_address、distance.text属性の値を取得して表示しています。
①steps[]:
行程内の区間の各ステップに関する情報を示すDirectionsStep オブジェクトの配列が格納。詳細は４）参照
②distance:
当該区間の距離の合計を、次の形式のDistanceオブジェクトとして示す。
value:メートル法に基づく距離
text: 距離の文字列表現（マイル、メートル）
③duration:
当該区間の所要時間の合計を、次の形式の Duration オブジェクトとして示す。
value: 所要時間を秒で示す。
text: 所要時間の文字列表現が格納。
④arrival_time:
この区間の予測到着時刻が格納。乗換案内の場合のみ返される。
⑤departure_time:
この区間の予測出発時刻がTimeオブジェクトとして指定されて格納。乗換案内の場合のみ。
⑥start_location:
この区間の出発地点の LatLng が格納
⑦end_location:
この区間の到着地点の LatLng が格納
⑧start_address:
この区間の始点の住所が人間の読める形式で格納（通常は住所形式）
⑨end_address:
この区間の終点の住所が人間の読める形式で格納（通常は住所形式）
４）ルートのステップ DirectionsStep
ルートを構成する最小単位で、「斜め右に折れる 0.1 km」などと表示される。
AngularJS、Googleマップの他の記事の目次