--- title: "Maps 문제 해결" slug: "maps-troubleshoot" updated: 2026-07-23T09:02:16Z published: 2026-07-23T09:02:16Z canonical: "guide-fin.ncloud-docs.com/maps-troubleshoot" --- > ## Documentation Index > Fetch the complete documentation index at: https://guide-fin.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # Maps 문제 해결 Maps 서비스를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오. ## Web Dynamic Map에서 API 인증 오류 Web Dynamic Map에서 API 인증 오류가 발생합니다. #### 원인 - 서비스 URL에는 포트 번호 및 URI이 포함되어 있습니다. - 스크립트 내 파라미터가 잘못 입력되었습니다. #### 해결 방법 **서비스 URL 확인** 서비스 URL은 포트 번호 및 URI를 제외한 호스트 도메인만 등록해야 합니다. 서비스 URL을 확인하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** > **Application** 메뉴를 차례대로 클릭해 주십시오. 2. App 이름을 확인한 후, **[인증 정보]** 버튼을 클릭해 주십시오. 3. **서비스환경** 영역의 **Web 서비스 URL** 정보를 확인해 주십시오. 4. 서비스 URL에 포트 번호 및 URI가 포함되어 있을 경우, 삭제해 주십시오. <예시> - http://localhost:8080 → http://localhost - http://127.0.0.1/main → http://127.0.0.1 **스크립트 내 파라미터 확인** 스크립트 내 파라미터를 확인하고 수정해 주십시오. - ClientID → ncpClientID 참고 NAVER 지도 API v3 로드에 관한 자세한 내용은 [NAVER 지도 API v3 로드하기](https://navermaps.github.io/maps.js.ncp/docs/tutorial-2-Getting-Started.html)를 참조해 주십시오. ## Web Dynamic Map에서 주소 검색 시 429 오류 Web Dynamic Map에서 주소 검색 시 429 (too many request) 오류가 발생합니다. #### 원인 주소를 좌표로 변환하는 API를 호출하려면 Geocoding 서비스를 반드시 신청해야 합니다. Geocoding 서비스를 신청하지 않은 경우, 오류가 발생할 수 있습니다. #### 해결 방법 Geocoding 서비스를 신청하는 방법은 다음과 같습니다. 1. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** > **Application** 메뉴를 차례대로 클릭해 주십시오. 2. Maps 애플리케이션 이름을 확인한 후, **[수정]** 버튼을 클릭해 주십시오. 3. **Geocoding**의 체크 박스를 선택하여 클릭해 주십시오. 4. **[저장]** 버튼을 클릭해 주십시오. ## Android 9 이상 버전에서 Web Dynamic Map 호출 시 500 오류 Android 9 이상의 버전에서 Web Dynamic Map 호출 시 500 오류가 발생합니다. #### 원인 해당 현상은 지도 API와 무관하며, Android 9 이상의 버전에서는 http 평문 통신이 차단되기 때문에 발생하는 현상입니다. #### 해결 방법 - 지도 화면이 있는 HTML을 file://로 사용하지 않고 TLS가 적용된(https) 웹서버에 호스팅해 주십시오. - 앱에서 [네트워크 보안 구성](https://developer.android.com/training/articles/security-config)을 통해 *.map.naver.com, *.map.naver.net에 대한 평문 통신을 허용해 주십시오. 다만 안드로이드에서는 모든 통신에 TLS 적용을 권장하므로 평문 통신을 허용하는 방법은 권고하지 않습니다. ## 좌표 검색과 주소 검색 시 마커 위치가 다름 지도의 좌표 검색과 주소 검색 시 마커 위치가 다릅니다. #### 원인 및 해결 방법 좌표 검색 시에는 지도의 정확한 위치 값을 마커 위치로 표기하고, 주소 검색 시에는 해당 주소 범위 중 가운데 지점을 마커로 표하므로 좌표 검색과 주소 검색의 마커 위치가 다를 수 있습니다. ## 한글 도메인 인증 오류 Web Dynamic Map 서비스에서 한글 도메인이 인증되지 않습니다. #### 원인 브라우저마다 한글 도메인을 처리하는 방식이 다르므로 인증 오류가 발생할 수 있습니다. #### 해결 방법 한글 도메인을 Application Web 서비스 URL에 등록해야 하는 경우, 한글 도메인을 퓨니코드로 변환한 값을 등록해 주십시오. 1. [퓨니코드 변환기](https://xn--3e0bx5euxnjje69i70af08bea817g.xn--3e0b707e/jsp/resources/domainInfo/punyCode.jsp)를 참조하여 한글 도메인을 퓨니코드로 변환해 주십시오. 2. 네이버 클라우드 플랫폼 콘솔에서 **Menu** > **All Services** > **AI·NAVER API** > **AI·NAVER API** > **Application** 메뉴를 차례대로 클릭해 주십시오. 3. Maps 애플리케이션의 Web 서비스 URL에 퓨니코드 변환기로 변환된 값을 등록해 주십시오. ## CORS 오류 Maps API 호출 시 CORS 오류가 발생합니다. #### 원인 Maps API가 JavaScript 환경에서 보안 상의 이슈로 CORS (Cross-Origin Resource Sharing)를 허용하지 않을 경우, 다음 오류가 발생할 수 있습니다. `Access to XMLHttpRequest at '' has been blocked by CORS policy: Response to preflight request doesn't pass access control check: It does not have HTTP ok status.` #### 해결 방법 JavaScript 환경인 경우, 동일한 도메인을 가진 Backend 서버를 따로 두고 해당 서버에서 API를 호출하는 방식을 사용해 주십시오. ## 둘러볼 콘텐츠 네이버 클라우드 플랫폼에서는 고객에게 도움을 주기 위해 다양한 방식으로 정보를 제공하고 있습니다. Maps 서비스 이용 시 활용할 수 있는 유용한 콘텐츠를 안내합니다. - 자주 하는 질문: [Maps 자주 하는 질문](https://www.fin-ncloud.com/support/faq/prod?categoryCode2=APP&categoryCode3=SV_0126&page=1) - NAVER Map's Github: [NAVER Map's Enterprise API](https://navermaps.github.io/maps.js.ncp/docs/index.html) 참고 이 가이드에서 필요한 정보를 찾지 못했거나 추가로 필요한 정보가 있으신 경우, 언제든지 아래의 피드백 아이콘을 클릭하여 의견을 보내 주십시오. 전달해 주신 의견을 참고하여 더 유용한 정보를 제공하겠습니다.