Add eventAttendanceMode to Event

[thill-odi]

Proposer

@nickevansuk (ODI/imin) with contributions from @thill-odi (ODI)

Use Case

An Opportunity provider is providing new means of accessing led classes online, as well as or instead of at a physical location.

This proposal obviously has increased salience in light of COVID-19 isolation measures.

Why is this not covered by existing properties?

The existing data model deals only with physical locations, not those available via online technologies.

Please provide a link to example data

See e.g. https://www.cococollective.co.uk/booking/ for a yoga studio that has recently moved to online events to replace physical ones.

Proposal

The schema.org property eventAttendanceMode should be added to all Opportunity types, with the exception of Slot, FacilityUse, and IndividualFacilityUse. Its purpose is to indicate whether participation is in a physical location only, online, or both, and it takes the following values:

• MixedEventAttendanceMode
• OfflineEventAttendanceMode
• OnlineEventAttendanceMode

It is assumed that eventAttendanceMode is fully heritable, so that values defined on parent objects (e.g. EventSeries, SessionSeries) are applicable to child objects (e.g. Event, ScheduledSession). Where this value is defined on a child object, however, the value defined at this lower level takes precedence over any defined higher up the chain.

[thill-odi]

See also #224, #226, #227.

[thill-odi]

Semantics rules (from @nickevansuk) ...

When:

• eventAttendanceMode is set to https://schema.org/OnlineEventAttendanceMode, virtualLocation MUST be present and location MAY be present, however data users MUST NOT advertise the location as a means of participation.
• eventAttendanceMode is set to https://schema.org/MixedEventAttendanceMode. virtualLocation MUST be present and location MUST be present.
• eventAttendanceMode is set to https://schema.org/OfflineEventAttendanceMode. virtualLocation MUST NOT be present and location MUST be present.

[nishaldesai]

To add to this, location information in all cases is very useful for local authorities and others wanting to support local businesses. i.e. if Westminster is going out to local businesses to get them to go virtual so that Active Westminster can support them, they should have a way for Westminster as a data user, or users as part of the UX, to filter for "local" only

[nickevansuk]

Is virtualLocation actually "MUST" - as some events will simply not include this detail (e.g. if the virtual location is behind a paywall)?

Perhaps it should be RECOMMENDED instead?

See https://docs.google.com/spreadsheets/d/1xENpJfK77neNlltsUre7kvjJBibowIDv1xFUBjpSYNU/edit#gid=0

[nickevansuk]

We also need to add guidance for location for OnlineEventAttendanceMode, that this is the original location of the class so not the house they’re in when they're under lockdown, but the studio they’re usually in, to help people find stuff that's "near to them" at least virtually

[nickevansuk]

Additionally should we relax constraints on PostalAddress for OnlineEventAttendanceMode, in case activity providers just want to give a rough location and not an exact one (e.g. postcode only).

This is something that has been discussed more generally in previous W3C calls to help outdoor providers too.

[nickevansuk]

As @lukehesluke has pointed out, perhaps there are two separate but often related semantic objectives that are being discussed?

• Original location: Where this studio was located before it went virtual
• Affiliated Locality: For a studio which was perhaps never physical. "I'm in Westminster borough". So it can be picked up by Active Westminster

Suggest location for OnlineEventAttendanceMode covers both of these - and in both cases is just indicative of where the broadcast is coming from

[JoshuaLevett]

Is there an estimated date for these virtual session additions?