Login
      내용 x
      Static Map API
        • 인쇄
        • PDF
        내용

        Static Map API

          • 인쇄
          • PDF
          기사 요약

          VPC 환경에서 이용 가능합니다.

          JavaScript를 사용하거나 동적 페이지를 로드하지 않고 입력한 좌표를 기준으로 지정한 크기의 네이버 지도 이미지(Static Map)를 불러옵니다. 지원되는 파라미터(지도 유형, 이미지 형식, 해상도, 마커 등)를 통해 지도 이미지를 원하는 대로 설정할 수 있습니다.

          요청

          요청 형식을 설명합니다.

          메서드URI설명
          GET/rasterID-KEY 인증
          GET/raster-corsHTTP Referer 인증
          참고
          • HTTP Refere 인증 방식을 사용하여 API를 호출하려면 Application 등록 시 Web 서비스 URL을 반드시 입력해야 합니다. 다음 가이드를 참조해 주십시오.
          • HTTP Referer 인증 방식을 사용할 경우 다음과 같이 HTML 태그를 추가해 요청할 수 있습니다.
            <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={API Gateway API Key ID}">

          요청 헤더

          Maps API에서 공통으로 사용하는 헤더에 대한 정보는 Maps 공통 헤더를 참조해 주십시오.

          요청 쿼리 파라미터

          요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

          필드타입필수 여부설명
          crsStringOptional좌표 체계
          • 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: 구글 맵
            • EPSG:5179: Korea 2000 / Unified CS
          centerStringConditional중심 좌표(X 좌표,Y 좌표)
          • X 좌표, Y 좌표 순서는 좌표 체계 정의에 따름
            • <예시> WGS84 경위도 좌표 체계: center=경도,위도
          • markers 미입력 시 반드시 입력
          • level 입력 시 반드시 입력
          levelIntegerConditional줌 레벨
          • 0~20
          • markers 미입력 시 반드시 입력
          • level 입력 시 반드시 입력
          w, hIntegerRequired가로, 세로 이미지 크기
          • w=int&h=int 형식으로 1~1,024 픽셀 지원
            • w: 가로 크기
            • h: 세로 크기
          maptypeStringOptional지도 유형
          • basic (기본값) | traffic | satellite | satellite_base | terrain
            • basic: 일반 지도
            • traffic: 교통 정보 지도(일반 지도 기반)
            • satellite: 위성 지도
            • satellite_base: 위성 배경 지도
            • terrain: 지형도
          formatStringOptional지도 이미지 형식
          • jpg/jpeg (기본값) | png8 | png
            • jpg/jpeg: 압축 품질 85%, 24비트
            • png8: 8비트
            • png: 24비트
          scaleIntegerOptional해상도
          • 1 (기본값) | 2
            • 1: 저해상도용 이미지 요청. 요청한 w, h 크기의 이미지를 256 x 256 타일 기반으로 생성해서 반환
            • 2: 고해상도용 이미지 요청. 요청한 w, h 크기의 이미지를 512 x 512 타일 기반으로 생성해서 반환(scale=1과 동일한 지도 서비스 지역이 반환되지만 각 크기에 포함되는 픽셀은 2배 증가)
          markersStringConditional마커 설정
          • center, level 미입력 시 반드시 입력
          • center, level 미입력 시 설정한 마커에 최적화된 줌 레벨과 위치로 지도 표시
          • 최대 20개 입력 가능
          • '| (Pipe char)'로 구분하여 옵션 설정 가능
          • 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
          langStringOptional라벨 언어
          • ko (기본값) | en | ja | zh
            • ko: 한국어
            • en: 영어
            • ja: 일본어
            • zh: 중국어 간체
          dataversionStringOptional버전 정보
          • Static Map API의 이미지 캐싱으로, 클라이언트에서 동일 URL 요청 시 원본 서버의 배경 타일 업데이트가 반영되지 않는 문제를 해결하기 위해 입력
          • 배경 타일에 대한 최신성 이슈가 있는 경우에 입력 권장
          • 버전 정보가 주기적으로 업데이트되므로 작업의 효율성을 위해 배치성 작업을 권장
          • 권장 업데이트 주기(interval)에 따라 일일 확인 횟수를 설정하여 정해진 시간에 확인한 버전 정보를 저장한 후 Static Map API 호출 시 사용하는 것을 권장
          • Data Version API를 통해 version 확인

          markers

          markers에 대한 설명은 다음과 같습니다.

          필드값필수 여부설명
          typeStringOptional마커 유형
          • d (기본값) | n | a | t | e
            • d: 기본
            • n: 숫자
            • a: 알파벳
            • t: 툴팁
            • e: 커스텀
          sizeStringOptional마커 크기
          • tiny | small | mid (기본값)
          • tiny일 경우 label을 입력하더라도 표시되지 않음
          colorStringOptional마커 색상
          • 사전 정의 색상 값 또는 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
          labelStringOptional마커 라벨
          • A~Z, 0~9
          • 미입력 시 마커만 표시
          • type이 tiny인 경우에는 입력하더라도 표시되지 않음
          posStringRequired마커 위치(X좌표,Y좌표)
          • ','로 구분하여 여러 개의 좌표 입력 가능
          • <예시> pos:126.9810479,2037.5695075,2C126.9950680,2037.5672557
          viewSizeRatioFloatOptional마커 크기 비율
          • type과 size별 기본 디자인을 기반으로 마커 크기 조절
          • 0.1~2.0 (기본값: 0.1)
          • 소수점 첫째 자리까지 입력 가능하며 0.1보다 작으면 0.1, 2.0보다 크면 2.0 입력
          iconStringConditional커스텀 마커 아이콘 URL
          • type이 e인 경우 반드시 입력
          • PNG, SVG 파일 지원
          • <예시> icon:http://aaa/bbb.svg
          anchorString, DoubleOptional마커 표시 위치
          • 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 픽셀이며, 레티나 디스플레이 대응 고해상도(scale=2)로 요청할 경우 128x128 픽셀입니다.
          • 커스텀 마커 요청 URL에서 2초 이내에 응답이 없으면 작업을 중지합니다.
          • 커스텀 마커는 최대 1일간 내부 캐시로 유지될 수 있습니다. 따라서 동일한 URL에 마커 이미지만 달라진 경우에는 최대 1일까지 변경된 이미지가 반영되지 않을 수 있습니다.

          Data Version API

          Data Version API에 대한 설명은 다음과 같습니다.

          • 요청
            메서드URL
            GEThttps://naveropenapi.apigw.ntruss.com/map-static/v2/lastversion
          • 응답
            필드타입필수 여부설명
            versionString-버전 정보
            • major_version.minor_version 형식
            • major_version: 정기 업데이트 시 변경, 원타일 맵 메이저 버전과 동일하게 유지(2달에 1번 업데이트)
            • minor_version: 부분 업데이트 시 버전 올림(1달에 1~2번 업데이트)
            intervalLong-권장 업데이트 주기(초)

          요청 예시

          요청 예시는 다음과 같습니다.

          예시

          이 가이드에서는 ID-KEY 인증 방식을 사용하는 예시를 제공합니다.

          center

          중심 좌표(center)가 127.1054221,37.3591614인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=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

          줌 레벨(level)이 11인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=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

          크기(w x h)가 300 x 200 픽셀인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=200&center=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

          지도 유형(maptype)이 일반 지도(basic)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=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

          지도 유형(maptype)이 교통 정보 지도(traffic)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=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

          지도 유형(maptype)이 위성 지도(satellite)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=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

          지도 유형(maptype)이 위성 배경 지도(satellite_base)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=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

          지도 유형(maptype)이 지형도(terrain)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=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

          이미지 형식(format)이 jpg(jpeg)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=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

          이미지 형식(format)이 png8인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=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

          이미지 형식(format)이 png인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=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

          저해상도(scale=1)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=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

          고해상도(scale=2)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?w=300&h=300&center=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

          라벨 언어(lang)가 한국어(ko)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?crs=EPSG:4326&w=375&h=258&center=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

          라벨 언어(lang)가 영어(en)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?crs=EPSG:4326&w=375&h=258&center=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

          라벨 언어(lang)가 일본어(ja)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?crs=EPSG:4326&w=375&h=258&center=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

          라벨 언어(lang)가 중국어 간체(zh)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.apigw.ntruss.com/map-static/v2/raster?crs=EPSG:4326&w=375&h=258&center=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

          기본 마커의 크기(size)가 tiny인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.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

          기본 마커의 크기(size)가 small인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.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

          기본 마커의 크기(size)가 mid인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET 'https://naveropenapi.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

          크기(size)가 mid, small, tiny인 기본 마커를 모두 표시하는 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET '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' \
--header 'x-ncp-apigw-api-key-id: {API Key ID}' \
--header 'x-ncp-apigw-api-key: {API Key}'

          markers=color:red

          기본 마커의 색(color)이 빨간색(red)인 지도 이미지를 요청하는 예시는 다음과 같습니다.

          • 사전 정의 색상 값으로 요청
            curl --location --request GET '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' \
--header 'x-ncp-apigw-api-key-id: {API Key ID}' \
--header 'x-ncp-apigw-api-key: {API Key}'
          • 24 비트 색상 값으로 요청
            curl --location --request GET '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' \
--header 'x-ncp-apigw-api-key-id: {API Key ID}' \
--header 'x-ncp-apigw-api-key: {API Key}'

          markers=viewSizeRatio:0.5

          기본 마커 크기의 비율(viewSizeRatio)을 0.5배(0.5)로 변경하는 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET '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' \
--header 'x-ncp-apigw-api-key-id: {API Key ID}' \
--header 'x-ncp-apigw-api-key: {API Key}'

          markers=viewSizeRatio:2.0

          기본 마커 크기의 비율(viewSizeRatio)을 2배(2.0)로 변경하는 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET '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' \
--header 'x-ncp-apigw-api-key-id: {API Key ID}' \
--header 'x-ncp-apigw-api-key: {API Key}'

          markers=type:n|label:{number}

          숫자 마커를 표시하는 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET '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' \
--header 'x-ncp-apigw-api-key-id: {API Key ID}' \
--header 'x-ncp-apigw-api-key: {API Key}'

          markers=type:a|label:{alphabet}

          알파벳 마커를 표시하는 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET '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' \
--header 'x-ncp-apigw-api-key-id: {API Key ID}' \
--header 'x-ncp-apigw-api-key: {API Key}'

          markers=type:t|label:{tooltip}

          툴팁 마커를 표시하는 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET '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' \
--header 'x-ncp-apigw-api-key-id: {API Key ID}' \
--header 'x-ncp-apigw-api-key: {API Key}'

          markers=type:e

          커스텀 마커를 표시하는 지도 이미지를 요청하는 예시는 다음과 같습니다.

          curl --location --request GET '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' \
--header 'x-ncp-apigw-api-key-id: {API Key ID}' \
--header 'x-ncp-apigw-api-key: {API Key}'

          응답

          응답 형식을 설명합니다.

          응답 상태 코드

          응답 상태 코드에 대한 설명은 다음과 같습니다.

          HTTP 상태 코드코드메시지설명
          400100Bad request요청에 유효하지 않은 파라미터가 입력됨
          500900Internal errorMaps 서버 오류
          • 해결 방법: 잠시 후 다시 시도하고, 문제가 지속될 경우에는 고객 지원으로 문의
          503500Service Unavailable시스템 유지 보수로 일시적인 응답 불가 상태
          • 해결 방법: 잠시 후 다시 시도
          504510Gateway Timeout시스템 과부하로 일시적 응답 불가 상태
          • 해결 방법: 잠시 후 다시 시도
          참고

          Maps API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Maps 공통 응답 상태 코드를 참조해 주십시오.

          응답 예시

          응답 예시는 다음과 같습니다.

          center

          중심 좌표(center)가 127.1054221,37.3591614인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_center

          level

          줌 레벨(level)이 11인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_level

          w, h

          크기(w x h)가 300 x 200 픽셀인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_wh

          maptype=basic

          지도 유형(maptype)이 일반 지도(basic)인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_maptype-basic

          maptype=traffic

          지도 유형(maptype)이 교통 정보 지도(traffic)인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_maptype-traffic

          maptype=satellite

          지도 유형(maptype)이 위성 지도(satellite)인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_maptype-satellite

          maptype=satellite_base

          지도 유형(maptype)이 위성 배경 지도(satellite_base)인 지도 이미지의 응답 예시는 다음과 같습니다.

          ai-naver-mapsstaticmap-raster_maptype-satellite_base

          maptype=terrain

          지도 유형(maptype)이 지형도(terrain)인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_maptype-terrian

          format=jpg

          이미지 형식(format)이 jpg(jpeg)인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_format-jpg

          format=png8

          이미지 형식(format)이 png8인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_format-png8

          format=png

          이미지 형식(format)이 png인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_format-png

          scale=1

          저해상도(scale=1)인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_scale1

          scale=2

          고해상도(scale=2)인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_scale2

          lang=ko

          라벨 언어(lang)가 한국어(ko)인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_lang-ko

          lang=en

          라벨 언어(lang)가 영어(en)인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_lang-en

          lang=ja

          라벨 언어(lang)가 일본어(ja)인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_lang-ja

          lang=zh

          라벨 언어(lang)가 중국어 간체(zh)인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_lang-zh

          markers=size:tiny

          기본 마커의 크기(size)가 tiny인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_markersize-tiny

          markers=size:small

          기본 마커의 크기(size)가 small인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_markersize-small

          markers=size:mid

          기본 마커의 크기(size)가 mid인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_markersize-mid

          markers=size:mid&markers=size:small&markers=size:tiny

          크기(size)가 mid, small, tiny인 기본 마커를 모두 표시하는 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_markersize-midsmalltiny

          markers=color:red

          기본 마커의 색(color)이 빨간색(red)인 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_markers-color

          markers=viewSizeRatio:0.5

          기본 마커 크기의 비율(viewSizeRatio)을 0.5배(0.5)로 변경하는 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_markersizeratio1

          markers=viewSizeRatio:2.0

          기본 마커 크기의 비율(viewSizeRatio)을 2배(2.0)로 변경하는 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_markersizeratio2

          markers=type:n|label:{number}

          숫자 마커를 표시하는 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_markerslabel-number

          markers=type:a|label:{alphabet}

          알파벳 마커를 표시하는 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_markerslabel-alphabet

          markers=type:t|label:{tooltip}

          툴팁 마커를 표시하는 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_markerslabel-text

          markers=type:e

          커스텀 마커를 표시하는 지도 이미지의 응답 예시는 다음과 같습니다.
          ai-naver-mapsstaticmap-raster_markers-custom

          이 문서가 도움이 되었습니까?
          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