GetCandidateAddresses
GetCandidateAddresses は、与えられた入力住所にマッチするとみなされる住所のリストを返します。GetCandidateAddresses は、入力住所が郵便データベースの複数の住所にマッチする場合のみ、候補の住所を返します。入力住所が、郵便データベースの 1 つの住所のみにマッチする場合は、住所データを返しません。
米国およびカナダ以外の住所については、ValidateAddress が返す複数のマッチ結果と、GetCandidateAddresses が同じ住所に対して返す結果の間に、矛盾が存在する場合があります。矛盾した結果が得られるのはおそらく、ValidateAddress のパフォーマンス チューニング設定で 100 以外の値を設定しているためです。GetCandidateAddresses と ValidateAddress で矛盾のない結果を得るには、パフォーマンス チューニング オプションを 100 に設定します。
注: デフォルトでは、GetCandidateAddresses は個々の家番号との一致は確認しません。各ストリートの家番号の範囲とのマッチングを行います。GetCandidateAddresses はストリート名、都市名、州/省名、および郵便番号を特定した後、入力された家番号が、マッチしたストリート名の家番号の範囲に含まれるかどうかを確認します。ユニット番号についても同様の処理が行われます。個々の家番号が有効であることを確認するには、ValidateAddress Delivery Point Validation (DPV) 処理オプションを使用する必要があります。DPV 処理は、米国住所に対してのみ使用可能です。
カナダのコーダーには、特定の郵便番号を入力として受け取り、その郵便番号のデータベースに格納されたストリート情報を返す逆検索ルーチンが含まれています。この機能を使用するには、PostalCode フィールドにカナダの郵便番号を入力します。カナダの郵便番号を入力した場合の結果については、以下の 2 つめの例を参照してください。
GetCandidateAddresses は、Universal Addressing モジュールに含まれています。
リソース URL
http://server:port/soap/GetCandidateAddresses
例
SOAP リクエストを以下に示します。
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/" xmlns:get="http://www.pb.com/spectrum/services/GetCandidateAddresses" xmlns:spec="http://spectrum.pb.com/">
<soapenv:Header/>
<soapenv:Body>
<get:GetCandidateAddressesRequest>
<get:input_port>
<get:Address>
<get:AddressLine1>P.O. Box 1</get:AddressLine1>
<get:City>New York</get:City>
<get:StateProvince>NY</get:StateProvince>
</get:Address>
</get:input_port>
</get:GetCandidateAddressesRequest>
</soapenv:Body>
</soapenv:Envelope>
応答は次のようになります。
注: この例では、空の応答要素を削除しています。最初の候補住所を 2 つだけ示します。
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns3:GetCandidateAddressesResponse xmlns:ns2="http://spectrum.pb.com/" xmlns:ns3="http://www.pb.com/spectrum/services/GetCandidateAddresses">
<ns3:output_port>
<ns3:Address>
<ns3:ProcessedBy>USA</ns3:ProcessedBy>
<ns3:RecordType>PostOfficeBox</ns3:RecordType>
<ns3:MatchLevel>A</ns3:MatchLevel>
<ns3:AddressLine1>PO Box 1</ns3:AddressLine1>
<ns3:HouseNumberLow>1</ns3:HouseNumberLow>
<ns3:HouseNumberHigh>60</ns3:HouseNumberHigh>
<ns3:HouseNumberParity>B</ns3:HouseNumberParity>
<ns3:City>New York</ns3:City>
<ns3:StateProvince>NY</ns3:StateProvince>
<ns3:PostalCode>10002</ns3:PostalCode>
<ns3:PostalCode.AddOn>0001</ns3:PostalCode.AddOn>
<ns3:Country>USA</ns3:Country>
</ns3:Address>
<ns3:Address>
<ns3:ProcessedBy>USA</ns3:ProcessedBy>
<ns3:RecordType>PostOfficeBox</ns3:RecordType>
<ns3:MatchLevel>A</ns3:MatchLevel>
<ns3:AddressLine1>PO Box 1</ns3:AddressLine1>
<ns3:HouseNumberLow>1</ns3:HouseNumberLow>
<ns3:HouseNumberHigh>9</ns3:HouseNumberHigh>
<ns3:HouseNumberParity>B</ns3:HouseNumberParity>
<ns3:City>New York</ns3:City>
<ns3:StateProvince>NY</ns3:StateProvince>
<ns3:PostalCode>10008</ns3:PostalCode>
<ns3:PostalCode.AddOn>0001</ns3:PostalCode.AddOn>
<ns3:Country>USA</ns3:Country>
</ns3:Address>
</ns3:output_port>
</ns3:GetCandidateAddressesResponse>
</soap:Body>
</soap:Envelope>