Get City State Province - addressing - Spectrum_OnDemand - 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

Get City State Province gibt Ort und Bundesland/Kanton für eine angegebene Eingabepostleitzahl zurück.

Anmerkung: Get City State Province funktioniert nur mit Adressen in den USA und Kanada.

Get City State Province ist Teil von Spectrum Universal Address.

Ressourcen-URL

JSON-Endpunkt:

http://server:port/rest/GetCityStateProvince/results.json
https://OnDemandServer/rest/GetCityStateProvince/results.json

XML-Endpunkt:

http://server:port/rest/GetCityStateProvince/results.xml
https://OnDemandServer/rest/GetCityStateProvince/results.xml
http://server:port/soap/GetCityStateProvince
https://OnDemandServer/soap/GetCityStateProvince

Eine Liste der Spectrum Technology Platform-Server finden Sie unter Herstellen einer Verbindung zu -Servern.

Beispiel mit JSON-Antwort

Im folgenden Beispiel wird eine JSON-Antwort angefordert:

http://myserver:8080/rest/GetCityStateProvince/results.json?​Data.PostalCode=12180
https://spectrum.precisely.com/rest/GetCityStateProvince/results.json?​Data.PostalCode=12180

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

{"output_port": [{    "ProcessedBy": "USA",    "PostalCode": "12180",    "City": "TROY",    "StateProvince": "NY",    "Country": "USA",    "City.Type": "P",    "user_fields": [] }]}

Beispiel mit XML-Antwort

Im folgenden Beispiel wird eine XML-Antwort angefordert:

http://myserver:8080/rest/GetCityStateProvince/results.xml?​Data.PostalCode=12180 
https://spectrum.precisely.com/rest/GetCityStateProvince/results.xml?​Data.PostalCode=12180 

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

<ns2:xml.GetCityStateProvinceResponse xmlns:ns2="http://www.pb.com/spectrum/services/GetCityStateProvince">    <ns2:output_port>       <ns2:Result>          <ns2:ProcessedBy>USA</ns2:ProcessedBy>          <ns2:PostalCode>12180</ns2:PostalCode>          <ns2:City>TROY</ns2:City>          <ns2:City.Type>P</ns2:City.Type>          <ns2:StateProvince>NY</ns2:StateProvince>          <ns2:Country>USA</ns2:Country>          <ns2:user_fields/>       </ns2:Result>    </ns2:output_port> </ns2:xml.GetCityStateProvinceResponse>

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/GetCityStateProvince"> 	<soapenv:Header/> 	<soapenv:Body> 		<get:GetCityStateProvinceRequest> 			<!--Optional:--> 			<get:input_port> 				<get:Input> 					<!--Optional:--> 					<get:PostalCode>60510</get:PostalCode> 					<!--Optional:--> 					<get:user_fields> 						<get:user_field> 							<get:name></get:name> 							<get:value></get:value> 						</get:user_field> 					</get:user_fields> 				</get:Input> 			</get:input_port> 		</get:GetCityStateProvinceRequest> 	</soapenv:Body> </soapenv:Envelope> 

Dies wäre die Antwort:

<soap:Envelope xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">    <soap:Body>       <ns3:GetCityStateProvinceResponse xmlns:ns2="http://spectrum.precisely.com/" ​xmlns:ns3="http://www.pb.com/spectrum/services/GetCityStateProvince">          <ns3:output_port>             <ns3:Result>                <ns3:ProcessedBy>USA</ns3:ProcessedBy>                <ns3:PostalCode>60510</ns3:PostalCode>                <ns3:City>BATAVIA</ns3:City>                <ns3:City.Type>P</ns3:City.Type>                <ns3:StateProvince>IL</ns3:StateProvince>                <ns3:Country>USA</ns3:Country>                <ns3:user_fields/>             </ns3:Result>          </ns3:output_port>       </ns3:GetCityStateProvinceResponse>    </soap:Body> </soap:Envelope>