Skip to content

Commit

Permalink
crossing: Add readme for crossing presets and fields
Browse files Browse the repository at this point in the history
  • Loading branch information
tordans committed Apr 25, 2024
1 parent 92f33b5 commit a5af304
Showing 1 changed file with 25 additions and 0 deletions.
25 changes: 25 additions & 0 deletions data/presets/highway/crossing/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,25 @@
# About the crossing presets

Check failure on line 1 in data/presets/highway/crossing/README.md

View workflow job for this annotation

GitHub Actions / Check file endings

File data/presets/highway/crossing/README.md is not a .json file.

## General

These presets use fields `@templates` to make sure all have a similar structure.
Some presets like `traffic_signals` have additinal fields and use a different field order.

Check failure on line 6 in data/presets/highway/crossing/README.md

View workflow job for this annotation

GitHub Actions / Check for spelling errors

additinal ==> additional
Try to keep the file structure very similar so they can be easily compared.

## nodes `highway=crossing + crossing=*`

Crossing nodes are handel by `highway/crossing.json` + `highway/crossing/*.json` (as geometry type `vertex`).

Check failure on line 11 in data/presets/highway/crossing/README.md

View workflow job for this annotation

GitHub Actions / Check for spelling errors

handel ==> handle

Crossing nodes and crossing ways have a big overlap.
However, there are a few tags that should _only_ be expected on the crossing node. When crossing ways are present, this also means there are separate ways attached with additional nodes that hald the

Check failure on line 14 in data/presets/highway/crossing/README.md

View workflow job for this annotation

GitHub Actions / Check for spelling errors

hald ==> held, hold, half, hall

There are places in OSM that follow a different tagging style where only crossing ways are used (without the vertex nodes). Those regions might have other conventions on where to place

## ways `highway=footway|cycleway|path + *=crossing + crossing=*`

Crossing way presets are duplicated per highway class:
- `/highway/footway/crossing.json` + `/highway/footway/crossing/*.json`
- `/highway/cycleway/crossing.json` + `/highway/cycleway/crossing/*.json`
- `/highway/path/crossing.json` + `/highway/path/crossing/*.json`

The crossing presets for `/cycleway*` and `/path*` are considered to be relevant for bike traffic and have additional fields that target bike vs. foot traffic.

0 comments on commit a5af304

Please sign in to comment.