道案内サービスを利用する(道案内情報を取得)

DirectionsServiceを利用すると、途中経路の位置情報だけではなく、文章による道案内情報も取得できます。 これを利用すると、カーナビのようなWebサービスが作成可能です。

サンプル

このサンプルは、DirectionsServiceのroute()メソッドが返す結果から、HTML文字列として返される道案内情報を取得して表示します。


<!DOCTYPE html>
<html>
  <head>
    <style type="text/css">
      html { height: 100% }
      body { height: 100%; margin: 0px; padding: 0px }
      #map { height: 100% }
    </style>

    <script src="http://maps.google.com/maps/api/js?v=3&sensor=true"
        type="text/javascript" charset="UTF-8"></script>

    <script type="text/javascript">
    //<![CDATA[

    var map;
    var ds;
    
    // 初期化。bodyのonloadでinit()を指定することで呼び出してます
    function init() {

      // Google Mapで利用する初期設定用の変数
      var latlng = new google.maps.LatLng(39, 138);
      var opts = {
        zoom: 6,
        mapTypeId: google.maps.MapTypeId.ROADMAP,
        center: latlng
      };

      // getElementById("map")の"map"は、body内の<div id="map">より
      map = new google.maps.Map(document.getElementById("map"), opts);

      // DirectionsRequest
      var req = {
        destination: "九段下駅",
        origin: "渋谷駅",
        travelMode: google.maps.DirectionsTravelMode.DRIVING
      };
      ds = new google.maps.DirectionsService();
      ds.route(req, directionsResultCallback);
    }
    
    function directionsResultCallback(result, status) {
      
      if (status != google.maps.DirectionsStatus.OK) {
        return;
      }

      var resdiv = document.getElementById("dumpresult");

      for (var i=0; i<result.routes.length; i++) {
        var r = result.routes[i];

        var legstxt =
           document.createTextNode("i="+i + " legs=" + r.legs.length);

        var p = document.createElement("p");
        p.appendChild(legstxt);
        resdiv.appendChild(p);

        var ul = document.createElement("ul");
        resdiv.appendChild(ul);
        
        for (var j=0; j<r.legs.length; j++) {
          for (var k=0; k<r.legs[j].steps.length; k++) {
            var txt = 
              document.createTextNode(r.legs[j].steps[k].instructions);

            var li = document.createElement("li");
            li.appendChild(txt);

            ul.appendChild(li);
          }
        }
      }
    }
    //]]>
    </script>
  </head>

  <body onload="init()">
    <div id="map" style="width:100%; height:100%"></div>
    <div id="dumpresult"></div>
  </body>

</html>

このサンプルのroute()へ要求を出す部分は前述した「道案内サービスを利用する(途中経路にマーカを設置)」と同じです。 今回のサンプルの違いは、DirectionsResultのroutesに含まれるoverview_pathプロパティではなく、legsプロパティに含まれる案内文を取得してHTMLとして表示している点が異なります。

legsプロパティに含まれる案内文は、「dumpresult」というidをつけたdivに書き込むようにしました。 各経路毎に経路番号とlegsに含まれる要素数を表示し、その後の説明文をul要素に含まれるli要素として列挙していくようにしてあります。

表示例

表示例です。 スクロールバーを動かして道案内文章をご覧下さい。