---
title: "Static Map 개요"
slug: "ai-naver-mapsstaticmap"
tags: ["Maps", "Static Map"]
updated: 2026-09-17T09:10:00Z
published: 2026-09-17T09:10:00Z
canonical: "api-fin.ncloud-docs.com/ai-naver-mapsstaticmap"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-fin.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Static Map 개요

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

## 공통 설정

클라이언트 아이디는 [NAVER Cloud Platform 콘솔](https://console.fin-ncloud.com/)에서 애플리케이션을 등록해 발급받습니다.

1. 콘솔의 **AI·NAVER API > AI·NAVER API > Application**에서 애플리케이션을 등록합니다. **[자세한 방법 보기](https://guide-fin.ncloud-docs.com/docs/naveropenapiv3-application) >**
2. **AI·NAVER API > AI·NAVER API > Application**에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.
3. **AI·NAVER API > AI·NAVER API > Application**의 **변경** 화면에서 **Static Map**가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

### API URL

| 메서드 | 요청 URI | 응답 형식 | 인증 방식 |
| --- | --- | --- | --- |
| GET | `https://naveropenapi.apigw-pub.fin-ntruss.com/map-static/v2/raster` | Binary(PNG/JPG 이미지 형식) | 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}` |

### 오류 코드

```
{
  "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 | content-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 | 서버 내부에 오류가 발생했음을 의미 지속적으로 문제 발생 시 [공식 문의 채널](https://www.fin-ncloud.com/support/question/service?parentCode=O2O_APP&code=O2O_APP_002) 확인 바람 |
| 503 | 500 | Service Unavailable | 시스템 유지보수로 인해 일시적인 응답 불가 상태 잠시 후 재시도 바람 |
| 504 | 510 | Gateway Timeout | 시스템 과부하로 인해 일시적인 응답 불가 상태 잠시 후 재시도 바람 |