Webメルカトル地図画像取得

API名: 

map_wm

概要: 

Webメルカトル地図画像を取得します。
指定パラメータで地図画像を作成、サーバ側に画像を保存し画像のURLを返却します。

※Webメルカトル(EPSG:3857)に対応した地図を指します

URI: 

https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/map_wm

<API使用例>
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/map_wm?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&?size=600,450&latlon=35.65851,139.76015&zoom=12

リクエストパラメータ

地図画像用パラメータ

パラメータ 必須 デフォルト値 説明
size   600,450 画像サイズ
画像サイズを”横幅[ピクセル],縦幅[ピクセル]”指定します。
画像サイズの指定範囲は横幅、縦幅それぞれ 16[ピクセル]~3000[ピクセル]です。
最大幅は、scaleの設定値によって変わります。
例) scale=2(高解像度) ⇒ 16~1500
latlon   35.6644033,139.7560 緯度経度
取得したい地点の緯度経度を指定します。
※同時に複数地点の緯度経度を指定することはできません。
※世界測地系(WGS84)のみ指定できます。
zoom   12 地図倍率
表示するメルカトル地図の倍率を指定します。
maptype   normal 地図画像種別
取得したい地図画像の種類を指定します。
normal デフォルト地図デザイン
overlay 重畳図形画像のみ
imageformat   png 画像フォーマット
画像を取得する時の画像フォーマットを指定します。
sslcache   F 地図画像データ暗号化指定
真偽値で指定します。
Tを指定すると地図画像をSSLを利用した暗号化通信で取得可能なURLを返却します。
llunit   dec 緯度経度形式
緯度経度形式を指定します。
scale   1 解像度
解像度を指定します。
1 通常
2 高解像度

重畳図形用パラメータ

パラメータ 必須 デフォルト値 説明
shape   - 図形重畳データ
図形重畳データを指定します。
※設定できる緯度経度の測地系は、世界測地系(WGS84)のみとなります。
adjust   T 自動設定指定
重畳図形データ全体を表示できるように、地図の中心位置と倍率を自動設定するかどうかを真偽値で指定します。
Tを指定すると、自動設定します。
latlon, zoomを指定する場合はFを指定してください。
adjsize   ※1 余白設定(絶対値指定)
adjustにTを指定した場合、重畳図形を収める範囲を"横幅[ピクセル], 縦幅[ピクセル]"で指定します。
この指定を行うことで、余白の調整が行えます。
指定できる範囲は、横幅、縦幅それぞれ16[ピクセル]~3000[ピクセル]です。

※1 デフォルトの値はsizeパラメータで指定した値となります。

adjsizesub   - 余白設定(相対値指定)
adjsizeと同じく余白の設定が行えますが、adjsizeと同時に指定することはできません。
adjsizeとの違いは、画像サイズからのマイナス値での指定を行う点です。
指定した値が、画像サイズを超える場合は無効となります。
指定できる範囲は、横幅、縦幅それぞれ0[ピクセル]~1500[ピクセル]です。

出力データ

出力フォーマット

{"map":{"width":600,
        "height":450,
        "center":{"lat":35.6644033,
                  "lon":139.756},
        "zoom":12,
        "bounds":{"sw":{"lat":35.6016278,
                        "lon":139.6530172},
                  "ne":{"lat":35.7271297,
                        "lon":139.8589828}},
        "scale":1},
 "imageUri":"https://core.its-mo.com/zmaps/api/pub/cache/f570350e94c579ca6b899af61accc4dd.png"}
キー名 データ型 説明
map   object 地図情報が入ります。
  width number 横幅が入ります。
  height number 縦幅が入ります。
  center object 中心緯度経度が入ります。
  zoom number ズーム値が入ります。
  bounds object 緯度経度矩形範囲が入ります。
  scale number 解像度が入ります。
imageUri   string 画像URLが入ります。

出力例

[通常出力例]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/map_wm?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&size=600,450&latlon=35.65851,139.76015&zoom=12

{"map":{"width":600,
        "height":450,
        "center":{"lat":35.65851,
                  "lon":139.76015},
        "zoom":12,
        "bounds":{"sw":{"lat":35.5957297,
                        "lon":139.6571672},
                  "ne":{"lat":35.7212411,
                        "lon":139.8631328}},
        "scale":1},
 "imageUri":"http://test.core.its-mo.com/zmaps/api/pub/cache/f570350e94c579ca6b899af61accc4dd.png"}

[指定の緯度経度が地図の提供範囲外だった場合]
https://test.core.its-mo.com/zmaps/api/apicore/core/v1_0/map_wm?if_clientid=JSZxxxxxxxxxx|xxxxx&if_auth_type=ip&latlon=30.1,135.1

{"map":{"width":600,
        "height":450,
        "center":{"lat":30.1,
                  "lon":135.1},
        "zoom":12,
        "bounds":{"sw":{"lat":30.0331556,
                        "lon":134.9970172},
                  "ne":{"lat":30.1667992,
                        "lon":135.2029828}},
        "scale":1},
 "imageUri":null}