![[English]](../../img/2en-88x31.gif){kind=small}
市区町村一覧検索サービス
都道府県コードを指定するとその都道府県に属する市区町村の名前とコードを組とした一覧を返します。簡易ジオコーディングサービスとセットで使用することを前提としています。
Webサービスは，サービス単体ではほとんど使い物にはなりません．みなさまが開発されるアプリケーションの一部機能について，インターネットを介してお手伝いするものです．
サービスURL
このサービスのURLは http://www.finds.jp/ws/municipalitylist.phpです．
パラメータ
Toy Service共通仕様もあわせてご覧下さい．
- jsonp (共通)
- 応答文書をJSONP形式にする場合に指定します．値を指定しない場合はJSON形式を返却します．
- json (共通)
- 応答文書をJSON形式にする場合に指定します．どのような値を指定しても，また値を指定しなくてもかまいません．
- php (共通)
- 応答文書をPHPシリアル化形式にする場合に指定します．どのような値を指定しても，また値を指定しなくてもかまいません．
- pcode
- 都道府県コードを指定します。
- lc
- 'en' を指定すると、ローマ字で表示されます。
応答文書
ルート要素
本サービスのルート要素は municipalitylist です．
応答ステータス
| コード | 意味 |
|---|---|
| 200 | 成功した場合 (共通) |
| 400 | パラメータ等に誤りがあって失敗した場合 (共通) |
| 500 | サーバ側で問題があって失敗した場合 (共通) |
result要素
Toy Service共通仕様もあわせてご覧下さい．
result要素は次に示す子要素を持っています．
- <municipality> (複数)
- 市区町村の名前とコードのセットが入ります。
- <mcode>
- 子要素に市区町村コードが入ります。
- <mname>
- 子要素に市区町村名が入ります。
実行例
XML文書，またはJavaScriptやPHPで使用される表現で表示されます．人が見たら読みにくいものと感じるかもしれません．あらかじめご了承ください．
- 広島県
-
- XML版
- JSONP版 (jsonp=callerを指定)
- JSON版
- PHPシリアライズ版
- 東京都
-
- XML版
- JSONP版 (jsonp=callerを指定)
- JSON版
- PHPシリアライズ版
- エラー例 - 都道府県コードに99を指定
-
- XML版
- JSONP版 (jsonp=callerを指定)
- JSON版
- PHPシリアライズ版
- エラー例 - パラメータなし
謝辞
このサービスの作成にあたっては国土交通省の国土情報の閲覧・提供サービスサイトで公開されている「国土数値情報(行政区域データ)」を使用しました。
なお、このサービスを使用した成果物を配布または公開する際には、上記のことを提示していただければありがたく思います。