- 印刷する
- PDF
gc
- 印刷する
- PDF
概要
Naver地図は座標を住所に変換(coordsToAddr)するReverse geocodingサービスを提供します。Reverse geocoding APIを利用して特定の座標に該当する韓国国内の法政洞/行政洞/地番住所/道路名住所情報を取得できます。
Reverse geocodingサービスはEPSG(European Petroleum Survey Group)で指定した一部座標体系と韓国国内で主に使う座標体系をサポートします。
リクエスト
curl "https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?coords={入力_座標}&sourcecrs={座標系}&orders={変換_作業_名称}&output={出力_形式}" \
-H "X-NCP-APIGW-API-KEY-ID: {アプリケーションを登録する時に発行されたclient id値}" \
-H "X-NCP-APIGW-API-KEY: {アプリケーションを登録する時に発行されたclient secret値}" -v
リクエストパラメータ
- sourcecrs、targetcrs、orders、outputパラメータの場合、該当パラメータが入力されないとdefault値(基本値)で呼び出されます。各パラメータ別のdefault値は以下の説明をご参考ください。
- default値でない値が必要な場合は該当パラメータを明示的に呼び出すことも可能です。
- ordersパラメータを呼び出さない場合 : 法政、行政結果リターン
- 詳細住所が必要な場合 : orders=legalcode,admcode,addr,roadaddrで呼び出す。
- (詳細住所の呼び出しにordersパラメータ値としてlegalcodeやadmcodeを追加して呼び出す理由 : 海岸線付近、新規住宅地などの詳細住所がない地域の場合、APIの結果として'結果なし'ではなく、法政または行政洞単位の結果を取得可能)
パラメータ | データタイプ | 必須 | 説明 |
---|---|---|---|
request | string | N | リクエストサービス名 Reverse geocodingではcoordsToaddrを使います。 default値(基本値)はcoordToaddrです。 例) request=coordsToaddr |
coords | string | Y | 入力座標 例) coords=128.12345,37.98776 |
sourcecrs | string | N | 入力座標系コード default値(基本値)は経緯度座標系(epsg:4326)です。 サポートされる座標系コードは座標体系をご参考ください。 例) sourcecrs=epsg:4326 (経緯度座標系) sourcecrs=nhn:2048 (utm-k座標系) sourcecrs=nhn:128 (katech座標系) sourcecrs=epsg:3857 (google座標系) |
targetcrs | string | N | 出力座標系コード default値(基本値)は経緯度座標系(epsg:4326)です。 サポートされる座標系コードは座標体系をご参考ください。 例) targetcrs=epsg:4326 (経緯度座標系) targetcrs=nhn:2048 (utm-k座標系) targetcrs=nhn:128 (katech座標系) targetcrs=epsg:3857 (google座標系) |
orders | string | N | 変換作業名称 default値(基本値)はlegalcode,admcodeです。 使用可能な値は以下の通りです。 - legalcode: 座標 to 法政洞 - admcode: 座標 to 行政洞 - addr: 座標 to 地番住所 - roadaddr: 座標 to 道路名住所(新しい住所) 多くの値を入力できますし、ordersリクエスト順で結果が表示されます。 例) orders=legalcode orders=addr,admcode orders=addr,admcode,roadaddr orders=legalcode,addr,admcode,roadaddr |
output | string | N | 出力形式 使用可能な値はjson, xmlです。 default値(基本値)はxmlです。 例) output=json output=xml |
callback | string | N | jsonp通信のためにcallback処理が必要な場合に渡すcallback名 output=jsonの場合のみ該当する callbackで指定した名称でjsonデータを包んで返却します。 例) callback=abc |
座標体系
名称 | コード | 連携サービス | 区分 | GCS情報 | PCS情報 | 비고 | |||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
googleマップ | EPSG:3857 | PCS | WGS_1984 | WGS_1984 | 6378137 (Semi_Minor) | 298.2572236 | Greenwich | Degree | M | 0 | 0 | 0 | 0 | Meter | 1 | ||
WGS 84 経緯度 | EPSG:4326 | GCS | WGS_1984 | WGS_1984 | 6378137 | 298.2572236 | Greenwich | Degree | 해당없음 | 해당없음 | 해당없음 | 해당없음 | 해당없음 | 해당없음 | 해당없음 | ||
UTM-K | NHN:2048 | PCS | D_ITRF_2000 | GRS_1980 | 6378137 | 298.2572221 | Greenwich | Degree | TM | 127.5 | 38 | 2,000,000 | 1,000,000 | Meter | 0.9996 | ||
KATECH(TM128) | NHN:128 | マッシュアップマップ、百科事典、ウェブ OpenAPI | PCS | D_Korean_Datum_1985 | Bessel 1841 | 6377397.155 | 299.1528128 | Greenwich | Degree | TM | 128 | 38 | 600,000 | 400,000 | Meter | 0.9999 | 타원체 変換계수 10개 : TRANSFORM"BADEKAS","-145.907,505.034,685.756,-1.162,2.347,1.592,6.342,-3159521.31,4068151.32,3748113.85" |
リクエストヘッダ
ヘッダ名 | 説明 |
---|---|
X-NCP-APIGW-API-KEY-ID | アプリケーションを登録する時に発行されたClient IDX-NCP-APIGW-API-KEY-ID:{Client ID} |
X-NCP-APIGW-API-KEY | アプリケーションを登録する時に発行されたClient SecretX-NCP-APIGW-API-KEY:{Client Secret} |
リクエストボディ
- 該当APIはリクエストボディが必要ありません。
レスポンス
レスポンスボディ
属性 | データタイプ | 説明 |
---|---|---|
name | string | 変換作業名称 |
code | number | コード情報 |
code.id | string | コード値 |
code.type | string | コードタイプ 例) L: 法政洞, A: 行政洞, S: 同一法政洞名が存在する行政洞 |
code.mappingId | string | idと関連されたマッピングコード 例) 法政コードにマッピングされたNaver洞コードまたは行政コードにマッピングされたNaver洞コード |
region | 地域名称情報 | |
region.area0 | ||
region.area0.name | string | 国家コードの最上位ドメインの2桁 詳しい内容については Country code top-level domainをご参考ください。 |
region.area0.coords.center | 行政区域の中心座標 | |
region.area0.coords.center.crs | string | 座標系コード サポートされる座標系コードは座標体系をご参考ください。 |
region.area0.coords.center.x | float | x軸座標 例) 経緯度(epsg:4326)である場合は経度(longitude) |
region.area0.coords.center.y | float | y軸座標 例) 経緯度(epsg:4326)である場合は緯度(latitude) |
region.area1 | ||
region.area1.name | string | 行政区域単位名称1 例) 大韓民国の場合、行政安全部から公示された市/道の名称 |
region.area1.coords | 行政区域と関連された座標 | |
region.area1.coords.center | 行政区域の中心座標 | |
region.area1.coords.center.crs | string | 座標系コード サポートされる座標系コードは座標体系をご参考ください。 |
region.area1.coords.center.x | float | x軸座標 例) 経緯度(epsg:4326)である場合は経度(longitude) |
region.area1.coords.center.y | float | y軸座標 例) 経緯度(epsg:4326)である場合は緯度(latitude) |
region.area2 | ||
region.area2.name | string | 行政区域単位名称2 例) 大韓民国の場合、行政安全部から公示された市/郡/区の名称 |
region.area2.coords | 行政区域と関連された座標 | |
region.area2.coords.center | 行政区域の中心座標 | |
region.area2.coords.center.crs | string | 座標系コード サポートされる座標系コードは座標体系をご参考ください。 |
region.area2.coords.center.x | float | x軸座標 例) 経緯度(epsg:4326)である場合は経度(longitude) |
region.area2.coords.center.y | float | y軸座標 例) 経緯度(epsg:4326)である場合は緯度(latitude) |
region.area3 | ||
region.area3.name | string | 行政区域単位名称3 例) 大韓民国の場合、行政安全部から公示された邑/面/洞の名称 |
region.area3.coords | 行政区域と関連された座標 | |
region.area3.coords.center | 行政区域の中心座標 | |
region.area3.coords.center.crs | string | 座標系コード サポートされる座標系コードは座標体系をご参考ください。 |
region.area3.coords.center.x | float | x軸座標 例) 経緯度(epsg:4326)である場合は経度(longitude) |
region.area3.coords.center.y | float | y軸座標 例) 経緯度(epsg:4326)である場合は緯度(latitude) |
region.area4 | ||
region.area4.name | string | 行政区域単位名称4 例) 大韓民国の場合、行政安全部から公示された里の名称) |
region.area4.coords | 行政区域と関連された座標 | |
region.area4.coords.center | 行政区域の中心座標 | |
region.area4.coords.center.crs | string | 座標系コード サポートされる座標系コードは座標体系をご参考ください。 |
region.area4.coords.center.x | float | x軸座標 例) 経緯度(epsg:4326)である場合は経度(longitude) |
region.area4.coords.center.y | float | y軸座標 例) 経緯度(epsg:4326)である場合は緯度(latitude) |
land | 詳細住所情報 | |
land.type | string | 地番住所の場合、地籍タイプ 例) 大韓民国の地番住所である場合 1: 一般土地、 2: 山 道路名住所の場合、reserved |
land.name | string | 詳細名称 例) 大韓民国の地番住所である場合、reserved 大韓民国の道路名住所である場合、道路名 |
land.number1 | string | 詳細番号1 例) 大韓民国の地番住所である場合、土地本番号 大韓民国の道路名住所である場合、詳細住所 |
land.number2 | string | 詳細番号2 例) 大韓民国の地番住所である場合、土地副番号 大韓民国の道路名住所である場合、reserved |
land.coords | 地籍広域に関係された座標 (reserved) | |
addition0 | 追加情報 地番住所である場合、reserved 道路名住所である場合、建物情報 | |
addition0.type | string | 道路名住所であり、建物情報がある場合、'building' |
addition0.value | string | 道路名住所であり、建物情報がある場合、建物名 |
addition1 | 追加情報 地番住所である場合、reserved 道路名住所である場合、郵便番号 | |
addition1.type | string | 道路名住所であり、郵便番号情報がある場合、'zipcode' |
addition1.value | string | 道路名住所であり、郵便番号情報がある場合、郵便番号 |
addition2 | 追加情報 地番住所である場合、reserved 道路名住所である場合、道路コード | |
addition2.type | string | 道路名住所である場合、'roadGroupCode' |
addition2.value | string | 道路名住所である場合、道路コード(12桁road group code) |
addutuib3~4 | reserved |
変換対象座標によって多様なレスポンス結果が返却されます。以下の各ケースをご参考ください。
一般邑面洞
https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=126.9913201,37.5666936&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
一般'里': 法政洞単位である'邑面'下位の'里'単位座標であるため、admcodeの結果にもcode typeは'L'に設定されます。
https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=128.2439084,36.4938906&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
ブンダン区 ジョンジャ洞: 法政洞と同じ名称の行政洞が存在します。(領域は異なる。)
https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=127.1114893,37.3614463&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
世宗市座標: 市郡区area2データがないし、世宗市下位のすべての行政洞の法政洞が同じです。(領域は異なる。)
ドダム洞(法政洞、行政洞が同一名称):
https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=127.2654387,36.5008113&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
ジョチウォン邑(法政):
https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=127.2923750,36.5929071&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
海の上(データなし):
https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=125.9913201,37.5666936&sourcecrs=epsg:4326&orders=admcode,legalcode,addr,roadaddr&output=xml
例示
リクエスト例示
curl "https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&output=json&orders=legalcode,admcode" \
-H "X-NCP-APIGW-API-KEY-ID: {アプリケーションを登録する時に発行されたclient id値}" \
-H "X-NCP-APIGW-API-KEY: {アプリケーションを登録する時に発行されたclient secret値}" -v
- 座標を法政コードに変換リクエスト
https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&output=json&orders=legalcode
- 座標を地番住所、行政コードに変換リクエスト
https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&output=json&orders=addr,admcode
- 座標を地番住所、行政コード、道路名住所に変換リクエスト
https://naveropenapi.apigw.ntruss.com/map-reversegeocode/v2/gc?request=coordsToaddr&coords=129.1133567,35.2982640&sourcecrs=epsg:4326&output=json&orders=addr,admcode,roadaddr
レスポンス例示
{
"status":{
"code":0,
"name":"ok",
"message":"done"
},
"results":[
{
"name":"legalcode",
"code":{
"id":"2641010100",
"type":"L",
"mappingId":"08410101"
},
"region":{
"area0":{
"name":"kr",
"coords":{
"center":{
"crs":"",
"x":0.0,
"y":0.0
}
}
},
"area1":{
"name":"釜山広域市",
"coords":{
"center":{
"crs":"EPSG:4326",
"x":129.0750222,
"y":35.1798159
}
}
},
"area2":{
"name":"クンジョン区",
"coords":{
"center":{
"crs":"EPSG:4326",
"x":129.0921,
"y":35.243068
}
}
},
"area3":{
"name":"ドゥグ洞",
"coords":{
"center":{
"crs":"EPSG:4326",
"x":129.1133567,
"y":35.2982641
}
}
},
"area4":{
"name":"",
"coords":{
"center":{
"crs":"",
"x":0.0,
"y":0.0
}
}
}
}
}
]
}
エラーコード
リクエスト結果が正常である場合はHTTPステータスコード200を返却するし、詳細コードは以下のようです。
code | name | 説明 |
---|---|---|
0 | ok | 正常的な機能実行及び返却された結果がある場合 |
3 | no results | 正常的な機能実行及び返却された結果がない場合 |
リクエスト結果が正常でない場合は次のように返却されます。
HttpStatusCode | ErrorCode | ErrorMessage | Description |
---|---|---|---|
400 | 100 | invalid request | リクエストパラメータが間違った場合 |
500 | 900 | unknown error / io error | 定義されてないエラー |