My3D Web API(試験運用中)

 My3D Web APIは,範囲やズームレベルをクエリーパラメータで指定することにより,任意の範囲や解像度で3D地図を表示できるWebページを提供します. 他のWebアプリケーションからリンクしたり,<ifram>要素で埋め込むなどして使用することができます.

サービスURL

URL http://gsj-seamless.jp/labs/my3d/my3d.html

クエリーパラメータ

上記のサービスURLに続けて以下のクエリーパラメータが指定できます.

パラメータ出現デフォルト説明
background 省略可 fffffe 背景色を16進数6桁(RRGGBB)で指定
base 省略可 (地理院地図を表示) 背景地図をタイルサービステンプレートまたは画像ファイルURLで指定
bbox 省略可 なし 表示範囲を,S, W, N, Eの順にカンマ区切りで指定.
bboxかcenterのいずれかは指定する
camera 省略可 0, -250, 200 注視点に対するカメラの位置をx, y, zの順にカンマ区切りで指定
center 省略可 なし 中心位置を緯度,経度の順にカンマ区切りで指定.
bboxかcenterのいずれかは指定する
height 省略可 document.documentElement
.clientHeight
描画領域の高さ
hf 省略可 1 高さ誇張係数(1が誇張なし,大きくすると誇張)
overlay 省略可
複数可
(シームレス地質図詳細版
を表示)
オーバーレイ地図をタイルサービステンプレート,
または画像ファイルURLで指定.
カンマに続けて不透明度も指定できます.
複数指定できます(後に指定したものが上に重なる)
res 省略可 2 標高データ解像度.2のres乗ピクセルおきに標高データを利用します.
shininess 省略可 鏡面指数.大きくするとカメラに入る光が多くなります.
specular 省略可 鏡面色
width 省略可 document.documentElement
.clientWidth
描画領域の横幅
z 必須 なし 表示ズームレベル(0~14)

 baseプロパティやoverlayプロパティでは,表示したい地図をタイルマップテンプレートまたは画像ファイルURLで指定します.  タイルマップテンプレートは,個々のタイルのURLを特定するための文字列で,グーグルマップ互換のズームレベル及びタイル座標値を{z}, {y}, {x}の書式で埋め込んだものです.
 なお,タイルマップテンプレート内で,クエリーパラメータに使用できない文字を使用したい場合は%エンコード(URIエンコード)を使って変換し,埋め込めます. 以下に%エンコードが必要な文字例を示します.

&%26
,%2c
?%3f
=%3d
 baseやoverlayプロパティでは単一の画像ファイルを指定することもできます. ただし,画像の範囲がbboxで指定した範囲と一致する必要があります.
 なお,baseやoverlayプロパティで使用するデータは,サーバ側でクロスドメインアクセスが許可されている必要があります. 地理院タイルやシームレス地質図ラボサイトのエナジーコーンタイルなどはこの設定がなされています.

地図操作法

キーボード,マウスによる操作が可能です.Chrome, Firefox ではゲームパッドも使用できます(Firefoxでは設定の変更が必要です). 操作方法はGoogle Earthとほぼ同様です.

キーボード マウス タッチ ゲームパッド 動作
[←][→][↑][↓] ドラッグ ドラッグ buttons[12][13][14][15] 水平移動
axes[0][1] 水平高速移動
[Shift]+[←]・[→] [Shift]+ドラッグ ダブルタッチ回転 左右回転(注視点中心)
[Shift]+[↑]・[↓] ダブルタッチ上下 チルトアップ・ダウン
(注視点中心)
[Ctrl]+[←]・[→] [Ctrl]+ドラッグ buttons[4][5] 左右回転(カメラ中心)
[Ctrl]+[↑]・[↓] axes[3] チルトアップ・ダウン
(カメラ中心)
buttons[6][7] 左右高速回転(カメラ中心)
[PgUp]・ [PgDn] ホイール,
ダブルクリック
ピンチイン・アウト ズームイン・アウト
buttons[3][0] 上昇,下降

ゲームパッドのボタン配置(W3C Working Draft 25 February 2014より)

補足

 緯度経度指定した範囲の地図画像の幅及び高さが2048ピクセルを超える場合は地図画像が表示されません. また,この場合特にエラーは返しません.
 使用できる地図投影法は,Webメルカトールのみです.投影法の変換は行いません.

サンプル

富士山の地理院地図とシームレス地質図詳細版

URL

https://gsj-seamless.jp/labs/my3d/my3d.html?bbox=35.2,138.6,35.5,138.9&z=11&width=400&height=300&overlay=https://gbank.gsj.jp/seamless/v2/api/1.3.1/tiles/{z}/{y}/{x}.png,0.6

表示


2014年5月10日更新