LatLonListCityNames - Request Message Sample

Free Web Services - Herong's Tutorial Examples

∟LatLonListCityNames - Return Latitudes and Longitudes of US Cities

∟LatLonListCityNames - Request Message Sample

This section provides a request message sample of LatLonListCityNames Web service.

The request message of LatLonListCityNames Web service contains a simple XML document with 1 parameter:

displayLevel - Specifies the level of cities to return. Valid levels are: 1 - Primary cities; 2 - Secondary cities; 3 - Third-level cities; 4 - Forth-level cities; 12 - Cities of level 1 and 2; 34 - Cities of level 3 and 4; 1234 - Cities of level 1, 2, 3, and 4.

Click on the "Request 1" below "LatLonListCityNames" in the "ndfdXMLBinding" operation list. You will see a request template of LatLonListCityNames in SOAP 1.1 format.

Enter "1" in the "displayLevel" element, you will get a sample request message of LatLonListCityNames to a list of all primary cities with their latitude and longitude information in United States:

<soapenv:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
 xmlns:xsd="http://www.w3.org/2001/XMLSchema"
 xmlns:soapenv="http://schemas.xmlsoap.org/soap/envelope/"
 xmlns:ndf="https://graphical.weather.gov/xml/DWMLgen/wsdl/ndfdXML.wsdl">
 <soapenv:Header/>
 <soapenv:Body>
  <ndf:LatLonListCityNames
   soapenv:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
   <displayLevel xsi:type="dwml:displayLevelType"
xmlns:dwml="https://graphical.weather.gov/xml/DWMLgen/schema/DWML.xsd">1</displayLevel>
  </ndf:LatLonListCityNames>
 </soapenv:Body>
</soapenv:Envelope>

Run this sample request and click the "Raw" vertical tab. You will see the entire HTTP request including header lines:

POST https://graphical.weather.gov/xml/SOAP_server/ndfdXMLserver.php HTTP/1.1
Content-Type: text/xml;charset=UTF-8
SOAPAction: "https://graphical.weather.gov/xml/DWMLgen/wsdl/ndfdXML.wsdl#LatLonListCityNames"
Content-Length: 607
Host: graphical.weather.gov
Connection: Keep-Alive
User-Agent: Apache-HttpClient/4.1.1 (java 1.5)

(request XML...)