郵便番号検索WebAPI

service サービス内容

郵便事業株式会社ホームページで提供されている郵便番号データを利用して、郵便番号から住所、住所から郵便番号を検索します

nekokoba ご利用方法

住所、または郵便番号をセットして、サービスを呼び出してください。

リクエストURL：http://websvr.kumakake.com/cgi-bin/zipsearch/v1/zipsearch.pl?
住所から検索する例）
$adr = uri_escape( encode( 'utf8', "兵庫県西宮市南昭和町" ));
$document = LWP::Simple::get( 'http://websvr.kumakake.com/cgi-bin/zipsearch/v1/zipsearch.pl?addr=' . $adr . '&fmt=xml' );
郵便番号から検索する例）
$document = LWP::Simple::get( 'http://websvr.kumakake.com/cgi-bin/zipsearch/v1/zipsearch.pl?zip=6620834&fmt=xml' );

パラメータの説明

パラメータ	値	説明
addr	全角文字列	記載された文字列が含まれる住所を検索します
zip	半角数値文字	記載された文字列が含まれる住所を前方一致で検索します
ftm	'xml' または 'json'	返却するデータフォーマットを指定します。

※addrとzipが両方記載された場合、addrが優先されます。

返却データ:UTF-8で返却されます
◯XML

$VAR1 = '
	<address>
		<city>西宮市</city>
		<prefecture>兵庫県</prefecture>
		<town>南昭和町</town>
		<zipcode>6620834</zipcode>
	</address>
	<datetime>2010/04/11 10:03:37</datetime>
	<msg></msg>
	<status>0</status>
	<version>1.0</version>
</opt>
';

◯JSON

$js = decode_json( $document );
warn Dumper( $js );
な、結果です。。
$VAR1 = {
 'msg' => '',
 'status' => 0,
 'version' => '1.0',
 'address' => [
  {
   'city' => "\x{e8}\x{a5}\x{bf}\x{e5}\x{ae}\x{ae}\x{e5}\x{b8}\x{82}",
   'town' => "\x{e5}\x{8d}\x{97}\x{e6}\x{98}\x{ad}\x{e5}\x{92}\x{8c}\x{e7}\x{94}\x{ba}",
   'zipcode' => '6620834',
   'prefecture' => "\x{e5}\x{85}\x{b5}\x{e5}\x{ba}\x{ab}\x{e7}\x{9c}\x{8c}"
  }
 ],
 'datetime' => '2010/04/11 10:03:36'
};

パラメータの説明

パラメータ	値	説明
status	整数値	0:正常終了 -1:検索データが設定されていない -2:文字列長が範囲外である(1 〜 256 ) -3:規定外の文字列が含まれている
msg	半角数値文字	statusに応じたメッセージが返却される 0:'' -1:'Not Define' -2:'Illegurar Length:文字列長 -3:'Illegurar Keyword:入力文字列'
datetime	日付	データが生成された日時が記載されます

service 利用規約

本APIの利用にあたっては、クレジット表示および利用規約に従うものとします。