Datasets

The goal of the Open Data Hub Project is to make available datasets containing data about the South Tyrolean Ecosystem, to allow third parties to develop novel applications on top of them, consuming the exposed data. These applications may range from a simple processing of datasets to extract statistical data and to display the result in different graphic formats like pie-charts, to far more complex applications that combine data from different datasets and correlate them in some useful way.

Note

This page was last updated on Nov 15, 2018, hence all information about the availability of datasets is correct as of this date. This page will be updated in due time as soon as more material will be made available.

This page will be soon removed, as all the information statically provided here will be in the near future be replaced by the broker service, which dynamically maintains the list.

As seen in Figure 1, data originate from different domains (Mobility, Tourism, and so on); they are gathered from sensors and packed within datasets. Sensors can be for example GPS devices installed on buses that send their real-time geographic position or a small electronic device on a plug of an e-charging station that checks the if the plug is being used or not, to let people know that the charging outlet is available.

A note about datasets.

At the time of writing, only a few datasets are published. As mentioned before in this section, the goal is to expose datasets containing only Open Data, which is at the moment not the case for all datasets. Indeed, some of the datasets contain data that can not be distributed under an open licence like, e.g., CC0 license (public domain) or CC BY-SA license. Therefore, to allow the highest possible data to be shared, an authentication mechanism has been implemented, to prevent access to the data in the datasets that has not yet been published as Open Data.

Datasets which require authentication are marked with the This dataset requires authorisation badge. If you are interested in accessing closed data, you can try to contact the dataset owner or express your interest to the Open Data Hub team.

Please refer to section Authentication for details.

For each domain the available datasets are listed. Please refer to the next sections for a complete list.

Datasets in the Mobility Domain

In this section, the following information are provided for each of the above-listed dataset:

  • The licence of the data present in the dataset.
  • The output format of the API call.
  • An e-mail contact for the dataset.
  • The versions of the API that can be used to access the dataset.
  • The swagger URL of the APIs.

it.bz.opendatahub.weather

This dataset contains meteorological data provided by the hydrographical Department of South Tyrol.

License CC0 license (public domain)
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://ipchannels.integreen-life.bz.it/meteorology

it.bz.opendatahub.environment

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://ipchannels.integreen-life.bz.it/environment/swagger-ui.html

it.bz.opendatahub.parking

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://ipchannels.integreen-life.bz.it/parking/swagger-ui.html

it.bz.opendatahub.bluetooth

The data for this datasets are collected by experimental Bluetooth-based sensors and detectors and represent traffic information, since the detectors scan available Bluetooth devices on board of vehicle that drive on.

License CC0 license (public domain)
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://ipchannels.integreen-life.bz.it/BluetoothFrontEnd

it.bz.opendatahub.trafficstation

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://ipchannels.integreen-life.bz.it/sensors/swagger-ui.html

it.bz.opendatahub.linkstation

Similar to the Bluetooth dataset, data available in this dataset are collected by Bluetooth-based sensors to measure the level of traffic on the strech of a road.

License CC0 license (public domain)
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://ipchannels.integreen-life.bz.it/LinkFrontEnd

it.bz.opendatahub.streetelements

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://ipchannels.integreen-life.bz.it/street/swagger-ui.html

it.bz.opendatahub.rwisstation

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://ipchannels.integreen-life.bz.it/roadweather/swagger-ui.html

it.bz.opendatahub.carsharing

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://ipchannels.integreen-life.bz.it/carsharing/swagger-ui.html

it.bz.opendatahub.bikesharing

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://ipchannels.integreen-life.bz.it/bikesharing/swagger-ui.html

it.bz.opendatahub.echargingstation

This datasets exposes data about the existing e-charging stations in South Tyrol and their status, including historical data and usage.

License CC0 license (public domain)
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://ipchannels.integreen-life.bz.it/EchargingFrontEnd

it.bz.opendatahub.carpoolinghub

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://ipchannels.integreen-life.bz.it/carpooling/swagger-ui.html

info.opensasa.realtime

This datasets shows the real time position of buses operated by SASA in South Tyrol and, through a few subsets, additional information about lines, station boards, and news.

License CC BY-SA license
Output geoJSON
E-mail contact info@sasabus.org
API version v1
Swagger URL http://sasabus.org/opendata

The additional subsets expose data in different formats:

  • info.opensasa.plandata (VDV 451 - VDV 452)
  • info.opensasa.stationboard (JSON)
  • info.opensasa.news (JSON)
  • info.opensasa.rssDE (XML)
  • info.opensasa.rssIT (XML)

Datasets in the Tourism Domain

Like in the previous section, the following information are provided for each of the above-listed dataset:

  • The licence of the data present in the dataset.
  • The output format of the API call.
  • An e-mail contact for the dataset.
  • The versions of the API that can be used to access the dataset.
  • The swagger URL of the APIs.

it.lts.accommodation

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://tourism.opendatahub.bz.it/swagger/ui/index#/Accommodation

it.hgv.package

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://service.suedtirol.info/swagger/ui/index#/Package

it.lts.poi

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://tourism.opendatahub.bz.it/swagger/ui/index#/Poi

it.lts.activity

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://tourism.opendatahub.bz.it/swagger/ui/index#/Activity

it.lts.event

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://tourism.opendatahub.bz.it/swagger/ui/index#/Event

it.bz.opendatahub.activity_poi

This dataset contains a collection of activities and points of interest (PoI) in the South Tyrol region. The available data have been extracted from different sources, but at the moment only the data about the South Tyrolean museums are freely available without authentication.

License museum’s data CC0 license (public domain), other data This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://tourism.opendatahub.bz.it/swagger/ui/index#/ODHactivityPoi

it.lts.gastronomy

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://tourism.opendatahub.bz.it/swagger/ui/index#/Gastronomy

it.bz.opendatahub.location

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://tourism.opendatahub.bz.it/swagger/ui/index#/Common

it.bz.opendatahub.ski

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://tourism.opendatahub.bz.it/swagger/ui/index#!/Common/Common_GetSkiAreas

it.bz.opendatahub.snowreport

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://tourism.opendatahub.bz.it/swagger/ui/index#!/Weather/Weather_GetSnowReportBase

it.bz.opendatahub.webcam

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://tourism.opendatahub.bz.it/swagger/ui/index#/Webcam

it.bz.opendatahub.weather-siag

License This dataset requires authorisation
Output JSON, mime-type application/json
E-mail contact info@opendatahub.bz.it
API version v1
Swagger URL http://tourism.opendatahub.bz.it/swagger/ui/index#/Weather

it.bz.siag.weather

License This dataset requires authorisation
Output XML#
E-mail contact meteo@provinz.bz.it
API version
Swagger URL

#The dataset in German can be dowloaded as XML using this URL: https://wetter.ws.siag.it/Weather_V1.svc/web/getLastProvBulletin

it.bz.siag.museum

This datasets contains information about the museums in the South Tyrol region and is retrieved directly from the Open Data portal of the Autonomous Province of Bolzano.

More information about this dataset, including metadata, is available in either Italian or German at the following URLs, respectively:

License CC0 license (public domain)
Output JSON, CSV, XML#
E-mail contact museen@provinz.bz.it
API version
Swagger URL
#The dataset can be dowloaded as XML using this URL:
https://cert.provinz.bz.it/musport/services/MuseumsService.MuseumsServiceHttpSoap11Endpoint/getMuseums

The Broker

The Open Data Hub Broker is a recently introduced online service (November 2018) that gives an overview and quick access of the datasets available within the Open Data Hub project.

The service is accessible at the URL https://api.opendatahub.bz.it and consists of a web page, divided in two parts:

  • The list of datasets accessible through the broker, which are all the datasets containing publicly accessible data. This list is dynamically created when the page is loaded, therefore is is always up to date. Each dataset can be clicked to open a panel with additional information about it.
  • An overview of the REST API provided by the broker, a few methods that allow to query the existing datasets. Results are in JSON-LD format and use the DCAT vocabulary. This means that all the keyword in the result set belong to a W3C standard, allowing the data in the result set to be reused and combined with results from foreign datasets that use the same vocabulary.

The results obtained by querying the broker give a number of metadata about one or more datasets, including the Contact for information or reuse of the dataset, and the Base URL, allowing for quick and direct access to the data, using the ODH APIs, described in the Documentation URL.

Note

While the Base URL, when accessed, may give an error, the API calls work and produce correct results. For example, consider the it.bz.opendatahub.echargingstation dataset. Calling the method get-station-details by using its base URL, https://api.opendatahub.bz.it/it.bz.opendatahub.echargingstation, actually produce the expected result, i.e., the list of stations in the dataset with all the information attached to it:

curl
"https://api.opendatahub.bz.it/it.bz.opendatahub.echargingstation/rest/get-station-details"
| jq '.' | head -10

[
  {
    "_t": "it.bz.idm.bdp.dto.emobility.EchargingStationDto",
    "id": "ASD_00000038",
    "name": "CAMPING_LATSCH",
    "latitude": 46.622135,
    "longitude": 10.863569,
    "municipality": "Latsch - Laces",
    "capacity": 1,
    "provider": "Alperia Smart Mobility",

Broker’s REST API

The methods available are the following.

  • GET /datasets Returns a list of all datasets in form of a dcat:Catalog.
  • GET /datasets/{id} Retrieve the metadata of a single dataset by its identifier, which corresponds to the identifier key that you can find in the in the outcome of the previous method’s call. See also the excerpt below. The result set is a dcat:Dataset.
  • GET /datasets/search/{query} Execute a custom, case insensitive query on the available datasets. All the fields within the result set of the GET /datasets query will be considered for an answer. Multiple words can be used as query string

The outcome of the query looks like the following excerpt which is, as mentioned in the previous section in JSON-LD format and uses the standard DCAT vocabulary.

{
   "title": "it.bz.opendatahub.echargingstation",
   "publisher": {
     "title": "Alperia, route220, Nevicam, Driwe",
     "@type": "http://www.w3.org/ns/org#Organization",
     "@context": {
       "title": "http://purl.org/dc/terms/title"
     }
   },
   "keyword": [
     "echarging",
     "mobility",
     "realtime"
   ],
   "identifier": "it.bz.opendatahub.echargingstation",
   "distribution": [
     {
       "license": "https://creativecommons.org/publicdomain/zero/1.0/",
       "format": "application/json",
       "accessURL": "https://api.opendatahub.bz.it/it.bz.opendatahub.echargingstation",
       }
     }
   ],
   "description": "Real time information about the echarging statons",
   "contactPoint": {
     "hasEmail": "info@geobank.bz.it"
   },
   "@type": "http://www.w3.org/ns/dcat#Dataset",
   "@id": "https://api.opendatahub.bz.it/datasets/it.bz.opendatahub.echargingstation",
 }

Note

References to some of the definitions of the vocabulary have been deleted from the excerpt for the sake of clarity.