MENU
      Maps 개요
        • PDF

        Maps 개요

        • PDF

        기사 요약

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

        Maps는 네이버 지도 콘텐츠와 데이터를 활용하여 위치 기반 서비스를 만들 수 있도록 지원하는 네이버 클라우드 플랫폼의 소프트웨어 인터페이스입니다. 정적 지도 이미지 생성, 경로 탐색, 주소 검색, 주소 변환 기능에 대한 API를 RESTful 형태로 제공하며, API를 호출하려면 API Gateway의 IAM 인증을 완료해야 합니다.

        Maps 공통 설정

        Maps API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

        요청

        공통 요청 형식을 설명합니다.

        API URL

        요청 API URL은 다음과 같습니다.

        Static Map: https://naveropenapi.apigw.ntruss.com/map-static/v2
        Directions 5: https://naveropenapi.apigw.ntruss.com/map-direction/v1
        Directions 15: https://naveropenapi.apigw.ntruss.com/map-direction-15/v1
        Geocoding: https://naveropenapi.apigw.ntruss.com/map-geocode/v2
        Reverse Geocoding: https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2
        HTTP

        요청 헤더

        헤더에 대한 설명은 다음과 같습니다.

        필드필수 여부설명
        x-ncp-apigw-api-key-idRequired네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client ID
        x-ncp-apigw-api-keyRequired네이버 클라우드 플랫폼 콘솔에서 Application 등록 후 발급받은 Client Secret
        참고

        네이버 클라우드 플랫폼 콘솔에서 Application을 등록하여 API 사용에 필요한 인증 정보(Client ID, Client Secret)를 발급받는 방법은 Maps 사용 가이드를 참조해 주십시오.
        콘솔에서 Application 등록 후 사용할 API가 선택되어 있는지 [수정] 버튼을 클릭하여 확인해 주십시오. 선택되어 있지 않으면 429 (Quota Exceed) 오류가 발생합니다.

        응답

        공통 응답 형식을 설명합니다.

        응답 상태 코드

        응답 상태 코드에 대한 설명은 다음과 같습니다.

        HTTP 상태 코드코드메시지설명
        400100Bad Request Exception요청 구문 오류
        401200Authentication Failed인증 실패
        401210Permission Denied접근 권한 없음
        404300Not Found Exception서버에서 찾을 수 없음
        413430Request Entity Too Large요청 크기(10 MB) 초과
        429400Quota Exceeded요청 할당량 초과
        429410Throttle Limited너무 빠르거나 잦은 요청
        429420Rate Limited특정 시간 동안 너무 많은 요청
        503500Endpoint Error엔트포인트 오류
        504510Endpoint Timeout엔트포인트 타임아웃
        500900Unexpected Error알 수 없는 오류
        참고

        네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

        Maps API

        Maps 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

        API설명
        Static Map정적 지도 이미지 생성
        Directions 5경로 탐색(경유지 최대 5개)
        Directions 15경로 탐색(경유지 최대 15개)
        Geocoding주소 검색
        Reverse Geocoding좌표를 주소로 변환

        Maps 연관 리소스

        Maps API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.


        이 문서가 도움이 되었습니까?

        What's Next
        Changing your password will log you out immediately. Use the new password to log back in.
        First name must have atleast 2 characters. Numbers and special characters are not allowed.
        Last name must have atleast 1 characters. Numbers and special characters are not allowed.
        Enter a valid email
        Enter a valid password
        Your profile has been successfully updated.