Zend_Service_StrikeIron(日本語)

Zend_Service_StrikeIron: バンドルされているサービス

Zend_Service_StrikeIron には、StrikeIron のサービスのうち人気のある 3 つについてのラッパークラスが含まれています。

ZIP Code Information

Zend_Service_StrikeIron_ZipCodeInfo は、StrikeIron の Zip Code Information Service 用のクライアントです。 このサービスについての詳細は、以下の StrikeIron のリソースを参照ください。

このサービスの getZipCode() メソッドは、 アメリカやカナダの郵便番号についての情報を取得します。

  1. $strikeIron = new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
  2.                                                 'password' => 'あなたのパスワード'));
  3.  
  4. // Zip Code Information サービス用のクライアントを取得します
  5. $zipInfo = $strikeIron->getService(array('class' => 'ZipCodeInfo'));
  6.  
  7. // 郵便番号 95014 についての情報を取得します
  8. $response = $zipInfo->getZipCode(array('ZipCode' => 95014));
  9. $zips = $response->serviceResult;
  10.  
  11. // 結果を表示します
  12. if ($zips->count == 0) {
  13.     echo 'みつかりませんでした';
  14. } else {
  15.     // コードをひとつだけ指定したときの返り値はオブジェクトとなります。
  16.     // 要素ひとつの配列ではありません。
  17.     if (! is_array($zips->zipCodes)) {
  18.         $zips->zipCodes = array($zips->zipCodes);
  19.     }
  20.  
  21.     // すべての結果を表示します
  22.     foreach ($zips->zipCodes as $z) {
  23.         $info = $z->zipCodeInfo;
  24.  
  25.         // すべてのプロパティを表示します
  26.         print_r($info);
  27.  
  28.         // あるいは都市名のみを表示します
  29.         echo $info->preferredCityName;
  30.     }
  31. }
  32.  
  33. // 詳細なステータス情報
  34. // http://www.strikeiron.com/exampledata/StrikeIronZipCodeInformation_v3.pdf
  35. $status = $response->serviceStatus;

U.S. Address Verification

Zend_Service_StrikeIron_USAddressVerification は StrikeIron の U.S. Address Verification Service 用のクライアントです。 このサービスについての詳細は、以下の StrikeIron のリソースを参照ください。

このサービスの verifyAddressUSA() メソッドは、 アメリカの住所を検証します。

  1. $strikeIron = new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
  2.                                                 'password' => 'あなたのパスワード'));
  3.  
  4. // Zip Code Information サービス用のクライアントを取得します
  5. $verifier = $strikeIron->getService(array('class' => 'USAddressVerification'));
  6.  
  7. // 調べる住所を指定します。すべてのフィールドが必須というわけではありませんが、
  8. // できるだけ多くを指定したほうがよい結果が得られます
  9. $address = array('firm'           => 'Zend Technologies',
  10.                  'addressLine1'   => '19200 Stevens Creek Blvd',
  11.                  'addressLine2'   => '',
  12.                  'city_state_zip' => 'Cupertino CA 95014');
  13.  
  14. // 住所を検証します
  15. $result = $verifier->verifyAddressUSA($address);
  16.  
  17. // 結果を表示します
  18. if ($result->addressErrorNumber != 0) {
  19.     echo $result->addressErrorNumber;
  20.     echo $result->addressErrorMessage;
  21. } else {
  22.     // すべてのプロパティを表示します
  23.     print_r($result);
  24.  
  25.     // あるいは企業名のみを表示します
  26.     echo $result->firm;
  27.  
  28.     // 正しい住所ですか?
  29.     $valid = ($result->valid == 'VALID');
  30. }

Sales & Use Tax Basic

Zend_Service_StrikeIron_SalesUseTaxBasic は、 StrikeIron の Sales & Use Tax Basic サービス用のクライアントです。 このサービスについての詳細は、以下の StrikeIron のリソースを参照ください。

このサービスには 2 つのメソッドがあります。 getTaxRateUSA() および getTaxRateCanada() は、 それぞれアメリカとカナダの販売・消費税の情報を取得します。

  1. $strikeIron = new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
  2.                                                 'password' => 'あなたのパスワード'));
  3.  
  4. // Sales & Use Tax Basic サービス用のクライアントを取得します
  5. $taxBasic = $strikeIron->getService(array('class' => 'SalesUseTaxBasic'));
  6.  
  7. // カナダのオンタリオ州の税率を取得します
  8. $rateInfo = $taxBasic->getTaxRateCanada(array('province' => 'foo'));
  9. print_r($rateInfo);               // すべてのプロパティを表示します
  10. echo $rateInfo->GST;              // あるいは GST (Goods & Services Tax) のみを表示します
  11.  
  12. // アメリカ・カリフォルニア州クパチーノの税率を取得します
  13. $rateInfo = $taxBasic->getTaxRateUS(array('zip_code' => 95014));
  14. print_r($rateInfo);               // すべてのプロパティを表示します
  15. echo $rateInfo->state_sales_tax// あるいは州の消費税のみを表示します

Zend_Service_StrikeIron(日本語)