documentation/manual/ja/module_specs/Zend_Service_StrikeIron-BundledServices.xml

   1 <?xml version="1.0" encoding="UTF-8"?>
   2 <!-- Reviewed: no -->
   3 <!-- EN-Revision: 20818 -->
   4 <sect1 id="zend.service.strikeiron.bundled-services">
   5     <title>Zend_Service_StrikeIron: バンドルされているサービス</title>
   6
   7     <para>
   8       <classname>Zend_Service_StrikeIron</classname> には、StrikeIron
   9       のサービスのうち人気のある 3 つについてのラッパークラスが含まれています。
  10     </para>
  11
  12     <sect2 id="zend.service.strikeiron.bundled-services.zip-code-information">
  13       <title>ZIP Code Information</title>
  14
  15       <para>
  16         <classname>Zend_Service_StrikeIron_ZipCodeInfo</classname> は、StrikeIron の
  17         Zip Code Information Service 用のクライアントです。
  18         このサービスについての詳細は、以下の StrikeIron のリソースを参照ください。
  19
  20         <itemizedlist>
  21           <listitem>
  22             <para>
  23               <ulink url="http://www.strikeiron.com/ProductDetail.aspx?p=267">Zip Code Information Service のページ</ulink>
  24             </para>
  25           </listitem>
  26           <listitem>
  27             <para>
  28               <ulink url="http://sdpws.strikeiron.com/zf1.StrikeIron/sdpZIPCodeInfo?WSDL">Zip Code Information Service の WSDL</ulink>
  29             </para>
  30           </listitem>
  31         </itemizedlist>
  32
  33         このサービスの <methodname>getZipCode()</methodname> メソッドは、
  34         アメリカやカナダの郵便番号についての情報を取得します。
  35
  36         <programlisting language="php"><![CDATA[
  37 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
  38                                                 'password' => 'あなたのパスワード'));
  39
  40 // Zip Code Information サービス用のクライアントを取得します
  41 $zipInfo = $strikeIron->getService(array('class' => 'ZipCodeInfo'));
  42
  43 // 郵便番号 95014 についての情報を取得します
  44 $response = $zipInfo->getZipCode(array('ZipCode' => 95014));
  45 $zips = $response->serviceResult;
  46
  47 // 結果を表示します
  48 if ($zips->count == 0) {
  49     echo 'みつかりませんでした';
  50 } else {
  51     // コードをひとつだけ指定したときの返り値はオブジェクトとなります。
  52     // 要素ひとつの配列ではありません。
  53     if (! is_array($zips->zipCodes)) {
  54         $zips->zipCodes = array($zips->zipCodes);
  55     }
  56
  57     // すべての結果を表示します
  58     foreach ($zips->zipCodes as $z) {
  59         $info = $z->zipCodeInfo;
  60
  61         // すべてのプロパティを表示します
  62         print_r($info);
  63
  64         // あるいは都市名のみを表示します
  65         echo $info->preferredCityName;
  66     }
  67 }
  68
  69 // 詳細なステータス情報
  70 // http://www.strikeiron.com/exampledata/StrikeIronZipCodeInformation_v3.pdf
  71 $status = $response->serviceStatus;
  72 ]]></programlisting>
  73       </para>
  74     </sect2>
  75
  76     <sect2 id="zend.service.strikeiron.bundled-services.us-address-verification">
  77       <title>U.S. Address Verification</title>
  78
  79       <para>
  80         <classname>Zend_Service_StrikeIron_USAddressVerification</classname>
  81         は StrikeIron の U.S. Address Verification Service 用のクライアントです。
  82         このサービスについての詳細は、以下の StrikeIron のリソースを参照ください。
  83
  84         <itemizedlist>
  85           <listitem>
  86             <para>
  87               <ulink url="http://www.strikeiron.com/ProductDetail.aspx?p=198">U.S. Address Verification Service のページ</ulink>
  88             </para>
  89           </listitem>
  90           <listitem>
  91             <para>
  92               <ulink url="http://ws.strikeiron.com/zf1.StrikeIron/USAddressVerification4_0?WSDL">U.S. Address Verification Service の WSDL</ulink>
  93             </para>
  94           </listitem>
  95         </itemizedlist>
  96       </para>
  97
  98       <para>
  99         このサービスの <methodname>verifyAddressUSA()</methodname> メソッドは、
 100         アメリカの住所を検証します。
 101
 102         <programlisting language="php"><![CDATA[
 103 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
 104                                                 'password' => 'あなたのパスワード'));
 105
 106 // Zip Code Information サービス用のクライアントを取得します
 107 $verifier = $strikeIron->getService(array('class' => 'USAddressVerification'));
 108
 109 // 調べる住所を指定します。すべてのフィールドが必須というわけではありませんが、
 110 // できるだけ多くを指定したほうがよい結果が得られます
 111 $address = array('firm'           => 'Zend Technologies',
 112                  'addressLine1'   => '19200 Stevens Creek Blvd',
 113                  'addressLine2'   => '',
 114                  'city_state_zip' => 'Cupertino CA 95014');
 115
 116 // 住所を検証します
 117 $result = $verifier->verifyAddressUSA($address);
 118
 119 // 結果を表示します
 120 if ($result->addressErrorNumber != 0) {
 121     echo $result->addressErrorNumber;
 122     echo $result->addressErrorMessage;
 123 } else {
 124     // すべてのプロパティを表示します
 125     print_r($result);
 126
 127     // あるいは企業名のみを表示します
 128     echo $result->firm;
 129
 130     // 正しい住所ですか?
 131     $valid = ($result->valid == 'VALID');
 132 }
 133 ]]></programlisting>
 134       </para>
 135     </sect2>
 136
 137     <sect2 id="zend.service.strikeiron.bundled-services.sales-use-tax-basic">
 138       <title>Sales &amp; Use Tax Basic</title>
 139
 140       <para>
 141         <classname>Zend_Service_StrikeIron_SalesUseTaxBasic</classname> は、
 142         StrikeIron の Sales &amp; Use Tax Basic サービス用のクライアントです。
 143         このサービスについての詳細は、以下の StrikeIron のリソースを参照ください。
 144
 145         <itemizedlist>
 146           <listitem>
 147             <para>
 148               <ulink url="http://www.strikeiron.com/ProductDetail.aspx?p=351">Sales &amp; Use Tax Basic Service のページ</ulink>
 149             </para>
 150           </listitem>
 151           <listitem>
 152             <para>
 153               <ulink url="http://ws.strikeiron.com/zf1.StrikeIron/taxdatabasic4?WSDL">Sales &amp; Use Tax Basic Service の WSDL</ulink>
 154             </para>
 155           </listitem>
 156         </itemizedlist>
 157       </para>
 158
 159       <para>
 160         このサービスには 2 つのメソッドがあります。
 161         <methodname>getTaxRateUSA()</methodname> および <methodname>getTaxRateCanada()</methodname> は、
 162         それぞれアメリカとカナダの販売・消費税の情報を取得します。
 163
 164         <programlisting language="php"><![CDATA[
 165 $strikeIron = new Zend_Service_StrikeIron(array('username' => 'あなたのユーザ名',
 166                                                 'password' => 'あなたのパスワード'));
 167
 168 // Sales & Use Tax Basic サービス用のクライアントを取得します
 169 $taxBasic = $strikeIron->getService(array('class' => 'SalesUseTaxBasic'));
 170
 171 // カナダのオンタリオ州の税率を取得します
 172 $rateInfo = $taxBasic->getTaxRateCanada(array('province' => 'foo'));
 173 print_r($rateInfo);               // すべてのプロパティを表示します
 174 echo $rateInfo->GST;              // あるいは GST (Goods & Services Tax) のみを表示します
 175
 176 // アメリカ・カリフォルニア州クパチーノの税率を取得します
 177 $rateInfo = $taxBasic->getTaxRateUS(array('zip_code' => 95014));
 178 print_r($rateInfo);               // すべてのプロパティを表示します
 179 echo $rateInfo->state_sales_tax;  // あるいは州の消費税のみを表示します
 180 ]]></programlisting>
 181       </para>
 182     </sect2>
 183 </sect1>