search

openactive / facility-types

Facility Types controlled vocabularies data and documentation
Creative Commons Attribution 4.0 International
1 stars 2 forks source link

facilityType-activity equivalence mapping #5

Open civsiv opened 1 year ago

civsiv commented 1 year ago

facility-types.jsonld currently contains a mapping between facilityType and activity. In order for this to be useful for backwards compatibility when dealing with datasets that currently use activity for FacilityUse this mapping needs to be an equivalence. This PR (https://github.com/openactive/facility-types/pull/4) addresses the cases where the mapping are not equivalent.

Going forward it would be helpful to formally define the nature of this mapping to ensure the mapping can be used consistently by all implementers.

For example the activity Tennis should map to Tennis Courts but not to Indoor Sports Hall. Indoor Sports Hall should not match to any activities as it is not equivalent to any specific activities.

Additionally it would be good to provide guidance for operators that still use systems that use activities to describe a FacilityUse so that they know which activity would result in the expected facilityType. For example an operator would use this mapping to manually tag a Tennis Court with the activity Tennis to ensure that it appears alongside other facilityType: Tennis Court in searches.

howaskew commented 1 year ago

Do you/we know which users still use activities to describe FacilityUse? I can try to get them along to a W3C call to discuss.

civsiv commented 1 year ago

I think it's predominantly Legend and Gladstone Booking Systems at the moment

civsiv commented 1 year ago

Squash court currently has two activity mappings:

Racketball is not mapped to "Racquetball Court" as Racketball and Racquetball are different sports (with different court sizes, rules, and balls).