Spectrum Global Address Validation - web_services - 23 - 23.1

Spectrum-Webdienste-Handbuch
Product type
Software
Portfolio
Integrate
Product family
Spectrum™ software
Product
Spectrum™ software > Web Services
Version
23.1
ft:locale
de-DE
Product name
Spectrum Technology Platform
ft:title
Spectrum-Webdienste-Handbuch
First publish date
2007
ft:lastEdition
2023-10-25
ft:lastPublication
2023-10-25T07:20:03.279000

Spectrum Global Address Validation bietet eine verbesserte Adressstandardisierung und -überprüfung. Spectrum Global Address Validation kombiniert Daten aus mehreren Datenquellen in einer Datenbank, um die umfassendsten und genauesten internationalen Adressdaten bereitzustellen.

Spectrum Global Address Validation analysiert und vergleicht jede Eingabeadresse mit der Global Addressing-Datenbank für das entsprechende Land. Bei Bedarf korrigiert und formatiert Global Address Validation die Adresse gemäß den für dieses Land geltenden Poststandards.

Die standardmäßige Adressausgabe besteht aus Adresszeilen, die dem entsprechen, wie die Adresse auf einem Adressetikett erscheint. Ort, Bundesland/-staat oder Provinz/Kanton, Postleitzahl und weitere Daten sind ebenfalls in der standardmäßigen Adressausgabe enthalten.

„Global Addressing Validation“ ist Teil des Global Addressing-Moduls.

Ressourcen-URL

JSON-Endpunkt:

http://server:port/rest/GlobalAddressValidation/result.json

XML-Endpunkt:

http://server:port/rest/GlobalAddressValidation/result.xml

Beispiel mit JSON-Antwort

Im folgenden Beispiel wird eine JSON-Antwort angefordert:

http://server:8080/rest/GlobalAddressValidation/result.json?​Data.AddressLine1=​103-113 STANLEY ST VICTORIA WEST MELBOURNE 3003 &Data.Country=AUS

Die von dieser Anforderung zurückgegebene JSON-Antwort würde wie folgt lauten:

{"output_port": [{    "AddressLine1": "103-113 Stanley Street",    "AddressBlock1": "103-113 Stanley Street",    "AddressBlock2": "West Melbourne VIC 3003",    "City": "West Melbourne",    "StateProvince": "VIC",    "PostalCode": "3003",    "Country": "Australia",    "PrecisionCode": "S8HPNTSCZG",    "ProcessedBy": "GAM",    "MultimatchCount": "1",    "HouseNumber": "103-113",    "StreetName": "Stanley",    "StreetType": "Street",    "Confidence": "92",    "Principality": "VIC",    "MatchOnAllStreetFields": "true",    "MatchOnStreetDirectional": "true",    "City.Matched": "true",    "CitySubdivision.Matched": "true",    "StateProvince.Matched": "false",    "StateProvinceSubdivision.Matched": "true",    "StreetName.Matched": "true",    "StreetType.Matched": "true",    "Firmname.Matched": "true",    "Housenumber.Matched": "true",    "Postalcode.Matched": "true",    "user_fields": [] }]}

Beispiel mit XML-Antwort

Im folgenden Beispiel wird eine XML-Antwort angefordert:

http://server:8080/rest/GlobalAddressValidation/result.xml?Data.AddressLine1=103-113 STANLEY ST VICTORIA WEST MELBOURNE 3003&Data.Country=AUS

Die von dieser Anforderung zurückgegebene XML-Antwort würde wie folgt lauten:

<xml.GlobalAddressValidationResponse xmlns="http://www.precisely.com/spectrum/services/GlobalAddressValidation"> <output_port>     <Row>         <AddressLine1>103-113 Stanley Street</AddressLine1>         <AddressBlock1>103-113 Stanley Street</AddressBlock1>         <AddressBlock2>West Melbourne VIC 3003</AddressBlock2>         <City>West Melbourne</City>         <StateProvince>VIC</StateProvince>         <PostalCode>3003</PostalCode>         <Country>Australia</Country>         <PrecisionCode>S8HPNTSCZG</PrecisionCode>         <ProcessedBy>GAM</ProcessedBy>         <MultimatchCount>1</MultimatchCount>         <HouseNumber>103-113</HouseNumber>         <StreetName>Stanley</StreetName>         <StreetType>Street</StreetType>         <Confidence>92</Confidence>         <Principality>VIC</Principality>         <MatchOnAllStreetFields>true</MatchOnAllStreetFields>         <MatchOnStreetDirectional>true</MatchOnStreetDirectional>         <City.Matched>true</City.Matched>         <CitySubdivision.Matched>true</CitySubdivision.Matched>         <StateProvince.Matched>false</StateProvince.Matched>         <StateProvinceSubdivision.Matched>true           </StateProvinceSubdivision.Matched>         <StreetName.Matched>true</StreetName.Matched>         <StreetType.Matched>true</StreetType.Matched>         <Firmname.Matched>true</Firmname.Matched>         <Housenumber.Matched>true</Housenumber.Matched>         <Postalcode.Matched>true</Postalcode.Matched>         <user_fields/>     </Row>  </output_port> </xml.GlobalAddressValidationResponse>

JSON-Beispiel

http://server:8080/rest/GlobalAddressValidation/result.json

Beispiel für eine JSON POST-Anforderung:

 { "options": {       "Database_GAV":"JP_AU" }, "input_port" : {               "Input" : [                {        "AddressLine1": "103-113 STANLEY ST VICTORIA WEST MELBOURNE 3003",        "Country": "AUS"       },       {        "AddressLine1": "103-114 STANLEY ST VICTORIA WEST MELBOURNE 3004",        "Country": "AUS"       }                      ] } }

Beispiel für eine JSON POST-Antwort:

{     "output_port": [         {             "AddressLine1": "103-113 Stanley Street",             "AddressBlock1": "103-113 Stanley Street",             "AddressBlock2": "West Melbourne VIC 3003",             "City": "West Melbourne",             "StateProvince": "VIC",             "PostalCode": "3003",             "Country": "Australia",             "PrecisionCode": "S8HPNTSCZG",             "ProcessedBy": "GAM",             "MultimatchCount": "1",             "HouseNumber": "103-113",             "StreetName": "Stanley",             "StreetType": "Street",             "Confidence": "92",             "Principality": "VIC",             "MatchOnAllStreetFields": "true",             "MatchOnStreetDirectional": "true",             "City.Matched": "true",             "CitySubdivision.Matched": "true",             "StateProvince.Matched": "false",             "StateProvinceSubdivision.Matched": "true",             "StreetName.Matched": "true",             "StreetType.Matched": "true",             "Firmname.Matched": "true",             "Housenumber.Matched": "true",             "Postalcode.Matched": "true",             "user_fields": []         },         {             "AddressLine1": "103-114 Stanley Street",             "AddressBlock1": "103-114 Stanley Street",             "AddressBlock2": "West Melbourne VIC 3003",             "City": "West Melbourne",             "StateProvince": "VIC",             "StateProvinceSubdivision": "Melbourne",             "PostalCode": "3003",             "Country": "Australia",             "PrecisionCode": "S5HPNTSC-A",             "ProcessedBy": "GAM",             "MultimatchCount": "1",             "HouseNumber": "103-114",             "StreetName": "Stanley",             "StreetType": "Street",             "Confidence": "80",             "Principality": "VIC",             "MatchOnAllStreetFields": "true",             "MatchOnStreetDirectional": "true",             "City.Matched": "true",             "CitySubdivision.Matched": "true",             "StateProvince.Matched": "false",             "StateProvinceSubdivision.Matched": "true",             "StreetName.Matched": "true",             "StreetType.Matched": "true",             "Firmname.Matched": "true",             "Housenumber.Matched": "true",             "Postalcode.Matched": "false",             "user_fields": []         }     ] }

XML-Beispiel

http://server:8080/rest/GlobalAddressValidation/result.xml
Beispiel für eine XML POST-Anforderung:
<GlobalAddressValidationRequest xmlns:gav="http://www.precisely.com/spectrum/services/GlobalAddressValidation"> <options> 	<Database_GAV>JP_AU</Database_GAV> </options>	 <gav:input_port>     <gav:Input>          <gav:AddressLine1>103-113 STANLEY ST VICTORIA WEST MELBOURNE 3003          </gav:AddressLine1>          <gav:Country>AUS</gav:Country>          <gav:user_fields>              <gav:user_field>                  <gav:name>id</gav:name>                  <gav:value>1</gav:value>              </gav:user_field>          </gav:user_fields>       </gav:Input>      <gav:Input>           <gav:AddressLine1>103-113 STANLEY ST VICTORIA WEST MELBOURNE 3003           </gav:AddressLine1>           <gav:Country>AUS</gav:Country>           <gav:user_fields>               <gav:user_field>                   <gav:name>id</gav:name>                   <gav:value>2</gav:value>               </gav:user_field>          </gav:user_fields>      </gav:Input> </gav:input_port> </GlobalAddressValidationRequest>
Beispiel für eine XML POST-Antwort:
<?xml version="1.0" encoding="UTF-8" standalone="yes"?> <xml.GlobalAddressValidationResponse xmlns="http://www.precisely.com/spectrum/services/GlobalAddressValidation">     <output_port>         <Row>             <AddressLine1>103-113 Stanley Street</AddressLine1>             <AddressBlock1>103-113 Stanley Street</AddressBlock1>             <AddressBlock2>West Melbourne VIC 3003</AddressBlock2>             <City>West Melbourne</City>             <StateProvince>VIC</StateProvince>             <PostalCode>3003</PostalCode>             <Country>Australia</Country>             <PrecisionCode>S8HPNTSCZG</PrecisionCode>             <ProcessedBy>GAM</ProcessedBy>             <MultimatchCount>1</MultimatchCount>             <HouseNumber>103-113</HouseNumber>             <StreetName>Stanley</StreetName>             <StreetType>Street</StreetType>             <Confidence>92</Confidence>             <Principality>VIC</Principality>             <MatchOnAllStreetFields>true</MatchOnAllStreetFields>             <MatchOnStreetDirectional>true</MatchOnStreetDirectional>             <City.Matched>true</City.Matched>             <CitySubdivision.Matched>true</CitySubdivision.Matched>             <StateProvince.Matched>false</StateProvince.Matched>             <StateProvinceSubdivision.Matched>true             </StateProvinceSubdivision.Matched>             <StreetName.Matched>true</StreetName.Matched>             <StreetType.Matched>true</StreetType.Matched>             <Firmname.Matched>true</Firmname.Matched>             <Housenumber.Matched>true</Housenumber.Matched>             <Postalcode.Matched>true</Postalcode.Matched>             <user_fields>                 <user_field>                     <name>id</name>                     <value>1</value>                 </user_field>             </user_fields>         </Row>         <Row>             <AddressLine1>103-113 Stanley Street</AddressLine1>             <AddressBlock1>103-113 Stanley Street</AddressBlock1>             <AddressBlock2>West Melbourne VIC 3003</AddressBlock2>             <City>West Melbourne</City>             <StateProvince>VIC</StateProvince>             <PostalCode>3003</PostalCode>             <Country>Australia</Country>             <PrecisionCode>S8HPNTSCZG</PrecisionCode>             <ProcessedBy>GAM</ProcessedBy>             <MultimatchCount>1</MultimatchCount>             <HouseNumber>103-113</HouseNumber>             <StreetName>Stanley</StreetName>             <StreetType>Street</StreetType>             <Confidence>92</Confidence>             <Principality>VIC</Principality>             <MatchOnAllStreetFields>true</MatchOnAllStreetFields>             <MatchOnStreetDirectional>true</MatchOnStreetDirectional>             <City.Matched>true</City.Matched>             <CitySubdivision.Matched>true</CitySubdivision.Matched>             <StateProvince.Matched>false</StateProvince.Matched>             <StateProvinceSubdivision.Matched>true             </StateProvinceSubdivision.Matched>             <StreetName.Matched>true</StreetName.Matched>             <StreetType.Matched>true</StreetType.Matched>             <Firmname.Matched>true</Firmname.Matched>             <Housenumber.Matched>true</Housenumber.Matched>             <Postalcode.Matched>true</Postalcode.Matched>             <user_fields>                 <user_field>                     <name>id</name>                     <value>2</value>                 </user_field>             </user_fields>         </Row>     </output_port> </xml.GlobalAddressValidationResponse>