Allow deep links into Android and iOS apps from Events

[nickevansuk]

Proposer

imin / mapping to Google Reserve

Use Case

Allow deep links into Android and iOS apps from Events and FacilityUses.

Why is this not covered by existing properties?

url on both Event/FacilityUse and Offer only covers web links.

Proposal

Based on schema.org actions. Allow for potentialAction to be specified on Event/FacilityUse and Offer to allow Android and iOS platform actions to be included: for example actions that would require an app to be download from the App Store.

For example asking the user to download the "Playwaze" app to book.

Example

{
  "@context": "https://openactive.io/",
  "type": "Event",
  "name": "Tai chi Class",
  "url": "http://www.playwaze.org/r/6/92204",
  "startDate": "2017-03-22T20:00:00Z",
  "activity": [
    {
      "type": "Concept",
      "id": "https://openactive.io/activity-list#72ddb2dc-7d75-424e-880a-d90eabe91381",
      "inScheme": "https://openactive.io/activity-list",
      "prefLabel": "Running"
    }
  ],
  "organizer": {
    "type": "Organization",
    "name": "ExampleCo Gym"
  },
  "potentialAction": {
    "@type": "ViewAction",
    "target": [
      /* Web URL */
      "http://www.playwaze.com/r/6/92204",
      /* Android */
      "android-app://com.playwaze/http/www.playwaze.com/r/6/92204",
      /* iOS */
      {
        "@type": "EntryPoint",
        "urlTemplate": "playwaze://r/6/92204",
        "application": {
          "@type": "SoftwareApplication",
          "@id": "284708449",
          "name": "Playwaze iPhone and iPad App",
          "operatingSystem": "iOS"
        }
      }
    ]
  },
  "location": {
    "type": "Place",
    "name": "ExampleCo Gym Kingswood",
    "address": {
      "type": "PostalAddress",
      "streetAddress": "1 High Street",
      "addressLocality": "Kingswood",
      "addressRegion": "South Gloucestershire",
      "postalCode": "BS1 4SD",
      "addressCountry": "GB"
    }
  }
}