# HuntGrid Backcountry's OpenStreetMap portages, whitewater and fire pits (docs/backcountry/PLAN.md B2.2a, Appendix C.5):
# Planetiler custom schema run by tools/geodata/backcountry-osm/build. Layers `portages`, `water` and `camp`; Planetiler's
# YAML schemas don't read route relations, so the `routes` layer (canoe and hiking route relations) is built by
# backcountry-osm/routes (GDAL's OSM driver + tippecanoe) and joined into the same file. ODbL: its own tileset, never
# joined with official data in tiles, tables or offline packs. Only what outdoor-osm (paths, springs, shelters, huts)
# and offroad-osm (camp sites and pitches, drinking water, toilets, trailheads) don't already carry:
# test_backcountry_osm.py checks the rules, the tags kept and that no rule repeats theirs.
schema_name: HuntGrid Backcountry OSM
schema_description: OpenStreetMap portages, canoe and hiking routes, rapids and fire pits (unofficial)
attribution: <a href="https://www.openstreetmap.org/copyright" target="_blank">&copy; OpenStreetMap contributors</a>
args:
  area:
    description: Geofabrik area to download (or "planet")
    default: minnesota
  osm_url:
    description: OSM URL to download
    default: '${ args.area == "planet" ? "aws:latest" : ("geofabrik:" + args.area) }'
sources:
  osm:
    type: osm
    url: '${ args.osm_url }'
definitions:
  portage: &portage {portage: ['yes', designated], canoe: portage}
  portage_attributes: &portage_attributes
  - key: name
  - key: ref
  - key: sac_scale
  - key: trail_visibility
  - key: surface
  - key: access
  water_attributes: &water_attributes
  - key: waterway
  - key: whitewater
  - key: 'whitewater:rapid_grade'
  - key: 'whitewater:section_grade'
  - key: name
  camp_attributes: &camp_attributes
  - key: kind
    value: firepit
  - key: name
  - key: access
layers:
# A portage is a way (C.5's rule: portage=yes|designated or canoe=portage); a portage mapped only as a node is a
# put-in or a sign, not a line to carry along.
- id: portages
  features:
  - source: osm
    geometry: line
    min_zoom: 10
    include_when: *portage
    attributes: *portage_attributes
- id: water
  features:
  - source: osm
    geometry: point
    min_zoom: 11
    include_when: {waterway: [rapids, waterfall], whitewater: __any__}
    attributes: *water_attributes
  - source: osm
    geometry: polygon_point_on_surface
    min_zoom: 11
    include_when: {waterway: [rapids, waterfall], whitewater: __any__}
    attributes: *water_attributes
  # Whitewater sections are open ways along a river (whitewater=section with its grade).
  - source: osm
    geometry: line
    min_zoom: 11
    include_when: {whitewater: __any__}
    attributes: *water_attributes
- id: camp
  features:
  - source: osm
    geometry: point
    min_zoom: 13
    include_when: {leisure: firepit}
    attributes: *camp_attributes
  - source: osm
    geometry: polygon_point_on_surface
    min_zoom: 13
    include_when: {leisure: firepit}
    attributes: *camp_attributes