ご参考

従来のデベロッパーセンターでhttps://openapi.naver.com/v1/map/reversegeocodeAPIを使用した場合、レスポンスおよびフォーマットの結果が異なる可能性があります。 次のNAVERデベロッパーセンターのAPI(v1)に比べて変わったことリンク先を参考にし、レスポンスフォーマットおよび結果によるコードの修正を行ってください。

従来のv1バージョンのReverse Geocoding REST APIは2019年2月28日まで正常に呼び出されます。2019年3月からはv1の使用が中止されます。

APIのご紹介

NAVER Mapでは座標を住所に変換(coordsToAddr)するReverse geocodingサービスを提供します。Reverse geocoding APIを利用して特定の座標に該当する国内の法定洞/行政洞/地番住所/道路名住所の情報を得ることができます。
Reverse geocodingサービスではEPSG(European Petroleum Survey Group)で指定した一部の座標体系と国内で主に使用する座標体系をサポートします。
住所を座標に変換するGeocodingサービスAPIについては検索API使用ガイドをご参考ください。

Reverse Geocoding API v2別途の開発ガイドのサイトを提供します。
Reverse Geocoding API v2参照書サイトにショートカット >

ご参考

リクエストパラメータ

  • レスポンスエンコーディングパラメータ(encoding)をこれ以上サポートしません。

    • パラメータ名が変更されました。
      • 座標の値 : query -> coords
      • 出力座標系 : coordType -> targetcrs
    • 必須パラメータがあります。
      • request=coordsToaddr
    • xml/jsonのレスポンス形式の選択をoutputパラメータでします。
      • output=xml or output=json
      • outputパラメータがない場合は基本的にxmlの結果を転送します。
    • 出力される住所の種類を細かく選択したり組み合わせることができます。
      • orders=legalcode : 法定洞
      • orders=admcode : 行政洞
      • orders=addr : 地番住所
      • orders=roadaddr : 道路名住所
      • orders=legalcode,admcode : 法定洞/行政洞両方を出力
      • orders=legalcode,admcode,addr,roadaddr : 法定洞/行政洞/地番/道路名住所すべてを出力
      • ordersパラメータなしに呼び出すと、'orders=legalcode,admcode'と同じ効果があります。
        • 法定洞、行政洞の情報を受信
      • デベロッパーセンターAPIのようにすべての住所を受信したい場合は'orders=legalcode,admcode,addr,roadaddr'を呼び出してください。
      • 詳細な住所(地番、道路名)を受信したい場合は'orders=addr,roadaddr'のような呼び出しよりは'orders=legalcode,admcode,addr,roadaddr'形式で呼び出すことをお勧めします。
        • 理由 : 海岸、川、新しい住宅地など、詳細な住所がない地域の場合、法定洞、行政洞の情報でも結果として一緒に受信できるため

レスポンス

  • レスポンス結果の行政単位別のdepth構造があり、それぞれの中心座標の情報も提供します。
  • 道路名住所の場合、郵便番号がある位置の座標結果なら、郵便番号の情報も一緒に提供します。
  • depth構造および詳細な情報を一緒に提供するため、従来のデベロッパーセンターの結果よりレスポンスが長いです。
  • 単一tagでfull addressを提供する項目がありません。
    • 従来のデベロッパーセンターの結果の'address'項目

例示

  • 従来(v1)の結果
    • query=127.1054065,37.3595669
{
   "result": {
       "total": 3,
       "userquery": "127.1054065,37.3595669",
       "items": [
           {
               "address": "京畿道城南市盆唐区亭子洞178-1",
               "addrdetail": {
                   "country": "大韓民国",
                   "sido": "京畿道",
                   "sigugun": "城南市盆唐区",
                   "dongmyun": "亭子洞",
                   "ri": "",
                   "rest": "178-1"
               },
               "isAdmAddress": false,
               "isRoadAddress": false,
               "point": {
                   "x": 127.1052208,
                   "y": 37.3595122
               }
           },
           {
               "address": "京畿道城南市盆唐区佛亭路6 NAVERグリーンファクトリー",
               "addrdetail": {
                   "country": "大韓民国",
                   "sido": "京畿道",
                   "sigugun": "城南市盆唐区",
                   "dongmyun": "佛亭路",
                   "ri": "",
                   "rest": "6 NAVERグリーンファクトリー"
               },
               "isAdmAddress": false,
               "isRoadAddress": true,
               "point": {
                   "x": 127.1052133,
                   "y": 37.3595316
               }
           },
           {
               "address": "京畿道城南市盆唐区亭子1洞178-1",
               "addrdetail": {
                   "country": "大韓民国",
                   "sido": "京畿道",
                   "sigugun": "城南市盆唐区",
                   "dongmyun": "亭子1洞",
                   "ri": "",
                   "rest": "178-1"
               },
               "isAdmAddress": true,
               "isRoadAddress": false,
               "point": {
                   "x": 127.106363,
                   "y": 37.372799
               }
           }
       ]
   }
}
  • 新しい(v2)結果
    • request=coordsToaddr&coords=127.1054065,37.3595669&orders=legalcode,admcode,addr,roadaddr&output=json
      {
      "status":{
       "code":0,
       "name":"ok",
       "message":"done"
      },
      "results":[
       {
          "name":"legalcode",
          "code":{
             "id":"4113510300",
             "type":"L",
             "mappingId":"02135103"
          },
          "region":{
             "area0":{
                "name":"kr",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             },
             "area1":{
                "name":"京畿道",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.550802,
                      "y":37.4363177
                   }
                },
                "alias":"京畿"
             },
             "area2":{
                "name":"城南市盆唐区",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.118925,
                      "y":37.38282
                   }
                }
             },
             "area3":{
                "name":"亭子洞",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.111533,
                      "y":37.361458
                   }
                }
             },
             "area4":{
                "name":"",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             }
          }
       },
       {
          "name":"admcode",
          "code":{
             "id":"4113555000",
             "type":"A",
             "mappingId":"02135550"
          },
          "region":{
             "area0":{
                "name":"kr",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             },
             "area1":{
                "name":"京畿道",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.550802,
                      "y":37.4363177
                   }
                },
                "alias":"京畿"
             },
             "area2":{
                "name":"城南市盆唐区",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.118925,
                      "y":37.38282
                   }
                }
             },
             "area3":{
                "name":"亭子1洞",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.106363,
                      "y":37.372799
                   }
                }
             },
             "area4":{
                "name":"",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             }
          }
       },
       {
          "name":"addr",
          "code":{
             "id":"4113510300",
             "type":"L",
             "mappingId":"02135103"
          },
          "region":{
             "area0":{
                "name":"kr",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             },
             "area1":{
                "name":"京畿道",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.550802,
                      "y":37.4363177
                   }
                },
                "alias":"京畿"
             },
             "area2":{
                "name":"城南市盆唐区",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.118925,
                      "y":37.38282
                   }
                }
             },
             "area3":{
                "name":"亭子洞",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.111533,
                      "y":37.361458
                   }
                }
             },
             "area4":{
                "name":"",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             }
          },
          "land":{
             "type":"1",
             "number1":"178",
             "number2":"1",
             "addition0":{
                "type":"",
                "value":""
             },
             "addition1":{
                "type":"",
                "value":""
             },
             "addition2":{
                "type":"",
                "value":""
             },
             "addition3":{
                "type":"",
                "value":""
             },
             "addition4":{
                "type":"",
                "value":""
             },
             "coords":{
                "center":{
                   "crs":"",
                   "x":0.0,
                   "y":0.0
                }
             }
          }
       },
       {
          "name":"roadaddr",
          "code":{
             "id":"4113510300",
             "type":"L",
             "mappingId":"02135103"
          },
          "region":{
             "area0":{
                "name":"kr",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             },
             "area1":{
                "name":"京畿道",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.550802,
                      "y":37.4363177
                   }
                },
                "alias":"京畿"
             },
             "area2":{
                "name":"城南市盆唐区",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.118925,
                      "y":37.38282
                   }
                }
             },
             "area3":{
                "name":"亭子洞",
                "coords":{
                   "center":{
                      "crs":"EPSG:4326",
                      "x":127.111533,
                      "y":37.361458
                   }
                }
             },
             "area4":{
                "name":"",
                "coords":{
                   "center":{
                      "crs":"",
                      "x":0.0,
                      "y":0.0
                   }
                }
             }
          },
          "land":{
             "type":"",
             "number1":"6",
             "number2":"",
             "addition0":{
                "type":"building",
                "value":"NAVERグリーンファクトリー"
             },
             "addition1":{
                "type":"zipcode",
                "value":"463867"
             },
             "addition2":{
                "type":"roadGroupCode",
                "value":"411353180030"
             },
             "addition3":{
                "type":"",
                "value":""
             },
             "addition4":{
                "type":"",
                "value":""
             },
             "name":"佛亭路",
             "coords":{
                "center":{
                   "crs":"",
                   "x":0.0,
                   "y":0.0
                }
             }
          }
       }
      ]
      }
      

に対する検索結果は~件です。 ""

    に対する検索結果がありません。 ""

    処理中...