API

LocationBox API

POI Count

POI Count Service gives quantity of POI based on some criterias which you can find below.

A POI Count request must look like this:

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=PoiCount&Typ=output_format&IlId=ilid&IlceId=ilceid&Brand=brand


Request Parameters


Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (PoiCount)
Typ: Response format. (XML or JSON)
IlId: ID value of City. (IlList)
IlceId: (Optional) ID of county. (IlceList)
MahalleId: (Optional) ID of district. (MahalleList)
RegionId(optional): ID of region.
Category: Category of POI. (CategoryList)
Brand: Brand of POI. (BrandList)

Response Parameters


XML Response

POI Count response returns in XML format when the Typ parameter is set as "XML".

Below is an example for a POI Count request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=PoiCount&Typ=XML&IlId=34&IlceId=34000015000&
Brand=TEKNOSA


The response will be as following:

<response>
 <transactionid>LBS_12238</transactionid>
 <status>0</status>
 <errno />
 <errdesc />
 <count>4</count>
</response>

JSON Response

POI Count response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for a POI Count request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=PoiCount&Typ=JSON&IlId=34&IlceId=34000015000&
Brand=TEKNOSA


The response will be as following:


{ "transactionid": "LBS_12239", "status": 0, "count": 4 }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

Error Codes
10001 Error processing your request. Please try again soon.
Cmd parameter is misspelled/not found.
10011 Error processing your request. Please check the Cmd parameter.
Cmd is not specified.
10012 Error processing your request. Please check the Key parameter.
Key is not specified.
10013 Error processing your request. Please check the Key parameter.
Key is invalid.
20012 No data found.

POI Count With Extent

POI Count With Extent Service gives quantity of POI which is in extent. For criterias, you can check below.

A POI Count With Extent request must look like this:

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=PoiCountWithExtent&Typ=output_format&MinLatitude=minlatitude&MaxLatitude=maxlatitude&MinLongitude=minlongitude
&MaxLongitude=maxlongitude&Category=category&Brand=brand


Request Parameters


Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (PoiCount)
Typ: Response format. (XML or JSON)
MinLatitude: Minimum Latitude value of the extent.
MaxLatitude: Maximum Latitude value of the extent.
MinLongitude: Minimum Latitude value of the extent.
MaxLongitude: Maximum Latitude value of the extent
Category: Category of POI. (CategoryList)
Brand: Brand of POI. (BrandList)

Response Parameters


XML Response

POI Count With Extent response returns in XML format when the Typ parameter is set as "XML".

Below is an example for a POI Count With Extent request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=PoiCountWithExtent&Typ=XML&MinLatitude=40.357822&MaxLatitude=41.327673&MinLongitude=28.521057&MaxLongitude=29.034842&
Brand=TEKNOSA


The response will be as following:

<response>
 <transactionid>LBS_12238</transactionid>
 <status>0</status>
 <errno />
 <errdesc />
 <count>42</count>
</response>

JSON Response

POI Count response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for a POI Count request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=PoiCountWithExtent&Typ=JSON&MinLatitude=40.357822&MaxLatitude=41.327673&MinLongitude=28.521057&MaxLongitude=29.034842&
Brand=TEKNOSA


The response will be as following:


{ "transactionid": "LBS_12239", "status": 0, "count": 42 }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response format. (XML or JSON)

Status Codes
0 -- Success
1 -- Fail

errno: Error code
errdesc: Error definition

Error Codes
10001 Error processing your request. Please try again soon.
Cmd parameter is misspelled/not found.
10011 Error processing your request. Please check the Cmd parameter.
Cmd is not specified.
10012 Error processing your request. Please check the Key parameter.
Key is not specified.
10013 Error processing your request. Please check the Key parameter.
Key is invalid.
20012 No data found.