陽気に郵便番号検索

※陽気に郵便番号検索開発キットは.NETバージョンに置き換わりました。このページのサポートは2005年12月で終了しています。

「陽気に郵便番号検索」はウェブサイト、ソフトウェア開発者のための郵便番号検索機能組み込み開発キットです。郵便番号<=>住所の双方向の変換処理をサポートします。住所として与えられる文字列の柔軟な解析で、該当する郵便番号の複数候補を提示することも可能です。

<<特徴>>

郵政公社が提供する全国の一般住所と、大口事業所のすべてのデータが含まれています。
COMオブジェクト、HTML(XSLテンプレートによる自由デザイン）、XMLサービス、SOAP（予定）の３種類のインターフェイスを持ち、貴殿の開発中のソフトに柔軟に対応して、組み込んで使用して頂くことができます。
独自のデータ加工で、より正確な検索、柔軟な候補選択が可能になりました。

<<応用例>>

ウェブサイトの住所入力フォームの支援機能
開発中の任意のアプリケーションへの追加機能

本コンポーネントは、検索処理に特化し、WindowsのGUI（ユーザーインターフェース）は一切持ちません。一方で、開発者が利用しやすいシンプルなメソッド を提供し、ウェブデザインではデザイナがプログラムの知識がなくてもテンプレートを自由に定義できる方法を提供します。

「陽気に郵便番号検索」は3種類の形態のプログラミングモデルを提供します。

■COMオブジェクト（OLEオートメーションオブジェクト）

VBScript, JScript(JavaScript), VisualBasic(AccessやWordなどのOffice製品を含む）,VisualC++、その他のMicrosoftのほとんどの開発言語から使用が可能 な COMコンポーネントです。CreateObject、CoCreateInstanceなどのメソッド、APIを使ったプログラミングに精通した方なら簡単に使用可能です。

＞サンプルページはこちらへ
 ＞COM仕様

■ウェブサービス（HTML＆XML）

よく見かけるのウェブページ上のフォームにある住所入力欄に、郵便番号から住所を、あるいは住所から郵便番号を調べて自動的に入力を補完する機能を付けたいと思われたことがあるでしょう。ISAPIをサポートするウェブサーバー（IISやWindows版Apacheなど）にインストールすることで、簡単にその機能を実装することができます。本モジュールは内部的に検索結果をXMLで出力し、XSLを使ってHTMLに変換することから、ユーザーインターフェイスは完全にフリー。プログラマの手を借りることなくウェブデザイナが望むデザインの中に組み込めます。デザインを伴わないXMLサービスとしても使用可能です。

＞HTMLサンプルページはこちらへ
 ＞XMLサンプルページはこちらへ
 ＞HTML&XML仕様

■ウェブサービス（SOAP版）　※のちのバージョンで実装予定

動作環境

OS環境

	Windows 98/ME	Windows NT4	Windows 2000	Windows XP	Windows 2003
COMオブジェクト	○※１	◎	◎	◎	◎
HTML＆XML版ISAPI	×	×	◎	◎	◎

◎ OSの標準的なインストール状態で使用可能　○ 追加コンポーネントのインストールが必要

※１標準構成に加えて DCOM98 Version 1.3 および MDAC 2.5 以上のインストールが必要

※２標準構成のIISによる動作についてのみ確認

※ COMオブジェクトの動作には、MDAC、HTML&XMLの動作には、MSXMLのランタイム機能を使用します。これらのコンポーネントの最新版がインストールされた環境を推奨します。

※ yzipcode.dllはデータベースにアクセスした状況で約26MBのメモリを消費します。

動作確認済みウェブサーバー

ウェブサーバー	OS	HTML/XML	備考
IIS 4.0	Windows NT4.0	×
IIS 5.0	Windows 2000	◎
IIS 5.1	Windows XP	◎
IIS 6.0	Windows 2003 Server	◎
Apache 1.3.28	Windows	△	mod_isapiによる実行。IISよりパフォーマンスに劣ります。また現在の所動作に不安定な点が見られます。
An HTTPD 1.42	Windows	×	動作しません

※ISAPIモジュールをキャッシュすることができないため、1回の検索処理ごとにデータベースがメモリ上にロードアンロードされ、十分なパフォーマンスが得られません。

インストール方法

インストールパッケージ yzipcode.exe を実行すると内容が次のディレクトリをデフォルトにして展開されます。

C:\Program Files\Common Files\Yokinsoft\YZipCode

インストーラは自動的に readme.hta ファイルを開きます。DLLの登録処理、ライセンスキーの登録処理はここからもできるようになっています。

3種類の目的別の使用方法がありますが、いずれの場合も yzipcode.dll と yzipcode.mde ファイルを同じディレクトリに配置します。COMオブジェクトとしての登録は regsvr32.exe や個別のインストーラを通じて登録処理が必要です。COMオブジェクトとして登録した場合、DLLファイルの移動などでファイルシステム上のパスが変わると再度登録処理が必要です。

主要ファイル一覧

ファイル名	内容
yzipcode.dll	COMサービス、ISPAIサービスの両方として機能するDLLコンポーネント
yzipcode.mde	郵便番号、住所検索のためのデータベース。次のINIファイルを用いない場合は、yzipcode.dllと同じディレクトリに配置します。
yzipcode.ini	yzipcode.mde ファイルを別のディレクトリパスに置いたときのパス指定など、設定情報を記述します。
yzipcode.xsl	HTML(ISAPI)動作時のXSLテンプレートファイル。XSLファイルは必ず実行される yzipcode.dll と同じディレクトリに置きます。

※太字ファイルは必須ファイル

yzipcode.dll と同じディレクトリに yzipcode.mde ファイルを配置したくない場合、あるいは、yzipcode.dllを複数のディレクトリに配置して、yzipcode.mdeは共通して１つのファイルを使いたい場合があります。その場合、yzipcode.ini ファイルをyzipcode.dllに配置して、そのファイルに、yzipcode.mde ファイルへのパスを記述します。

ウェブサーバーに yzipcode.dll を配置する場合はセキュリティー上の配慮から yzipcode.mde または yzipcode.ini ファイルへのアクセスを遮断するように設定することが望まれます。

yzipcode.iniの内容

[YZIPCODE]
DatabasePath=C:\Program Files\Common Files\Yokinsoft\YZipCode\yzipcode.mde
　

COMオブジェクトとして使用する場合

配置されるyzipcode.dllのパスは任意です。regsvr32またはインストーラの機能などを使ってレジストリへの登録が必要です。

ISAPIモジュールとして使用する場合

IISへISAPI DLLの実行を許可しているディレクトリに配置します。（regsvr32相当のレジストリへの登録処理は必要ありません）IISでのISAPIの設定で「アプリケーション保護」の設定は、いずれでもかまいませんが、メモリの消費が多いこと空も「分離プロセス」などを選択することをおすすめします。

アンインストール方法

自動的なアンインストール方法は用意されていません。

regsvr32 /u <yzipcode.dllへのパス>

でレジストリへの登録か解除し、インストールされているファイルをフォルダごと削除します。デフォルトのインストールパスは次の通りです。

C:\Program Files\Common Files\Yokinsoft\YZipCode

ライセンス条件

●著作権

「陽気な郵便番号検索」（以下、本ソフトウェア）の住所データベースの内容を除く部分のすべての著作権は陽気なソフト（当方）に属します。本ソフトウェアの使用方法は、後述の未登録状態、登録状態のいずれかの元に、指定された条件の下使用することを許諾します。

●無保証規定

「陽気な郵便番号検索」（以下、本ソフトウェア）は提供される時点における現状のものをそのまま提供するもので、現在未知の内在するいかなる不具合や、さらに本ソフトウェアを使用した結果によるいかなる障害、損害に対しても、当方は責任を負わないものとします。また、データベースの表示形態など将来のバージョンで仕様が変更される可能性があります。

●本ソフトウェアの使用条件は、「未登録」状態での使用と、「登録」状態での使用の2つがあります。

○未登録での使用上の制限

検索結果の文字列にランダムに未登録である旨の文字列が挿入されます。
ただし、次項のバナーの表示を伴うHTML出力を行うISAPIとして使用した場合に限り、検索結果は完全な状態で出力されます。
ISAPIとして使用し、XSLテンプレートを使いHTMLページとして使用した場合、表示ページ内に「陽気なソフト」のバナーを挿入するJavaScriptが挿入されます。（このバナーを意図的に隠蔽するような行為は契約違反とします。）

以上の制限を許容する限りに置いて、開発目的、商用、非商用の目的のいずれの場合にも、本ソフトウェアの購入、ユーザー登録、ライセンスキーの交付なしに、無期限の使用を許諾します。

○ライセンス登録による使用

「未登録状態」における制限事項を解除した状態で使用可能になります。

ライセンス数は次の条件のうち、数量が最小となる数え方を選択した場合の数を適用するものとします。

本ソフトウェアがインストールされるOS数（Microsoft Windowsのライセンス数）
本ソフトウェアがインストールされるインターネット上のドメイン名（フルドメイン名）の数

例1）	1台のサーバー上のIISに複数ドメインを設定して1つ以上のパスにyzipcode.dllを設定した。	=>1ライセンス
例2）	1台のPC上にVirtualPCまたはVMWareなどの仮想マシンソフトで、複数のOSをインストールし、それぞれのOS環境のIISに2種類のドメイン名を与え、yzipcode.dllをインストールした	=> 2ライセンス
例3）	1台のPC上にVirtualPCまたはVMWareなどの仮想マシンソフトで、複数のOSをインストールし、それぞれのOS環境のIISに同じドメイン名を与え、yzipcode.dllをインストールした	=> 1ライセンス
例3）	開発したある１つのアプリケーションソフトにyzipcode.dllを組み込み、組織内10台のPCにインストールして使用する。	=>10ライセンス
例4）	開発したあるアプリケーションソフトが組織内に多数配布され、そのアプリケーションソフトは組織内の1台のPCにインストールされたyzipcode.dllのXMLサービスにアクセスする。	=> 1ライセンス

※なお、本ソフトウェアを組み込んだソフトウェアの不特定多数の再配布を予定している場合や、OEMなどを希望される場合など個別に契約内容を相談させて頂きます。

ライセンス登録の購入方法、インストール方法についてはこちらをご覧下さい。

サポート

本ソフトウェアのサポートは当方のウェブサイト上または、電子メールにて行います。

ソフトウェアのバージョンアップなどはウェブサイト上にて告知します。特に、郵便番号データベースファイルは頻繁に更新されるため、データベースファイルのみを個別にダウンロード可能な場所に用意します。

なお、既存のウェブサーバーへの本システムの組み込みについて、当方に、インストールの可否、インストール作業を依頼して頂くこともできます。その場合、組み込み工賃は別途見積となります。

mailto: support@yo-ki.com
http://www.yo-ki.com/software/yzipcode/

※本システムでは、郵政公社が著作権フリーで提供する全国の郵便番号データを独自に加工、最適化処理して実装しています。