APIの実装に関する情報や実装方法を解説します。
次のサンプルは、APIを利用した最も簡単なサンプルとして、東京駅を中心とした地図を表示します。
地図はマウスによるドラッグ＆ドロップによるスクロールと、マウスホイールによる縮尺レベルの変更ができます。
地図を表示させるまでの手順は次の通りです。
１．script タグにローダーの処理を記述して、webgl.jsを読み込みます。
２．地図を表示する領域の div 要素「ZMap」を作成します。（名称は任意です）
３．ZDC.Mapオブジェクトを作成して、mapオブジェクトに代入する処理を記述します。
４．map オブジェクトを body タグの onloadイベントから初期化します。
<!DOCTYPE html> <html> <head> <meta http-equiv="Content-Type" content="text/html; charset=EUC-JP"> <script src="//api.its-mo.com/v3/webgl-loader?key=JSZddc5111626c8|Zo4wz&ver=bldg_w_tex&api=webgl.js&enc=EUC&force=1" type="text/javascript"></script> <script type="text/javascript"> "use strict"; /* 東京 */ var map, lat = 35.66297325982054, lon = 139.76598186955528; // lat = 35.6778614, lon = 139.7703167; function loadMap() { map = new ZDC.Map( document.getElementById('ZMap'), { latlon: new ZDC.LatLon(lat, lon), zoom: 14.5, heading: 155, tilt: 70 } ); /* スケールバーを作成 */ var scale = new ZDC.ScaleBar(); /* スケールバーを表示 */ map.addWidget(scale); }; </script> </head> <body onload="loadMap();"> <div id="ZMap" style="border:1px solid #777777; width:750px; height:500px; top:0px; left:20px; position:absolute;"></div> </body> </html>
1行目で文書型の宣言を行っています。
APIでは、次の文書宣言で動作が保障されています。
・<!DOCTYPE html>
上記以外の記述ではお客様のWebページ中の表示位置や内容がブラウザごとに異なる場合があります。
5行目の<meta>は必須ではありませんが、文字化けを防ぐためのものです。
6行目の<script>でAPIをダウンロードします。
ダウンロードにはローダー（webgl-loader）を使い、お客様のキーや、ローダーに関するオプションパラメータを指定します。
13～21行目で、地図を表示する記述を行っています。
APIのZDC.Mapクラスを利用して、第1引数にdiv要素「Zmap」を、第2引数に地図の初期表示に関するオプションパラメータを指定します。
このWebページでは初期表示位置(latlon)、及び初期表示の縮尺(zoom)の指定を行っています。
26行目で、onload イベントに紐付けて地図の表示を行うようにする設定を行っています。
この処理は必須ではありませんが、APIの実行がWebページの読み込みより先に行われるケースを回避します。
27行目で、地図をWebページに表示する領域を定義して、styleの指定を行っています。
ここでは「ZMap」としていますが、div要素は任意の名称が利用可能です。
APIを利用するにはローダーを利用します。
APIはスマートフォン・タブレットでもご利用いただけます。
ZDC.addListener()を使って地図やウィジットにイベントリスナを登録すると、追加したイベント
が発生したときに地図やウィジットを操作できます。
実装例