GetCandidateAddressesLoqate
GetCandidateAddressesLoqate は、与えられた入力住所に一致するとみなされる住所のリストを返します。GetCandidateAddressesLoqate は、入力住所が郵便データベースの複数の住所にマッチする場合のみ、候補の住所を返します。入力住所が、郵便データベースの 1 つの住所のみにマッチする場合は、住所データを返しません。[Country] 入力フィールドは必須です。このフィールドが空白の場合、出力は返されません。
注: デフォルトでは、GetCandidateAddressesLoqate は個々の家番号との一致は確認しません。各ストリートの家番号の範囲とのマッチングを行います。GetCandidateAddressesLoqate はストリート名、都市名、州/省名、および郵便番号を特定した後、入力された家番号が、マッチしたストリート名の家番号の範囲に含まれるかどうかを確認します。ユニット番号についても同様の処理が行われます。
GetCandidateAddressesLoqate は、Universal Addressing モジュールに含まれています。
リソース URL
http://server:port/soap/GetCandidateAddressesLoqate
例
SOAP リクエストを以下に示します。
<soapenv:Envelope xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
xmlns:get="http://www.pb.com/spectrum/services/GetCandidateAddressesLoqate"
xmlns:spec="http://spectrum.pb.com/">
<soapenv:Header/>
<soapenv:Body>
<get:GetCandidateAddressesLoqateRequest>
<get:input_port>
<get:Address>
<get:AddressLine1>PO Box 1</get:AddressLine1>
<get:City>New York</get:City>
<get:StateProvince>NY</get:StateProvince>
</get:Address>
</get:input_port>
</get:GetCandidateAddressesLoqateRequest>
</soapenv:Body>
</soapenv:Envelope>
応答は次のようになります。
注: この例では、空の応答要素を削除しています。最初の候補住所を 2 つだけ示します。
<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body>
<ns3:GetCandidateAddressesLoqateResponse xmlns:ns2="http://spectrum.pb.com/"
xmlns:ns3="http://www.pb.com/spectrum/services/GetCandidateAddressesLoqate">
<ns3:output_port>
<ns3:Address>
<ns3:ProcessedBy>LOQATE</ns3:ProcessedBy>
<ns3:AddressLine1>PO Box 101</ns3:AddressLine1>
<ns3:City>New York Mls</ns3:City>
<ns3:StateProvince>NY</ns3:StateProvince>
<ns3:PostalCode>13417-0101</ns3:PostalCode>
<ns3:PostalCode.AddOn>0101</ns3:PostalCode.AddOn>
<ns3:Country>USA</ns3:Country>
</ns3:Address>
<ns3:Address>
<ns3:ProcessedBy>LOQATE</ns3:ProcessedBy>
<ns3:AddressLine1>PO Box 102</ns3:AddressLine1>
<ns3:City>New York Mls</ns3:City>
<ns3:StateProvince>NY</ns3:StateProvince>
<ns3:PostalCode>13417-0102</ns3:PostalCode>
<ns3:PostalCode.AddOn>0102</ns3:PostalCode.AddOn>
<ns3:Country>USA</ns3:Country>
</ns3:Address>
</ns3:output_port>
</ns3:GetCandidateAddressesLoqateResponse>
</soap:Body>
</soap:Envelope>