![[Finds]](../../img/logo-88x31.png){kind=logo}
簡易逆ジオコーディングサービス
簡易的な逆ジオコーディング(リバースジオコーディング)サービスです．
全国各地の陸地(無人島等の一部は除く)の緯度経度座標(世界測地系)を指定すると，その地点の属する都道府県，市区町村名を検索することができます．
また，都市計画区域内においては，おおむねの町丁目・字，番地を検索することができます．
当サービスのスクリプト等を逆ジオコーディングサービス配布サイトにて配布しております．
サービスURL
このサービスのURLは http://www.finds.jp/ws/rgeocode.phpです．
パラメータ
Toy Service共通仕様もあわせてご覧下さい．
- jsonp (共通)
- 応答文書をJSONP形式にする場合に指定します．
- php (共通)
- 応答文書をPHPシリアル化形式にする場合に指定します．
- lat
- 検索対象点の緯度(latitude)を，十進の度(度+分/60+秒/3600)で指定します．北緯を正とします．
- lon
- 検索対象点の経度(longitude)を，十進の度(度+分/60+秒/3600)で指定します．東経を正とします．
- lr
- 番地等(街区レベル位置参照情報)の検索半径を指定します．単位はメートル，デフォルト値は500，指定可能範囲は100から1000までです．
- lx
- 応答文書に挿入される番地等(街区レベル位置参照情報)要素の最大要素数を指定します．デフォルト値は1，指定可能範囲は1から100までです．
- ar
- 字・町丁目(大字・町丁目レベル位置参照情報)の検索範囲を指定します．単位はメートル，デフォルトは0，指定可能範囲は1000から10000までです．この値が正数でない場合は字・町丁目の検索は行いません．
- ax
- 応答文書に挿入される字・町丁目(大字・町丁目レベル位置参照情報)要素の最大要素数を指定します．デフォルト値は0，指定可能範囲は1から100までです．この値が正数でない場合は字・町丁目の検索は行いません．
応答文書
ルート要素
本サービスのルート要素は rgeocode です．
応答ステータス
| コード | 意味 |
|---|---|
| 200 | 成功した場合 (共通) |
| 201 | 地番等が発見されず(refult/local要素が存在しない)，字・町丁目も発見されない(result/aza要素が存在しない)場合 |
| 202 | 字・町丁目が発見された(result/aza要素が存在する)場合 (この場合は地番等は発見されていません) |
| 400 | パラメータ等に誤りがあって失敗した場合 (共通) |
| 500 | サーバ側で問題があって失敗した場合 (共通) |
result要素
Toy Service共通仕様もあわせてご覧下さい．
result要素は次に示す子要素を持っています．
- <prefecture>
- 都道府県に関するデータを持ちます．正常終了(statusの子要素が200番台)の時のみ出現します．
- <pcode>
- 子要素に都道府県コードが入ります．
- <pname>
- 子要素に都道府県名が入ります．
- <municipality>
- 市区町村に関するデータを持ちます．正常終了(statusの子要素が200番台)の時のみ出現します．
- <mcode>
- 子要素に市区町村コードが入ります(ご注意)．
- <mname>
- 子要素に市区町村名が入ります．
- <local> (複数)
- 番地等の検索結果情報を持ちます．発見できた時(statusの子要素が200)のみ出現します(ご注意)．
- <section>
- 町丁目・字等の名称を持ちます．
- <homenumber>
- 番地等を持ちます(ご注意)．
- <latitude>
- 番地等の代表点の位置の緯度を示します．
- <latitude>
- 番地等の代表点の位置の経度を示します．
- <aza> (複数)
- 字・町丁目の検索結果情報を持ちます．発見できた時(statusの子要素が202)のみ出現します(ご注意)．
- <name>
- 町丁目・字の名称を持ちます．
- <latitude>
- 町丁目・字の代表点の位置の緯度を示します．
- <latitude>
- 町丁目・字の代表点の位置の経度を示します．
ご注意
- 所属地未定について
- 市区町村コードにおいて，埋立地等では所属する市区町村が未定の場合があります．この場合，市区町村コードは，仮番号として
(都道府県コード) + "000"というコードを与えています(たとえば，千葉県の所属未定地なら 12000 としています．)．また，市区町村名として「所属地未定」という文字列が入ります． - local要素について
- local要素の出現条件は，次の通りです．
- 検索対象地点が属する市区町村が「街区レベル位置参照情報」のポイントデータを持っている，すなわち，都市計画区域を持つ市区町村である．
- 検索対象地点を中心に，lrパラメータの値(単位はメートル)で指定した距離内に「街区レベル位置参照情報」のポイントデータが存在する．
- homenumber要素(番地)について
- 番地と実際の建物の住所表記とは異なる場合がよくあります．理由として考えられるのは，データの精度の問題や，地図情報と地籍に違いがある，等です．また，ポイントデータが存在する領域の境界付近では全く信用できない結果を返します．この点にご留意いただき，番地情報の取扱には十分に注意して下さい．
- aza要素について
- aza要素の出現条件は，次の通りです．
- 地番等検索に失敗した(local要素が存在しない)場合
- 検索対象地点が属する市区町村が「大字・町丁目レベル位置参照情報」のポイントデータを持っている．
- 検索対象地点を中心に，arパラメータの値(単位はメートル)で指定した距離内に「大字・町丁目レベル位置参照情報」のポイントデータが存在する．
実行例
XML文書，またはJavaScriptやPHPで使用される表現で表示されます．人が見たら読みにくいものと感じるかもしれません．あらかじめご了承ください．
- 近畿中国四国農業研究センター (地図 - 本館からずらしています)
-
- XML版 / lx=10 / lx=50, lr=1000
- JSONP版 (jsonp=callerを指定)
- PHPシリアライズ版
- 街区レベル位置参照データが存在しない地点の例 - 広島県世羅郡世羅町( 地図)
-
- XML版 / ax=50,ar=10000
- JSONP版 / ax=50,ar=10000 (jsonp=callerを指定)
- PHPシリアライズ版 / ax=50,ar=10000
- ax=50, ar=10000 を指定して字・町丁目を併用する例 - 広島県世羅郡世羅町( 地図)
-
- XML版
- JSONP版 (jsonp=callerを指定)
- PHPシリアライズ版
- 所属地未定の例 - 千葉県船橋市近くの埋立地(地図)
-
- XML版
- JSONP版 (jsonp=callerを指定)
- PHPシリアライズ版
- エラー例 - 潮岬沖(30.0N 136.0E)で該当市町村なし(地図)
-
- XML版
- JSONP版 (jsonp=callerを指定)
- PHPシリアライズ版 (jsonp=callerを指定)
- エラー例 - パラメータなし
測地系について
本サービスの位置情報については，世界測地系(JGD2000)に基づきます(地理に関連した情報をご参照下さい)．
個別ご使用条件
当サービスご使用になる場合は，ご使用条件のほか，次のご使用条件にも従って下さい．
- サービス応答文書のうち番地情報は，実態と異なる場合があり，またプライバシーにも関わることがありますので，特に慎重に扱って下さい．
- このサービスを使用した成果物のうち，番地情報を表示または使用するものを配布または公開する際には，次のことと同じ趣旨のことを通知して下さい．
- 番地情報は，実態と異なる場合があり，またプライバシーにも関わることがありますので，特に慎重に扱って下さい．
![[National Agricultural Research Center for Western Region]](../../img/wenarc-logo-121x31.png){kind=logo}
![[National Agriculture And Food Research Organization]](../../img/naro-logo-142x31.png){kind=logo}