Groove Technology の郵便番号検索 API を扱う Services_Groove_ZipSearch を作りました

- グルーブテクノロジー株式会社 - Web サービス
  http://groovetechnology.co.jp/webservice/

  グルーブテクノロジーによる郵便番号検索 API を利用して，結果を取得するライブラリ Services_Groove_ZipSearch を作りました．

  この API の特長は，JSON 形式，JSONP 形式，XML 形式，PHP の serialize() 形式という風に，任意の形式で出力を受け取れることです．
  今回は，PEAR パッケージにしてみました．

- Services_Groove_ZipSearch-0.1.0
  http://pocari.org/tools/php/Services_Groove_ZipSearch-0.1.1.tgz

  インストールは，以下のようできます．

# pear install http://pocari.org/tools/php/Services_Groove_ZipSearch-0.1.1.tgz

- 使い方

<?php

require_once 'Services/Groove_ZipSearch.php';

$zip = new Services_Groove_ZipSearch;

$result = $zip->search(1000001);
if (PEAR::isError($result)) {
    exit($result->getMessage());
}

print_r(unserialize($result));
?>

- 出力

Array
(
    [address] => Array
        (
            [0] => Array
                (
                    [zipcode] => 1000001
                    [prefecture] => 東京都
                    [city] => 千代田区
                    [town] => 千代田
                    [prefecture_yomi] => トウキョウト
                    [city_yomi] => チヨダク
                    [town_yomi] => チヨダ
                )

        )

    [office] => Array
        (
        )

)

  Groove_ZipSearch::search() に郵便番号検索 API のパラメータを渡すことができます．
  パラメータの種類と順序は，郵便番号検索 API のリクエストパラメータと同じです．詳しくはソースを見てください．

  また，郵便番号検索 API の出力形式 (format) のデフォルト値は json になっていますが，このライブラリでは PHP になっています．
  すなわち，serialize() された形がデフォルトで戻ってきます．

- via: using API; RESTで使える郵便番号検索API
  http://api.zuzara.com/archives/115

- 追記 (2007-12-18)
  サンプルが間違っていたのを修正して、0.1.1 (alpha) をリリースしました。
  サンプルの出力結果を追記しました。