市区町村検索サービス

ひとことお願いします

市区町村の名前、重心等の一覧を返します。絞り込み条件として、都道府県コード、市区町村コード、緯度・経度・半径、があります。

ご案内 Webサービスは、単体ではほとんど使い物にはなりません。みなさまがアプリケーションの一部機能について、インターネットを介してお手伝いするものです。

ご注意 ご使用前にご使用条件をご覧ください。

サービスURL

このサービスのURLは http://www.finds.jp/ws/mncpl.phpです。

パラメータ

Toy Service共通仕様もあわせてご覧下さい。

jsonp (共通)
応答文書をJSONP形式にする場合に指定します。値を指定しない場合はJSON形式を返却します。
json (共通)
応答文書をJSON形式にする場合に指定します。どのような値を指定しても、また値を指定しなくてもかまいません。
php (共通)
応答文書をPHPシリアル化形式にする場合に指定します。どのような値を指定しても、また値を指定しなくてもかまいません。
pcode
pcode=*とした場合は、都道府県一覧を返します。都道府県コードで絞り込みます。pcode、mcodeもしくはlon及びlatが指定されていなければなりません。
mcode
市区町村コードで絞り込みます。pcode、mcodeもしくはlon及びlatが指定されていなければなりません。
lon
検索範囲のうち中心点経度を指定します。単位は十進の度です。lonとlatは同時に指定されなければなりません。pcode、mcodeもしくはlon及びlatが指定されていなければなりません。
lat
検索範囲のうち中心点経度を指定します。単位は十進の度です。lonとlatは同時に指定されなければなりません。pcode、mcodeもしくはlon及びlatが指定されていなければなりません。
mnr
検索範囲のうち半径を指定します。単位はメートルです。lonとlatが指定されていなければrは無意味です。rが指定されていない場合には、半径は0メートルとします。

応答文書

ルート要素

本サービスのルート要素は mncpl です。

応答ステータス

コード意味
200成功した場合 (共通)
400パラメータ等に誤りがあって失敗した場合 (共通)
500サーバ側で問題があって失敗した場合 (共通)

result要素

Toy Service共通仕様もあわせてご覧下さい。

result要素は次に示す子要素を持っています。

<prefecture> (0個以上)
都道府県の名前とコードのセットを持ちます。
<mcode>
子要素に都道府県コードを持ちます。
<mname>
子要素に都道府県名を持ちます。
<centroid>
子要素に都道府県の重心位置を持ちます。
<latitude>
子要素に重心の緯度を持ちます。単位は十進の度です(度・分・秒で表現する場合は若干の計算が必要です)。北緯が正となります。
<longitude>
子要素に重心の緯度を持ちます。単位は十進の度です(度・分・秒で表現する場合は若干の計算が必要です)。東経が正となります。
<municipality> (0個以上)
市区町村の名前とコードのセットを持ちます。
<mcode>
子要素に市区町村コードを持ちます。
<mname>
子要素に市区町村名を持ちます。
<relation> (0個か1個)
lon,latを指定した場合に出現し、子要素にlon,latで指定した位置との関係が入ります。
<distance>
子要素に、指定した位置からその市区町村までの最短距離が入ります。単位はメートルです。
<azimuth>
子要素に、指定した位置から見て、その市区町村の最短点への方位が入ります。単位は度です。最短距離が0の場合には、0が入ります。
<centroid>
子要素に市区町村の重心位置を持ちます。
<latitude>
子要素に重心の緯度を持ちます。単位は十進の度です(度・分・秒で表現する場合は若干の計算が必要です)。北緯が正となります。
<longitude>
子要素に重心の緯度を持ちます。単位は十進の度です(度・分・秒で表現する場合は若干の計算が必要です)。東経が正となります。

実行例

ご注意 XML文書、またはJavaScriptやPHPで使用される表現で表示されます。人が見たら読みにくいものと感じるかもしれません。あらかじめご了承ください。

lon,lat,mnrを指定

広島県庄原市 (133.13931941986084E 34.78529408172752N)
半径1,000m以内 (mnr=1000)
半径を指定しない場合
所属地未定の例 - 千葉県船橋市近くの埋立地(35.672N 139.96E)から半径1,000m以内
エラー例 - 潮岬沖(30.0N 136.0E)から半径1,000m以内

pcodeまたはmcodeを指定

広島県(pcode=34)市区町村一覧
広島県福山市 (mcode=34207)
東京都(pcode=13)と広島県福山市(mcode=34207)の重複指定

エラー例

lon,latを指定せずにmnrを指定した場合
半径100,000m以内を検索しようとした場合(mnr=100000)
エラー例 - 都道府県コードに99を指定
エラー例 - 市区町村コードに99999を指定
パラメータなし

謝辞

このサービスの作成にあたっては国土交通省の国土情報の閲覧・提供サービス(外部サイト)で公開されている「国土数値情報(行政区域データ)」を使用しました。

なお、このサービスを使用した成果物を配布または公開する際には、上記のことを提示していただければありがたく思います。


Finds.jp について | 新着情報 | サイトマップ | お問い合わせ

HTTP | HTTPS

農研機構