郵便番号・住所検索API Ver 1.0 マニュアル

データベース構築

郵便番号と住所のデータは、管理メニューの上にある「データベース構築」から構築します。

このボタンは青の背景に白で「データベース構築」と書かれています。

「データベース構築」をクリックするとデータアップロード場面が表示されます。画面の説明に従って処理を進めてください。

CSVファイルのダウンロード

本 CGI の郵便番号情報には、日本郵政ゆうびんホームページで公開されている郵便番号データ(事業所の個別郵便番号を含む)を採用しています。そのため、前述のサイトより郵便番号データをダウンロード頂き、データベース構築処理を行わなければいけません。

日本郵政ゆうびんホームページで公開されている郵便番号データ(事業所の個別郵便番号を含む)は、LHA 形式で圧縮されたファイル(拡張子は .lzh)として公開されています。CSV ファイルのアップロード画面に、そのダウンロードリンクが掲載されていますので、それをクリックして、該当の圧縮ファイルをダウンロードしてください。

CSV アップロード欄にはファイル・アップロード・コントロールが 2 つあります。それぞれには、住所の郵便番号 CSV ファイル(KEN_ALL_CSV)と事業所の個別郵便番号 CSV ファイル(JIGYOSYO.CSV)をセットします。

CSV アップロード欄

必要なデータは、以下の 2 つです。

ken_all.lzh と jigyosyo.lzh は、Windows であれば、緑色のフォルダ・アイコンとして表示されます。

ken_all.lzh と jigyosyo.lzh をダウンロードしたら、それらを解凍してください。Windows であれば、ダブルクリックすると圧縮ファイルの中身がすぐにご覧いただけるはずです。それぞれの圧縮ファイルの中にある CSV ファイルをデスクトップなどにコピーしてください。

KEN_ALL.CSV と JIGYOSYO.CSV は、Microsoft Excel がインストールされていれば、Excel ファイルのアイコンとして表示されます。

CSV ファイルのダウンロードとデスクトップへのコピーが終わったら、引き続き、CSV ファイルのアップロードへ進んでください。

CSVファイルのアップロードと構築処理

管理メニューの CSV ファイルのアップロード欄の「参照」ボタンを押して、デスクトップにコピーした KEN_ALL.CSV と JIGYOSYO.CSV をそれぞれに選択してください。ChromeFirefoxSafari の最新版であれば、デスクトップからドラッグ & ドロップでファイルをセットすることも可能です。

CSV アップロード画面 に CSV ファイルをセットすると、ファイル選択コントロールに選択ファイルのファイル名がパス付きで表示されます。

CSV アップロード欄

CSV ファイルをセットしたら「アップロード」ボタンを押してください。サーバーへ、CSV ファイルがアップロードされ、データベース構築の準備が行われます。アップロードが完了すると、構築処理画面が表示されます。

構築処理画面には、3 つのプログレスバーが表示されます。処理が開始される前は、いずれのプログレスバーには「待機中」と表示されます。

構築処理画面(開始前)

構築処理画面が表示されたら「構築開始」ボタンを押してください。ブラウザーを閉じずに、処理が完了するまでお待ちください。ご利用のサーバーにもよりますが、処理完了までに 5 分程度かかります。処理が完了すると、「構築開始」ボタンの上に「処理完了」と表示されます。

処理が完了すると、すべてのプログレスバーは 100 パーセントの状態になり、さらに、画面上部に「処理完了」と表示されます。

構築処理画面(構築中)

以上でデータベース構築の処理が完了です。引き続き、検索動作確認を行ってください。

検索動作確認

データベース構築が完了したら、管理メニューの上にある「データベース構築」を開いてください。

データベース構築ボタン

データベースの構築が正常に完了していれば、最終データベース構築日時欄が表示されます。この欄の中に郵便番号を入力するテキスト入力フィールドと動作確認ボタンが表示されます。

最終データベース構築日時表示欄

郵便番号を入力するテキスト入力フィールドにはデフォルトで 123 がプリセットされていますが、お好きな郵便番号の候補に書き換えて頂いても構いません。そして「動作確認」ボタンを押してください。データベース構築が正常に完了していれば、検索結果が表示されるはずです。

郵便番号から検索された住所の一覧がグレーの子ウィンドウに表示されます。

動作確認結果

実在しない郵便番号を入力すると何も表示されませんので注意してください。もし実在するはずの郵便番号を指定したにもかかわらず何も表示されない場合は、データベース構築に失敗している可能性がありますので、再度、データベース構築をやり直してください。

検索動作確認が問題なければ、サイトへの組み込みに進んでください。