> For the complete documentation index, see [llms.txt](https://help.qshop.ai/customer_support/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.qshop.ai/customer_support/guide/partner/navermap.md).

# 네이버 지도

네이버 지도 블록을 사용하여 사용자에게 위치 정보를 알려줄 수 있습니다.

네이버 지도는 월 1,000만 건 무료로 제공이 되고 있습니다. 사이트에 지도가 표시 될 경우 1건이 차감이 되며, 새로고침 시에도 1건이 차감이 됩니다. 즉, 지도가 적용이 된 페이지를 월 1,000만번 볼 수 있는 것이며, 한도 초과 시 네이버 클라우드 플랫폼 가입 시 등록한 신용카드 정보로 건당 0.1원 이용 요금이 발생하게 됩니다.

{% hint style="info" %}
네이버 지도 API의 이용량 정책 및 상세요금은 아래 링크를 참고 부탁드립니다.

**\[**[**Maps API 무료 이용량 정책**](https://www.ncloud.com/support/faq/prod/2828)**] \[**[**Maps API 상세 요금 안내**](https://www.ncloud.com/product/applicationService/maps?region=KR#pricing)**]**
{% endhint %}

네이버 지도 사용을 위해서는 네이버 클라우드 플랫폼 가입 및 네이버 지도 API설정을 해주셔야합니다.

클라우드 플랫폼 가입 후 지도 블록 연동 과정은 아래 가이드를 참고 부탁드립니다.

{% hint style="info" %}
큐샵 도메인( \_\_\_.qshop.ai)만 사용할 경우 **\[5. 네이버 지도 블록 추가하기]** 과정만 진행을 해주시면 됩니다.
{% endhint %}

<details>

<summary><strong>1. 네이버 클라우드 플랫폼 가입하기</strong></summary>

1. [**네이버 클라우드 플랫폼**](https://www.ncloud.com/)에 접속합니다.
2. 오른쪽 위 회원 가입 버튼을 클릭합니다.

   <figure><img src="/files/6w2aNpLqtCVId4jECZIj" alt=""><figcaption></figcaption></figure>
3. 계정으로 사용 할 이메일 주소를 입력합니다.
4. 가입 유형 항목의 거주 국가, 회원 유형, 사용 언어를 선택합니다.\
   💡거주 국가 선택에 따라 결제 통화가 결정되며, 이후 변경이 불가능합니다.

   <figure><img src="/files/c9VzCX5s4IUhb2BKHSbi" alt=""><figcaption></figcaption></figure>
5. 약관 동의를 진행합니다.
6. 로그인에 사용 할 아이디와 비밀번호를 입력합니다.\
   💡이 과정에서 이메일 인증을 거치게 되며, 인증 후 다음 버튼을 클릭합니다.

   <figure><img src="/files/0frKIU7c2l8SLCYnSbIi" alt=""><figcaption></figcaption></figure>
7. 계정 소유자 정보의 이름, 휴대 전화번호, 주소를 입력합니다.\
   💡위 과정에서 회원유형을 “사업자 회원”으로 선택했을 경우 입력하는 소유자 정보가 달라질 수 있습니다.

   <figure><img src="/files/h8FBFInkGAw4Sdbt5wKC" alt=""><figcaption></figcaption></figure>
8. 회원 가입이 완료 되었습니다.\
   이제 **\[2. 결제수단 등록하기]** 과정을 진행해주시면 됩니다.

   <figure><img src="/files/h6fa5cQVCNkrpe1CrZww" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>2. 결제수단 등록하기</strong></summary>

1. 회원 가입 완료 페이지의 **\[결제 수단 등록]** 버튼을 클릭합니다.

   <figure><img src="/files/GEMZft0KJB2h39PzQalE" alt=""><figcaption></figcaption></figure>

   💡만약 페이지를 벗어났다면, 클라우드 플랫폼 오른쪽 위 **\[결제수단등록]**&#xBC84;튼을 통해 진행이 가능합니다.

   <figure><img src="/files/BRfjMl6TOwookgKyfPXd" alt=""><figcaption></figcaption></figure>
2. 결제 수단을 선택합니다.

   💡결제수단은 신용카드 및 체크카드만 선택이 가능합니다.
3. 휴대폰 인증하기 버튼을 클릭하여 약관 동의 및 인증 과정을 진행합니다.
4. 인증이 완료 된 후 **카드번호**와 **유효기간**을 입력하여, 결제 수단을 등록합니다.\
   💡등록 과정에서는 과금이 발생하지 않습니다.
5. 결제수단 등록이 완료됩니다.

</details>

<details>

<summary><strong>3. Application 만들기</strong></summary>

1. 클라우드 플랫폼 오른쪽 위 **\[콘솔]**&#xBC84;튼을 클릭합니다.

<figure><img src="/files/8OrRZy3NuWsFCszpwPaw" alt=""><figcaption></figcaption></figure>

2. 왼쪽 메뉴의 **\[Services > Application Services > Maps]**&#xB97C; 클릭합니다

<figure><img src="/files/B3Fo5lhNkfSnfrpbYqzj" alt=""><figcaption></figcaption></figure>

3. Maps 페이지로 이동한 후 아래 **\[+ 이용 신청]** 버튼을 클릭하여, 약관 동의를 진행합니다.\
   만약 이용 신청이 된 상태라면, 다음 과정으로 넘어갑니다.

<figure><img src="/files/M4qyQixCDXQD4dqaW4ex" alt=""><figcaption></figcaption></figure>

4.이용 신청 및 약관 동의를 진행한 후 **\[+ Application 등록]** 버튼을 클릭합니다.

<figure><img src="/files/Y1PfjRNJcheUIZVf4YB2" alt=""><figcaption></figcaption></figure>

5. **Application 이름**을 입력합니다.

{% hint style="info" %}
영문자, 숫자, 특수문자(-)만 입력할 수 있으며, 영문자로 시작해야 합니다.
{% endhint %}

6. API 선택 항목 중  **Dynamic Map** 과 **Geocoding** 두 가지를 선택합니다.

<figure><img src="/files/9hp9DphCfi2WwlQEyvxd" alt=""><figcaption></figcaption></figure>

7. 서비스 환경 등록 항목에, 아래 내용을 참고하여 네이버 지도를 표시할 모든 도메인 주소를 추가합니다.

<figure><img src="/files/S6XGQT9HJ8nwhrhA78lY" alt=""><figcaption></figcaption></figure>

* Web 서비스 URL 입력 칸에 <http://qshop.ai> 를 입력하고, **\[＋ 추가]** 버튼을 클릭합니다.
* Web 서비스 URL 입력 칸에 사용하시는 커스텀 도메인을 예시와 같은 형태로 입력하고, **\[＋ 추가]**&#xBC84;튼을 클릭합니다. (예 - <http://mydomain.com>)

{% hint style="info" %}
한글도메인을 사용하시는 경우, 아래 링크를 통해 퓨니코드로 변환하여 등록을 합니다.\
\[[한글도메인 퓨니코드 변환하기](https://www.inplaza.com/puny/index.php)]
{% endhint %}

8. 입력한 정보를 확인하신 후 **\[등록]**&#xBC84;튼을 클릭하여 Application 생성을 마무리 합니다.

</details>

<details>

<summary><strong>4. Application key 적용하기</strong></summary>

1. \[**3.** **Application 만들기]**&#xACFC;정에서 등록한 Application의 **\[인증 정보]** 버튼을 클릭합니다.

<figure><img src="/files/JGjHzi4xtMd4xiSfwyU7" alt=""><figcaption></figcaption></figure>

2. Application key 항목의 **Client ID** 와 **Client Secret** 값을 복사합니다.

<figure><img src="/files/MK75u5lsCzpp8GTNPFFT" alt=""><figcaption></figcaption></figure>

3. 4-3. 사이트 **\[관리자 페이지 > 성장센터 > 네이버]** 페이지의 **네이버 지도** 탭으로 이동합니다.
4. 사용함 체크를 한 후 \[2번 과정]에서 복사한 **Client ID 와 Client Secret** 값을 붙여넣고 오른쪽 위 저장 버튼을 클릭합니다.

<figure><img src="/files/ozC2CR6MM8fCLUESdnWl" alt=""><figcaption></figcaption></figure>

</details>

<details>

<summary><strong>5. 네이버 지도 블록 추가하기</strong></summary>

1. 에디터에 들어갑니다.
2. 왼쪽 추가 패널을 통해 네이버 지도 블록을 추가합니다.
3. \[[네이버 지도 블록](/customer_support/guide/design/editor/contents/advanced/navermap.md)] 가이드를 참고하여 지도 등록 및 설정을 합니다.

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.qshop.ai/customer_support/guide/partner/navermap.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.