Reverse Geocoding

参考

概要

座標を通じて住所情報(法政洞、行政洞、地番住所、道路名住所など)を返却します。

共通設定

Client IDは Naverクラウドプラットフォームコンソールでアプリケーションを登録して発行します。

  1. コンソールのAI·Application Service > AI·NAVER API > Applicationでアプリケーションを登録します。 詳しい方法の確認 >

  2. AI·Application Service > AI·NAVER API > Applicationで登録したアプリケーションを選択してClient IDとClient Secretの値を確認します。

  3. AI·Application Service > AI·NAVER API > Application変更画面で Reverse Geocodingが選択されていることを確認します。選択されてない場合は429 (Quota Exceed)が発生するのでご注意をお願いします。

API URL

メソッド 認証 リクエストURL レスポンス形式
GET ID,KEY https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc XML 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"
  }
}

共通エラー

HttpStatusCode ErrorCode ErrorMessage Description
400 100 Bad Request Exception protocol(https), endocing(UTF-8) など requestエラー
401 200 Authentication Failed 認証失敗
401 210 Permission Denied 権限なし
404 300 Not Found Exception 権限なし
429 400 Quota Exceeded Quota超過
429 410 Throttle Limited Rate超過
429 420 Rate Limited Rate超過
413 430 Request Entity Too Large conent-length超過 (10MB)
503 500 Endpoint Error エンドポイント連結エラー
504 510 Endpoint Timeout エンドポイント連結時間超過
500 900 Unexpected Error 例外処理がされてないエラー

APIエラー

HttpStatusCode ErrorCode ErrorMessage Description
400 100 invalid request リクエストパラメータが間違った場合
500 900 unknown error / io error 定義されてないエラー

オペレーション