@trailstash/ultra 3.0.0-dev

package/.gitlab-ci.yml

@@ -0,0 +1,15 @@
+pages:
+  image: node:18
+  script:
+    - apt update && apt install -y mkdocs-material
+    - npm ci
+    - npm run build -- -c ./configs/lab/index.js
+    - npm run build:examples-docs
+    - npm run build:maplibre-examples-docs
+    - npm run build:docs
+    - npm run build:pages
+  artifacts:
+    paths:
+    - public
+  only:
+  - main

package/Examples/alt-bbox-format.ultra

@@ -0,0 +1,9 @@
+---
+title: Load GeoJSON with custom BBOX format
+description: Load GeoJSON from the Bunting Labs API using the east/west/south/north shortcuts.
+type: geojson
+options:
+  center: [-122.6847, 45.5112]
+  zoom: 15
+---
+https://osm.buntinglabs.com/v1/osm/extract?bbox={{west}},{{south}},{{east}},{{north}}&tags=amenity%3Dbicycle_repair_station&api_key=4WBfyRaP9pGv

package/Examples/atp-usps-dropboxes.ultra

@@ -0,0 +1,68 @@
+---
+title: ATP USPS Dropboxes
+description: Load and style USPS Dropboxes from an [All The Places](https://alltheplaces.xyz) dump.
+type: geojson
+options:
+  center: [ -90.2027, 38.6339 ]
+  zoom: 11
+style:
+  layers:
+    - type: circle
+      minzoom: 6
+      circle-color: darkblue
+      circle-stroke-color: white
+      circle-radius: 3
+      circle-stroke-width: 2
+      circle-opacity:
+        - interpolate
+        - [linear]
+        - [zoom]
+        - 6
+        - 0
+        - 7
+        - 1
+      circle-stroke-opacity:
+        - interpolate
+        - [linear]
+        - [zoom]
+        - 6
+        - 0
+        - 7
+        - 1
+    - type: heatmap
+      maxzoom: 8
+      heatmap-weight: .01
+      heatmap-color: 
+        - interpolate
+        - [linear]
+        - [heatmap-density]
+        - 0
+        - rgba(255,255,255,0)
+        - 0.1
+        - darkblue
+        - 1
+        - white
+      heatmap-opacity:
+        - interpolate
+        - [linear]
+        - [zoom]
+        - 6
+        - 1
+        - 7
+        - 0
+    - type: symbol
+      minzoom: 10
+      icon-image: temaki:post_box
+      icon-color: darkblue
+      icon-halo-color: white
+      icon-halo-width: 3
+      icon-opacity:
+        - interpolate
+        - [linear]
+        - [zoom]
+        - 10
+        - 0
+        - 11
+        - 1
+---
+https://overpass-ultra.us/docs/assets/data/Examples/atp_usps_collection_boxes.geojson

package/Examples/bike-infra.ultra

@@ -0,0 +1,111 @@
+---
+title: Bike Infrastructure
+description: Query and style bikelanes, bike parking, repair stations, and bike shops.
+options:
+  zoom: 14
+  center: [-77.4705, 37.5686]
+style:
+  extends: https://styles.trailsta.sh/openmaptiles-osm.json
+  layers:
+    - type: line
+      beforeLayerId: road_path_oneway
+      filter:
+        - any
+        - [ ==, [ get, cycleway ], track ]
+        - [ ==, [ get, 'cycleway:right' ], track ]
+        - [ ==, [ get, 'cycleway:left' ], track ]
+      paint: &paint
+        line-width:
+          stops: [ [ 13, 2.5 ], [ 16, 4 ] ]
+        line-color: blue
+    - type: line
+      beforeLayerId: road_path_oneway
+      filter:
+        - any
+        - [ ==, [ get, cycleway ], lane ]
+        - [ ==, [ get, 'cycleway:right' ], lane ]
+        - [ ==, [ get, 'cycleway:left' ], lane ]
+      paint:
+        <<: *paint
+        line-dasharray: [ 4, 2 ]
+    - type: line
+      beforeLayerId: road_path_oneway
+      filter:
+        - any
+        - [ ==, [ get, cycleway ], shared_lane ]
+        - [ ==, [ get, 'cycleway:right' ], shared_lane ]
+        - [ ==, [ get, 'cycleway:left' ], shared_lane ]
+      paint:
+        <<: *paint
+        line-dasharray: [ 1, 2 ]
+    - type: line
+      beforeLayerId: road_path_oneway
+      filter: [ ==, [ get, highway ], cycleway ]
+      paint:
+        <<: *paint
+        line-color: darkblue
+    - type: symbol
+      filter: [ ==, [ geometry-type ], Point ]
+      icon-halo-width: 2
+      icon-halo-blur: 1
+      icon-halo-color: white
+      icon-size:
+        - case
+        - [ ==, [ get, amenity ], bicycle_repair_station ]
+        - 0.75
+        - [ ==, [ get, amenity ], bicycle_parking ]
+        - 0.5
+        - [ ==, [ get, bicycle_rental ], docking_station ]
+        - 0.75
+        - 1
+      icon-color:
+        - case
+        - [ ==, [ get, amenity ], bicycle_repair_station ]
+        - rgb(0, 146, 218)
+        - [ ==, [ get, amenity ], bicycle_parking ]
+        - rgb(0, 146, 218)
+        - [ ==, [ get, bicycle_rental ], docking_station ]
+        - rgb(0, 146, 218)
+        - [ ==, [ get, shop ], bicycle ]
+        - rgb(172, 57, 172)
+        - [ ==, [ get, amenity ], bicycle_rental ]
+        - rgb(172, 57, 172)
+        - black
+      symbol-sort-key:
+        - case
+        - [ ==, [ get, amenity ], bicycle_repair_station ]
+        - 30
+        - [ ==, [ get, amenity ], bicycle_parking ]
+        - 40
+        - [ ==, [ get, amenity ], bicycle_rental ]
+        - 10
+        - [ ==, [ get, shop ], bicycle ]
+        - 0
+        - 50
+      icon-image:
+        - case
+        - [ ==, [ get, amenity ], bicycle_repair_station ]
+        - temaki:bicycle_repair
+        - [ ==, [ get, amenity ], bicycle_parking ]
+        - temaki:bicycle_parked
+        - [ ==, [ get, amenity ], bicycle_rental ]
+        - temaki:bicycle_rental
+        - [ ==, [ get, shop ], bicycle ]
+        - maki:bicycle
+        - maki:circle
+---
+[bbox:{{bbox}}];
+(
+nwr[shop=bicycle];
+nwr[amenity=bicycle_rental];
+nwr[amenity=bicycle_repair_station];
+nwr[amenity=bicycle_parking];
+);
+out center;
+(
+way[cycleway][cycleway!=no];
+way["cycleway:right"]["cycleway:right"!=no];
+way["cycleway:left"]["cycleway:left"!=no];
+way[highway=cycleway];
+);
+out geom;

package/Examples/contribution-heatmap.ultra

@@ -0,0 +1,17 @@
+---
+title: User Contribution Heatmap
+description: Create a heatmap of your OSM mapping contributions.
+options:
+  zoom: 8.82
+  center: [-77.4762, 37.555]
+style:
+  layers:
+    - type: heatmap
+      paint:
+        heatmap-opacity: 0.5
+        heatmap-intensity: 1
+        heatmap-radius: 5
+  extends: https://styles.trailsta.sh/protomaps-black.json
+---
+nw(user_touched:"dpschep"); /* Change to your OSM username */
+out skel;

package/Examples/custom-style.ultra

@@ -0,0 +1,114 @@
+---
+title: Create a custom map style
+description: Define an entire MapLibre GL style in a query document.
+type: vector
+style:
+  version: 8
+  layers:
+    - type: background
+      background-color: white
+    - type: fill
+      source-layer: landuse
+      filter:
+        - any
+        - [==, 'pmap:kind', park]
+        - [==, 'pmap:kind', protected_area]
+        - [==, 'pmap:kind', national_park]
+        - [==, 'pmap:kind', nature_reserve]
+      fill-color: rgba(174, 210, 151, .5)
+    - type: line
+      source-layer: water
+      filter: [==, $type, LineString]
+      line-color: rgba(119, 187, 234, 1)
+    - type: fill
+      source-layer: water
+      filter: [==, $type, Polygon]
+      fill-color: rgba(119, 187, 234, 1)
+    - type: line
+      source-layer: boundaries
+      line-dasharray: [4, 4]
+      line-width: 0.5
+      line-color: rgba(39, 39, 39, 1)
+    - type: fill
+      source-layer: buildings
+      fill-color: rgba(206, 206, 206, 1)
+    - type: line
+      source-layer: transit
+      filter: [==, 'pmap:kind', rail]
+      line-color: rgba(160, 160, 160, 1)
+    - type: line
+      source-layer: transit
+      filter: [==, 'pmap:kind', rail]
+      line-color: rgba(119, 119, 119, 1)
+      line-dasharray: [4, 4]
+    - type: line
+      source-layer: highway
+      filter:
+        - any
+        - [==, type, path]
+        - [==, type, steps]
+        - [==, type, sidewalk]
+      line-color: black
+      line-width: 0.7
+      line-dasharray: [10, 3]
+    - type: line
+      source-layer: highway
+      filter:
+        - any
+        - [==, type, trail]
+        - [==, type, track]
+      line-color: black
+      line-width: 0.7
+      line-dasharray: [3, 3]
+    - type: line
+      source-layer: highway
+      filter:
+        - none
+        - [==, type, path]
+        - [==, type, trail]
+        - [==, type, steps]
+        - [==, type, cut]
+        - [==, type, sidewalk]
+        - [==, type, track]
+      line-color:
+        - case
+        - [==, type, freeway]
+        - darkgrey
+        - black
+      line-width:
+        - case
+        - [==, type, freeway]
+        - 4
+        - [==, type, highway]
+        - 3
+        - [==, type, major]
+        - 2
+        - 1
+    - type: line
+      source-layer: highway
+      filter:
+        - all
+        - [==, type, path]
+        - [==, bike, designated]
+      line-width: 4
+      line-color: rgba(11, 50, 213, 1)
+    - type: line
+      source-layer: highway
+      filter: [==, cycleway, bikelane]
+      line-color: rgba(0, 154, 18, 1)
+      line-width: 4
+    - type: line
+      source-layer: highway
+      filter: [==, cycleway, sharrows]
+      line-color: rgba(242, 134, 60, 1)
+      line-width: 4
+    - type: line
+      source-layer: highway
+      filter: [==, cycleway, cycletrack]
+      line-color: rgba(125, 24, 152, 1)
+      line-width: 4
+options:
+  zoom: 14
+  center: [-77.4723, 37.5193]
+---
+https://tiles.trailstash.net/opentrailstash.json

package/Examples/glow-effect.ultra

@@ -0,0 +1,27 @@
+---
+title: Create a glowing effect for points
+description: Stack blurred circles to create a glowing effect for point data.
+options:
+  center: [2.3336, 48.8579]
+  zoom: 11
+style:
+  layers:
+    - type: circle
+      paint:
+        circle-blur: 3
+        circle-radius: 25
+        circle-color: rgba(0, 200, 50, 0.3)
+    - type: circle
+      paint:
+        circle-blur: 3
+        circle-radius: 10
+        circle-color: rgba(0, 255, 100, 0.3)
+    - type: circle
+      paint:
+        circle-radius: 1
+        circle-color: white
+  extends: https://styles.trailsta.sh/protomaps-dark.json
+---
+[bbox:{{bbox}}];
+nwr[highway=bus_stop];
+out center;

package/Examples/index.md

@@ -0,0 +1,7 @@
+# Overview
+
+These examples highlight capabilities and differences unique to Overpass Ultra such as it's styling
+capabilities, non-OSM data capabilities, etc.
+
+For examples of how to author OverpassQL queries, please reference the abundance of documentation
+on the [OSM Wiki](https://wiki.openstreetmap.org) and elsewhere.

package/Examples/landmarks-prototype.ultra

@@ -0,0 +1,68 @@
+---
+title: Create a map of local landmarks
+description: >
+  Select specific OSM elements by their wikidata IDs to make a map of local landmarks. 
+  This was a prototype of [MapRVA](https://maprva.org)'s
+  [Open Landmarks](https://github.com/maprva/open-landmarks) project.
+options:
+  zoom: 13.03
+  center: [-77.46967, 37.55065]
+style:
+  extends: https://styles.trailsta.sh/osm-bright.json
+  layers:
+    - type: symbol
+      minzoom: 11
+      layout:
+        icon-image:
+          - case
+          - [ ==, [ get, name ], Phillip Morris ]
+          - maki:industry
+          - [ ==, [ get, wikidata ], Q5052468 ]
+          - maki:place-of-worship
+          - - any
+            - [ ==, [ get, wikidata ], Q7433575 ]
+            - [ ==, [ get, wikidata ], Q4013975 ]
+          - maki:museum
+          - [ ==, [ get, wikidata ], Q5123443 ]
+          - maki:stadium
+          - [ ==, [ get, wikidata ], Q7730070 ]
+          - maki:stadium
+          - [ ==, [ get, wikidata ], Q1700358 ]
+          - temaki:racetrack_oval
+          - [ ==, [ get, wikidata ], Q11343430 ]
+          - maki:rail
+          - [ ==, [ get, wikidata ], Q4883643 ]
+          - maki:park
+          - [ ==, [ get, wikidata ], Q2537798 ]
+          - temaki:capitol
+          - [ ==, [ get, wikidata ], Q127740146 ]
+          - maki:monument
+          - maki:circle
+        text-field: '{name}'
+        text-font: [ Open Sans Regular ]
+        text-variable-anchor: [ top ]
+        text-justify: auto
+        text-radial-offset: 1.25
+        text-size: 12
+      paint:
+        icon-color: rgb(51, 51, 51)
+        text-color: rgb(51, 51, 51)
+        icon-halo-color: white
+        icon-halo-width: 3
+        text-halo-color: white
+        text-halo-width: 2
+---
+(
+nwr[wikidata=Q5052468]; /* Cathedral of the Sacred Heart */
+nwr[wikidata=Q7433575]; /* Science Museum */
+nwr[wikidata=Q4013975]; /* VMFA */
+nwr[wikidata=Q1700358]; /* Richmond Raceway */
+nwr[wikidata=Q11343430][building=train_station]; /* Main St Station */
+nwr[wikidata=Q4883643]; /* Belle Isle */
+nwr[wikidata=Q127740146]; /* Carillon */
+way[industrial=tobacco][name="Phillip Morris"](37.461143557941966,-77.45029756083287,37.480867748310146,-77.41825168956744);
+nwr[wikidata=Q5123443]; /* City Stadium */
+nwr[wikidata=Q7730070]; /* The Diamond */
+nwr[wikidata=Q2537798]; /* Capital */
+);
+out center;

package/Examples/minimalist-ski-map.ultra

@@ -0,0 +1,55 @@
+---
+title: Minimalist Ski Map
+description: Create minimalist ski maps of your favorite ski resort.
+options:
+  zoom: 13.38
+  center: [-120.06396, 38.67543]
+  bearing: -138.4
+  pitch: 60
+style:
+  version: 8
+  sources:
+    dem:
+      type: raster-dem
+      tiles:
+        - 'https://s3.amazonaws.com/elevation-tiles-prod/terrarium/{z}/{x}/{y}.png'
+      encoding: terrarium
+      tileSize: 256
+  layers:
+    - type: background
+      background-color: white
+    - id: slopes
+      type: line
+      filter:
+        - all
+        - [==, [geometry-type], LineString]
+        - [has, piste:type]
+      line-width: 3
+      line-color:
+       - case
+       - - any 
+         - [==, [get, piste:difficulty], novice]
+         - [==, [get, piste:difficulty], easy]
+       - green
+       - [==, [get, piste:difficulty], intermediate]
+       - blue
+       - black
+    - id: lifts
+      type: line
+      filter:
+        - all
+        - [==, [geometry-type], LineString]
+        - [has, aerialway]
+      line-width: 2
+      line-color: red
+      line-dasharray: [2, 2]
+  terrain:
+    source: dem
+    exaggeration: 1
+---
+[bbox:{{bbox}}];
+(
+  way[aerialway][aerialway!=zip_line];
+  way["piste:type"=downhill];
+);
+out geom;

package/Examples/opentrailstash-3d.ultra

@@ -0,0 +1,40 @@
+---
+title: Prototype a 3D version of a style
+description: Add 3D terrain and Buildings to OpenTrailStash using AWS-hosted DEM tiles and OpenMapTiles buildings
+options:
+  hash: m
+  center: [ 11.380881, 47.312333 ]
+  zoom: 16
+  pitch: 73
+  bearing: -47.3
+  maxPitch: 85
+style:
+  extends: https://open.trailsta.sh/style.json
+  sources:
+    openmaptiles:
+      type: vector
+      url: https://tile.ourmap.us/data/v3.json
+    terrainSource:
+      type: raster-dem
+      tiles:
+        - 'https://s3.amazonaws.com/elevation-tiles-prod/terrarium/{z}/{x}/{y}.png'
+      encoding: terrarium
+      tileSize: 256
+  terrain:
+    source: terrainSource
+    exaggeration: 1
+  layers:
+    - id: poi_dot
+      visibility: none
+    - id: poi
+      visibility: none
+    - type: fill-extrusion
+      beforeLayerId: poi_dot
+      source: openmaptiles
+      source-layer: building
+      minzoom: 13
+      filter: ['!=', [get, hide_3d], true]
+      fill-extrusion-color: '#c0c9b2'
+      fill-extrusion-height: [ get, render_height ]
+      fill-extrusion-base: [ get, render_min_height ]
+---

package/Examples/overture-landcover-plus-hillshade.ultra

@@ -0,0 +1,45 @@
+---
+title: Overture Landcover with Hillshade
+description: A basic natural background consisting of only hillshade and landcover.
+type: vector
+options:
+  center: [ 11.39085, 47.27574 ]
+  zoom: 8
+style:
+  sources:
+    terrarium: {"type":"raster-dem","tiles":["https://s3.amazonaws.com/elevation-tiles-prod/terrarium/{z}/{x}/{y}.png"],"minzoom":0,"maxzoom":15,"tileSize":256,"encoding":"terrarium"}
+  version: 8
+  layers:
+    - type: background
+      background-color: lightblue
+    - type: fill
+      beforeLayerId: waterway_tunnel
+      source-layer: land_cover
+      paint:
+        fill-outline-color: rgba(0,0,0,0)
+        fill-color:
+          - case
+          - [ ==, [ get, subtype ], urban ]
+          - rgb(167, 162, 186)
+          - [ ==, [ get, subtype ], forest ]
+          - rgb(134, 178, 137)
+          - [ ==, [ get, subtype ], barren ]
+          - rgb(245, 237, 213)
+          - [ ==, [ get, subtype ], shrub ]
+          - rgb(239, 218, 182)
+          - [ ==, [ get, subtype ], grass ]
+          - rgb(254, 239, 173)
+          - [ ==, [ get, subtype ], crop ]
+          - rgb(222, 223, 154)
+          - [ ==, [ get, subtype ], wetland ]
+          - rgb(158, 207, 195)
+          - [ ==, [ get, subtype ], mangrove ]
+          - rgb(83, 171, 128)
+          - [ ==, [ get, subtype ], moss ]
+          - rgb(250, 230, 160)
+          - [ ==, [ get, subtype ], snow ]
+          - rgb(255, 255, 255)
+          - rgba(255, 255, 255, 0)
+    - {"id":"terrain-rgb-terrarium","type":"hillshade","source":"terrarium","minzoom":0,"paint":{"hillshade-shadow-color":"hsl(39, 21%, 33%)","hillshade-illumination-direction":315,"hillshade-exaggeration":0.3}}
+---
+https://tiles.trailstash.net/overture-land_cover.json

package/Examples/overture-places-and-osm.ultra

@@ -0,0 +1,29 @@
+---
+title: Combine POI from Overture and OSM
+description: Bike shops from the Overture Places dataset and OpenStreetMap combined in a single map using MapLibre symbol collision logic as a sort of run-time conflation.
+querySources: [ultra, overture]
+options:
+  zoom: 13.63
+  center: [4.89824, 52.37592]
+style:
+  sources:
+    overture:
+      type: vector
+      url: pmtiles://https://data.source.coop/protomaps/overture/2024-05-16-beta.0/places.pmtiles
+  layers:
+    - type: symbol
+      source: overture
+      source-layer: place
+      filter:
+        - all
+        - [==, [get, '@category'], bicycle_shop]
+        - ['>', [get, confidence], 0.6]
+      icon-image: maki:bicycle
+      icon-color: darkblue
+    - type: symbol
+      icon-image: maki:bicycle
+      icon-color: darkgreen
+---
+[bbox:{{bbox}}];
+nwr[shop=bicycle];
+out center;

package/Examples/trees.ultra

@@ -0,0 +1,60 @@
+---
+title: Tree Cover
+description: Create stylized tree coverage from `natural=tree` nodes and `natural=tree_row` ways.
+options:
+  zoom: 14
+  center: [-77.03717, 38.89135]
+style:
+  layers:
+    - type: circle
+      filter: [==, [geometry-type], Point]
+      beforeLayerId: landcover_subclass_patterns
+      circle-color: rgba(169, 210, 145, .5)
+      circle-blur: 1
+      circle-radius:
+        stops:
+          - [ 0, 1 ]
+          - [ 20, 300 ]
+        base: 2
+    - type: line
+      filter: [==, [geometry-type], LineString]
+      beforeLayerId: landcover_subclass_patterns
+      line-color: rgba(169, 210, 145, .5)
+      line-cap: round
+      line-blur:
+        stops:
+          - [ 0, 1 ]
+          - [ 20, 100 ]
+        base: 2
+      line-width:
+        stops:
+          - [ 0, 1 ]
+          - [ 20, 200 ]
+        base: 2
+    - type: circle
+      filter: [==, [geometry-type], Point]
+      circle-color: rgba(169, 210, 145, .5)
+      circle-blur: 1
+      circle-radius:
+        stops:
+          - [ 0, 1 ]
+          - [ 20, 300 ]
+        base: 2
+    - type: line
+      filter: [==, [geometry-type], LineString]
+      line-color: rgba(169, 210, 145, .5)
+      line-cap: round
+      line-blur:
+        stops:
+          - [ 0, 1 ]
+          - [ 20, 100 ]
+        base: 2
+      line-width:
+        stops:
+          - [ 0, 1 ]
+          - [ 20, 200 ]
+        base: 2
+  extends: https://styles.trailsta.sh/openmaptiles-osm.json
+---
+node[natural=tree]({{bbox}}); out;
+way[natural=tree_row]({{bbox}}); out geom;