郵便番号（7桁）から住所を検索するCGIです。日本郵政のゆうびんホームページの郵便番号ページにて公開されている新郵便番号データ（事業所の個別郵便番号を含む）からデータベースを構築されています。日本全国すべての郵便番号に対応しております。また、郵便番号データベースは膨大ながらも、GDBM（GNUデータベース・マネージャ）を使っているため、すばやい検索を実現しております。ホームページでのご注文フォームなどで住所の入力軽減ツールとしてご利用ください。入力フォームや結果ページはテンプレート方式ですので、ご自由にカスタマイズできます。
サンプルでは、郵便番号を入力させ注文フォームの住所欄に自動的に結果が挿入されることを想定したものです。このサンプルは、同梱されているテンプレートファイルとは異なります。
日本郵政のゆうびんホームページの郵便番号ページにて公開されている新郵便番号データ（事業所の個別郵便番号を含む）に登録されている住所を検索し、ページに表示します。表示できる項目は、以下の通りです。
| ※ | 事業所郵便番号の場合にのみ検索されます。 |
|---|
検索結果のページは、テンプレート方式を取っておりますので、デザインは自由自在に設定できます。また、不要なデータを表示しないようにすることも自由自在です。
CGIを一つセットアップするだけで、検索結果に使うテンプレートは、いくつでもご利用いただけます。
郵便番号を全角で入力しても、ハイフンを入れても入れなくても、正しく検索可能です。
このCGIは、以下の環境下で動作します。お使いのサーバが対応しているかをご確認ください。
| 個人利用 | 法人・商用利用 |
|---|---|
| 無料 フリーソフトとしてご利用頂けます。 |
1サイトあたり ￥1,050 本体価 ￥1,000 消費税 ￥50 |
クレジットカード決済、コンビニ決済、Vectorシェアレジ、銀行振込をご用意しております。シェアウェア料金のお支払はこちらからどうぞ。
このパッケージに含まれるデータベースは、日本郵政公社のゆうびんホームページの郵便番号ページにて公開されている平成17年1月31日更新版を、Linux サーバ用にデータベース化したものです。FreeBSD サーバをお使いの場合には、別途、データベースファイルをダウンロードしてください。Linux サーバをご利用の方においても、最新版のデータベースは、別途、下段のデータベースファイルをダウンロードして下さい。
ダウンロードの前に、必ず、CGI 利用規定を良くお読みになり、同意したうえで、ご利用下さい。
| バージョン | サイズ | ファイル |
|---|---|---|
| 2.3 | 5.52 MB (5,793,148 バイト) | postalcode2_3.zip  |
日本郵政のゆうびんホームページの郵便番号ページにて公開されている平成19年08月31日更新版をデータベース化したものです。お使いのサーバ OS にあわせて、ダウンロードしてください。解凍すると、localcode.gdbm, postalcode.gdbm が同梱されています。これらのファイルを、BINARY モードでサーバに上書きアップロードして下さい。
|
|
|
|
CGIをダウンロードし、解凍してください。それぞれのファイルについて解説します。
| ファイル名 | パーミッション1 | パーミッション2 | 転送モード | ファイルの機能 |
|---|---|---|---|---|
postalcode/ |
変更不要 | 変更不要 | 本CGI用ディレクトリ | |
getaddr.cgi |
704 | 705 | [ASCII] | CGI本体 |
config.cgi |
変更不要 | 変更不要 | [ASCII] | 設定ファイル |
form.html |
変更不要 | 変更不要 | [ASCII] | 郵便番号入力フォームサンプルHTML |
result.html |
変更不要 | 変更不要 | [ASCII] | 結果テンプレートサンプルHTML |
result1.html |
変更不要 | 変更不要 | [ASCII] | 結果テンプレートサンプルHTML |
error.html |
変更不要 | 変更不要 | [ASCII] | エラー画面テンプレートサンプルHTML |
jcode.pl |
変更不要 | 変更不要 | [ASCII] | 日本語コード変換ライブラリー |
localcode.gdbm |
変更不要 | 変更不要 | [BINARY] | データベースファイル1（Linux 版） |
postalcode.gdbm |
変更不要 | 変更不要 | [BINARY] | データベースファイル2（Linux 版） |
フォルダ「postalcode」を、転送モードに注意して、プロバイダー指定の場所にアップロードしてください。入力フォームとなる「form.html」に関しては、通常の HTML ファイルをアップロードする場所に設置してください。ただし、form タグ内の CGI の URL は書き換えてください。（後述）
また、データベースファイルは 2 つ（localcode.gdbm, postalcode.gdbm）ありますが、これらのファイルも同じディレクトリにアップロードしてください。データベースファイルをアップロードする際には、バイナリーモードで転送してください。
同梱されているデータベースファイルは Linux サーバ用です。お使いのサーバが Free BSD または Solaris（Intel 版）の場合には、別途、こちらからデータベースファイルをダウンロードして、お使いのサーバにアップロードして下さい。
これらパーミッションは、あくまでも例です。お使いのプロバイダー、レンタルサーバ業者の指示に従ってください。
上表には、パーミッションの指定が 2 種類指定しております。CGI がオーナー権限で実行されるサーバをお使いの場合には、パーミッション１の設定を使ってください。CGI が ohter 権限で実行されるサーバをお使いの場合には、パーミッション２の設定を使ってください。
CGI がオーナー権限で実行されるか、other 権限で実行されるかは、お使いのプロバイダーもしくはレンタルサーバ業者に確認してください。おおむね、CGI ファイルのパーミッションが、704 でも動作する場合には、オーナー権限で実行されると考えても結構です。CGI ファイルのパーミッションが、705 もしくは 707 でないと動作しない場合には、other 権限で実行されているとお考えください。
「変更不要」と指定しているファイルは、サーバにアップロードするだけで OK です。あえてパーミッションを変更しないでください。
とりあえず、動かしてみましょう。以下の手順に従って、サンプルを動かしてみましょう。
添付の郵便番号入力フォームHTML「form.html」をテキストエディタで開いてください。
「getaddr.cgi」の部分を、CGIを設置したサーバに合わせてURLを正しく書き直してください。
プロバイダーによって、Perlパスが異なります。デフォルトでは「#!/usr/local/bin/perl」と設定しております。プロバイダーの指示に従い、getaddr.cgi の1行目を書き換えてください。ほとんどのプロバイダーではそのままで動作します。
これで設定は完了ですので、サーバへアップロードしましょう。localcode.gdbm, postalcode.gdbm はBINARIモードで、その他のファイルはすべてASCII（テキスト）モードで転送してください。
同梱されているデータベースファイルは Linux サーバ用です。お使いのサーバが Free BSD または Solaris（Intel 版）の場合には、別途、こちらからデータベースファイルをダウンロードして、お使いのサーバにアップロードして下さい。
ホームページコンテンツとCGIのディレクトリが異なるプロバイダーをご利用の方は、「form.html」をホームページコンテンツ用のディレクトリへ、その他はCGI用のディレクトリへアップろロードしてください。転送が完了しましたら、「getaddr.cgi」のパーミッションを「704」にして下さい。もし、お使いのプロバイダーでは異なるパーミッションを指定しているようでしたら、プロバイダーの指示に従ってください。
サーバへアップロードした「form.html」に、ブラウザーでアクセスしてみてください。フォームサンプル画面が表示されましたね。ここに郵便番号を入力して検索ボタンを押してください。すると、該当の住所が表示されます。
いかがでしたか？ちゃんと動いたでしょうか。これからは、あなたの環境に合わせて、少しずつカスタマイズしていってください。次から、カスタマイズの方法をご案内します。
サンプルの「form.html」を例に取り説明します。
それぞれの意味は、以下の通りです。
サンプルの「confirm.html」を例にとり説明します。
例えば、「$PREF$」と書かれた部分は、CGIプログラムによって「東京都」のように都道府県名に置き換えられます。その他の項目も同様で、それぞれに対応した文字列を指定して記述すれば、その部分が該当する結果に置き換えられます。対応は以下の通りです。
| 文字列 | 結果 |
|---|---|
| $POSTALCODE1$ | 検索のキーとなった郵便番号の上３桁です。入力された郵便番号が全角で入力されたとしてもすべて半角数字に変換されます。設定により全角数字に変換することも可能です。 |
| $POSTALCODE2$ | 検索のキーとなった郵便番号の下４桁です。入力された郵便番号が全角で入力されたとしてもすべて半角数字に変換されます。設定により全角数字に変換することも可能です。 |
| $PREF$ | 都道府県名に置き換えられます。（漢字） |
| $CITY$ | 市区町村に置き換えられます。（漢字） |
| $TOWN$ | 小字名、丁目、番地等に置き換えられます。（漢字） |
| $PREFKANA$ | 都道府県名カナに置き換えられます。（全角カナ） |
| $CITYKANA$ | 市区町村名カナに置き換えられます。（全角カナ） |
| $TOWNKANA$ | 小字名、丁目、番地等のカナに置き換えられます。（全角カナ） |
| $ORG$ | 事業所（会社）名に置き換えられます。※ |
| $ORGKANA$ | 事業所（会社）名のカナに置き換えられます。（全角カナ）※1 |
| ※1 | 事業所郵便番号の場合にのみ検索されます。 |
|---|
なお、指定文字列は、全角・半角、大文字・小文字を区別します。必ず半角・大文字で指定して下さい。
サンプルの「error.html」を例にとり説明します。
このエラー画面で注意すべきところは、「$EEROR$」だけです。この部分に、エラーメッセージが表示されますので、お好きなところに、「$EEROR$」を記述して下さい。もし、個別のエラーメッセージではなく、単一のメッセージにしたい場合には、「$EEROR$」を消して下さい。
すべての機能設定、環境設定は、「config.cgi」で行います。すべて重要な設定項目ですので、もれなく説明を読んでいただき、お好みにあわせて設定してください。
Ver 2.0 以上をお使いの方は、getaddr.cgi の Perl のパスを確認のうえ、ASCII モードで上書きアップロードして下さい。加えて、postalcode.gdbm、localcode.gdbm の 2 ファイルをバイナリーモードでサーバに上書きアップロードして下さい。
Ver 1.x をお使いの方は、お手数ながら、設定ファイル config.cgi の設定を再度行っていただき、すべてのファイルを上書きしてください。
【Ver 2.2 → Ver 2.3】 2005/02/09
【Ver 2.1 → Ver 2.2】 2003/11/16
【Ver 2.0 → Ver 2.1】 2002/08/11
【Ver 1.2 → Ver 2.0】 2002/07/24
【Ver 1.1 → Ver 1.2】 2002/06/16
【Ver 1.1 → Ver 1.2】 2002/05/20
【Ver 1.0 → Ver 1.1】 2001/11/15