distance #104

Proposer

British Cycling, Run Together, GoodGym, SportStarta, British Triathlon

Use Case

"As a potential participant of an event with a route, I want to know how long the route is - using either an exact value or approximate range"

Why is this not covered by existing properties?

Distance isn't covered in the existing model

Please provide a link to example data

• British Cycling: http://api.letsride.co.uk/public/v1/rides
• Goodgym: https://www.goodgym.org/api/happenings
• SportStarta: http://www.devapi.lewishamparklife.co.uk/api/games/get_active_single_game

Proposal

Propose using the existing schema.org https://schema.org/distance property on the Event type, but having it contain an object of type QuantitativeValue instead of a string.

The specification should also mandate that minValue, maxValue and value are all represented as number types in JSON (see this rule)

Example

From the beta work on this topic, the following looks like a good start:

// 0-5
"distance": {
  "type": "QuantitativeValue",
  "minValue": 0,
  "maxValue": 5,
  "unitCode": "KMT"
}

// 5
"distance": {
  "type": "QuantitativeValue",
  "value": 5,
  "unitCode": "KMT"
}

// 50+
"distance": {
  "type": "QuantitativeValue",
  "minValue": 50,
  "unitCode": "KMT"
}

Beta use

Use beta:distance for early implementations of this proposal.