Login
      目次 x
      raster
        • 印刷する
        • PDF
        目次

        raster

          • 印刷する
          • PDF
          Article Summary

          概要

          Naver地図では、JavaScriptを使わずにWebページでNaver地図を利用して簡単に位置を表示して案内できるStatic Map(静的地図)サービスを提供します。

          HTMLページ内で必要なイメージを取得するためにはリクエスト形式にあうURLを作り<img>タグに配置します。

          リクエスト

          ID-KEY基盤認証

          curl "https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=127.1054221,37.3591614&level=16" \
	-H "X-NCP-APIGW-API-KEY-ID: {アプリケーションを登録する時に発行されたclient id値}" \
	-H "X-NCP-APIGW-API-KEY: {アプリケーションを登録する時に発行されたclient secret値}" -v

          HTTP Referer基盤認証

          <img src="https://naveropenapi.apigw.ntruss.com/map-static/v2/raster-cors?w=300&h=300&center=127.1054221,37.3591614&level=16&X-NCP-APIGW-API-KEY-ID={アプリケーションを登録する時に発行されたclient id値}">

          リクエストパラメータ

          パラメータタイプ必須説明
          crsstringN座標体系を表します。
          値を省略する場合、WGS84経緯度の座標体系(EPSG:4326)として認識します。

          サポートする座標体系は以下の通りです。
          - EPSG:4326: WGS84経緯度
          - NHN:2048: UTMK
          - NHN:128: Katech TM128
          - EPSG:4258: GRS80経緯度
          - EPSG:4162: Bessel経緯度
          - EPSG:2096: Korea East Belt
          - EPSG:2097: Korea Central Belt
          - EPSG:2098: Korea West Belt
          - EPSG:3857 or EPSG:900913: Google Maps
          - EPSG:5179: Korea 2000 / Unified CS
          centerstringY or N中心座標
          'center=X 座標,Y 座標'の形式で入力します。
          X 座標, Y 座標順番は座標体系の定義にしたがいます。
          例えば、WGS84経緯度の座標体系である場合、入力形式は <経度、緯度> の順番です。
          markersパラメータ設定時には省略できます。
          levelintY or Nズームレベル、markersパラメータ設定時には省略できます。
          - 入力範囲: 0~20
          w、hintY横、縦イメージサイズ
          'w=サイズ&h=サイズ'の形式で入力
          最小1~1024ピクセルサポート
          maptypestringN地図タイプ、入力できる値は以下の通りです。
          - basic: 一般(基本値)
          - satellite: 衛星
          - terrain: 地形図
          formatstringN返却イメージ形式、入力できる値は以下の通りです。
          - png: 24ビット(基本値)
          - jpgまたはjpeg: 圧縮品質85%, 24ビット
          scaleintN高解像度ディスプレイサポートのためのオプション、入力できる値は以下の通りです。
          - 1: 低解像度(基本値)
          - 2: 高解像度
          markersstringNマーカー種類別のスタイル及び位置指定

          リクエストヘッダ

          該当ヘッダはID-KEY基盤認証でのみ必要です。

          ヘッダ名説明
          X-NCP-APIGW-API-KEY-IDアプリケーションを登録する時に発行されたClient ID
          X-NCP-APIGW-API-KEY-ID:{Client ID}
          X-NCP-APIGW-API-KEYアプリケーションを登録する時に発行されたClient Secret
          X-NCP-APIGW-API-KEY:{Client Secret}

          リクエストボディ

          • 該当APIはリクエストボディが必要ありません。

          レスポンス

          レスポンスボディ

          正常的なリクエストの場合、パラメータに合わせて一つのイメージファイル(pngやjpeg)を返却します。
          エラーが発生するとHTTPステータスコードが200でない値がJSON形式で返却されます。

          例示

          リクエスト例示

          center

          地図の中心座標を設定します。

          • 形式: center=X 座標、Y 座標

          中心座標はX 座標地点とY 座標地点で構成されるし、X、Y座標地点値はコンマで区分します。経緯度座標の入力形式は <経度、緯度>です。
          但し、markersパラメータを設定して最適化されたズームレベルと位置で地図を表示する時はcenterとlevelパラメータを省略できます。

          次はWGS84経緯度座標体系の中心座標が127.1054221,37.3591614であるイメージをリクエストする例題です。

          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=127.1054221,37.3591614&level=16

          次の図の正中央が中心座標になります。

          default-center.png

          level

          地図のズームレベルを設定します。

          • 形式: level=ズームレベル

          ズームレベルは最小0、最大20 レベルまでサポートします。
          但し、markersパラメータを設定して最適化されたズームレベルと位置で地図を表示する時はcenterとlevelパラメータを省略できます。

          次はレベルが11である地図をリクエストする例題です。

          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=127.1054221,37.3591614&level=11

          次のように11レベルの地図が表示されます。
          default-level.png

          w、h

          イメージのサイズを横(w)、縦(h)で表示します。単位はピクセル(pixel)であり、値の範囲は横、縦が各1~1024ピクセルです。

          • 形式: w=サイズ&h=サイズ

          次は地図のサイズを横300ピクセル、縦200ピクセルでリクエストする例題です。

          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=200&center=127.1054221,37.3591614&level=16

          次のようにリクエストしたサイズの地図が表示されます。
          default-wh.png

          maptype

          地図タイプを設定します。

          • 形式: maptype=basic|satellite|terrain
            • basic: 一般地図タイプ
            • satellite: 衛星地図タイプ
            • terrain: 地形図タイプ

          一般地図リクエスト

          次は一般地図タイプをリクエストする例題です。

          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=127.1054221,37.3591614&level=11&maptype=basic

          次のように一般地図が表示されます。

          default-maptype-basic.png

          衛星地図リクエスト

          次は衛星地図タイプをリクエストする例題です。

          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=127.1054221,37.3591614&level=11&maptype=satellite

          次のように衛星地図が表示されます。
          default-maptype-satellite.png

          地形図リクエスト

          次は地形図タイプをリクエストする例題です。

          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=127.1054221,37.3591614&level=11&maptype=terrain

          次のように地形図が表示されます。
          default-maptype-terrain.png

          format

          地図イメージの形式を設定します。

          • 形式: format=イメージ形式(pngまたはjpgまたはjpeg)

            返却されるイメージ形式はpng、jpeg(jpg)です。
          • png(基本値)は24ビットPNG形式をサポートします。 値を別途に明示しない場合とサポートされる形式として明示しない場合はpngとみなします。
          • jpeg(jpg)は圧縮品質85%の24ビットJPEG形式をサポートします。(jpgとjpegキーワードをすべてサポートします。)

          pngイメージ形式リクエスト

          次はpngイメージ形式で地図をリクエストする例題です。

          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=127.1054221,37.3591614&level=16&format=png

          次のようにpng形式の地図が表示されます。
          default-format-png.png

          jpeg(jpg)イメージ形式リクエスト

          次はjpeg(jpg)イメージ形式で地図をリクエストする例題です。

          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=127.1054221,37.3591614&level=16&format=jpg

          次のようにjpeg形式の地図が表示されます。
          default-format-jpg.jpg

          scale

          高解像度ディスプレイサポートのためのオプションを設定します。

          • 形式: scale=1|2
            • 1: 低解像度用イメージリクエスト、リクエストした w、hサイズ(ピクセル単位)のイメージを256 x 256 タイル基盤で作成して返却します。 この値が基本値であり、省略できます。
            • 2: 高解像度用イメージリクエスト、リクエストした w、hサイズのイメージを512 x 512タイル基盤で作成して返却します。 すなわち、scale=1と同じ地図サービス地域が返却されるが、各サイズに含まれるピクセルは2倍に増えます。例えば、320 x 320がリクエストされると640 x 640イメージを返却します。

          低解像度リクエスト

          次は地図を低解像度(scale=1)でリクエストする例題です。

          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=127.1054221,37.3591614&level=16&scale=1

          次のように低解像度地図イメージが表示されます。
          default-scale-1.png

          高解像度リクエスト

          次は地図を高解像度(scale=2)でリクエストする例題です。

          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=127.1054221,37.3591614&level=16&scale=2

          次のように高解像度地図イメージが表示されます。
          default-scale-2.png

          markers

          地図上にマーカーを表示します。リクエストの個数分マーカーを表示するし、最大20個をサポートします。
          markersパラメータ値のみを指定してcenter、levelパラメータを省略するとリクエストした地図サイズを基準にマーカーが含まれた最適の位置とズームレベルで地図を表示します。

          • 形式: markers=property:value|property:value1,value2|...
          属性値必須基本値説明設定例
          typed(default), n(number), a(alphabet), t(tooltip)Ndマーカータイプtype:dまたはtype:n
          sizetiny, small, midNmidマーカーサイズ、tinyである場合、label表現は省略される。size:tinyまたはsize:small
          color事前定義色相または0xFFFFFF(24ビット色相値)Nなし省略すると基本色相の値である0x08da76で表示、
          事前定義色相は代表的に使用する色相を使いやすく文字列で定義した値です。
          事前定義色相は以下の通りです。
          - Default: 0x08DA76
          - Blue: 0x029DFF
          - Orange: 0xFE8C52
          - Yellow: 0xFFBA01
          - Red: 0xFF6355
          - Brown: 0xA4885B
          - Green: 0x63AA41
          - Purple: 0xD182C8
          - Gray: 0x666666          		color:greenまたはcolor:0x00FF00
          labelA-Z, 0-9Nなし省略するとマーカーのみ表示label:A, label:9
          posx1 y1,x2 y2, ...Yなしマーカーが表示される位置、多数入力可能pos:127.15(空白)38.15,126.12(空白)37.523
          viewSizeRatio0.1~2.0N1.0マーカータイプ(type)とサイズ(size)別の基本デザインをもとにマーカーのサイズ調節
          - 小数点1桁のみサポート
          - 0.1より小さい場合は0.1、 2.0より大きい場合は2.0に設定          		viewSizeRatio:2.0

          基本マーカー

          次は多様な基本マーカー(type:d)リクエスト例題と結果イメージです。

          • マーカーサイズ別リクエスト- size:tiny
          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:tiny|pos:127.1054221%2037.3591614

          marker-1.png

          • マーカーサイズ別リクエスト- size:small
          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:small|pos:127.1054221%2037.3591614

          marker-2.png

          • マーカーサイズ別リクエスト- size:mid
          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:mid|pos:127.1054221%2037.3591614

          marker-3.png

          • 多様なサイズのマーカーリクエスト- size:mid + small + tiny
          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:mid|pos:126.9865479%2037.5612557&markers=type:d|size:small|color:red|pos:126.9870479%2037.5695075%2C126.9950680%2037.5612557%2C126.9743160%2037.5620754&markers=type:d|size:tiny|color:green|pos:126.9810479%2037.5695075%2C126.9950680%2037.5672557%2C126.9843160%2037.5570754

          marker-4.png

          • 色相変更 - red
          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:small|pos:127.1054221%2037.3591614|color:red
https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:small|pos:127.1054221%2037.3591614|color:0xFF6355

          marker-5.png

          • マーカーサイズ変更 - 0.5倍サイズ
          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:mid|pos:127.1054221%2037.3591614|viewSizeRatio:0.5

          marker-6.png

          • マーカーサイズ変更 - 2倍サイズ
          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:mid|pos:127.1054221%2037.3591614|viewSizeRatio:2.0

          marker-7.png

          ** 数字マーカー**

          • 様々な数字マーカーの組み合わせ
          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:n|size:mid|pos:126.9865479%2037.5612557|label:1&markers=type:n|size:small|color:blue|pos:126.9870479%2037.5695075|label:2&markers=type:n|size:small|color:blue|pos:126.9950680%2037.5612557|label:3&markers=type:n|size:small|color:blue|pos:126.9743160%2037.5620754|label:4

          marker-8.png

          アルファベットマーカー

          • 様々なアルファベットマーカーの組み合わせ
          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:a|size:mid|pos:126.9865479%2037.5612557|label:a&markers=type:a|size:small|color:blue|pos:126.9870479%2037.5695075|label:b&markers=type:a|size:small|color:blue|pos:126.9950680%2037.5612557|label:c&markers=type:a|size:small|color:blue|pos:126.9743160%2037.5620754|label:d

          marker-9.png

          ツールチップマーカー

          • マーカーサイズはいつもtinyで固定
          • label内容が吹き出しで表現されます。
          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?crs=EPSG:4326&scale=1&format=png&w=375&h=258&markers=type:t|pos:126.9616187%2037.507435|label:%EB%8F%99%EC%9E%91%EA%B5%AC,%20%EC%84%9C%EC%B4%88%EA%B5%AC,%20%EA%B4%80%EC%95%85%EA%B5%AC&markers=type:t|color:blue|pos:126.96060539999999%2037.507685699999996|label:%EB%8F%99%EC%9E%91%EA%B5%AC,%20%EC%84%9C%EC%B4%88%EA%B5%AC,%20%EC%9A%A9%EC%82%B0%EA%B5%AC%20%EB%B0%A9%EB%A9%B4&markers=type:t|color:0xEE3A3A|pos:126.9616377%2037.506708950000004|label:%EB%8F%99%EC%9E%91%EA%B5%AC,%20%EC%84%9C%EC%B4%88%EA%B5%AC,%20%EC%9A%A9%EC%82%B0%EA%B5%AC%20%EB%B0%A9%EB%A9%B4

          marker-11.png

          カスタムマーカー
          カスタムマーカー(external marker)を設定します。

          カスタムマーカー設定時には次のような制約事項があります。

          • カスタムマーカーの最大サイズは基本 64 x 64ピクセルであり、Retinaディスプレイ対応の高解像度(scale=2)リクエストである場合、128 x 128ピクセルです。
          • カスタムマーカーリクエストURLで 2秒以内にレスポンスがないと作業を中止します。
          • カスタムマーカーは最大1日間内部キャッシュで維持できます。同じURLにマーカーイメージのみが変わる場合は最大1日まで更新されない可能性があります。
          • svg、image形式をサポートします。
          属性値必須基本値説明設定例
          typee(external)Yなしカスタムマーカータイプtype:e
          iconURLパスYなしURLパス、png、svgタイプサポートicon:http://aaa/bbb.svgまたはicon:http://aaa/bbb.png
          anchorマーカー表示位置Nbottom(0.5, 1.0)地図イメージでマーカーイメージ位置のオフセット値、マーカー表示位置を詳細に調整する必要があるときに設定します。
          doubleまたはtextタイプで設定できます。
          doubleタイプで入力する場合、小数点以下2桁(0.00~1.00)まで表現できるし、xOffset、yOffsetの順番で入力します。(例:左上は0.0,0.0、右下は1.0,1.0)
          textタイプで入力する場合、入力できる値は以下の通りです。
          - top: 0.5, 0.0
          - bottom: 0.5, 1.0(基本値)
          - left: 0.0, 0.5
          - right: 1.0, 0.5
          - center: 0.5, 0.5
          - topleft: 0.0, 0.0
          - topright: 0.0, 1.0
          - bottomleft: 1.0, 0.0
          - bottomright: 1.0, 1.0
          例えば、ピンの形のアイコンである場合、普通はイメージの真ん中の一番下の方に表示するため、doubleタイプで入力する時はdouble:0.5,1.0で入力し、textタイプで入力する時はtext:bottomで入力します。          		anchor:0.5,0.0またはanchor:top
          posx1 y1,x2 y2, ...Yなしマーカーが表示される位置、多数入力可能pos:127 38,126 37

          次はカスタムマーカーをリクエストする例題です。

          https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&scale=2&markers=type:e|anchor:center|icon:https://aaa.bbb.com/icon/construction-medium@2x.png|pos:127.0597827%2037.5118871

          リクエスト結果は次の通りです。

          marker-10.png

          エラーコード

          HttpStatusCodeErrorCodeErrorMessageDescription
          400100Bad requestリクエストに有効でないパラメータが存在することを表します。
          500900Internal errorサーバ内部でエラーが発生したことを意味します。
          継続的に問題が発生する場合、公式問い合わせチャンネルを確認してください。
          503500Service Unavailableシステムのメンテナンスのため、一時的にレスポンスが不可能な状態です。
          しばらくしてから、再度お試しください。
          504510Gateway Timeoutシステムの過負荷のため一時的にレスポンスが不可能な状態です。
          しばらくしてから、再度お試しください。
          この記事は役に立ちましたか?
          What's Next
          Change password!
          Changing your password will log you out immediately. Use the new password to log back in.
          Change profile
          Success!
          First name must have atleast 2 characters. Numbers and special characters are not allowed.
          Last name must have atleast 1 characters. Numbers and special characters are not allowed.
          Enter a valid email
          Enter a valid password
          Your profile has been successfully updated.
          Logout