Skip to content

ODHActivityPoi

RudiThoeni edited this page May 4, 2022 · 21 revisions

How to use the ODHActivityPoi Endpoint

ODHActivityPoi contains data from different data Providers (LTS, Siag, IDM, Suedtirol Wine, etc...).

The source is identified by the field

_Meta: {
    Id: "xxxxxxx",
    Source: "idm",
    ....
}

ODHActivityPoi - important infos about fields

Type, SubType, PoiType deprecated, should not be used.
AdditionalPoiInfos.language.MainType, AdditionalPoiInfos.language.MainType and AdditionalPoiInfos.language.SubType deprecated should not be used

Instead we strongly recommend to rely on the multiple categorization defined by Tagging:

ODHTags Categorization of the ODHActivityPoi
AdditionalPoiInfos.[language].Categories Categorization to show (some Tags are marked ad Categories to display and this Tags will be present here in all languages)

GpsInfo

GpsPoints should be used instead of deprecated GpsInfo

Filtering

type
activitytype
poitype
subtype
level3type

odhtagfilter odhtagfilterand

All type/subtype/level3type Filter "under the hood" are filtering on the assigned Tags. Every ODHActivityPoi can have multiple Tags association. The Bitmask is only helpful do shorten the Parameter and allows filtering by certain type combinations. The type/activitytype/poitype/subtype/level3type filter is here for compatibility reasons. All can be done also with the odhtagfilter, and odhtagfilterand.

ODHActivityPoi

type --> Filters by ODHActivityPoi main types. Find all available types on this list ODHActivityPoi Main Types and pass the key / bitmask

subtype --> Additional Filtering by subtype. Only available if filtering by ONE type is active. Find all available keys on this list by passing the maintype key https://tourism.api.opendatahub.bz.it/v1/ODHActivityPoiTypes?rawfilter=and(eq(Type,"SubType"),eq(Parent,"TYPEKEY"))

ODHActivityPoi - Kultur Sehenswürdigkeiten
[ODHActivityPoi - Wellness Entspannung](https://tourism.api.opendatahub.bz.it/v1/ODHActivityPoiTypes?rawfilter=and(eq(Type,"SubType"),eq(Parent,"Wellness Entspannung")))
[ODHActivityPoi - Essen Trinken](https://tourism.api.opendatahub.bz.it/v1/ODHActivityPoiTypes?rawfilter=and(eq(Type,"SubType"),eq(Parent,"Essen Trinken")))
ODHActivityPoi - Sommer
ODHActivityPoi - Winter
ODHActivityPoi - Anderes
ODHActivityPoi - Mobilität
[ODHActivityPoi - Geschäfte und Dienstleister](https://tourism.api.opendatahub.bz.it/v1/ODHActivityPoiTypes?rawfilter=and(eq(Type,"SubType"),eq(Parent,"Geschäfte und Dienstleister")))

level3type --> Additional Filtering by level 3 type. Only available if filtering by ONE type and ONE subtype is active. Find all available keys on this list by passing by passing the subtypekey. https://tourism.api.opendatahub.bz.it/v1/ODHActivityPoiTypes?rawfilter=and(eq(Type,"PoiType"),eq(Parent,"SUBTYPEKEY"))

Example:
All Level 3 Types from Subtype Wandern https://tourism.api.opendatahub.bz.it/v1/ODHActivityPoiTypes?rawfilter=and(eq(Type,"PoiType"),eq(Parent,"Wandern"))

Filtering Example:

I want to filter on all ODHActivityPois of Type "Winter" Using the ODHActivityPoi Main Types Key:
https://tourism.api.opendatahub.bz.it/v1/ODHActivityPoiTypes?type=Winter Using the ODHActivityPoi Main Types Bitmask:
https://tourism.api.opendatahub.bz.it/v1/ODHActivityPoiTypes?type=2

I want to filter on all ODHActivityPois of Type "Winter" and "Sommer" Using the ODHActivityPoi Main Types Keys separated by ",":
https://tourism.api.opendatahub.bz.it/v1/ODHActivityPoiTypes?type=Winter,Sommer Using the ODHActivityPoi Main Types Bitmask (adding values 2 + 4 = 6):
https://tourism.api.opendatahub.bz.it/v1/ODHActivityPoiTypes?type=6

Filters for Compatibility

activitytype --> Filters by the LTS Activity categorization.
Find all available categorizations on this list LTS Activity Main Types

poitype --> Filters by the LTS categorization.
Find all available categorizations on this list LTS Poi Main Types
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

Clone this wiki locally