GeoPlaces Web Service

NOTE: This service requires a subscription.
You can register online using Subscriptions interface. There're several types of subscriptions available including a free subscription so you can continue using the web service without paying. When you subscribe you will be issued a subscriber ID that uniquely identify you. You must submit that ID with every request by setting AuthenticationHeader SOAP header. Consult WSDL for more information.

Help and samples Contact info

Click here for a complete list of operations.

FindPlacesAroundAreaCodeFiltered

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), filter - string to filter results, filterType - type of filter (StartsWith, EndsWith, Anywhere, None).

Test

To test the operation using the HTTP POST protocol, click the 'Invoke' button.

Parameter	Value
AuthenticationHeader:
areaCode:
distance:
placeTypeToFind:
filter:
filterType:

SOAP 1.1 (show / hide)

The following is a sample SOAP 1.1 request and response. The placeholders shown need to be replaced with actual values.

POST /services/PlaceLookup.asmx HTTP/1.1
Host: www.codebump.com
Content-Type: text/xml; charset=utf-8
Content-Length: length
SOAPAction: "http://skats.net/services/FindPlacesAroundAreaCodeFiltered"

<?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:FindPlacesAroundAreaCodeFiltered>
      <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>
      <filter xsi:type="xsd:string">string</filter>
      <filterType xsi:type="tns:FilterType">None or StartsWith or EndsWith or Anywhere</filterType>
    </tns:FindPlacesAroundAreaCodeFiltered>
  </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:FindPlacesAroundAreaCodeFilteredResponse>
      <FindPlacesAroundAreaCodeFilteredResult href="#id1" />
    </tns:FindPlacesAroundAreaCodeFilteredResponse>
    <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>

HTTP GET (show / hide)

The following is a sample HTTP GET request and response. The placeholders shown need to be replaced with actual values.

GET /services/PlaceLookup.asmx/FindPlacesAroundAreaCodeFiltered?areaCode=string&distance=string&placeTypeToFind=string&filter=string&filterType=string HTTP/1.1
Host: www.codebump.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>

HTTP POST (show / hide)

The following is a sample HTTP POST request and response. The placeholders shown need to be replaced with actual values.

POST /services/PlaceLookup.asmx/FindPlacesAroundAreaCodeFiltered HTTP/1.1
Host: www.codebump.com
Content-Type: application/x-www-form-urlencoded
Content-Length: length

areaCode=string&distance=string&placeTypeToFind=string&filter=string&filterType=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>