POI Radius Search
Contents
A POI Radius Search retrieves a list of Points of Interest (POIs) within a certain radius from a center point identified by its geographic coordinates. POIs include everything from restuarants and gas stations to emergency medical facilities and places of worship. See a full list of POI categories available for your search.
GET /poi
Resource URL
https://pcmiler.alk.com/apis/rest/v1.0/service.svc/poi
| Parameter | Description | Data Type | Value/Example |
|---|---|---|---|
| center | Coordinates of the center point represented in lon, lat format. | Comma-separated long/lat pair | -76.12345,42.12345 |
| region | The data region in which pings are located. |
Enum | NA (default) AF AS EU NA OC SA ME |
| countryAbbrevType | The abbreviation format for countries. Only applicable when poiCategories is set to Zip. |
Enum | FIPS (Default) ISO2 ISO3 GENC2 GENC3 |
| country | The country code using the format set by
countryAbbrevType. (FIPS is the default format.) Setting this parameter limits POI results to the specified country. Only applicable when poiCategories is set to Zip. |
string | UK |
| radius | radius distance from center of point. |
string | |
| radiusUnits | Units used for the radius distances in Miles or Kilometers. The default is miles. |
Enum | Miles Kilometers |
| poiCategories | Categories of points of interest with comma delimited choices, such as "Dining, Lodging, Gas".
|
object | |
| nameFilter | It is used to filter the results with the supplied value. |
string | |
| dataset | For users licensed for multiple regional datasets. |
Enum | PCM_EU PCM_OC PCM_SA PCM_ME PCM_AS PCM_AF PCM_WW (Worldwide) PCM_GT (GeoTrack) Current (default) |
Parameters
Required parameters are marked with an asterisk.
POI Data
The radius search will return up to 3000 POIs regardless of the miles requested. In some cases you may need to specify a smaller radius to get a complete list of matches. Also, the API uses air miles not road miles.