ZIP SEARCH API SERVICEver 1.0.0
サービス概要
- 郵便番号(3桁+4桁)から住所を検索するAPIです。
- jsonデータ形式で無料提供しております。
- 住所データは月初にデータベースを自動更新しています。
- 事業所の個別郵便番号にも対応。(2011/8/4より)
- サンプルページをご用意しております。
- 必ずご注意事項とお願い、ご利用規約をご覧の上ご利用ください。
- 都道府県コード対応版のご案内はこちら [ ZIP SEARCH API SERVICE 「JIS X0401」対応版 ]
サンプルページ
解説
表示するWebページのフォーマット
- XHTML形式、文字コードはutf-8です。
- javascriptの文字コードはutf-8です。(受け取るデータには日本語文字列が含まれます。)
変数設定
//郵便番号の変数を指定します。 var zip3=郵便番号最初の3桁; var zip4=郵便番号最初の4桁;
リクエスト
javascript、jQueryによる取得例です。
javascript版のリクエスト
//リクエスト書式 var url = "http://api.thni.net/jzip/"+zip3+"/"+zip4+".json" //リクエストするJSONのアドレスを生成 //リクエストします。 callJSONP( url ); //javascriptのエレメントを生成 function callJSONP(url) { var target = document.createElement('script'); target.charset = 'utf-8'; target.src = url; document.body.appendChild(target); }
jquery版のリクエスト
$.getJSON( "http://api.thni.net/jzip/"+zip3+"/"+zip4+".json" + '?jsoncallback=?');
コールバック関数書式
function ZipSearchValue(data){ //受信後の処理 //※上の関数名は固定です。 }
データ型について
取得するデータは以下の書式です。
書式サンプル
ZipSearchValue({ "state":"13", "stateName":"東京都", "city":"荒川区", "street":"東日暮里" })
配列キーについて
//配列キーは以下の通りです。 // "state" サンプルページの都道府県選択利用の場合のoption value ※optionのvalueとラベルはサンプルページのソースからコピーしてご利用ください。 // "stateName" 都道府県名 // "city" 市・区名 // "street" : 町・村・番地
ご注意事項とお願い
- 必ずご利用規約をお読みいただき、同意の上ご利用ください。
- 内容及び動作、仕様、サービス自体の提供について予告なしに変更、または中止する場合がございます。
- 本サービスはネットワーク状況やメンテナンスその他の要因により、一時機能しない場合がございます。
ご利用規約
- 著作権は、「IW3 PROJECT」が保有します。
- 当サイトのサービスを利用した時点で当規約に同意したものとみなします。
- 個人・法人・商用・非商用問わず無料でご利用可能です。
- 各種コンテンツ等の無断転用を禁じます。
- 本サービスの使用又は使用不能から生じるお客様の損害について、当社は一切の責任を負いません。
- 管理人が不適当と判断した場合、設置・利用・公開を中止していただく場合があります。
- このページの内容(著作権・免責事項・その他)は変更する場合があります。