Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Describing surfaces of pitches #1

Open
ldodds opened this issue Apr 20, 2018 · 32 comments
Open

Describing surfaces of pitches #1

ldodds opened this issue Apr 20, 2018 · 32 comments

Comments

@ldodds
Copy link

ldodds commented Apr 20, 2018

How should we support specifying the surface of a football pitch (for example).

One option is to add a surface property which can be applied to a SportsActivityLocation

@nickevansuk
Copy link
Contributor

Suggest this property should now be on FacilityUse?

@nickevansuk
Copy link
Contributor

Worth thinking about: court/pitch type, i.e surface type, indoor/outdoor. Perhaps surface and indoor/outdoor are separate properties?

@jamiefoale
Copy link

jamiefoale commented Feb 7, 2019

Based on discussions with Izy at Sport England, Tom at Played and myself we have thought the following:

  • Active Places have worked with NGBs to create a structure for their sport facilities already, which incorporate the different facility types
  • Therefore we believe this is suitable as a source of truth as is already curated by the NGBs and hosted by SE / Active Places
  • While it doesn't strictly cover each sport that can be played on a facility, this is more intangible now as a 'space' eg pitch can be used for multiple purposes as formats are becoming more flexible. Eg you have tag rugby played on a traditional 5 a side football pitch
  • There are other gaps eg tennis courts are pretty limited, but if NGBs can be informed of the use of this structure (which should in turn be used by many operators) then it should motivate them to ensure thorough curation
  • There is an existing API for Active Places which could make any tech work easier

The two fields are 'Facility type' and 'Facility sub type'. These are mapped so each sub type is specific to the ID of the Facility type. These two sheets are attached.

In order to make the use of opportunity data scalable we feel this should be included in the FacilityUse.

Thanks

FacilityType and FacilitySubType.xlsx

@IzyChampion
Copy link

Hiya

Here's some more contextual information on how Active Places is structured, provided by my colleague Mark, which answers (to some extent) the question on tennis courts above from @jamiefoale :)

The key tables/tabs within the Sport Data Model are: FacilityType, FacilitySubType, and Lookups, however there are some inconsistencies with Active Places as to where surface type is defined. For example the Facility Type of Artificial Grass Pitches has Facility Sub-Types based upon the surface type - Surface Type is not a facility specific attribute and does not reference the lookup table within the Sport Data Model (SDM).

AGP Rubber crumb 3G Sand dressed Sand filled Water based Length Width Pile length …..

However, for Tennis Courts, the Facility Sub-Type is Tennis Courts. The Surface Type is an attribute within the facility specific details references surface type within the lookup table in the SDM

Tennis Courts Tennis Courts Surface Clay Grass ….

We're keen to see if we can iron out some of this detail through use of Active Places via OpenActive - and potentially explore creating common data standards between the two!

@nickevansuk
Copy link
Contributor

nickevansuk commented Feb 7, 2019

Comments regarding progressing this as a maintained list in OpenActive

Interesting! Just had a quick look… the list supplied seems to be a mix of activities which already feature in the OpenActive Activity List (e.g. “Paragliding”, “Canoeing”, “Horse Racing”, “Baseball”, “Hurling”), some surface types (e.g. “Permanent Grass”) and some other facility types (e.g. “Indoor Climbing Wall”, “Dodjo”, "Boxing Gym").

I suspect, as Mark has pointed out, that this list might have been created for a slightly different purpose?

Given the high number of duplicates between this list and the current OpenActive Activity List, it looks like there's still quite a bit of work to separate out the concept of an "Activity" (in OA terms) from the types of "Facility" (e.g. "Sports Hall", "Pitch", "Climbing Wall") and attributes of "Facility" such as "Surface type" ("Rubber crumb pile (3G)") and Indoor/Outdoor.

@jamiefoale for reference, would you be able to post MLP's own surface/pitch type schema you mentioned in the last call, as a point of comparison?

It would be good to get lists from a few different sources, as we've done with other aspects of the standards, to ensure we've got a range of inputs for this.

This is likely to take some time, though is certainly worthwhile.

Comments regarding the short term

Another great input into the long term discussion is to see early use of a property in the wild, which would be achieved via a "beta" property. This way how the "beta" property is used becomes another input to the long term discussion, and also provides data users with useful data in the interim too.

For this to be viable within short-term timescales we'd need to get to something a bit more curated fairly rapidly.

Perhaps existing schema's such as MLPs could be a good way to do this? Or perhaps we want to focus on the long term here?

@IzyChampion
Copy link

You're right in terms of that list covering a myriad of uses, and I think we'd be keen to understand how we can make it more useful! The other thing to note is that this list covers all the technical specifications for different surfaces (eg Sand Filled, Sand Dressed, Rubber Crumb etc) - and not what they might be named by someone promoting the pitch. For example, through this process I learnt that there's no such thing as a 4G pitch, despite many places advertising their pitches as such!

We suggested that one way around not distorting the technical specifications (which are agreed and set with NGBs) and the need to call them something meaningful to consumers would be to follow the lead of the activity list spec - e.g. where a leisure operator calls a session something strange like 'bubble buddies' but it can still be tagged as swimming to make it meaningful.

@nickevansuk
Copy link
Contributor

nickevansuk commented Feb 7, 2019

Regarding using language from the technical specifications: it depends on how widely recognised the technical specs are, and how diverse the consumer facing brands are compared with the underlying spec names - agree we should certainly aim for canonical activities where we can.

In terms of making it more useful / linking it with existing OA data, I've just had a quick chat with @jamiefoale and looks like we might have a way forward with this for an MVP.

Facility types are often shared between sports, and as the Active Places list shows, sometimes sports don't have specific facility types (e.g. "Drag Racing").

MVP vocab and Beta property

So to create this MVP, I've created the following template as a starting point:
https://docs.google.com/spreadsheets/d/1ZZ1J13Ry3y8p5nA2Voady98A3dZocvGebuNu1PYIveI/edit#gid=0

Note that this will only be a straw-man at this stage, and is to give implementing systems something to include to prove the concept and usefulness of the data. It will change and evolve over time.

Instructions

For each facility type we want to include, we need to find the relevant activities that would be applicable to it from http://activity-list-editor.openactive.io/en.html, and reference them against that facility type. Notice the pattern in the example of including the URL of the activity from the activity list along with its name, this is important as it includes the ID.

Note the highest level activity includes all sub activities
so e.g. Football (http://activity-list-editor.openactive.io/en/concepts/_0a5f732d-e806-4e51-ad40-0a7de0239c8c.html) will include all of these:
screenshot 2019-02-07 at 19 42 34

We want to avoid duplicating facility types with the same name (e.g. I notice Active Places includes "Rubber crumb pile (3G)" twice).

As an example of a user interface to give some context to this: when a provider selects the standard "activities" related to their facility use, they can then select multiple matching entries from the relevant Facility Types which are related to it. E.g. they select "Football", then can choose "3G" from the list of types that becomes available. If they select both "Football" and "Netball" for their FacilityUse, and both of Football and Netball are linked to the Facility Type "3G", then the 3G option only appears once and can be selected for the FacilityUse once.

Note that there is also an "altLabel" column, which follows SKOS and the pattern of the OpenActive Activity List - the altLabel can be used for alternative terms that a consumer might use during a search. This helps capture the widely recognised terms that are being used for the same thing. To include multiple altLabels just separate them with commas.

Also note you don't need to have an Active Places reference for each entry that exists at this stage, but if you can see one then do use it. The main thing is the prefLabel column in the middle (in yellow) and the activity list references on the right.

@nickevansuk
Copy link
Contributor

nickevansuk commented Feb 7, 2019

Additionally shall we use a beta property named beta:facilityType to reference these entries from a FacilityUse, and that we use SKOS to represent this list? In a very similar way to how this works: https://www.openactive.io/accessibility-support/

Thoughts welcome!

@nickevansuk
Copy link
Contributor

One further question, should we also have a property for beta:facilitySetting: with options of either https://openactive.io/IndoorFacility or https://openactive.io/OutdoorFacility?

Or otherwise should we just have Outdoor and Indoor included as facility types? I ask as Indoor/Outdoor seems to be relevant to every type of activity.

@tommarley148
Copy link

tommarley148 commented Feb 8, 2019

Hi guys,

Have made a first pass at this S/S -https://docs.google.com/spreadsheets/d/1ZZ1J13Ry3y8p5nA2Voady98A3dZocvGebuNu1PYIveI/edit#gid=0

Have used a combination of MLP's, Played's and Active Places resources and have included Activities that will take place at each of these surface types.

I aired on the side of caution so have maybe included too many surface types. i.e table tennis table - when there was not a clear surface that the sport could be played on.

I have just included Activities in the Applicable OpenActive Activities that would take place at a surface type included - I have included activities such as Tennis, Football, Volleyball etc and not included activities such as Angling, Gardening etc - does this approach make sense?

If you could feedback that would be awesome.

Thanks
Tom

@IzyChampion
Copy link

Hi everyone

I've made some comments on the spreadsheet shared by @tommarley148 - thanks Tom for pulling this together!

Overall, I think it's an excellent first stab. I've made a few comments based on some internal conversations I've had - apologies for the delay in getting on to this. The main points are:

  • A couple of items seem more like pieces of equipment or facility properties rather than surfaces (like Table Tennis Table, or Cricket Nets) - I've made comments on each of these in the spreadsheet.

  • A couple of surfaces were described in a way which didn't match their Active Places identifier (Sand and Sand Based Carpet, which are both types of Artificial Grass Pitch) - I've made suggestions on updating these, but they may in fact warrant new rows, depending on if there is a different kind of surface meant?

  • A couple of surfaces were linked up to sports which didn't seem to match (Lawn and Crown Green) - AFAIK they are both just linked to Bowls. I've made those suggestions

  • A couple of surfaces didn't appear in the Active Places data (Sports Hall and Squash Courts don't have associated surfaces). Part of me wonders how relevant the surface type is to the consumers who might be looking to book these - is the activity available in the space in these cases more important than the surface type?

I've also added some extra things in which are more 'for reference' than anything.

  • Two additional columns: Id and FacilitySpecificSurfaceOptions - These are links to the relevant entry in the Sports Data Model which links to Active Places and which also contains some relevant surface information, including a whole host of rock climbing surfaces!

  • Some sports have 'preferred surfaces' - e.g. Hockey prefers Sand Based Artificial Grass. I've added them in where I know them. This doesn't change the spreadsheet necessarily, but might help with designing how you serve options to consumers

Hope that helps?

@nickevansuk nickevansuk transferred this issue from openactive/modelling-opportunity-data Mar 4, 2019
@nickevansuk
Copy link
Contributor

nickevansuk commented Mar 4, 2019

I've transferred this over to a repository of its own (also available at https://www.openactive.io/facility-types/), added a tab to the spreadsheet which renders the data sheet into JSON, and added the resulting JSON to this repo.

The cut of the data taken into the JSON is just directly from the spreadsheet, without adjusting for @IzyChampion's most recent comments.

@IzyChampion , @tommarley148 , @jamiefoale it would be great if you could work together to address these comments and get the sheet into a state you're all happy with. Please feel free to make any changes you like to the "Raw Data" sheet, as the formulae for JSON generation are all in the "JSON" sheet.

Beta Properties added

The following have been added resulting from the discussion in this issue. To progress these further they need to be formalised into two proposals: one for facilityType and one for facilitySetting (and its associated IndoorFacility and OutdoorFacility). If it would also be useful to have preferredSurfaces or similar, please create a further proposal for this also.

The facilitySetting has been added to both Event and FacilityUse as it is broadly applicable.

Please create the proposals here.

Properties

(Class) Property Expected Type Proposal Description
(schema:Event, oa:FacilityUse)
beta:facilitySetting
beta:FacilitySettingType #1 Whether the facility is indoor or outdoor.
(oa:FacilityUse)
beta:facilityType
skos:Concept #1 The type of facility in use.

Classes

Class subClasses Proposal Description
beta:FacilitySettingType schema:Enumeration #1 An enumeration of settings in which a facility can exist.

Enumeration Values

Type Value Proposal Description
beta:FacilitySettingType https://openactive.io/ns-beta#IndoorFacility #1 Facility is indoors
beta:FacilitySettingType https://openactive.io/ns-beta#OutdoorFacility #1 Facility is outdoors

@nickevansuk
Copy link
Contributor

@jamiefoale @IzyChampion @tommarley148 as requested please see example UI below. Comments welcome!

Screenshot 2019-03-19 at 10 56 20

@nickevansuk
Copy link
Contributor

nickevansuk commented Mar 21, 2019

Just a quick note that facilityType and facilitySetting might also be useful on SessionSeries for sessions that happen in facilities - I've added facilitySetting to Event for now as it's broadly applicable (and updated "Beta Properties added" above and the Beta namespace to reflect this)

@IzyChampion
Copy link

Following a few calls, myself, @tommarley148 and @jamiefoale have matched any activity type we think needs a facility type to the relevant ones. Hopefully this is now a pretty complete list! @nickevansuk let us know if we need to do anything else to get this finalised!!

Thanks :)

@domfennell
Copy link

domfennell commented Feb 23, 2021

Hi, I've noticed beta:facilitySetting on the ns-beta page, which dictates “Whether the event or facility is indoor or outdoor”.

Because this is used for both events and facilities, wondering it could be more intuitively named to avoid confusion about indoor/outdoor referring specifically to facilities, as opposed to both the facility and event. Perhaps something more widely interpretable across both events and facilities feeds like beta:sportsActivityLocationType would be better?

@nishaldesai
Copy link

Hi everyone.

As part of the MCRactive work, MCRactive would like for users to be able to search Facilities (Uses) and Places by facilityType. (e.g. show me the facility uses that are in a Sports Hall).

I've reviewed the current facilityType list (https://www.openactive.io/facility-types/facility-types.jsonld and https://docs.google.com/spreadsheets/d/1ZZ1J13Ry3y8p5nA2Voady98A3dZocvGebuNu1PYIveI/edit#gid=0) and I believe the following updates would make this list more robust and usable in practice:

  • the list should be hierarchical
  • we should include the following:
    Football Pitch
    Rugby Pitch
    Cricket Pitch
    Athletics Track
    Multi Use Games Area
    Tennis Court
    Track
    Basketball Court
    Golf Course
    Bowling Green
    Baseball Field

In the hierarchy, facilityTypes like Rubber Crumb Artificial Grass and Sand Based Artificial Grass could live under the types of pitches they refer to, e.g. Football Pitch. Or, Lawn & Crown Green can live under Bowling Green.

In this way, data publishers can include the facilityType detail to whatever level of detail they are able to, but crucially data users will know if a given facilityUse is available in a Sports Hall, or a Football Pitch, etc.

@jamiefoale
Copy link

We thought about doing this approach but it then requires someone to be very prescriptive about what activities can take place on a facility. Eg an astroturf of any type (rubber crumb or sand based) can and is being used by multiple activity providers, beyond what the pitch markings indicate. So the parent property shouldn't be the sport but a description of the facility type. If instead 'suggested' sports (eg not an exclusive list) can be under a facility type that could make it easier for publishers but I would discourage giving the sport the seniority.

When thinking about how this translates to booking systems, I believe that you'll find the space / resource is the parent entity and sports/activities sit underneath it.

@nishaldesai
Copy link

Maybe I'm confused about this (sorry if so!). My take on this was that facilityType is just a property under a FacilityUse, and doesn't force any prescriptive decisions to be made, but insteads offers a route for facility owners to be more specific about where (in what type of facility) a FacilityUse is "taking place".

So if a data publisher has FacilityUse called "Badminton", with Activity Type "Badminton" and facilityType "Sports Hall", then the data publisher isn't being prescriptive about what else can happen in that Sports Hall, they are simply saying that this specific facilityUse use takes places in the sports hall. It's not saying that no other facilityuse can happen there.

Or, if I am a facility and I have one grass pitch, that can be used for either Football or Rugby, I can have a FacilityUse called "Junior Football Pitch" (or whatever), activity type is "Football", and FacilityType is "Football Pitch" and maybe "Grass" or whatever other specifics under that or alongside it. I can also have a second facilityuse called "Senior Rugby Pitch", activity type is "Rugby" and FacilityType is "Rugby Pitch" (and then "Grass" or whatever).

Moreover, I believe what I'm suggesting doesn't interfere with the previous proposals, but allows facility owners who wish to clarify where exactly a given faciiltyUse is taking place to do so. If data users just want to show the surface type, they can ignore the other facilityType labels? There's already faciiltyType like Squash Court in the list, but not tennis court or other core sport facilityTypes, so my believe this is just an extension suggestion to make the list more exhaustive.

This allows users who want to search for Places that have certain Facility Types ("show me all the Places near me that have Tennis Courts"), or to search for Facilities only occurring on a facilityType ("show me the availability Basketball facilities in sports halls").

@nickevansuk
Copy link
Contributor

nickevansuk commented Apr 7, 2021

Reflecting on the mention of this in today's W3C call, and summarising thoughts as:

  • This list currently represents both "Surface type" (e.g. "Grass") and "Facility type" (e.g. "Boxing Gym", "BMX Race Track", "Watersports Centre"), however it is missing key facility types such as "MUGA" and "Tennis Court".
  • The challenge is that "Surface type" does not infer "Facility type" and visa versa ("Grass" doesn't infer "Football Pitch", and "Football Pitch" doesn't infer "Grass")
  • Hence these do not make sense as a hierarchy of "broader terms" in the same way as the OpenActive Activity List is a hierarchy of "broader terms" (where "Zumba Gold" infers "Zumba" which infers "Group Exercise")
  • Additionally in the current beta vocabulary it is often hard to classify whether something is a "Surface type" or a "Facility type", e.g. "Synthetic Track"

The options here seem to be:

  1. Split out "Surface type" and "Facility type" as separate properties (i.e. beta:facilitySurface and beta:facilityType) with separate controlled vocabularies - terms would need to be clearly one or the other, e.g. "Synthetic Track" would need to be split into "Synthetic" (surface type) and "Athletics Track" (facility type)
  2. Use beta:facilityType and this controlled vocabulary for both "Surface type" and "Facility type"

Modelling best practice would be (1), however given that this is still a beta property, and is already in use in applications, perhaps the easiest route to go down for now would be (2)? This helps us gather further implementation experience before splitting it out further?

This would mean that a FacilityUse could have a beta:facilityType of both "Football Pitch" and "Grass". Perhaps we could tag all "surfaces" within the list itself to distinguish them from types, so that e.g. "Grass" could be presented differently in the UI if required? If after further implementation experience it's clear that the "surfaces" in the list are fully distinct from the "types", and there is no need for further categorisation, then we can split this into two properties and two lists when graduating into the modelling specification?

The downside of the above is that the splitting the lists later will mean updating all the IDs for one half of the list, which will create work/cost for all implementers to migrate. Hence if we know that the list can be clearly split into surface and type now, it would be cheaper to do it earlier rather than later.

Thoughts welcome!

@nishaldesai
Copy link

Thanks @nickevansuk, yes that would work for the use cases we're coming across and is in line with what I was suggesting in my last comment

@thill-odi
Copy link

Reviewing the list, we definitely need more implementation experience. My suspicion is that the modelling problems here are deep.

If we go with @nickevansuk's suggestion above for the moment, however, the question is I think simply syntactic: how do we indicate that a given Concept is a surface rather than a dedicated facility?

My first thought is that we could use skos:scopeNote for this. Semantically this is a little odd, but it's unlikely to be usefully populated by other values (as would e.g. skos:note or skos:definition).

@nickevansuk
Copy link
Contributor

Interesting, yes - skos-scopeNote is a great find!

Also noting this sentence in the SKOS Primer:

Before concluding this section, it is important to note that other, non-SKOS properties could be used to document concepts. The dct:creator property from Dublin Core [DC] can for instance be used to point to a person that created the concept:
ex:madagascarFishEagle dct:creator [ foaf:name "John Smith" ].

This is similar to the use of activity in the current iteration of the vocab.

So another options could be to define a property which is a beta enum of e.g. beta:conceptType which could include values such as https://openactive.io/ns-beta#FacilitySurface and https://openactive.io/ns-beta#FacilityType

Alternatively a simple boolean property beta:isSurface?

Enum is more extensible as this problem evolves.

@matdavies
Copy link

Some examples of cases we have had to model in the past:

"Court 1" which can be used for Indoor Cricket, Netball or Soccer, as it is largely just a loose netted off area, but which then has:

"Court 1 Half 1" which is, as the name suggests, half of court 1 and can be used for dodgeball, birthday parties, or any other "generic" booking
"Court 1 Half 2" as above.

Half 1 and Half 2 are child courts of Court 1. And then:

"Badminton 1", "Badminton 2", "Badminton 3" which are child courts of both "Court 1" AND of "Court 1 Half 1" (Badminton 1 and 2) AND "Court 2 Half 2" (Badminton 2 again and Badminton 3). On the "Badmintons" bookings of type "Badminton" can be made, or pilates or "Pitch hire" which is a generic booking type.

This is probably the most convoluted set of "bookable area" relationships that we have modelled, but it was up to the provider to decide what could be done on each bookable area. The end user though would have been looking to book an activity type largely - ie, they would be looking to book to play Badminton. Unless they were not, of course... In which case they may just have been looking to book an indoor court area on which to play Indoor Softball for example (which is not popular enough to warrant it being a specific booking type in the system) - in which case it would have been the fact that it was "indoor" that was important, and probably the surface too (ie, you couldn't play indoor softball on the sand beach volleyball court that this arena also had down the other end of the warehouse).

So not sure if that helps, but essentially I think both the booking type and the properties of the bookable area would be things that could drive a customer's decision as to whether they wanted to book. Meaning splitting the activities, the setting (indoor/outdoor) and the surface properties (which again there might be multiple of, so should allow a list so as to avoid combinatorial explosion - eg "Wood floor", "Spring loaded" etc - even the colour might be useful to someone looking to book the area for a photo shoot or a music video, though I appreciate that's not exactly sport based, but none the less the sort of thing people might want to be booking for.)

@jamiefoale
Copy link

A few examples of how it works for us:

Bookteq
We have a Space and a Facility. A Space is just an entity that encapsulates one or more Facilities. A Facility has the following properties:

  • Activity
  • Surface
  • Amenities
  • Pricing
    You can select facilities which overlap but not all facilities overlap which each other. So a sports hall can have 1 indoor basketball court, and 2 tennis or netball courts, and different pricing is applied to tennis or netball.

Playfinder
We follow a simple format of Venue > Sport > Format > Surface. So you can see all 11 a side football pitches at a venue, whether grass, astroturf etc. It is up to us with our Playfinder hat to decide whether a full sized pitch can be used for football, rugby, hockey, quidditch etc, and usually done in conversation with the venue operator.

We dont mind this element of curation, full automation is a great end goal but perhaps there are challenges to meet first.

@tommarley148
Copy link

We are considering from both the perspective of the operator and the end user.

How it currently works within our system for operators.

  1. Create 'venue' - this is the location in which the facility is.
  2. Select sport - we have a list of popular sports to choose from (short list)
  3. Add facilities - you add facilities per sport (e.g 2 football pitches, 4 tennis courts)
  4. Properties of facility - surface type, price, name etc.

How it works for end users

  1. Select venue (if multiple)
  2. Select sport
  3. View availability
  4. Book

The issue we need to address is multiple use spaces and non sports facilities (i.e classrooms for schools).

@nickevansuk
Copy link
Contributor

Some screenshots for the call today:

Screenshot 2021-06-02 at 14 07 22
Screenshot 2021-06-02 at 14 07 18

@nickevansuk
Copy link
Contributor

nickevansuk commented Jun 3, 2021

Summarising conclusions from the W3C call on 2021-06-02:

  • Facility type controlled vocab should be a shallow hierarchical list ("Basketball Court" -> "Basketball Half Court"), to ensure flexibility. This also allows the data user to more easily reason about the terms.
  • Surface type is presented to the user as a separate field, managed by beta:isSurface flags on the same underlying list
  • facilityType is required for FacilityUse, and activity is deprecated on FacilityUse
  • Facility type list includes a mapping to activities, which can optionally used by data consumers

Next steps:

  • Curate the facility type list based on the existing lists
  • Ensure facilityType is included in the next modelling spec point release, and proceed on the basis that this will be so

Potentially unanswered questions (to answer once list is fully curated, and potentially to be explored during curation):

  • Should the "surface type" field actually be more generic, e.g. a facilityAttribute property. This would allow it to include "sprung floors", "ballet bars", "mirrors" (for dance use cases) as well as "concrete", "3G Astroturf", etc.
  • Should the facilityAttribute have its own list separate from facilityType?
  • Should we have a mechanism for discouraging sellers from using generic terms (e.g. we encourage them to tag the FacilityUse with the Offer of £50 with "Basketball Full Court" and to tag the FacilityUse with the Offer of £25 with "Basketball Half Court", instead of just tagging both as "Basketball Court". This could be a "beta:isGenericTerm" tag on the list, which booking systems could use to force selection of a more specific term? "beta:isGenericTerm" could also be useful for search use cases when wanting to only display "Football Pitch" rather than the specific formats available.

@nickevansuk
Copy link
Contributor

nickevansuk commented Dec 7, 2021

Note the facilityType property has been added to tooling and documentation ahead of inclusion in the next point release of the OpenActive Modelling Opportunity Data specification, as agreed on the W3C call 2021-06-02 above. Currently either facilityType or activity are required, for backwards compatibility.

@nickevansuk
Copy link
Contributor

nickevansuk commented Dec 7, 2021

Below are the lists that were referenced on the call above, useful for informing the FacilityType list with relevant entries:

From Played
  • Athletics Track
  • Badminton
  • Basketball
  • Cricket
  • Cricket Nets
  • Football
  • Futsal
  • Golf
  • Hockey
  • Netball
  • Padel Tennis
  • Pickleball
  • Racquetball
  • Rugby
  • Squash
  • Table Tennis
  • Tennis
  • Volleyball
From Playfinder
  • Dance Studio
  • Drama Studio
  • Function Room
  • Spin Studio
  • Classroom
  • Badminton
  • Kitchen
  • School Hall
  • Music Suite
  • Multi Purpose Room
  • Bar
From imin
  • Football Pitch
  • Rugby Pitch
  • Cricket Pitch
  • Athletics Track
  • Multi Use Games Area
  • Tennis Court
  • Track
  • Basketball Court
  • Golf Course
  • Bowling Green
  • Baseball Field

Combining these shows the merits of a Facility Type list (and how this differs from the activity list), and the result has a large degree of overlap with the Active Places list above:

Example Facility Type list
  • Athletics Track
  • Badminton Court
  • Bar
  • Baseball Field
  • Basketball Court
  • Bowling Green
  • Classroom
  • Cricket Net
  • Cricket Pitch
  • Dance Studio
  • Drama Studio
  • Driving Range
  • Football Pitch
  • Function Room
  • Futsal Court
  • Golf Course
  • Gymnasium
  • Hockey Pitch
  • Kitchen
  • Multi Purpose Room
  • Multi Use Games Area
  • Music Suite
  • Netball Court
  • Padel Tennis Court
  • Pickleball Court
  • Racquetball Court
  • Rugby Pitch
  • School Hall
  • Spin Studio
  • Squash Court
  • Table Tennis Table
  • Tennis Court
  • Track
  • Volleyball Court

This indicates that taking another look at the Active Places list and original Facility Type MVP, and this time focussing on deriving a "Facility Type" list rather than a "Surface" list, should yield the result we are looking for.

@tommarley148
Copy link

tommarley148 commented Dec 8, 2021 via email

@nickevansuk
Copy link
Contributor

nickevansuk commented Jun 13, 2022

Should the "surface type" field actually be more generic, e.g. a facilityAttribute property. This would allow it to include "sprung floors", "ballet bars", "mirrors" (for dance use cases) as well as "concrete", "3G Astroturf", etc.
Should the facilityAttribute have its own list separate from facilityType?

Following the last calls on the subject, and to aid this discussion and current implementers (including #3), beta:facilityAttribute has now been added to the beta namespace, and a separate list created at https://openactive.io/facility-attribute-list/.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

10 participants