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

バージョン


2.0 ( 2021-03-09 )

サービスURL


https://gbank.gsj.jp/seamless/mymap3d/2.0/map.html

クエリーパラメーター


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

地図

名称意味省略とデフォルト説明
box地図上の描画範囲省略可
デフォルトは 富士山周辺
カンマ区切りで南,西,北,東を指定(度数)
南と北は-90~90でなければなりません.
西 < 東でなければなりません
zズームレベル省略可,デフォルト値 110以上の整数で指定
base背景地図省略可
デフォルトは地理院地図(標準)
タイルURLテンプレート(*1)で指定
空文字を指定すると白色無地
overlayオーバーレイ地図省略可
デフォルトはシームレス地質図V2
地図画像URLまたはタイルURLテンプレート(*1)で指定
地図画像URLを指定すると範囲いっぱいに拡大
空文字を指定すると非表示
このパラメーターは複数指定可
opacityオーバーレイ地図の不透明度省略可,デフォルト値 0.70~1の数値で指定
infoクリック時のポイント情報省略可
デフォルトは20万分の1日本シームレス地質図V2の凡例情報
ポイント情報を取得するAPIのURLテンプレートを指定
APIはテンプレートに埋め込んだ緯度と経度を示す{lat}及び{lng}キーワードを利用してhtmlまたはjsonを返すもの
markersラベル付きマーカー省略可
省略した場合はマーカーを表示しない
カンマ区切りで,緯度,経度,ラベル,色のセットを,マーカーの数だけ並べる
マーカーの色は6桁の16進数(rrggbb)で指定

地形

名称意味省略とデフォルト説明
terrain地形データ(*2)省略可
デフォルトはシームレス標高タイルの統合DEM
標高タイルのタイルURLテンプレート(*1)で指定
terrainZ地形データのズームレベル省略可,デフォルト値 80以上の整数で指定
hf高さの誇張係数省略可,デフォルト値 10以上の数値で指定
invalid標高値が無効な場合の高さ省略可
デフォルト値 0
数値(メートル)で指定
空文字を指定すると描画に使用しない

ステージ

ambient環境光の強度省略可,デフォルト値 0.50~1の数値で指定
background背景色省略可,デフォルト値 7ca2de(青藤色)6桁の16進数(rrggbb)で指定
rotation自動回転時の秒数省略可,デフォルト値 301回転に要する秒数を0 以上の数値で指定
空文字または0を指定すると回転しない
shadow影の表示省略可,デフォルト値 1(表示)0(非表示)または1(表示)で指定

材質

shininess鏡面反射度省略可,デフォルト値 無し0以上の数値で指定
鏡面反射の光沢の度合い
metalness金属類似度省略可,デフォルト値 無し0~1の数値で指定
材質の金属との類似度
roughness表面の粗さ省略可,デフォルト値 無し0~1の数値で指定
0でスムーズな鏡面反射,1で完全な拡散
鏡面反射から拡散反射までの度合い

カメラ

azimuthCカメラの方位角省略可,デフォルト値 1800~360未満の数値で指定
原点から見たカメラの方位角
(真北を0度とした時計回りの角度)
elevCカメラの仰角省略可,デフォルト値 30-90~90の数値で指定
地図原点から見たカメラの仰角
distanceC原点とカメラの距離省略可,省略すると自動調整正の数値で指定(メートル)
height原点の高さ省略可,デフォルト値 0数値(メートル)で指定

光源

directional光源の強度省略可,デフォルト値 0.70~1の数値で指定
azimuthL光源の方位角省略可,デフォルト値 1200~360未満の数値で指定
原点から見た光源位置の方位角
(真北を0度とした時計回りの角度)
elevL光源の仰角省略可,デフォルト値 25-90~90の数値で指定
地図原点から見た光源位置の仰角
colorL光源の色省略可,デフォルト値 ffffff(白色)6桁の16進数(rrggbb)で指定

操作ボタン

colorBボタンの色省略可,デフォルト値 ffffff(白色)6桁の16進数(rrggbb)で指定
sizeBボタンのサイズ省略可,デフォルト値 0.50~1の数値で指定
0を指定すると非表示

開発補助

axis3軸表示省略可,デフォルト値 0(非表示)0(非表示)または1(表示)で指定
helper光源ヘルパー省略可,デフォルト値 0(非表示)0(非表示)または1(表示)で指定
光源,光束.到達距離を把握するための補助表示

*1 タイルURLテンプレート

 地図タイルを呼び出すために使用する以下のような文字列で,"{x}", "{y}", "{z}"といったキーワードが埋め込まれています.
(例) 20万分の1日本シームレス地質図V2
https://gbank.gsj.jp/seamless/v2/api/1.2.1/tiles/{z}/{y}/{x}.png
 これらのキーワードは,MyMap3D内で実際の値(タイル座標やズームレベル)に変換されて使用されます.国土地理院の地理院タイル一覧で「URL: 」に続けて記載されている文字列がこれに当たります.

*2 地形データ

 MyMap3Dでは,デフォルトではシームレス標高タイルで公開されている統合DEMが使用されます.この統合DEMは,国土地理院標高タイル基盤地図情報数値標高モデル及び西之島付近の噴火活動関連情報 兵庫県_全域数値地形図_ポータル(2010年度~2018年度)のデータから作成されています.
 terrainパラメーターを設定して地形データを変更できます.シームレス標高タイルで公開されているその他のタイルセットのほか,国土地理院から公開されている以下の標高タイルも利用できます.

地図操作方法


ドラッグ&ドロップ対応


 MyMap3Dは,ドラッグ&ドロップマップ(DDマップ)に対応しています.
 DDマップアイコン(対象ファイル)をウインドウ内にドラッグ&ドロップすることにより,背景地図やオーバーレイ地図,地形データを変更することができます.
 DDマップアイコンがウインドウ内にドロップされると,[レイヤー名称],[URLテンプレート],[データの種別]を設定する以下のようなレイヤー設定ウィンドウが開きます.

 [データの種別]は,背景地図,オーバーレイ,標高データから選択できます.

エラー


 パラメーターの指定にエラーがあった場合は,3D表示をせずにブラウザにエラーを表示します.