@trailstash/ultra/docs/url-parameters.md

A web based tool for making MapLibre GL maps with data from sources such as Overpass, GeoJSON, GPX, KML, TCX, etc

# URL Hash Parameters

You use the following query string parameters as a hash to instruct Ultra to set certain properties on startup (such as the query or the map location).

## `query` <small>(URL-encoded string)</small>

This sets the query to the given string.

Example: [http://overpass-ultra.us/#query=node%5B%22amenity%22%3D%22drinking_water%22%5D(%7B%7Bbbox%7D%7D)%3B%0Aout%3B](<http://overpass-ultra.us/#query=node%5B%22amenity%22%3D%22drinking_water%22%5D(%7B%7Bbbox%7D%7D)%3B%0Aout%3B>)

### Loading Gists

You can load a query from a Gist by using a string prefixed with `gist:`

Example: [http://overpass-ultra.us/#query=gist:8ecb8ba0a0136f4f0dbc36de82061de4](http://overpass-ultra.us/#query=gist:8ecb8ba0a0136f4f0dbc36de82061de4)

### Loading URLs

You can load a query from any url by using a string prefixed with `url:`

Example: [http://overpass-ultra.us/#query=url:https%3A%2F%2Fraw.githubusercontent.com%2FMapRVA%2Fmaprva.org%2F76eb1cd1bc8c022399f578e38f89917b98c97056%2F_ultra-maps%2Fsurveillance.ultra](http://overpass-ultra.us/#query=https%3A%2F%2Fraw.githubusercontent.com%2FMapRVA%2Fmaprva.org%2F76eb1cd1bc8c022399f578e38f89917b98c97056%2F_ultra-maps%2Fsurveillance.ultra)

## `q` <small>(lz-string-compressed string)</small>

This sets the query to the given Base64-encoded lz-string string.

Example: [http://overpass-ultra.us/#q=NoIxHsA8C4G9bFAvkgugbgFAHcCGBPYACwEsBzIvfAXgAdcAXIjTcAVwYAIyBTcAW3RA](http://overpass-ultra.us/#q=NoIxHsA8C4G9bFAvkgugbgFAHcCGBPYACwEsBzIvfAXgAdcAXIjTcAVwYAIyBTcAW3RA)

## `m` <small>(z/x/y viewport)</small>

Sets the map center coordinates and zoom level.

Example: [http://overpass-ultra.us/#m=14.64/-33.8842/151.2077](http://overpass-ultra.us/#m=14.64/-33.8842/151.2077)

## `run`

Runs the query immediately after startup.

Example: [http://overpass-ultra.us/#run&query=node%5B%22amenity%22%3D%22drinking_water%22%5D(%7B%7Bbbox%7D%7D)%3B%0Aout%3B&m=14.64/-33.8842/151.2077](<http://overpass-ultra.us/#run&query=node%5B%22amenity%22%3D%22drinking_water%22%5D(%7B%7Bbbox%7D%7D)%3B%0Aout%3B&m=14.64/-33.8842/151.2077>)

## `map`

Runs the query as a customizable interactive map.

Example: [http://overpass-ultra.us/#map&query=node%5B%22amenity%22%3D%22drinking_water%22%5D(%7B%7Bbbox%7D%7D)%3B%0Aout%3B&m=14.64/-33.8842/151.2077 ](<http://overpass-ultra.us/#map&query=node%5B%22amenity%22%3D%22drinking_water%22%5D(%7B%7Bbbox%7D%7D)%3B%0Aout%3B&m=14.64/-33.8842/151.2077>)