指定された緯度経度の地番を返却します。
https://chibanapi.geospace.jp/api/reverseChiban/
UTF-8
GET,POST
パラメータ名 | 内容 | 型 | 必須 | 設定値・備考 |
---|---|---|---|---|
callback | コールバック関数名 | 半角文字列 | 任意 | JSONP で利用する際のコールバック用関数名。未指定の場合は「JSON」で返却。 |
appid | アプリケーションID | 半角文字列 | 必須 | ご利用時に発行されたID |
search_type | 検索種類 | 半角数字 | 任意 | 検索する種類を指定 0:座標点から該当地番を検索(※デフォルト) 1:多角形ポリゴン内の地番を検索 2:円ポリゴン内の地番を検索 未設定の場合、0:座標点検索になります。 |
lat | 緯度 | 半角数値 | 必須 | 世界測地系(wgs84)degree 形式の緯度 |
lon | 経度 | 半角数値 | 必須 | 世界測地系(wgs84)degree 形式の経度 |
polygon | 多角形ポリゴン | 半角数字、カンマ | 必須(1:多角形ポリゴン検索のみ) | 多角形ポリゴン検索(検索種類:1)では必須。 多角形ポリゴンの角座標を経度緯度の順にカンマ区切りで設定 例)3角形なら各3点の頂点座標と終点して始点の座標を加えた4点の座標を設定 [経度,緯度,経度,緯度,経度,緯度,経度,緯度]として設定 最大10点とする。(10角形まで) ※指定範囲内の地番数が設定された最大数を超えた場合エラーとなります。 ※最初(始点)と最後(終点)の座標は同一としてください。相違の場合エラーとなります。 |
radius | 半径 | 半角数字 | 必須(2:円ポリゴン検索のみ) | 円ポリゴン検索(検索種類:2)では必須。 単位はメートルとし小数点での指定は不可となります。 |
is_polygon | ポリゴン返却有無 | true / false | 任意 | trueの場合、地番ポリゴンがレスポンスに含まれます(応答速度が低下します) 未指定の場合は false が指定されます。 ※座標点検索(検索種類:0)のみ有効 |
is_num | 総件数返却有無 | true / false | 任意 | trueの場合、指定条件の総件数がレスポンスに含まれます(応答速度が低下します) 未指定の場合は false が指定されます。 ※多角形ポリゴンおよび円ポリゴン検索時のみ有効 |
limit | 取得件数 | 半角数値 | 任意 | 未設定の場合、10になります。 ※最大50まで |
offset | 取得開始位置 | 半角数値 | 任意 | 未設定の場合、0になります。 |
項目名 | 値 | 補足事項 | |
---|---|---|---|
status | ステータス |
レスポンス状態を表します。正常に完了した場合は「success」 結果が無い場合は「zero results」 パラメータ不正やシステムエラーで終了した場合は「error」となります。 |
|
error_message | エラーメッセージ | ステータスが「error」の場合にデバッグ用情報が格納されます。 | |
chiban | pref_name | 都道府県名 | |
city_name | 市区町村名 | ||
ooaza_name | 大字名 | ||
aza_name | 小字名 | ||
chiban | 地番 | ||
address_chiban | 住所地番結合文字列 | 都道府県名、市区町村名、大字名、小字名、地番の順に結合した文字列 | |
jis_code | JIS市町村コード | 住所コード(都道府県+市区町村):5桁 | |
ooaza_code | 大字コード | 住所コード(大字):3桁 | |
aza_code | 字コード | 住所コード(字):3桁 | |
adcd | 住所コード | JIS市町村コード、大字コード、字コードを結合した11桁のコード | |
mitei_f | 筆界未定フラグ | 「1」の場合、筆界未定。それ以外は「0」 | |
chiban_yyyymm | 地番整備年月 | ||
lat | 地番の緯度 | ||
lon | 地番の経度 | ||
polygon | 地番ポリゴン | GeoJSON形式となります。 | |
num | 検索総件数 | リクエストパラメータで入力された条件の総件数 | |
input_limit | 入力取得件数 | リクエストパラメータで入力されたlimit | |
input_offset | 入力取得開始位置 | リクエストパラメータで入力されたoffset |
https://chibanapi.geospace.jp/api/reverseChiban/?lon=139.79331403970718&lat=35.70949407099177&appid=[appid]
{ "chiban":[ { "pref_name":"東京都", "city_name":"台東区", "ooaza_name":"雷門", "aza_name":"1丁目", "chiban":"37‐1", "address_chiban":"東京都台東区雷門1丁目37‐1", "jis_code":"13106", "ooaza_code":"010", "aza_code":"001", "adcd":"13106010001", "mitei_f":"0", "lon":"139.793440896502", "lat":"35.7095174550498" } ], "status":"success", "input_limit":10, "input_offset":0 }
https://chibanapi.geospace.jp/api/reverseChiban?search_type=1&appid=[appid]&polygon=139.793099462986,35.709844715078404,139.7937512397766,35.70975106494538,139.79373782873154,35.70930459186816,139.793099462986,35.709844715078404
"chiban":[ { "pref_name":"東京都", "city_name":"台東区", "ooaza_name":"雷門", "aza_name":"1丁目", "chiban":"37‐1", "address_chiban":"東京都台東区雷門1丁目37‐1", "jis_code":"13106", "ooaza_code":"010", "aza_code":"001", "adcd":"13106010001", "mitei_f":"0", "lon":"139.793440896502", "lat":"35.7095174550498" } { "pref_name":"東京都", "city_name":"台東区", "ooaza_name":"雷門", "aza_name":"1丁目", "chiban":"45", "address_chiban":"東京都台東区雷門1丁目45", "jis_code":"13106", "ooaza_code":"010", "aza_code":"001", "adcd":"13106010001", "mitei_f":"0", "lon:"139.792878019042", "lat:"35.7097944838895" } ・ ・<省略> ・ ], "status":"success", "input_limit":10, "input_offset":0 }
https://chibanapi.geospace.jp/api/reverseChiban?search_type=2&appid=[appid]&lon=139.79331403970718&lat=35.7094940709917&radius=100
{ "chiban":[ { "pref_name":"東京都", "city_name":"台東区", "ooaza_name":"雷門", "aza_name":"1丁目", "chiban":"37‐1", "address_chiban":"東京都台東区雷門1丁目37‐1", "jis_code":"13106", "ooaza_code":"010", "aza_code":"001", "adcd":"13106010001", "mitei_f":"0", "lon":"139.793440896502", "lat":"35.7095174550498" } { "pref_name":"東京都", "city_name":"台東区", "ooaza_name":"雷門", "aza_name":"1丁目", "chiban":"46‐3", "address_chiban":"東京都台東区雷門1丁目46‐3", "jis_code":"13106", "ooaza_code":"010", "aza_code":"001", "adcd":"13106010001", "mitei_f":"0", "lon:"139.793029267019", "lat:"35.7095163720458" } ・ ・<省略> ・ ], "status":"success", "input_limit":10, "input_offset":0 }