Static Map 개요
- 인쇄
- PDF
Static Map 개요
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
요청된 URL 매개변수를 기반으로 웹 페이지에 표시할 수 있는 이미지로 지도를 반환합니다.
공통 설정
클라이언트 아이디는 네이버 클라우드 플랫폼 콘솔에서 애플리케이션을 등록해 발급받습니다.
콘솔의 AI·NAVER API > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >
AI·NAVER API > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.
AI·NAVER API > AI·NAVER API > Application의 변경 화면에서 Static Map가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.
API URL
메서드 | 요청 URI | 응답 형식 | 인증 방식 |
---|---|---|---|
GET | https://naveropenapi.apigw.gov-ntruss.com/map-static/v2/raster | Binary(PNG/JPG 이미지 형식) | ID-KEY 인증 |
GET | https://naveropenapi.apigw.gov-ntruss.com/map-static/v2/raster-cors | Binary(PNG/JPG 이미지 형식) | HTTP Referer 인증 |
요청 헤더
헤더 명 | 설명 |
---|---|
X-NCP-APIGW-API-KEY-ID | 앱 등록 시 발급받은 Client IDX-NCP-APIGW-API-KEY-ID:{Client ID} |
X-NCP-APIGW-API-KEY | 앱 등록 시 발급 받은 Client SecretX-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 | 시스템 과부하로 인해 일시적인 응답 불가 상태 잠시 후 재시도 바람 |
이 문서가 도움이 되었습니까?