市区町村の名前、重心等の一覧を返します。絞り込み条件として、都道府県コード、市区町村コード、緯度・経度・半径、があります。
Webサービスは、単体ではほとんど使い物にはなりません。みなさまがアプリケーションの一部機能について、インターネットを介してお手伝いするものです。
ご使用前にご使用条件をご覧ください。
このサービスのURLは https://aginfo.cgk.affrc.go.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 | サーバ側で問題があって失敗した場合 (共通) |
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を指定
-
- パラメータなし
-
このサービスの作成にあたっては国土交通省の国土情報の閲覧・提供サービス
で公開されている「国土数値情報(行政区域データ)」を使用しました。
なお、このサービスを使用した成果物を配布または公開する際には、上記のことを提示していただければありがたく思います。