ご参考
従来のデベロッパーセンターで
https://openapi.naver.com/v1/map/geocode
APIを使用した場合、レスポンスおよびフォーマットの結果が異なる可能性があります。 次のNAVERデベロッパーセンターAPI(v1)に比べて変わったことリンク先を参考にし、レスポンスフォーマットおよび結果によるコードの修正を行ってください。従来のv1バージョンのGeocoding REST APIは2019年2月28日まで正常に呼び出されます。2019年3月からはv1の使用が中止されます。
APIのご紹介
住所検索APIは地番、道路名の問い合わせ言語を使って住所の情報を検索します。検索結果として住所のリストと詳細情報をJSONの形で返します。
Geocoding API v2別途の開発ガイドのサイトを提供します。
Geocoding API v2参照書サイトにショートカット >
ご参考
NAVERデベロッパーセンターAPIに比べて変わったこと
リクエストパラメータ
- レスポンスエンコーディングパラメータ(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": ""
}