GeoCourse registry
The registry lists the names GeoCourse files use, so names never collide (spec 7). Each list is a JSON file, published at https://geocourse.org/registry/<file>.
| File | Lists |
|---|---|
range-types.json |
Range types (spec 5) |
kinds.json |
kind values for structure, hazard and marker (spec 5.7 to 5.9) |
extensions.json |
Extension names and vendor prefixes (spec 7) |
attribution-licences.json |
SPDX licence ids that make attribution required (rule 14) |
Naming
- Core range types and
kindvalues are lowercase, with no prefix. Only the spec adds them. - Extension range types and
kindvalues arevendor:name, for exampleacme:checkpoint. - Extension names are
vendor_feature, for exampleacme_scenery. vendoris your organisation or project, lowercase letters and digits. The vendoracmeis reserved for examples and test files.
Request a name
- Check the lists above for your vendor prefix and name.
- Open a request at https://geocourse.org/request/ with the name, what it is (range type,
kindvalue, extension or licence), a one-paragraph description, and a link to its documentation if public. - A maintainer checks the spelling rules and collisions, and adds the entry in a pull request. The first request for a vendor prefix reserves it for the requester; later names under that prefix come from the same vendor.
The registry is dedicated to the public domain under CC0 1.0 (LICENSE).
Registering a name does not make it part of the spec. Names in the registry never change meaning and are never reused.
Range types
| Type | Spec | Since |
|---|---|---|
surface | 5.2 | 0.1 |
road | 5.3 | 0.1 |
bend | 5.4 | 0.1 |
climb | 5.5 | 0.1 |
segment | 5.6 | 0.1 |
structure | 5.7 | 0.1 |
hazard | 5.8 | 0.1 |
marker | 5.9 | 0.1 |
Kind values
| Range type | kind | OSM tags | Since |
|---|---|---|---|
structure | bridge | bridge=yes | 0.1 |
structure | tunnel | tunnel=yes | 0.1 |
structure | building_passage | tunnel=building_passage | 0.1 |
hazard | cattle_grid | barrier=cattle_grid | 0.1 |
hazard | speed_bump | traffic_calming=bump | 0.1 |
hazard | railway_crossing | railway=level_crossing | 0.1 |
hazard | ford | ford=yes | 0.1 |
hazard | gate | barrier=gate | 0.1 |
marker | start | 0.1 | |
marker | finish | 0.1 | |
marker | summit | natural=peak | 0.1 |
marker | sprint | 0.1 | |
marker | feed | 0.1 | |
marker | town | place=town, place=village | 0.1 |
marker | viewpoint | 0.1 | |
marker | sign | 0.1 | |
marker | info | 0.1 |
Extensions
None registered yet.
Reserved vendor prefixes: acme.
Attribution licences
A source under one of these licences makes attribution required (rule 14): ODbL-1.0, ODC-By-1.0, CC-BY-2.0, CC-BY-2.5, CC-BY-3.0, CC-BY-4.0, CC-BY-SA-2.0, CC-BY-SA-2.5, CC-BY-SA-3.0, CC-BY-SA-4.0, CC-BY-NC-4.0, CC-BY-NC-SA-4.0, CC-BY-ND-4.0, CC-BY-NC-ND-4.0, OGL-UK-3.0, OGL-Canada-2.0, DL-DE-BY-2.0, etalab-2.0, NLOD-2.0.
No attribution needed: CC0-1.0, PDDL-1.0. Any other licence id is reported as a warning.