GetCandidateAddressesLoqate

GetCandidateAddressesLoqate gibt eine Liste der Adressen zurück, die bei einer angegebenen Eingabeadresse als Übereinstimmungen gelten. GetCandidateAddressesLoqate gibt nur Kandidatenadressen zurück, wenn die Eingabeadresse mit mehreren Adressen in der Postdatenbank übereinstimmt. Wenn die Eingabeadresse nur mit einer Adresse in der Postdatenbank übereinstimmt, werden keine Adressdaten zurückgegeben. Das Eingabefeld „Land“ ist erforderlich. Wenn dieses Feld leer ist, wird keine Ausgabe zurückgegeben.

Anmerkung: Standardmäßig gleicht GetCandidateAddressesLoqate keine einzelnen Hausnummern ab. Stattdessen werden für jede Straße Hausnummernbereiche verwendet. Nachdem GetCandidateAddressesLoqate den Straßennamen, den Ortsnamen, Bundesland/Kanton und Postleitzahl bestimmt hat, überprüft es, ob die eingegebene Hausnummer in einen der Hausnummernbereiche fällt, die für die übereinstimmende Straße angegeben sind. Dieselbe Logik wird auf Einheitsnummern angewendet.

GetCandidateAddressesLoqate ist Teil des Universal Addressing-Moduls.

Ressourcen-URL

http://server:port/soap/GetCandidateAddressesLoqate

Beispiel

Im Folgenden wird eine SOAP-Anforderung dargestellt:

<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>

Dies wäre die Antwort:

Anmerkung: Aus diesem Beispiel wurden leere Antwortelemente entfernt. Nur die ersten zwei Kandidatenadressen werden angezeigt.
<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>