Geocoding 개요
    • PDF

    Geocoding 개요

    • PDF

    Article Summary

    주소의 텍스트를 입력받아 좌표를 포함한 상세정보들을 제공합니다.

    공통 설정

    클라이언트 아이디는 NAVER Cloud Platform 콘솔에서 애플리케이션을 등록해 발급받습니다.

    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변경 화면에서 Geocoding가 선택되어 있는지 확인합니다. 선택되어 있지 않으면 429 (Quota Exceed)가 발생하니 주의하시기 바랍니다.

    API URL

    메서드인증요청 URL응답 형식
    GETID,KEYhttps://naveropenapi.apigw-pub.fin-ntruss.com/map-geocode/v2/geocodeJSON

    요청 헤더

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

    공통 오류

    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 Largecontent-length 초과 (10MB)
    503500Endpoint Error엔드포인트 연결오류
    504510Endpoint Timeout엔드포인트 연결시간 초과
    500900Unexpected Error예외처리가 안된 오류

    API 오류

    HttpStatusCodeResultCodeErrorMessageDescription
    200OK-정상 응답
    400INVALID_REQUESTBad Request Exception요청 오류
    500SYSTEM_ERRORUnexpected Error예외처리가 안된 오류

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

    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.