ご参考

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

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

APIのご紹介

住所検索APIは地番、道路名の問い合わせ言語を使って住所の情報を検索します。検索結果として住所のリストと詳細情報をJSONの形で返します。

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

ご参考

リクエストパラメータ

  • レスポンスエンコーディングパラメータ(encoding)をこれ以上サポートしません。(常に'utf-8'でレスポンス)
  • レスポンス座標体系パラメータ(coordType)をこれ以上サポートしません。(常に'緯度・軽度'でレスポンス)

レスポンス

  • 検索語(query)に該当する住所結果について道路名、地番、英語の住所の3種類の形をすべて提供します。
  • 従来、pointオブジェクト内のx,yに送っていた座標情報をpointオブジェクトなしに直ちに転送します。
  • 従来、addrdetailに送っていた情報はaddressElementsフィールド(array)に代替されます。これは、住所のタイプと値を構造化し、いつでも新しい住所タイプを追加できる拡張された構造です。例えば、addressElementsの中のtypesの値がPOSTAL_CODEである要素は郵便番号を表します。

例示

  • 'query=烟砂里93'の検索結果

  • 従来(v1)の結果

{
  "result": {
    "total": 1,
    "userquery": "烟砂里93",
    "items": [
      {
        "address": "慶尚南道巨濟市延草面烟砂里93",
        "addrdetail": {
          "country": "大韓民国",
          "sido": "慶尚南道",
          "sigugun": "巨濟市",
          "dongmyun": "延草面",
          "ri": "烟砂里",
          "rest": "93"
        },
        "isRoadAddress": false,
        "point": {
          "x": 128.6521583,
          "y": 34.9070498
        }
      }
    ]
  }
}
  • 新しい(v2)結果
{
    "status": "OK",
    "meta": {
        "totalCount": 1,
        "page": 1,
        "count": 1
    },
    "addresses": [
        {
        "roadAddress": "慶尚南道巨濟市延草面孝村1路10-1",
        "jibunAddress": "慶尚南道巨濟市延草面烟砂里93",
        "englishAddress": "10-1, Hyochon 1-gil, Yeoncho-myeon, Geoje-si, Gyeongsangnam-do, Republic of Korea",
        "addressElements": [
            {
            "types": ["SIDO"],
            "longName": "慶尚南道",
            "shortName": "慶尚南道",
            "code": ""
            },
            {
            "types": ["SIGUGUN"],
            "longName": "巨濟市",
            "shortName": "巨濟市",
            "code": ""
            },
            {
            "types": ["DONGMYUN"],
            "longName": "延草面",
            "shortName": "延草面",
            "code": ""
            },
            {
            "types": ["RI"],
            "longName": "烟砂里",
            "shortName": "烟砂里",
            "code": ""
            },
            {
            "types": ["ROAD_NAME"],
            "longName": "孝村1路",
            "shortName": "孝村1路",
            "code": ""
            },
            {
            "types": ["BUILDING_NUMBER"],
            "longName": "10-1",
            "shortName": "10-1",
            "code": ""
            },
            {
            "types": ["BUILDING_NAME"],
            "longName": "",
            "shortName": "",
            "code": ""
            },
            {
            "types": ["LAND_NUMBER"],
            "longName": "93",
            "shortName": "93",
            "code": ""
            },
            {
            "types": ["POSTAL_CODE"],
            "longName": "53209",
            "shortName": "53209",
            "code": ""
            }
        ],
        "x": "128.6521583",
        "y": "34.9070498",
        "distance": 0
        }
    ],
    "errorMessage": ""
}

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

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

    処理中...