Points of Interest

Index Action

The index action can be used to obtain a list of POIs. The resulting list can be further narrowed by passing parameters like name, description or geolocation in conjunction with radius. So this action can be used as textual search and/or location based search.

Parameter Abbreviation Data Type
name n STRING
description d STRING
language l LANGUAGE
category ca INTEGER
geolocation g GEOLOCATION
radius r INTEGER
limit lt INTEGER
offset ot INTEGER
network_id nid INTEGER

Notes

Output

{
  "Pois": [<INTEGER>, ...],
  "StatusCode": <INTEGER>
}

Example Requests

http://api.ostar.inf.unibz.it/0/pois?lt=5&g=11.345646,46.494722&r=500
{
  "Pois": [507, 1447, 737, 1094, 903],
  "StatusCode": 0
}

 

http://api.ostar.inf.unibz.it/0/pois?lt=5&l=de&name=uni
{
  "Pois": [235, 244, 907, 1031, 1641],
  "StatusCode": 0
}

Show Action

Parameter Abbreviation Data Type
language l LANGUAGE
network_id nid INTEGER

Output

{
  "Poi": {
    "Id": <INTEGER>,
    "Name": <STRING>,
    "Location": <GEOLOCATION>,
    "NodeId": <INTEGER>,
    "CategoryIds": [<INTEGER>, ...],
    "Description": <STRING>,
    "VisitTime": <INTEGER (in seconds)>,
    "Street": <STRING>,
    "PostalCode": <STRING>,
    "City": <STRING>,
    "Score": <INTEGER [0..100]>,
    "Url": <STRING>,
    "Telephone": <STRING>,
    "Email": <STRING>,
    "ImageIds": [<INTEGER>, ...],
    "Modified": <DATETIME>
  },
  "StatusCode": <INTEGER>
}

Example Requests

http://api.ostar.inf.unibz.it/0/pois/71?&l=de
{
  "Poi": {
    "Id": 71,
    "Name": "Entwicklungs- und Forschungszentrum",
    "Location": "11.3473072798792,46.4945349641,0.0",
    "NodeId": 2000619,
    "CategoryIds": [3],
    "Description": "EURAC RESEARCH ACCADEMIA EUROPEA",
    "VisitTime": 3370,
    "Street": "DRUSUSALLEE",
    "PostalCode": "39100",
    "City": "Bozen",
    "Score": 62,
    "Url": null,
    "Telephone": null,
    "Email": null,
    "ImageIds": [420, 421, 422, 423, 424, 425],
    "Modified": "2013-01-30T17:19:46+01:00"
  },
  "StatusCode": 0
}

Multishow Action

Parameter Abbreviation Data Type
ids ids IDS
language l LANGUAGE
network_id nid INTEGER

Output

{
  "Pois": [{
    "Id": <INTEGER>,
    "Name": <STRING>,
    "Location": <GEOLOCATION>,
    "NodeId": <INTEGER>,
    "CategoryIds": [<INTEGER>, ...],
    "Description": <STRING>,
    "VisitTime": <INTEGER (in seconds)>,
    "Street": <STRING>,
    "PostalCode": <STRING>,
    "City": <STRING>,
    "Score": <INTEGER [0..100]>,
    "Url": <STRING>,
    "Telephone": <STRING>,
    "Email": <STRING>,
    "ImageIds": [<INTEGER>, ...],
    "Modified": <DATETIME>
  }, ...],
  "StatusCode": <INTEGER>
}

Example Requests

http://api.ostar.inf.unibz.it/0/pois/multishow?ids=70,71&l=de
{
  "Pois": [
    {
      "Id": 70,
      "Name": "Bar, ristoro, caffè, enoteca (DE)",
      "Location": "11.3473072798792,46.4945349641,0.0",
      "NodeId": 2000619,
      "CategoryIds": [9],
      "Description": "CAFE’ EURAC",
      "VisitTime": 2197,
      "Street": "DRUSUSALLEE",
      "PostalCode": "39100",
      "City": "Bozen",
      "Score": 75,
      "Url": null,
      "Telephone": null,
      "Email": null,
      "ImageIds": [414, 415, 416, 417, 418, 419],
      "Modified": "2013-01-30T17:19:13+01:00"
    },
    {
      "Id": 71,
      "Name": "Entwicklungs- und Forschungszentrum",
      "Location": "11.3473072798792,46.4945349641,0.0",
      "NodeId": 2000619,
      "CategoryIds": [3],
      "Description": "EURAC RESEARCH ACCADEMIA EUROPEA",
      "VisitTime": 3370,
      "Street": "DRUSUSALLEE",
      "PostalCode": "39100",
      "City": "Bozen",
      "Score": 62,
      "Url": null,
      "Telephone": null,
      "Email": null,
      "ImageIds": [420, 421, 422, 423, 424, 425],
      "Modified": "2013-01-30T17:19:46+01:00"
    }
  ],
  "StatusCode": 0
}