@trailstash/ultra
Version:
A web based tool for making MapLibre GL maps with data from sources such as Overpass, GeoJSON, GPX, KML, TCX, etc
138 lines (88 loc) • 5.07 kB
Markdown
# Mapping Resources
## Query Data
There are many sources of query data for use with Ultra.
### OpenStreetMap
Ultra was initially made to visualize OSM data via [Overpass](#overpass) queries. OSM continues to
be an excellent source of data for Ultra, and can be consumed in more ways than one.
#### Overpass
[OverpassQL](https://wiki.openstreetmap.org/wiki/Overpass_API/Overpass_QL) or [Overpass
XML](https://wiki.openstreetmap.org/wiki/Overpass_API/Language_Guide) queries are supported by the
[`overpass` query provider](./yaml.md#overpass).
#### Ohsome
The [ohsome API](https://api.ohsome.org) can be used via the [`ohsome` query
provider](./yaml.md#ohsome) to loader quanties of OSM data with a simpler [filtering
syntax](https://docs.ohsome.org/ohsome-api/v1/filter.html) than Overpass.
#### Bunting Labs
Using [separate N/S/E/W bbox
placeholders](./query-shortcuts.md#other-formats), the [`geojson`
provider](./yaml.md#geojson) can load data from the [Bunting Labs
API](https://buntinglabs.com/solutions/openstreetmap-extracts)
#### OSM API
The [`osmxml`](./yaml.md#osmxml) and [`osmjson`](./yaml.md#osmjson) providers can load data
directly from the [OSM API](https://wiki.openstreetmap.org/wiki/API_v0.6).
#### Tiles
There are a variety of providers of tiled OSM data.
##### OpenStreetMap US Tileserver
Née the [OSM Americana](https://americanamap.org/) Community Vector Tile Server, [OSM
US](https://openstreetmap.us) hosts [OpenMapTiles](https://openmaptiles.org) on
[tile.ourmap.us](https://tile.ourmap.us). For usage, see their
[policy](https://tile.ourmap.us/usage.html).
### Google My Maps
The [`kml` provider](./yaml.md#kml) can directly load Google My Maps URLs.
### Natural Earth
[Natural Earth Data](https://www.naturalearthdata.com/) data is available as GeoJSON from the
[geojson.xyz CDN](https://geojson.xyz)
### US Census Bureau
State boundaries from the [US Census Bureau](https://www.census.gov/geographies/mapping-files/time-series/geo/carto-boundary-file.html)
data is available as GeoJSON from [github.com/glynnbird/usstatesgeojson](https://github.com/glynnbird/usstatesgeojson)
### Wilderness.net
[Wilderness.net](https://wilderness.net) provides GIS data for Wildernes Areas in the USA. The data
files need to be downloaded, converted to tiles or GeoJSON, and hosted before using them with Ultra
* [Downloads Page](https://wilderness.net/visit-wilderness/gis-gps.php)
* [Shapefile](https://www.wilderness.net/GIS/Wilderness_Areas.zip)
* [state KMZs](https://wilderness.net/visit-wilderness/google-earth.php)
### All The Places
[All The Places](https://alltheplaces.xyz) provides GeoJSON files for a many retail establishments,
scraped from their websites.
ATP doesn't serve the files with [CORS
headers](https://developer.mozilla.org/en-US/docs/Glossary/CORS), so you must re-host them with the
appropriate headers yourself.
### Overture Maps
The [Overture foundation](https://overturemaps.org/) makes map data derived from various sources
available. It needs to be processed and hosted before use with Ultra.
### Esri
mappingsupport.com maintains an excellent list of ArcGIS REST servers:
https://mappingsupport.com/p/surf_gis/list-federal-state-county-city-GIS-servers.pdf
## Base Style resources
### Protomaps API
The [Protomaps API](https://protomaps.com/api) is free for non-commercial use.
### TrailStash Style Server
Most of the styles made available in the **Style Picker** menu on
[overpass-ultra.us](https://overpass-ultra.us) are hosted on
[styles.trailsta.sh](https://styles.trailsta.sh).
#### OpenMapTiles Styles
Most of the [OpenMapTiles Styles](https://openmaptiles.org/styles/) are available, with fonts and
sprites hosted along-side the style, and tiles hosted by [OpenFreeMap](#openfreemap).
#### Protomaps
The light, dark, white, grey, black variants and the community "contrast" varaint of the Protomaps
styles are available, with fonts and sprites hosted by the [protomaps basemaps assets
repo](https://github.com/protomaps/basemaps-assets) and tiles hosted by the [Protomaps
API](https://protomaps.com)
#### Esri Satellite
A style using [Esri World
Imagery](https://www.arcgis.com/home/item.html?id=10df2279f9684e4a9f6a7f08febac2a9) is available.
### Natural Earth
The [TrailStash fork](https://trailstash.github.io/naturalearthtiles/) of [Lukas Martinelli's
Natural Earth Tiles](https://github.com/lukasmartinelli/naturalearthtiles) includes a MapLibre
vector style.
### Versatiles
[Versatiles](https://versatiles.org/intro.html) provides a few styles based on the [Shortbread
Schema](https://shortbread-tiles.org/), free for use anywhere.
### OpenFreeMap
[OpenFreeMap](https://openfreemap.org/quick_start/) provides a few styles based on the [OpenMapTile
schema](https://openmaptiles.org/schema/) free for use
anywhere.
### Commercial Providers
Any MapLibre style provider can be used with Ultra. See [Awesome
MapLibre](https://github.com/maplibre/awesome-maplibre?tab=readme-ov-file#maptile-providers) for a
more comprehensive list of MapLibre style providers.