Endpoint Migration Guide

Use ODHActivityPoi Endpoint instead of the legacy Activity, Poi, Gastronomy Endpoints

ODHActivityPoi contains all data from the Endponits Activity, Poi and Gastronomy. Also it contains more data from different data Providers (Siag, IDM, Suedtirol Wine, Redactional Content, Link to Outdooractive etc...).

We strongly recommend to use the new Endpoint the old Endpoints are legacy and will no longer be supported in the near future

The new Endpoint is compatible with the old Endpoints, all filtering possibilities are recreated, all properties of the data structure are still there. However there are some small differences we try to describe in this guide

Data structure compared

ODHActivityPoi - Activity

ODHActivityPoi - Poi

Type, SubType, PoiType fields are different, however they are obsolete and should not be used. We have seen a 1:1 Type assignment is not possible so ODH switched to the multiple Categorization by it's Tags.

LTSTags original Tagging provided by the datasource
ODHTags ODH Tagging, contains ODH categorization
The Tagging can differ, it is up to the data consumer which Tagging he would use, we recommend to use ODH Tags Gpstype English naming used

ODHActivityPoi - Gastronomy

GpsInfo:

Gastronomy

"Gpstype": "GPSCenter",
"Altitude": 948,
"Latitude": 46.8979,
"Longitude": 11.4314,

ODHActivityPoi --> GpsPoints

"GpsInfo": [
{
"Gpstype": "position",
"Altitude": 948,
"Latitude": 46.8979,
"Longitude": 11.4314,
"AltitudeUnitofMeasure": "m"
}
],

Filtering compatibility

ODHActivityPoi - Activity

On ODHActivityPoi all filters from Activity are available.
activitytype --> Filters by the LTS categorization. Find all available categorizations on this list https://tourism.api.opendatahub.bz.it/v1/ActivityTypes

ODHActivityPoi - Poi

On ODHActivityPoi all filters from the Poi Endpoint are available.
poitype --> Filters by the LTS categorization. Find all available categorizations on this list https://tourism.api.opendatahub.bz.it/v1/PoiTypes
Simply Pass the Bitmask
If poitype is passed, the subtype Filter can be used also for the subtypes defined in the list.

Example, we filter on Shops (Bitmask 2) and Subtype Antiques (Bitmask 2) + Flowers (Bitmask 4) poitype=2
subtype=6
https://tourism.api.opendatahub.bz.it/v1/ODHActivityPoi?poitype=2&subtype=6
same as https://tourism.api.opendatahub.bz.it/v1/Poi?poitype=2&subtype=6

ODHActivityPoi - Gastronomy

On ODHActivityPoi all filters from Gastronomy are available.
categorycodefilter --> Filters by the LTS Categories dishcodefilter--> Filters by the LTS Dish Codes ceremonycodefilter--> Filters by the LTS Ceremony Codes facilitycodefilter--> Filters by the LTS Facility Codes cuisinecodefilter--> Filters by the LTS Cuisine Codes

Find all available categorizations for Gastronomies on this list https://tourism.api.opendatahub.bz.it/v1/GastronomyTypes