Service Name: Location Search | NOSTRA Developer

Service Name: Location Search

Service URL

https://api.nostramap.com/Service/V2/Location/Search

Description

This service allows you to search place information in Thailand, also AEC countries. You can query specified area by sending parameters, category or admin level.

Testing

We provide testing service Here


Required Parameters

NameTypeDetails
keyStringNOSTRA API Key. To get the API Key, please register your profile on the NOSTRA API Console
keyword *StringA term to be matched with NOSTRA place name, address, road name or etc.
catCode *StringNOSTRA’s POI category such as 'BANK|SHOPPING'. All category are separated using the pipe (|) character. You can get NOSTRA’s POI category, See for more information.
localCatCode *StringNOSTRA’s POI local category such as '22604|20218|27011'. All category are separated using the pipe (|) character. You can get NOSTRA’s POI local category, See for more information.
houseNo *StringHouse number such as '123/4'.
telephone *StringTelephone number such as '021234567'.

Optional Parameters

null

NameTypeDetails
latDoubleLatitude of point in decimal degree.
lonDoubleLongitude of point in decimal degree.
radiusDoubleDefines the distance (in kilometer) within latitude (Lat) and longitude (Lon) parameter. Default is NULL.
adminLevel1StringRefer to province name or province code. You can get Thailand province code, See for more information. Default is NULL.
adminLevel2StringRefer to district name or district code. You can get Thailand district code, See for more information. Default is NULL.
adminLevel3StringRefer to sub district name or sub district code. You can get Thailand sub district code, See for more information. Default is NULL.
adminLevel4StringRoad name and SOI name. For example 'Sathon Nuea' Default is NULL.
postcodeStringPost Code, Postal Code or Zip Code. Default is NULL.
rowsPerPageINTNumber of record to return. Maximum value is specified by NOSTRA.
pageNumberINTNumber of Page. Default is 1.
optionStringOption codes for filtering the search result or using other search methods. Default is NULL.

- perfectMatch : Only result with the completed phrases of keyword will be returned.

- address : Keyword will be compared with address information only and it won't be compared with location name.

Two or more option codes can be defined in a set of string seperated by vertical bar ( | ). For example: perfectMatch|address
countryStringCountry code. TH=Thailand | SG=Singapore | MY=Malaysia | BN=Brunei | VN=Vietnam | PH=Philippines
|ID=Indonesia | MM=Myanmar | LA=Laos | KH=Cambodia. Default value is 'TH'

Response

A JSON response contains two root elements below

NameSummary
errorMessageAn error message displayed when an unexpected condition occurs, null if not.
resultsThis root contains array of place.

Response Details

results

NameDetails
AdminLevel1_EProvince name in English.
AdminLevel1_LProvince name in Local language.
AdminLevel2_EDistrict name in English.
AdminLevel2_LDistrict name in Local language.
AdminLevel3_ESub district name in English.
AdminLevel3_LSub district name in Local language.
AdminLevel4_ERoad and SOI name in English.
AdminLevel4_LRoad and SOI name in Local language.
AdminLevel1CodeProvince code.
AdminLevel2CodeDistrict code.
AdminLevel3CodeSub district code.
Branch_EBranch in English.
Branch_LBranch in Local language.
CatCodeCategory’s name of POI.
LocalCatCodeLocal category's name of POI.
HouseNoHouse number.
LatLonPoint of interest’s Latitude and Longitude.
LatLon_Route1Point of interest’s Latitude and Longitude entrance 1.
LatLon_Route2Point of interest’s Latitude and Longitude entrance 2.
LatLon_Route3Point of interest’s Latitude and Longitude entrance 3.
LatLon_Route4Point of interest’s Latitude and Longitude entrance 4.
Name_ELocation name in English.
Name_LLocation name in Local language.
NoResult’s order.
NostraIdID of data.
PostCodePostcode.
TelephoneTelephone number.
distDistance from input location in km.
https://api.nostramap.com/Service/V2/Location/Search

***Please enter your Nostra Key.

Parameters

{
"keyword": "สาทร",
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
Ln:1Col:1

Results

object
{0}
(empty object)