MENU
      Reverse Geocoding 개요

        Reverse Geocoding 개요


        기사 요약

        좌표를 통해 주소 정보(법정동, 행정동, 지번주소, 도로명주소 등)를 반환합니다.

        공통 설정

        클라이언트 아이디는 네이버 클라우드 플랫폼 콘솔에서 애플리케이션을 등록해 발급받습니다.

        1. 콘솔의 AI·NAVER API > AI·NAVER API > Application에서 애플리케이션을 등록합니다. 자세한 방법 보기 >

        2. AI·NAVER API > AI·NAVER API > Application에서 등록한 애플리케이션을 선택해 Client ID와 Client Secret값을 확인합니다.

        3. AI·NAVER API > AI·NAVER API > Application변경 화면에서 Reverse Geocoding가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

        API URL

        메서드인증요청 URL응답 형식
        GETID,KEYhttps://naveropenapi.apigw.gov-ntruss.com/map-reversegeocode/v2/gcXML or JSON

        요청 헤더

        헤더 명설명
        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"
          }
        }
        JSON

        공통 에러

        HttpStatusCodeErrorCodeErrorMessageDescription
        400100Bad Request ExceptionProtocol(https), Endocing(UTF-8) 등 Request 에러
        401200Authentication Failed인증실패
        401210Permission Denied권한없음
        404300Not Found Exception권한없음
        429400Quota ExceededQuota 초과
        429410Throttle LimitedRate 초과
        429420Rate LimitedRate 초과
        413430Request Entity Too Largeconent-length 초과 (10MB)
        503500Endpoint Error엔드포인트 연결에러
        504510Endpoint Timeout엔드포인트 연결시간 초과
        500900Unexpected Error예외처리가 안된 에러

        API 에러

        HttpStatusCodeErrorCodeErrorMessageDescription
        400100invalid request요청 파라미터가 잘못된 경우
        500900unknown error / io error정의되지 않은 에러

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

        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.