Query Parameters
Parameter | Description | Usage |
---|---|---|
country | 3 character ISO code or country name. | Required |
areaName1 | Specifies the largest geographical area, like a State or a Province. | |
areaName3 | Specifies the name of city or town. This parameter is used along the country parameter. | Optional |
postcode1 | Post code in the appropriate format for the country. This parameter is used along the country parameter. | Optional |
postcode2 | Post code extension in the appropriate format for the country. | Optional |
name |
Specifies the name of the place (POI) to be searched. Also performs search on partially specified names. It requires minimum 3 characters to search. The input values can be case-insensitive. For Example, "KFC", "Citi Bank", "Toyota", "Nike" etc. |
Optional |
type | Filters the points of interest (POIs) by place types. For
example, bank, atm, hospital, school, park, police, zoo etc.
Click here to view a list of popular types. Any possible place type could be mentioned in this parameter even if that type is not available in the above list. This service matches the input type against place descriptions and types, and return best matching relevant results. |
Optional |
categoryCode | Acts as a filter to narrow down and refine POI search results. The input value(s) are
comma separated category codes. The category codes are unique 4, 6,
or 11 digit numeric values. Maximum of 10 category codes can be specified in a comma-separated format. Click here to view full list of category codes. |
Optional |
sicCode | Acts as a filter to narrow down and refine POI search results.
The input value(s) are comma separated SIC codes. The SIC codes are
unique 4 or 8 digit SIC codes. Maximum of 10 SIC codes can be specified in a comma-separated format. Click here to view full list of SIC codes. |
|
maxCandidates | Specifies the maximum number of POIs to be retrieved per page. Default Value: 20 for JSON response format and 2000 for CSV. Maximum Value: 100 for JSON response format and 2000 for CSV format. Maximum of 20,000 POIs can be returned overall for a given search criteria. We recommend you to use filters (such as categoryCode, sicCode and searchRadius) to narrow down your search and get the relevant results. |
Optional |
fuzzyOnName | Whether to allow fuzzy search on name. Possible values are: Y (default), N. | Optional |
page | Specifies the page number of results. Allows API consumer to
implement pagination in their application. Page size is the value of maxCandidates in request. For example:
|
Optional |
matchMode | Select a leniency to be used when making a match between your
input name and the reference data. Allowed values are:
|
Optional |
specificMatchOn | This allows a specific match against Name, Brand Name, Trademark or Any other POI. | Optional |