サービス概要
ZIP SEARCH API SERVICE 「JIS X0401」対応版 の特徴
サンプルページ
郵便番号から住所情報を検索した例
住所情報から郵便番号を検索した例
解説：郵便番号から住所を検索する場合
表示するWebページのフォーマット
JSONPのリクエスト
//リクエスト書式
http://api.thni.net/jzip/X0401/JSONP/郵便番号上3桁の数値/郵便番号下4桁の数値.js
//例 http://api.thni.net/jzip/X0401/JSONP/064/0941.js
JSONPの取得データ型
//取得データ例
ZipSearchValue({ "state":"1", "stateName":"北海道", "city":"札幌市中央区", "street":"旭ケ丘" })
JSONのリクエスト
//リクエスト書式
http://api.thni.net/jzip/X0401/JSON/郵便番号上3桁の数値/郵便番号下4桁の数値.js
//例 http://api.thni.net/jzip/X0401/JSON/064/0941.js
JSONの取得データ型
//取得データ例
{ "state":"1", "stateName":"北海道", "city":"札幌市中央区", "street":"旭ケ丘" }
配列キー
// "state" サンプルページの都道府県選択利用の場合のoption value
// "stateName" 都道府県名
// "city" 市・区・群名
// "street" : 町・村名
解説：住所情報から郵便番号を検索する場合
表示するWebページのフォーマット
リクエストについて
JSONPのリクエスト
//都道府県リストをリクエスト
例 http://api.thni.net/jzip/X0401/JSONP/J/state_index.js
//取得データ型 StateIndex([{"name":"北海道","kana":"ホッカイドウ"}, {...}])
--▼----------------------------------
//市・区・群リストをリクエスト （都道府県名をディレクトリの要領で以下のようにリクエスト※）
例 http://api.thni.net/jzip/X0401/JSONP/J/北海道/city_index.js
//取得データ型 CityIndex([{"name":"札幌市中央区","kana":"サッポロシチュウオウク"},{...}])
--▼----------------------------------
//町・村リストをリクエスト（都道府県名、市・区・群をディレクトリの要領で以下のようにリクエスト※）
例 http://api.thni.net/jzip/X0401/JSONP/J/北海道/札幌市中央区/street_index.js
//取得データ型
StreetIndex([{"name":"以下に掲載がない場合","kana":"イカニケイサイガナイバアイ"}, {"name":"旭ケ丘","kana":"アサヒガオカ"}'{...}])
--▼----------------------------------
//郵便番号リクエスト（都道府県名、市・区・群、町・村をディレクトリの要領で以下のようにリクエスト※）
例 http://api.thni.net/jzip/X0401/JSONP/J/北海道/札幌市中央区/旭ケ丘.js
//取得データ型
KenSearchValue({ "zipcode":"064-0941", "state":"北海道", "city":"札幌市中央区", "street":"旭ケ丘",
"state_kana":"ホッカイドウ", "city_kana":"サッポロシチュウオウク", "street_kana":"アサヒガオカ" })
--■ご注意----------------------------------
※日本語の部分にはencodeURIをかけてリクエストしてください。
JSONのリクエスト
//都道府県リストをリクエスト
例 http://api.thni.net/jzip/X0401/JSON/J/state_index.js
//取得データ型 [{"name":"北海道","kana":"ホッカイドウ"},{...}]
--▼----------------------------------
//市・区・群リストをリクエスト（都道府県名をディレクトリの要領で以下のようにリクエスト※）
http://api.thni.net/jzip/X0401/JSON/J/北海道/city_index.js
//取得データ型 [{"name":"札幌市中央区","kana":"サッポロシチュウオウク"},{...}]
--▼----------------------------------
//町・村リストをリクエスト（都道府県名、市・区・群をディレクトリの要領で以下のようにリクエスト※）
例 http://api.thni.net/jzip/X0401/JSON/J/北海道/札幌市中央区/street_index.js
//取得データ型
[{"name":"以下に掲載がない場合","kana":"イカニケイサイガナイバアイ"}, {"name":"旭ケ丘","kana":"アサヒガオカ"},{...}]
--▼----------------------------------
//郵便番号リクエスト（都道府県名、市・区・群、町・村をディレクトリの要領で以下のようにリクエスト※）
例 http://api.thni.net/jzip/X0401/JSON/J/北海道/札幌市中央区/旭ケ丘.js
//取得データ型
{ "zipcode":"064-0941", "state":"北海道", "city":"札幌市中央区", "street":"旭ケ丘",
"state_kana":"ホッカイドウ", "city_kana":"サッポロシチュウオウク", "street_kana":"アサヒガオカ" }
--■ご注意----------------------------------
※日本語の部分にはencodeURIをかけてリクエストしてください。
配列キーについて
//郵便番号リクエスト時の配列キー
"zipcode"：郵便番号
"state"：都道府県名
"city"：市・区・群名
"street"：町・村名
ご注意事項とお願い
- 必ずご利用規約をお読みいただき、同意の上ご利用ください。
- 内容及び動作、仕様、サービス自体の提供について予告なしに変更、または中止する場合がございます。
- 本サービスはネットワーク状況やメンテナンスその他の要因により、一時機能しない場合がございます。
ご利用規約
- 著作権は、「IW3 PROJECT」が保有します。
- 当サイトのサービスを利用した時点で当規約に同意したものとみなします。
- 個人・法人・商用・非商用問わず無料でご利用可能です。
- 各種コンテンツ等の無断転用を禁じます。
- 本サービスの使用又は使用不能から生じるお客様の損害について、当社は一切の責任を負いません。
- 管理人が不適当と判断した場合、設置・利用・公開・サービス提供を中止していただく場合があります。
- このページの内容（著作権・免責事項・その他）は変更する場合があります。