API

LocationBox API

Set Poi Attribute

Set Poi Attribute Service set attributes for a POI with criterias which you can find below.

A POI Attribute request must look like this:

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=SetPoiAttribute&Typ=output_format&PoiId=poiid&Attribute=attribute&Type=type
&Value=value


Request Parameters


Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (PoiList)
Typ: Response format. (XML or JSON)
PoiId: Id of the POI which you want to set some attribute.
Attribute: Name of the attribute.
Type: Data type of attribute (1,2,3)
1- Number
2- String
3- Date
Value: Value of Attribute to be added.
For value of date, proper example is as follows:
For 6 May 2014 10:12:13 you should write like this: 20140506101213

Response Parameters


XML Response

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

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

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=SetPoiAttribute&Typ=XML&PoiId=3420004679325&Attribute=TEST_LIKE&Type=1&Value=34

The response will be as following:

<response>
 <transactionid>LBS_43720</transactionid>
 <status>0</status>
 <errno />
 <errdesc />
</response>

JSON Response

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

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

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=SetPoiAttribute&Typ=JSON&PoiId=3420004679325&Attribute=TEST_LIKE&Type=1&Value=34

The response will be as following:


{ "transactionid": "LBS_43719", "status": 0 }

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.


Increment Poi Attribute

Increment Poi Attribute Service increases attributes for a POI with criterias which you can find below.

A Increment POI Attribute request must look like this:

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=IncrementPoiAttribute&Typ=output_format&PoiId=poiid&Attribute=attribute&Type=type
&Value=value


Request Parameters


Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (GetPoi)
Typ: Response format. (XML or JSON)
PoiId: Id of the POI which you want to increase your attribute.
Attribute: Name of the attribute.
Type: Data type of attribute (1,2,3)
1- Number
2- String
3- Date
Value: Value of Attribute to be added.
For value of date, proper example is as follows:
For 6 May 2014 10:12:13 you should write like this: 20140506101213

XML Response

Increment Poi Attribute response returns in XML format when the Typ parameter is set as "XML".

Below is an example for an address element (getpoi) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=IncrementPoiAttribute&Typ=XML&PoiId=34256143722&Attribute=TEST_LIKE&Type=1&Value=1

The response will be as following:


<response>
 <transactionid>LBS_43720</transactionid>
 <status>0</status>
 <errno />
 <errdesc />
</response>

JSON Response

Increment Poi Attribute response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for an address element (get poi) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=IncrementPoiAttribute&Typ=JSON&PoiId=34256143722&Attribute=TEST_LIKE&Type=1&Value=1

The response will be as following:


{ "transactionid": "LBS_43719", "status": 0 }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response code

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.
20022 City is not found.
20023 Town is not found.
20024 District is not found.


Decrement Poi Attribute

Decrement Poi Attribute Service decreases attributes for a POI with criterias which you can find below.

A Decrement POI Attribute request must look like this:

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=DecrementPoiAttribute&Typ=output_format&PoiId=poiid&Attribute=attribute&Type=type
&Value=value


Request Parameters


Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (GetPoi)
Typ: Response format. (XML or JSON)
PoiId: Id of the POI which you want to decrease your attribute.
Attribute: Name of the attribute.
Type: Data type of attribute (1,2,3)
1- Number
2- String
3- Date
Value: Value of Attribute to be added.
For value of date, proper example is as follows:
For 6 May 2014 10:12:13 you should write like this: 20140506101213

XML Response

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

Below is an example for an address element (getpoi) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=DecrementPoiAttribute&Typ=XML&PoiId=34256143722&Attribute=TEST_LIKE&Type=1&Value=1

The response will be as following:


<response>
 <transactionid>LBS_43720</transactionid>
 <status>0</status>
 <errno />
 <errdesc />
</response>

JSON Response

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

Below is an example for an address element (get poi) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=DecrementPoiAttribute&Typ=JSON&PoiId=34256143722&Attribute=TEST_LIKE&Type=1&Value=1

The response will be as following:


{ "transactionid": "LBS_43719", "status": 0 }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response code

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.
20022 City is not found.
20023 Town is not found.
20024 District is not found.


Remove Poi Attribute

Remove Poi Attribute Service removes attributes for a POI with criterias which you can find below.

A Remove POI Attribute request must look like this:

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=RemovePoiAttribute&Typ=output_format&PoiId=poiid&Attribute=attribute


Request Parameters


Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (GetPoi)
Typ: Response format. (XML or JSON)
PoiId: Id of the POI which you want to decrease your attribute.
Attribute: Name of the attribute.

XML Response

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

Below is an example for an address element (getpoi) request which is expected to return a response in XML format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=RemovePoiAttribute&Typ=XML&PoiId=34256143722&Attribute=TEST_LIKE

The response will be as following:


<response>
 <transactionid>LBS_43720</transactionid>
 <status>0</status>
 <errno />
 <errdesc />
</response>

JSON Response

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

Below is an example for an address element (get poi) request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=RemovePoiAttribute&Typ=JSON&PoiId=34256143722&Attribute=TEST_LIKE

The response will be as following:


{ "transactionid": "LBS_43719", "status": 0 }

transactionid: The id of response given by LocationBox Service. Every response can be tracked using transactionid when necessary.
status: Response code

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.
20022 City is not found.
20023 Town is not found.
20024 District is not found.