GeoPlaces Web Service

GeoPlaces Service is the evolution of ZipCode Lookup service. It enhances ZipCode Lookup by adding support for city names. Now you can find near by zip codes and cities, find distance between zip codes and cities, get coordinates of zip codes and cities. Place's coordinates are determined using an approximate center point of the shape.

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

The following operations are supported. For a formal definition, please review the Service Description.

GetPlaceDetails
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).

FindPlacesAroundAreaCode
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).

GetPlacesWithinFiltered
Returns a list of geo places within a specified distance from a given place. Parameters: place - place name (65 char max), state - 2 letter state code (not required for zip codes), distance - distance in miles, placeTypeToFind - type of place to look for: ZipCode, City, ThreeDigitZipCode (unique 3-digit zip codes) or AreaCode, filter - string to filter results, filterType - type of filter (StartsWith, EndsWith, Anywhere, None).

GetPlacesWithin
Returns a list of geo places within a specified distance from a given place. Parameters: place - place name (65 char max), state - 2 letter state code (not required for zip codes), distance - distance in miles, placeTypeToFind - type of place to look for: ZipCode, City, ThreeDigitZipCode (unique 3-digit zip codes) or AreaCode.

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).

GetAllStates
Returns an array of all US states.

GetAllUserPlaces
Returns an array of all user-defined places.

GetPlacesInside
Returns a list of geo places inside a given place. If zip code passed in then cities with that zip code are returned. If a city/state passed in then zip codes in that city are returned. Parameters: place - place name (65 char max), state - 2 letter state code (not required for zip codes).

GetDistanceBetweenPlaces
Returns a distance in miles between two geo places. Parameters: place1 - place name (65 char max), state1 - 2 letter state code (not required for zip codes), place2 - place name (65 char max), state2 - 2 letter state code (not required for zip codes).

GetUserPlacesWithin
Returns a list of user-defined places within a specified distance from a given place. Parameters: place - place name (65 char max), state - 2 letter state code (not required for zip codes), distance - distance in miles, category - an optional category, if not empy only user-defined places that match the category will be returned.

SaveUserPlaces
Saves user-defined places.