Returns a geo place details: name, type, state and coordinates. Parameters: place - place name (65 char max), state - 2 letter state code (not required for zip codes).
The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.
POST /geosvc_api/PlaceLookup.asmx HTTP/1.1
Host: api.geosvc.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://skats.net/services/GetPlaceDetails"
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://skats.net/services/" xmlns:types="http://skats.net/services/encodedTypes" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Header>
<tns:AuthenticationHeader>
<SessionID xsi:type="xsd:string">string</SessionID>
</tns:AuthenticationHeader>
</soap:Header>
<soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<tns:GetPlaceDetails>
<place xsi:type="xsd:string">string</place>
<state xsi:type="xsd:string">string</state>
</tns:GetPlaceDetails>
</soap:Body>
</soap:Envelope>
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<soap:Envelope xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:soapenc="http://schemas.xmlsoap.org/soap/encoding/" xmlns:tns="http://skats.net/services/" xmlns:types="http://skats.net/services/encodedTypes" xmlns:soap="http://schemas.xmlsoap.org/soap/envelope/">
<soap:Body soap:encodingStyle="http://schemas.xmlsoap.org/soap/encoding/">
<tns:GetPlaceDetailsResponse>
<GetPlaceDetailsResult href="#id1" />
</tns:GetPlaceDetailsResponse>
<tns:GeoPlaceDetails id="id1" xsi:type="tns:GeoPlaceDetails">
<Name xsi:type="xsd:string">string</Name>
<Type xsi:type="tns:GeoPlaceType">ZipCode or City or State or ThreeDigitZipCode or AreaCode</Type>
<State xsi:type="xsd:string">string</State>
<LatDegrees xsi:type="xsd:float">float</LatDegrees>
<LonDegrees xsi:type="xsd:float">float</LonDegrees>
<LatRadians xsi:type="xsd:float">float</LatRadians>
<LonRadians xsi:type="xsd:float">float</LonRadians>
</tns:GeoPlaceDetails>
</soap:Body>
</soap:Envelope>
The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.
GET /geosvc_api/PlaceLookup.asmx/GetPlaceDetails?place=string&state=string HTTP/1.1
Host: api.geosvc.com
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<GeoPlaceDetails xmlns="http://skats.net/services/literalTypes">
<Name>string</Name>
<Type>ZipCode or City or State or ThreeDigitZipCode or AreaCode</Type>
<State>string</State>
<LatDegrees>float</LatDegrees>
<LonDegrees>float</LonDegrees>
<LatRadians>float</LatRadians>
<LonRadians>float</LonRadians>
</GeoPlaceDetails>
The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.
POST /geosvc_api/PlaceLookup.asmx/GetPlaceDetails HTTP/1.1
Host: api.geosvc.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
place=string&state=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<GeoPlaceDetails xmlns="http://skats.net/services/literalTypes">
<Name>string</Name>
<Type>ZipCode or City or State or ThreeDigitZipCode or AreaCode</Type>
<State>string</State>
<LatDegrees>float</LatDegrees>
<LonDegrees>float</LonDegrees>
<LatRadians>float</LatRadians>
<LonRadians>float</LonRadians>
</GeoPlaceDetails>