Returns a list of geo places within a specified distance from an area code. Parameters: areaCode - area code, distance - distance in miles, placeTypeToFind - type of place to look for: ZipCode, City, ThreeDigitZipCode (unique 3-digit 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/FindPlacesAroundAreaCode"
<?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:FindPlacesAroundAreaCode>
<areaCode xsi:type="xsd:int">int</areaCode>
<distance xsi:type="xsd:float">float</distance>
<placeTypeToFind xsi:type="tns:GeoPlaceType">ZipCode or City or State or ThreeDigitZipCode or AreaCode</placeTypeToFind>
</tns:FindPlacesAroundAreaCode>
</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:FindPlacesAroundAreaCodeResponse>
<FindPlacesAroundAreaCodeResult href="#id1" />
</tns:FindPlacesAroundAreaCodeResponse>
<soapenc:Array id="id1" soapenc:arrayType="tns:GeoPlaceDistance[2]">
<Item href="#id2" />
<Item href="#id3" />
</soapenc:Array>
<tns:GeoPlaceDistance id="id2" xsi:type="tns:GeoPlaceDistance">
<ToPlace xsi:type="xsd:string">string</ToPlace>
<ToState xsi:type="xsd:string">string</ToState>
<Distance xsi:type="xsd:float">float</Distance>
</tns:GeoPlaceDistance>
<tns:GeoPlaceDistance id="id3" xsi:type="tns:GeoPlaceDistance">
<ToPlace xsi:type="xsd:string">string</ToPlace>
<ToState xsi:type="xsd:string">string</ToState>
<Distance xsi:type="xsd:float">float</Distance>
</tns:GeoPlaceDistance>
</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/FindPlacesAroundAreaCode?areaCode=string&distance=string&placeTypeToFind=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"?>
<ArrayOfGeoPlaceDistance xmlns="http://skats.net/services/literalTypes">
<GeoPlaceDistance>
<ToPlace>string</ToPlace>
<ToState>string</ToState>
<Distance>float</Distance>
</GeoPlaceDistance>
<GeoPlaceDistance>
<ToPlace>string</ToPlace>
<ToState>string</ToState>
<Distance>float</Distance>
</GeoPlaceDistance>
</ArrayOfGeoPlaceDistance>
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/FindPlacesAroundAreaCode HTTP/1.1
Host: api.geosvc.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length
areaCode=string&distance=string&placeTypeToFind=string
HTTP/1.1 200 OK
Content-Type: text/xml; charset=utf-8
Content-Length: length
<?xml version="1.0" encoding="utf-8"?>
<ArrayOfGeoPlaceDistance xmlns="http://skats.net/services/literalTypes">
<GeoPlaceDistance>
<ToPlace>string</ToPlace>
<ToState>string</ToState>
<Distance>float</Distance>
</GeoPlaceDistance>
<GeoPlaceDistance>
<ToPlace>string</ToPlace>
<ToState>string</ToState>
<Distance>float</Distance>
</GeoPlaceDistance>
</ArrayOfGeoPlaceDistance>