Static Map

참고

네이버 클라우드 플랫폼의 상품 사용 방법을 보다 상세하게 제공하고, 다양한 API의 활용을 돕기 위해 [설명서][API 참조서]를 구분하여 제공하고 있습니다.

Static Map API 참조서 바로가기 >>
Static Map 설명서 바로가기 >>

개요

요청된 URL 매개변수를 기반으로 웹 페이지에 표시할 수 있는 이미지로 지도를 반환합니다.

공통 설정

클라이언트 아이디는 네이버 클라우드 플랫폼 콘솔에서 애플리케이션을 등록해 발급받습니다.

  1. 콘솔의 AI·Application Service > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >

  2. AI·Application Service > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.

  3. AI·Application Service > AI·NAVER API > Application변경 화면에서 Static Map가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

API URL

메서드 요청 URI 응답 형식 인증 방식
GET https://naveropenapi.apigw.ntruss.com/map-static/v2/raster Binary(PNG/JPG 이미지 형식) ID-KEY 인증
GET https://naveropenapi.apigw.ntruss.com/map-static/v2/raster-cors Binary(PNG/JPG 이미지 형식) HTTP Referer 인증

요청 헤더

헤더 명 설명
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}

에러 코드

{
  "error": {
    "errorCode": "300",
    "message": "Not Found Exception"
  }
}

공통 에러

HttpStatusCode ErrorCode ErrorMessage Description
400 100 Bad Request Exception protocol(https), endocing(UTF-8) 등 request 에러
401 200 Authentication Failed 인증실패
401 210 Permission Denied 권한없음
404 300 Not Found Exception 권한없음
429 400 Quota Exceeded Quota 초과
429 410 Throttle Limited Rate 초과
429 420 Rate Limited Rate 초과
413 430 Request Entity Too Large conent-length 초과 (10MB)
503 500 Endpoint Error 엔드포인트 연결에러
504 510 Endpoint Timeout 엔드포인트 연결시간 초과
500 900 Unexpected Error 예외처리가 안된 에러

API 에러

HttpStatusCode ErrorCode ErrorMessage Description
400 100 Bad request 요청에 유효하지 않은 파라미터가 있음을 나타냅니다.
500 900 Internal error 서버 내부에 오류가 발생했음을 의미합니다.
지속적으로 문제 발생 시 공식 문의 채널을 확인해 주세요.
503 500 Service Unavailable 시스템 유지보수로 인해 일시적인 응답 불가 상태입니다.
잠시 후 재시도하시기 바랍니다.
504 510 Gateway Timeout 시스템 과부하로 인해 일시적인 응답 불가 상태입니다.
잠시 후 재시도하시기 바랍니다.

오퍼레이션

아쉬운 점이 있다면 이야기해 주세요.
0/5000
내용을 입력해 주세요
의견 보내기