# 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.