API

LocationBox API

Social Event Search

(powered by dakick.com services)

Social Event Search Service lists social events with their locations based on criterias which you can find below.

A Social Event Search request must look like this:

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=SocialEventSearch&Typ=output_format
&Latitude=latitude&Longitude=longitude&Radius=radius


Request Parameters


Key: LocationBox user key. (Register for user key)
Cmd: LocationBox service name. (SocialEventSearch)
Typ: Response format. (XML or JSON)
Latitude: Latitude of location.
Longitude: Longitude of location.
Radius: The radius of the area bounding for social event search result.

Response Parameters


XML Response

Social Event Search response returns in XML format when the Typ parameter is set as "XML".

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

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=SocialEventSearch&Typ=XML
&Latitude=41.0961&Longitude=29.0619&Radius=10000

The response will be as following:

<response>
 <transactionid>LBS_37525910</transactionid>
 <status>0</status>
 <errno />
 <errdesc />
 <items>
  <socialevent>
   <id>7949980</id>
   <name>Geçmişten Günümüze Bebek Ürünleri Sergisi</name>
   <description>"Geçmişten Günümüze Bebek Ürünleri Sergisi" 10-25 Kasım tarihleri arasında Palladium AVM'de.</description>
   <category>140</category>
   <location>Palladium AVM</location>
   <startdate>2012-11-10 10:00:00</startdate>
   <enddate>2012-11-25 22:00:00</enddate>
   <timezone>Istanbul</timezone>
   <latitude>40.9862</latitude>
   <longitude>29.1007</longitude>
   <distance>2644</distance>
  </socialevent>
  <socialevent>
   <id>7869738</id>
   <name>Memduh Kuzay Resim Sergisi</name>
   <description>Türkiye’nin yanısıra Amerika ve Almanya’da sürdüren Memduh Kuzay’ın Tolga Eti SanatEvi’nin sanat anlayışına paralel gerçekleştirdiği resim sergisi 3 Kasım – 8 Aralık 2012 tarihleri arasında izlenebilir.</description>
   <category>140</category>
   <location>Tolga Eti Sanatevi</location>
   <startdate>2012-11-03 10:00:00</startdate>
   <enddate>2012-12-08 19:00:00</enddate>
   <timezone>Istanbul</timezone>
   <latitude>40.9802</latitude>
   <longitude>29.0823</longitude>
   <distance>3629</distance>
  </socialevent>

   ...

  <socialevent>
   <id>7853952</id>
   <name>Boğaziçi Caz Korosu Konseri</name>
   <description>Yaklaşık 35 kişilik kadrosuyla çağdaş müzikten caza, hatta çok sesli türkü düzenlemelerine kadar uzanan çok geniş bir repertuvara sahip olan Boğaziçi Caz Korosu zengin bir programla 19 Kasım akşamı Süreyya Operası’nda.</description>
   <category>128</category>
   <location>Süreyya Operası</location>
   <startdate>2012-11-19 20:00:00</startdate>
   <enddate>2012-11-19 22:00:00</enddate>
   <timezone>Istanbul</timezone>
   <latitude>40.9881</latitude>
   <longitude>29.0286</longitude>
   <distance>6481</distance>
  </socialevent>
  </items>
</response>
JSON Response

Social Event Search response returns in JSON format when the Typ parameter is set as "JSON".

Below is an example for a Social Event Search request which is expected to return a response in JSON format .

http://www.locationbox.com.tr/locationbox/services?Key=key&Cmd=SocialEventSearch&Typ=JSON
&Latitude=41.0961&Longitude=29.0619&Radius=10000

The response will be as following:


{ "transactionid": "LBS_19522", "status": 0, "items": [ { "id": 7949980, "name": "Geçmişten Günümüze Bebek Ürünleri Sergisi", "description": "`Geçmişten Günümüze Bebek Ürünleri Sergisi` 10-25 Kasım tarihleri arasında Palladium AVM`de.", "category": 140, "location": "Palladium AVM", "startdate": "2012-11-10 10:00:00", "enddate": "2012-11-25 22:00:00", "timezone": "Istanbul", "latitude": 40.9862, "longitude": 29.1007, "distance": 2644 }, { "id": 7869738, "name": "Memduh Kuzay Resim Sergisi", "description": "1985 yılında Mimar Sinan Güzel Sanatlar Üniversitesi Özdemir Altan resim atölyesinden mezun olduktan sonra sanat yaşamını, Türkiye’nin yanısıra Amerika ve Almanya’da sürdüren Memduh Kuzay’ın Tolga Eti SanatEvi’nin sanat anlayışına paralel gerçekleştirdiği resim sergisi 3 Kasım – 8 Aralık 2012 tarihleri arasında izlenebilir.Memduh Kuzay’ın resimleri yurt dışında da sergilenmekte ve koleksiyonlarda yer almaktadır.", "category": 140, "location": "Tolga Eti Sanatevi", "startdate": "2012-11-03 10:00:00", "enddate": "2012-12-08 19:00:00", "timezone": "Istanbul", "latitude": 40.9802, "longitude": 29.0823, "distance": 3629 }, ... { "id": 7853952, "name": "Boğaziçi Caz Korosu Konseri", "description": "Yaklaşık 35 kişilik kadrosuyla çağdaş müzikten caza, hatta çok sesli türkü düzenlemelerine kadar uzanan çok geniş bir repertuvara sahip olan Boğaziçi Caz Korosu zengin bir programla 19 Kasım akşamı Süreyya Operası’nda.", "category": 128, "location": "Süreyya Operası", "startdate": "2012-11-19 20:00:00", "enddate": "2012-11-19 22:00:00", "timezone": "Istanbul", "latitude": 40.9881, "longitude": 29.0286, "distance": 6481 } ] }

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

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.