Maps 문제 해결

Classic/VPC 환경에서 이용 가능합니다.

Maps 서비스를 이용하면서 다음과 같은 문제를 겪을 수 있습니다. 문제별 원인과 해결 방법을 확인하고 적절하게 조치해 주십시오.

Web Dynamic Map에서 API 인증 오류

Web Dynamic Map에서 API 인증 오류가 발생합니다.

원인

• 서비스 URL에는 포트 번호 및 URI이 포함되어 있습니다.
• 스크립트 내 파라미터가 잘못 입력되었습니다.

해결 방법

서비스 URL 확인
서비스 URL은 포트 번호 및 URI를 제외한 호스트 도메인만 등록해야 합니다. 서비스 URL을 확인하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > 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

Web Dynamic Map에서 주소 검색 시 429 오류

Web Dynamic Map에서 주소 검색 시 429 (too many request) 오류가 발생합니다.

원인

주소를 좌표로 변환하는 API를 호출하려면 Geocoding 서비스를 반드시 신청해야 합니다. Geocoding 서비스를 신청하지 않은 경우, 오류가 발생할 수 있습니다.

해결 방법

Geocoding 서비스를 신청하는 방법은 다음과 같습니다.

1. 네이버 클라우드 플랫폼 콘솔에서 Services > 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) 웹서버에 호스팅해 주십시오.
• 앱에서 네트워크 보안 구성을 통해 *.map.naver.com, *.map.naver.net에 대한 평문 통신을 허용해 주십시오. 다만 안드로이드에서는 모든 통신에 TLS 적용을 권장하므로 평문 통신을 허용하는 방법은 권고하지 않습니다.

좌표 검색과 주소 검색 시 마커 위치가 다름

지도의 좌표 검색과 주소 검색 시 마커 위치가 다릅니다.

원인 및 해결 방법

좌표 검색 시에는 지도의 정확한 위치 값을 마커 위치로 표기하고, 주소 검색 시에는 해당 주소 범위 중 가운데 지점을 마커로 표하므로 좌표 검색과 주소 검색의 마커 위치가 다를 수 있습니다.

Reverse Geocoding 기능

Mobile Dynamic Map v3에서 Reverse Geocoding(좌표 값을 주소로 반환 받는) 기능이 없습니다.

원인

Mobile Dynamic Map SDK v2에서는 Reverse Geocoding 기능이 포함되어 있으나, Mobile Dynamic Map SDK v3은 Reverse Geocoding 기능이 없습니다.

해결 방법

해당 기능을 사용하려면 Reverse Geocoding API를 직접 호출해야 합니다. Reverse Geocoding API에 대한 자세한 설명은 Reverse Geocoding API를 참조해 주십시오.

한글 도메인 인증 오류

Web Dynamic Map 서비스에서 한글 도메인이 인증되지 않습니다.

원인

브라우저마다 한글 도메인을 처리하는 방식이 다르므로 인증 오류가 발생할 수 있습니다.

해결 방법

한글 도메인을 Application Web 서비스 URL에 등록해야 하는 경우, 한글 도메인을 퓨니코드로 변환한 값을 등록해 주십시오.

1. 퓨니코드 변환기를 참조하여 한글 도메인을 퓨니코드로 변환해 주십시오.
2. 네이버 클라우드 플랫폼 콘솔에서 Services > 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 자주 하는 질문
• 개발자 포럼: Maps 개발자 포럼
• NAVER Map's Github: NAVER Map's Enterprise API