簡易ジオコーディングサービス
都道府県または市区町村を指定すると、その都道府県または市区町村の重心を計算して返します。都道府県または市区町村の地域コードのみをパラメータとする簡易的なジオコーダとしての利用を想定しています。
Webサービスは，サービス単体ではほとんど使い物にはなりません．みなさまが開発されるアプリケーションの一部機能について，インターネットを介してお手伝いするものです．
サービスURL
このサービスのURLは http://www.finds.jp/ws/geocode.phpです．
パラメータ
Toy Service共通仕様もあわせてご覧下さい．
- jsonp (共通)
- 応答文書をJSONP形式にする場合に指定します．値を指定しない場合はJSON形式を返却します．
- json (共通)
- 応答文書をJSON形式にする場合に指定します．どのような値を指定しても，また値を指定しなくてもかまいません．
- php (共通)
- 応答文書をPHPシリアル化形式にする場合に指定します．どのような値を指定しても，また値を指定しなくてもかまいません．
- pcode
- い都道府県を都道府県コードで指定します。mcodeが指定された場合にはpcodeは無効になります。
- mcode
- 重心を求めたい市区町村を市区町村コードで指定します。
応答文書
ルート要素
本サービスのルート要素は geocode です．
応答ステータス
| コード | 意味 |
|---|---|
| 200 | 成功した場合 (共通) |
| 201 | mcodeとpcodeを同時に指定した場合 |
| 400 | パラメータ等に誤りがあって失敗した場合 (共通) |
| 500 | サーバ側で問題があって失敗した場合 (共通) |
result要素
Toy Service共通仕様もあわせてご覧下さい．
result要素は次に示す子要素を持っています．
- <latitude>
- 子要素に、重心の緯度を持ちます。単位は十進の度なので、度・分・秒で表現する場合は若干の計算が必要です。また、北緯が正となります。
- <longitude>
- 子要素に、重心の経度を持ちます。単位は十進の度なので、度・分・秒で表現する場合は若干の計算が必要です。また、東経が正となります。
実行例
XML文書，またはJavaScriptやPHPで使用される表現で表示されます．人が見たら読みにくいものと感じるかもしれません．あらかじめご了承ください．
- 広島県(34)
-
- XML版
- JSONP版 (jsonp=callerを指定)
- JSON版
- PHPシリアライズ版
- 広島県福山市(34207)
-
- XML版
- JSONP版 (jsonp=callerを指定)
- JSON版
- PHPシリアライズ版
- 東京都(13)と広島県福山市(34207)の重複指定
-
- XML版
- JSONP版 (jsonp=callerを指定)
- JSON版
- PHPシリアライズ版
- エラー例 - 都道府県コードに99を指定
-
- XML版
- JSONP版 (jsonp=callerを指定)
- JSON版
- PHPシリアライズ版
- エラー例 - 市区町村コードに99999を指定
-
- XML版
- JSONP版 (jsonp=callerを指定)
- JSON版
- PHPシリアライズ版
- エラー例 - パラメータなし
関連情報
- ROCOCOライブラリ
- ROCOCライブラリの市区町村移動機能は、このサービスを利用しています。
謝辞
このサービスの作成にあたっては国土交通省の国土情報の閲覧・提供サービスサイトで公開されている「国土数値情報(行政区域データ)」を使用しました。
なお、このサービスを使用した成果物を配布または公開する際には、上記のことを提示していただければありがたく思います。