--- title: "Static Map" slug: "application-maps-static" updated: 2026-09-17T09:57:26Z published: 2026-09-17T09:57:26Z canonical: "api.ncloud-docs.com/application-maps-static" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Static Map VPC環境で利用できます。 JavaScriptを使用したり、動的ページをロードせず、入力した座標を基準に指定したサイズの NAVERマップ画像(Static Map)を読み込みます。サポートするパラメータ(地図のタイプ、画像形式、解像度、マーカーなど)を使用すると必要に応じて地図画像を設定できます。 ## リクエスト リクエスト形式を説明します。 | メソッド | URI | 説明 | | --- | --- | --- | | GET | /raster | ID-KEY認証 | | GET | /raster-cors | HTTP Referer認証 | 参考 - HTTP Refere認証方式を使用して APIを呼び出すには、Application登録時に Webサービス URLを入力する必要があります。次のガイドをご参照ください。 - [Applicationご利用ガイド](https://guide.ncloud-docs.com/docs/ja/application-maps-app-vpc#Application%EB%93%B1%EB%A1%9D) - [Mapsご利用の申し込み](https://guide.ncloud-docs.com/docs/ja/application-maps-start-vpc#Maps%EC%9D%B4%EC%9A%A9%EC%8B%A0%EC%B2%AD) - HTTP Referer認証方法を使用する場合、次のように HTMLタグを追加してリクエストすることができます。 ``` ``` ### リクエストヘッダ Maps APIで共通して使用されるヘッダの詳細は、[Mapsのリクエストヘッダ](/docs/ja/application-maps-overview#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)をご参照ください。 ### リクエストクエリパラメータ リクエストクエリパラメータの説明は次の通りです。 | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `crs` | String | Optional | 座標システム - `EPSG:4326`(デフォルト) \| `NHN:2048` \| `NHN:128` \| `EPSG:4258` \| `EPSG:4162` \| `EPSG:2096` \| `EPSG:2097` \| `EPSG:2098` \| `EPSG:3857` \| `EPSG:900913` \| `EPSG:5179` - `EPSG:4326`: WGS84経緯度 - `NHN:2048`: UTM-K - `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`、`EPSG:900913`: Googleマップ - `EPSG:5179`: Korea 2000 / Unified CS | | `center` | String | Conditional | 中心座標(X座標,Y座標) - X座標、Y座標の順序は座標システムの定義に従う - 例) WGS84経緯度座標システム: `center=経度,緯度` - `markers`を入力しない場合、必ず入力 - `level`入力時、必ず入力 | | `level` | Integer | Conditional | ズームレベル - 0~20 - `markers`を入力しない場合、必ず入力 - `level`入力時、必ず入力 | | `w`, `h` | Integer | Required | 画像の横長、縦長サイズ - `w=int&h=int`形式で1~1,024ピクセルをサポート - `w`: 横長 - `h`: 縦長 | | `maptype` | String | Optional | 地図のタイプ - `basic`(デフォルト) \| `traffic` \| `satellite` \| `satellite_base` \| `terrain` - `basic`: 一般地図 - `traffic`: 交通情報地図(一般地図基盤) - `satellite`: 衛星地図 - `satellite_base`: 衛星背景地図 - `terrain`: 地形図 | | `format` | String | Optional | 地図の画像形式 - `jpg`/`jpeg`(デフォルト) \| `png8` \| `png` - `jpg`/`jpeg`: 圧縮品質85%、24ビット - `png8`: 8ビット - `png`: 24ビット | | `scale` | Integer | Optional | 解像度 - `1`(デフォルト) \| `2` - `1`: 低解像度用画像をリクエスト。リクエストした`w`、`h`サイズの画像を256 x 256タイルで作成して返す - `2`: 高解像度用画像をリクエスト。リクエストした`w`、`h`サイズの画像を512 x 512タイルで作成して返す(`scale=1`と同じ地図サービス地域が返されるが、各サイズに含まれるピクセルは2倍増加) | | `markers` | String | Conditional | マーカー設定 - `center`、`level`を入力しない場合、必ず入力 - `center`、`level`を入力しない場合、設定したマーカーに最適化されたズームレベルと位置で地図に表示 - 最大20個まで入力可能 - 「\| (Pipe char)」で区切ってオプション設定可能 - [`markers`](/docs/ja/application-maps-static#markers)を参照 - 例) `markers=type:n\\|size:tiny\\|color:Blue\\|pos:126.9810479%2037.5695075&markers=type:d\\|size:mid\\|color:Default\\|pos:123.524712%2024.1236547` | | `lang` | String | Optional | ラベル言語 - `ko`(デフォルト) \| `en` \| `ja` \| `zh` - `ko`: 韓国語 - `en`: 英語 - `ja`: 日本語 - `zh`: 中国語簡体字 | | `dataversion` | String | Optional | バージョン情報 - Static Map APIの画像キャッシュで、クライアントが同じ URLをリクエストした場合にオリジンサーバの背景タイルの更新が反映されない問題を解決するために入力 - 背景タイルが最新かどうかのイシューがある場合に入力することがお勧め - バージョン情報が定期的に更新されるため、タスクの効率化のためにバッチ型タスクをお勧め - 推奨更新周期(`interval`)に応じて一日の確認回数を設定し、決められた時間に確認したバージョン情報を保存して Static Map APIの呼び出し時に使用することをお勧め - [Data Version API](/docs/ja/application-maps-static#DataVersionAPI)を通じて`version`を確認 | #### `markers` `markers`の説明は次の通りです。 | フィールド | 値 | 必須の有無 | 説明 | | --- | --- | --- | --- | | `type` | String | Optional | マーカータイプ - `d`(デフォルト) \| `n` \| `a` \| `t` \| `e` - `d`: デフォルト - `n`: 数字 - `a`: 英字 - `t`: ツールチップ - `e`: カスタム | | `size` | String | Optional | マーカーのサイズ - `tiny` \| `small` \| `mid`(デフォルト) - `tiny`の場合、`label`を入力しても表示されない | | `color` | String | Optional | マーカーの色 - 事前定義色または24ビット色形式で入力 - `Default`(デフォルト) \| `Blue` \| `Orange` \| `Yellow` \| `Red` \| `Brown` \| `Green` \| `Purple` \| `Gray` - `Default`: `0x08DA76` - `Blue`: `0x029DFF` - `Orange`: `0xFE8C52` - `Yellow`: `0xFFBA01` - `Red`: `0xFF6355` - `Brown`: `0xA4885B` - `Green`: `0x63AA41` - `Purple`: `0xD182C8` - `Gray`: `0x666666` | | `label` | String | Optional | マーカーのラベル - a~z、1~9 - 入力しないとマーカーのみ表示 - `type`が`tiny`の場合、入力しても表示されない | | `pos` | String | Required | マーカーの位置(X座標[Space]Y座標) - 「,」で区切って複数の座標を入力可能 - 例) `pos:126.9810479%2037.5695075%2C126.9950680%2037.5672557` - パラメータは UrlEncodeすること | | `viewSizeRatio` | Float | Optional | マーカーサイズの比率 - `type`と`size`別基本デザインを基にマーカーサイズを調整 - 0.1~2.0 (デフォルト: 0.1) - 小数点第一位まで入力可能で、0.1より小さい場合は`0.1`、2.0より大きい場合は`2.0`を入力 | | `icon` | String | Conditional | カスタムマーカーアイコン URL - `type`が`e`の場合、必ず入力 - PNG、SVGファイルをサポート - 例) `icon:http://aaa/bbb.svg` | | `anchor` | String, Double | Optional | マーカー表示位置 - `type`が`e`の場合にのみ入力可能 - 地図画像でのマーカー画像位置のオフセット値で、マーカーの表示位置を細かく調整する場合に設定 - Stringタイプで入力時 - `top` \| `bottom`(デフォルト) \| `left` \| `right` \| `center` \| `topleft` \| `topright` \| `bottomleft` \| `bottomright` - `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タイプで入力時 - 小数点第二位まで入力可能 - 例) `anchor:0.75,0.5`または`anchor:top` | 参考 カスタムマーカー設定時の制限事項 - カスタムマーカーの最大サイズは基本64x64ピクセルで、Retinaディスプレイ対応高解像度(`scale=2`)でリクエストする場合は128x128ピクセルです。 - カスタムマーカーリクエスト URLから2秒以内にレスポンスがない場合はタスクを停止します。 - カスタムマーカーは、最大1日間内部キャッシュで維持することができます。そのため、同じ URLにマーカーの画像だけが変わった場合は、最大1日まで変更された画像が反映されない場合があります。 #### Data Version API Data Version APIの説明は次の通りです。 - リクエスト | メソッド | URL | | --- | --- | | GET | https://maps.apigw.ntruss.com/map-static/v2/lastversion | - レスポンス | フィールド | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `version` | String | - | バージョン情報 - `major_version.minor_version`形式 - `major_version`: 定期更新時に変更、ワンタイルマップメジャーバージョンと同様に維持(2か月に1回更新) - `minor_version`: 一部更新時にバージョンアップ(1か月に1~2回更新) | | `interval` | Long | - | 推奨更新周期(秒) | ### リクエスト例 リクエストのサンプルコードは次の通りです。 参考 このガイドでは、ID-KEY認証方式を使用するサンプルコードを提供します。 #### [`center`](/docs/ja/application-maps-static#center2) 中心座標(`center`)が`127.1054221,37.3591614`の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300¢er=127.1054221,37.3591614&level=16' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`level`](/docs/ja/application-maps-static#level2) 中心レベル(`level`)が`11`の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300¢er=127.1054221,37.3591614&level=11' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`w`, `h`](/docs/ja/application-maps-static#wh2) サイズ(`w` x `h`)が300 x 200ピクセルの地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=200¢er=127.1054221,37.3591614&level=16' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`maptype=basic`](/docs/ja/application-maps-static#maptypebasic2) 地図タイプ(`maptype`)が一般地図(`basic`)の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300¢er=127.1054221,37.3591614&level=11&maptype=basic' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`maptype=traffic`](/docs/ja/application-maps-static#maptypetraffic2) 地図タイプ(`maptype`)が交通情報地図(`traffic`)の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300¢er=127.1054221,37.3591614&level=11&maptype=traffic' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`maptype=satellite`](/docs/ja/application-maps-static#maptypesatellite2) 地図タイプ(`maptype`)が衛星地図(`satellite`)の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300¢er=127.1054221,37.3591614&level=11&maptype=satellite' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`maptype=satellite_base`](/docs/ja/application-maps-static#maptypesatellite_base2) 地図タイプ(`maptype`)が衛星背景地図(`satellite_base`)の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300¢er=127.1054221,37.3591614&level=11&maptype=satellite_base' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`maptype=terrain`](/docs/ja/application-maps-static#maptypeterrain2) 地図タイプ(`maptype`)が地形図(`terrain`)の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300¢er=127.1054221,37.3591614&level=11&maptype=terrain' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`format=jpg`](/docs/ja/application-maps-static#formatjpg2) 画像形式(`format`)が`jpg`(`jpeg`)の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300¢er=127.1054221,37.3591614&level=16&format=jpg' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`format=png8`](/docs/ja/application-maps-static#formatpng82) 画像形式(`format`)が`png8`の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300¢er=127.1054221,37.3591614&level=16&format=png8' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`format=png`](/docs/ja/application-maps-static#formatpng2) 画像形式(`format`)が`png`の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300¢er=127.1054221,37.3591614&level=16&format=png' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`scale=1`](/docs/ja/application-maps-static#scale12) 低解像度(`scale=1`)の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300¢er=127.1054221,37.3591614&level=16&scale=1' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`scale=2`](/docs/ja/application-maps-static#scale22) 高解像度(`scale=2`)の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300¢er=127.1054221,37.3591614&level=16&scale=2' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`lang=ko`](/docs/ja/application-maps-static#langko2) ラベル言語(`lang`)が韓国語(`ko`)の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?crs=EPSG:4326&w=375&h=258¢er=126.96311062857343,37.50843783043817&level=16&lang=ko' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`lang=en`](/docs/ja/application-maps-static#langen2) ラベル言語(`lang`)が英語(`en`)の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?crs=EPSG:4326&w=375&h=258¢er=126.96311062857343,37.50843783043817&level=16&lang=en' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`lang=ja`](/docs/ja/application-maps-static#langja2) ラベル言語(`lang`)が日本語(`ja`)の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?crs=EPSG:4326&w=375&h=258¢er=126.96311062857343,37.50843783043817&level=16&lang=ja' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`lang=zh`](/docs/ja/application-maps-static#langzh2) ラベル言語(`lang`)が中国語(簡体字)(`zh`)の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?crs=EPSG:4326&w=375&h=258¢er=126.96311062857343,37.50843783043817&level=16&lang=zh' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`markers=size:tiny`](/docs/ja/application-maps-static#markerssizetiny2) 基本マーカーのサイズ(`size`)が`tiny`の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:tiny|pos:127.1054221%2037.3591614' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`markers=size:small`](/docs/ja/application-maps-static#markerssizesmall2) 基本マーカーのサイズ(`size`)が`small`の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:small|pos:127.1054221%2037.3591614' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`markers=size:mid`](/docs/ja/application-maps-static#markerssizemid2) 基本マーカーのサイズ(`size`)が`mid`の地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:mid|pos:127.1054221%2037.3591614' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`markers=size:mid&markers=size:small&markers=size:tiny`](/docs/ja/application-maps-static#markerssizemidsmalltiny2) サイズ(`size`)が`mid`、`small`、`tiny`の基本マーカーをすべて表示する地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.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' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`markers=color:red`](/docs/ja/application-maps-static#markerscolorred2) 基本マーカーの色(`color`)が赤(`red`)の地図画像をリクエストするサンプルコードは次の通りです。 - 事前定義色でリクエスト ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:small|pos:127.1054221%2037.3591614|color:red' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` - 24ビット色でリクエスト ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:small|pos:127.1054221%2037.3591614|color:0xFF6355' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`markers=viewSizeRatio:0.5`](/docs/ja/application-maps-static#markersviewSizeRatio052) 基本マーカーサイズの比率(`viewSizeRatio`)を0.5倍(`0.5`)に変更する地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:mid|pos:127.1054221%2037.3591614|viewSizeRatio:0.5' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`markers=viewSizeRatio:2.0`](/docs/ja/application-maps-static#markersviewSizeRatio202) 基本マーカーサイズの比率(`viewSizeRatio`)を2倍(`2.0`)に変更する地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&markers=type:d|size:mid|pos:127.1054221%2037.3591614|viewSizeRatio:2.0' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`markers=type:n|label:{number}`](/docs/ja/application-maps-static#markerstypenlabelnumber2) 数字マーカーを表示する地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.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' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`markers=type:a|label:{alphabet}`](/docs/ja/application-maps-static#markerstypealabelalphabet2) 英字マーカーを表示する地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.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' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`markers=type:t|label:{tooltip}`](/docs/ja/application-maps-static#markerstypetlabeltooltip2) ツールチップマーカーを表示する地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.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' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` #### [`markers=type:e`](/docs/ja/application-maps-static#markerstypee2) カスタムマーカーを表示する地図画像をリクエストするサンプルコードは次の通りです。 ``` curl --location --request GET 'https://maps.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' \ --header 'x-ncp-apigw-api-key-id: {API Key ID}' \ --header 'x-ncp-apigw-api-key: {API Key}' ``` ## レスポンス レスポンス形式を説明します。 ### レスポンスステータスコード Maps APIで共通して使用されるレスポンスステータスコードの詳細は、[Mapsのレスポンスステータスコード](/docs/ja/application-maps-overview#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)をご参照ください。 ### レスポンス例 レスポンスのサンプルコードは次の通りです。 #### [`center`](/docs/ja/application-maps-static#center1) 中心座標(`center`)が`127.1054221,37.3591614`の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_center](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_center.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`level`](/docs/ja/application-maps-static#level1) ズームレベル(`level`)が`11`の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_level](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_level.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`w`, `h`](/docs/ja/application-maps-static#wh1) サイズ(`w` x `h`)が300 x 200ピクセルの地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_wh](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_wh.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`maptype=basic`](/docs/ja/application-maps-static#maptypebasic1) 地図タイプ(`maptype`)が一般地図(`basic`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_maptype-basic](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_maptype-basic.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`maptype=traffic`](/docs/ja/application-maps-static#maptypetraffic1) 地図タイプ(`maptype`)が交通情報地図(`traffic`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_maptype-traffic](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_maptype-traffic.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`maptype=satellite`](/docs/ja/application-maps-static#maptypesatellite1) 地図タイプ(`maptype`)が衛星地図(`satellite`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_maptype-satellite](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_maptype-satellite.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`maptype=satellite_base`](/docs/ja/application-maps-static#maptypesatellite_base1) 地図タイプ(`maptype`)が衛星背景地図(`satellite_base`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_maptype-satellite_base](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_maptype-satellite_base.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`maptype=terrain`](/docs/ja/application-maps-static#maptypeterrain1) 地図タイプ(`maptype`)が地形図(`terrain`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_maptype-terrian](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_maptype-terrian.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`format=jpg`](/docs/ja/application-maps-static#formatjpg1) 画像形式(`format`)が`jpg`(`jpeg`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_format-jpg](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_format-jpg.jpg?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`format=png8`](/docs/ja/application-maps-static#formatpng81) 画像形式(`format`)が`png8`の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_format-png8](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_format-png8.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`format=png`](/docs/ja/application-maps-static#formatpng1) 画像形式(`format`)が`png`の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_format-png](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_format-png.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`scale=1`](/docs/ja/application-maps-static#scale11) 低解像度(`scale=1`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_scale1](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_scale1.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`scale=2`](/docs/ja/application-maps-static#scale21) 高解像度(`scale=2`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_scale2](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_scale2.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`lang=ko`](/docs/ja/application-maps-static#langko1) ラベル言語(`lang`)が韓国語(`ko`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_lang-ko](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_lang-ko.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`lang=en`](/docs/ja/application-maps-static#langen1) ラベル言語(`lang`)が英語(`en`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_lang-en](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_lang-en.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`lang=ja`](/docs/ja/application-maps-static#langja1) ラベル言語(`lang`)が日本語(`ja`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_lang-ja](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_lang-ja.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`lang=zh`](/docs/ja/application-maps-static#langzh1) ラベル言語(`lang`)が中国語(簡体字)(`zh`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_lang-zh](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_lang-zh.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`markers=size:tiny`](/docs/ja/application-maps-static#markerssizetiny1) 基本マーカーのサイズ(`size`)が`tiny`の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_markersize-tiny](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_markersize-tiny.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`markers=size:small`](/docs/ja/application-maps-static#markerssizesmall1) 基本マーカーのサイズ(`size`)が`small`の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_markersize-small](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_markersize-small.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`markers=size:mid`](/docs/ja/application-maps-static#markerssizemid1) 基本マーカーのサイズ(`size`)が`mid`の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_markersize-mid](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_markersize-mid.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`markers=size:mid&markers=size:small&markers=size:tiny`](/docs/ja/application-maps-static#markerssizemidsmalltiny1) サイズ(`size`)が`mid`、`small`、`tiny`の基本マーカーをすべて表示する地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_markersize-midsmalltiny](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_markersize-midsmalltiny.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`markers=color:red`](/docs/ja/application-maps-static#markerscolorred1) 基本マーカーの色(`color`)が赤(`red`)の地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_markers-color](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_markers-color.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`markers=viewSizeRatio:0.5`](/docs/ja/application-maps-static#markersviewSizeRatio051) 基本マーカーサイズの比率(`viewSizeRatio`)を0.5倍(`0.5`)に変更する地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_markersizeratio1](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_markersizeratio1.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`markers=viewSizeRatio:2.0`](/docs/ja/application-maps-static#markersviewSizeRatio201) 基本マーカーサイズの比率(`viewSizeRatio`)を2倍(`2.0`)に変更する地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_markersizeratio2](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_markersizeratio2.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`markers=type:n|label:{number}`](/docs/ja/application-maps-static#markerstypenlabelnumber1) 数字マーカーを表示する地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_markerslabel-number](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_markerslabel-number.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`markers=type:a|label:{alphabet}`](/docs/ja/application-maps-static#markerstypealabelalphabet1) 英字マーカーを表示する地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_markerslabel-alphabet](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_markerslabel-alphabet.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`markers=type:t|label:{tooltip}`](/docs/ja/application-maps-static#markerstypetlabeltooltip1) ツールチップマーカーを表示する地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_markerslabel-text](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_markerslabel-text.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D) #### [`markers=type:e`](/docs/ja/application-maps-static#markerstypee1) カスタムマーカーを表示する地図画像のレスポンスのサンプルコードは次の通りです。 ![ai-naver-mapsstaticmap-raster_markers-custom](https://cdn.document360.io/da0368a0-4444-4862-a528-42f78876f9e6/Images/Documentation/ai-naver-mapsstaticmap-raster_markers-custom.png?sv=2026-02-06&spr=https&st=2026-10-30T08%3A07%3A32Z&se=2026-10-30T09%3A07%3A32Z&sr=c&sp=r&sig=TF4XupS%2BkZBP%2F5IRyN8hYXJLXNIlhTDdCGjaISmCSMI%3D)