Open Trail System Specification

Read Working Draft Get Sample Data

trail_segments.geojson

Required

Name Type Req'd? Summary Values
id string yes A unique identifier assigned by the data producer. The “Named Trails” described in named_trails.csv are constructed with arrays of trail segments, identified via this field. n/a
steward_id string yes id of agency or organization responsible for trail maintenance, regulation, and safety. These values are defined in stewards.csv n/a
motor_vehicles string-encoded boolean A judgement as to the appropriate use of OHV, ATVs, and snowmobiles on this trail segment. "yes" or "no"
foot string-encoded boolean Indicates whether walking and hiking is an appropriate use of this trail segment. "yes" or "no"
bicycle string-encoded boolean Indicates whether general bicycling is an appropriate use of this trail segment. "yes" or "no"
horse string-encoded boolean Indicates whether horseback riding or equestrian travel is an appropriate use of this trail segment. "yes" or "no"
ski string-encoded boolean Indicates whether over-land or cross-country skiing is an appropriate use of this trail segment. "yes" or "no"
wheelchair string-encoded boolean Indicates whether this trail segment is considered wheelchair accessible. This field is derived from OpenStreetMap conventions. Other attributes that describe accessibility can be included in the 'osmTags" field. "yes", "no", "permissive", "designated"
osm_tags string-encoded array This field is designed to incorporate a fungible number of key-value pairs to further describe features. OpenTrails recommends using pre-defined sets of OpenStreetMap tags for this purpose, defined in the appdenices. n/a
Example
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "id": "01",
        "steward_id": "1",
        "name": "",
        "motor_vehicles": "no",
        "foot": "yes",
        "bicycle": "no",
        "horse": "no",
        "ski": "no",
        "wheelchair": "no",
        "osm_tags": "surface=gravel; width=5"
      },
      "geometry": {
        "type": "LineString",
        "coordinates": [
          [
            -105.26275634765625,
            43.24320200099953
          ],
          [
            -105.71319580078125,
            43.42100882994726
          ],
          [
            -105.71319580078125,
            43.44100882994726
          ],
          [
            -105.68319580078125,
            43.44100882994726
          ]
        ]
      }
    },
  ]
}

named_trails.csv

Required

Name Type Req'd? Summary Values
name string yes The publicly advertised name of the trail, as shown on materials oriented towards visitors.
segment_ids a string-encoded, semi-colon delimited array of “id” values from trail_segments.geojson yes An array of ids corresponding to those segments from which the Named Trail is composed. This field is required, but may have a null value.
id string yes A unique identifier assigned by the data producer.
description string yes This is the primary field for narrative descriptions of a Named Trail, and the experience or features a visitor might expect to encounter.
part_of string-encoded array

This field allows for data contributors to indicate a relationship between Named Trails.

The primary anticipated use case is to indicate that a trail serves a leg in a larger trail system or regional trail, which is present in the named_trails.csv file, but which cannot be completely described (because it is beyond the scope of the data producer)--and therefore is included without any segment_ids.

Thus, this is an array of named_trail “id” values. This is really for description purposes, rather than display purposes.

Example
				      
				        
name description segment_ids part_of id
Oak Trail One of tde park district's most demanding hikes; forms a sort of figure eight with Spring Hollow Trail. Travels through ravines and over streams. 01;02 11
Elm Trail 011;09;08 92
Magnolia Trail This unpaved loop trail is mostly wooded, featuring stands of grey-barked beech trees and a ravine of hemlocks. It twice crosses the tributary of the Cuyahoga River for which the trail is named. The length and moderate hills make this a good choice for intermediate-level cross-country skiers and runners. Watch for birds that prefer mature forests. 08;07;04;05 833

trailheads.geojson

Required

Name Type Req'd? Summary Values
name string yes The public name of the trailhead, as advertised to visitors.
id string yes A unique identifier assigned by the data producer.
trail_ids string yes A collection of IDs for Named Trails (match to "id" in named_trails.csv), each representing a trail that can be accessed via this trailhead.
steward_ids string-encoded array yes A collection of IDs for Stewards (match to "id" stewards.csv), representing each agency or organization responsive to visitor concerns or inquiries about this trailhead.
address string The street address, if one exists, that is associated with this trialhead.
parking string-encoded boolean An indication as to whether visitors can expect to find automobile park at or immediately adjacent to this trailhead. "yes" or "no"
drinkwater string-encoded boolean An indication as to whether visitors can expect to find drinking water available at or immediately adjacent to this trailhead. "yes" or "no"
restrooms string-encoded boolean An indication as to whether visitors can expect to find restrooms at or immediately adjacent to this trailhead. "yes" or "no"
kiosk string-encoded boolean An indication as to whether visitors can expect to find an information kiosk available at or immeidatley adjacent to this trailhead "yes" or "no"
osm_tags string-encoded array This field is designed to incorporate a fungible number of key-value pairs to further describe features. OpenTrails recommends using pre-defined sets of OpenStreetMap tags for this purpose, defined in the appdenices.
Example
{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "properties": {
        "name": "Soutwest Trailhead",
        "id": "32"
        "trail_ids": "1; 2"
        "steward_id": "2",
        "address": "",
        "parking": "yes",
        "drinkwater": "yes",
        "restrooms": "yes",
        "kiosk": "no",
        "osm_tags":"natural=stone; natural=tree"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -105.91644287109374,
          43.35364335728179
        ]
      }
    },
    {
      "type": "Feature",
      "properties": {
        "name": "West Side Trailhead",
        "id": "33"
        "trail_ids": "2"
        "steward_id": "2",
        "address": "",
        "parking": "yes",
        "drinkwater": "yes",
        "restrooms": "yes",
        "kiosk": "no",
        "osmTags":"natural=stone; natural=tree"
      },
      "geometry": {
        "type": "Point",
        "coordinates": [
          -105.91506958007812,
          43.47036259175014
        ]
      }
    },
  ]
}

stewards.csv

Required

Name Type Req'd? Summary Values
name string yes Name of agency or organization responsible for trail maintenance, regulation, and safety.
id string yes A unique ID for this land steward organization.
url string yes HTTP link to information about the steward organization.
phone string yes Phone number that can be provided to the visiting public, so they may solicit assistance and report problems.
address string yes The primary street address at which visitors can find assistance from park staff in person. A mailing address, or some geocodable-address, is preferred.
publisher string yes Boolean-encoded string identifying whether the steward is the publisher of the data.
license string yes An HTTP link to information about the license and appropriate use of data associated with this steward.
Example
				      
				        
name url phone address publisher license id
Local Park Agency http://localparks.gov 555-555-555 123 Main St http://localparks.gov/license 1
State Park Agency http://stateparks.gov 555-555-555 213 Main St http://stateparks.gov/license 2
National Park Agency http://nationalparks.gov 555-555-555 321 Main St yes http://nationalparks.gov/license 3

areas.geojson

Optional

Name Type Req'd? Summary Values
name string yes The publicly-advertised name of the individual park or preserve described, if one exists.
id string yes A unique ID for this land area, which can be referenced by data consumers.
steward_id string yes The id of the primary steward responsible for fielding public inquiries about this area, as defined in stewards.csv
url string HTTP link to information specifically about this land area.
osm_tags string-encoded array This field is designed to incorporate a fungible number of key-value pairs to further describe features. OpenTrails recommends using pre-defined sets of OpenStreetMap tags for this purpose, defined in the appdenices.
Example
{
  "type": "FeatureCollection",
  "features": 
  [
    {
      "type": "Feature",
      "properties": {
        "name": "Local Park",
        "id": "1",
        "steward_id": "1",
        "url": "",
        "osm_tags": "landuse=forest; boundary=administrative"
      },
      "geometry": {
        "type": "Polygon",
        "coordinates": [
          [
            [
              -104.90432739257812,
              43.21518500735673
            ],
            [
              -105.39871215820312,
              43.41103348412606
            ],
            [
              -105.26275634765625,
              43.24020079624684
            ],
            [
              -104.90432739257812,
              43.21518500735673
            ]
          ]
        ]
      }
    }
  ]
}