API

LocationBox API

PoiListEx

PoiListEx Service lists POI with more information based on criterias which you can find below.

A PoiListEx request must look like this:

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=PoiListEx&Typ=output_format
&IlId=ilid&IlceId=ilceid&MahalleId=mahalleid&ExType=extype



Request Parameters


Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (PoiListEx)
Typ: Response format. (XML or JSON)
IlId: (Optional) (See list.)
IlceId: (Optional) (See list.)
MahalleId: (Optional) (See list.)
ExType: PoiListEx type.

Ex Type Values

FUELPRICES -- Fuel Prices
CARPARKPRICES -- Car Park Prices
PHARMACYONDUTY -- Pharmacy On Duty

Response Parameters


XML Response

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

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

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=PoiListEx&Typ=XML
&IlId=34&ExType=FUELPRICES


The response will be as following:

<response>
 <transactionid>LBS_37486400</transactionid>
 <status>0</status>
 <errno />
 <errdesc />
 <poilist>
  <poi>
   <id>34200129970</id>
   <name>PO-PETROL OFÝSÝ ANONÝM ÞÝRKETÝ</name>
   <address>SELÝMÝYE MAH. TIBBÝYE CADDESÝ ÜSKÜDAR ÝSTANBUL</address>
   <phone>+90 532 4232515</phone>
   <latitude>4558913</latitude>
   <longitude>452099</longitude>
   <distance>0</distance>
  <nvs>
   <nv></nv>
    <name>OCTANE95</name>
    <value>4.17</value>
   </nv>
   <nv></nv>
    <name>OCTANE95PLUS</name>
    <value>4.23</value>
   </nv>
   <nv></nv>
    <name>OCTANE97</name>
    <value>4.23</value>
   </nv>
   <nv></nv>
    <name>EURODIESEL10</name>
    <value>3.63</value>
   </nv>
   <nv></nv>
    <name>PRODIESEL10</name>
    <value>3.59</value>
   </nv>
  </nvs>
  </poi>
  <poi>
   <id>34200046605</id>
   <name>PO-KUZEN PETROL AKARYAKIT SANAYÝ VE TÝCARET LÝMÝTED ÞÝRKETÝ</name>
   <address>KAYNARCA MAH. AYDINLI YOLU CADDESÝ PENDÝK ÝSTANBUL</address>
   <phone>+90 216 5000743</phone>
   <latitude>4542316</latitude>
   <longitude>470631</longitude>
   <distance>0</distance>
  <nvs>
   <nv></nv>
    <name>OCTANE95</name>
    <value>4.17</value>
   </nv>
   <nv></nv>
    <name>OCTANE95PLUS</name>
    <value>4.23</value>
   </nv>
   <nv></nv>
    <name>OCTANE97</name>
    <value>4.23</value>
   </nv>
   <nv></nv>
    <name>EURODIESEL10</name>
    <value>3.63</value>
   </nv>
   <nv></nv>
    <name>PRODIESEL10</name>
    <value>3.59</value>
   </nv>
  </nvs>
  </poi>

   ...

  <poi>
   <id>34200046773</id>
   <name>SHELL-MENZÝL NAKLÝYE MADENCÝLÝK ÝNÞAAT OTOMOTÝV TURÝZM SAN.</name>
   <address>BATTAL GAZÝ MAH. BOSNA BULVARI SULTANBEYLÝ ÝSTANBUL</address>
   <phone>+90 216 5926627</phone>
   <latitude>4554140</latitude>
   <longitude>472592</longitude>
   <distance>0</distance>
  <nvs>
   <nv></nv>
    <name>OCTANE95</name>
    <value>4.16</value>
   </nv>
   <nv></nv>
    <name>OCTANE95PLUS</name>
    <value>4.33</value>
   </nv>
   <nv></nv>
    <name>OCTANE97</name>
    <value>4.33</value>
   </nv>
   <nv></nv>
    <name>EURODIESEL10</name>
    <value>3.67</value>
   </nv>
   <nv></nv>
    <name>PRODIESEL10</name>
    <value>3.59</value>
   </nv>
  </nvs>
   </poi>
 </poilist>
</response>

JSON Response

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

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

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=PoiListEx&Typ=JSON
&IlId=34&ExType=FUELPRICES


The response will be as following:


{ { "transactionid": "LBS_37726418", "status": 0, "poilist": [ { "id": 34200129970, "name": "PO-PETROL OFÝSÝ ANONÝM ÞÝRKETÝ", "address": "SELÝMÝYE MAH. TIBBÝYE CADDESÝ ÜSKÜDAR ÝSTANBUL", "phone": "+90 532 4232515", "latitude": 4558913, "longitude": 452099, "distance": 0, "nvs": [ { "name": "OCTANE95", "value": "4.17" }, { "name": "OCTANE95PLUS", "value": "4.23" },{ "name": "OCTANE97", "value": "4.23" }, { "name": "EURODIESEL10", "value": "3.63" }, { "name": "PRODIESEL10", "value": "3.59" } ] }, { "id": 34200129970, "name": "PO-PETROL OFÝSÝ ANONÝM ÞÝRKETÝ", "address": "SELÝMÝYE MAH. TIBBÝYE CADDESÝ ÜSKÜDAR ÝSTANBUL", "phone": "+90 532 4232515", "latitude": 4558913, "longitude": 452099, "distance": 0, "nvs": [ { "name": "OCTANE95", "value": "4.17" }, { "name": "OCTANE95PLUS", "value": "4.23" }, { "name": "OCTANE97", "value": "4.23" }, { "name": "EURODIESEL10", "value": "3.63" }, { "name": "PRODIESEL10", "value": "3.59" } ] },

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.