# overpass turbo

- https://overpass-turbo.eu/ – stable version
- https://tyrasd.github.io/overpass-turbo/ – latest version

This is a GUI for testing and developing queries for the [Overpass-API](https://www.overpass-api.de/). It can also used for simple analysis of OSM data.

[![](https://upload.wikimedia.org/wikipedia/commons/thumb/0/0c/Overpass_turbo_screenshot_2022.png/1280px-Overpass_turbo_screenshot_2022.png)](https://overpass-turbo.eu)

## Getting Started

Just point your browser to [overpass-turbo.eu](https://overpass-turbo.eu) and start running your Overpass queries.

More information about _overpass turbo_ is found in the [OSM wiki](https://wiki.openstreetmap.org/wiki/Overpass_turbo).

## Translating

Translations are managed using the [Transifex](https://explore.transifex.com/overpass-turbo/overpass-turbo) platform. After signing up, you can go to [overpass-turbo's project page](https://explore.transifex.com/overpass-turbo/overpass-turbo), click _JOIN THIS PROJECT_ and pick a language to start translating.

If your language isn't currently in the list, just drop me a [mail](mailto:tyr.asd@gmail.com) or open an [issue ticket](https://github.com/tyrasd/overpass-turbo/issues/new).

To download the latest translations from Transifex, run `tx pull --all` using the [Transifex client `tx`](https://docs.transifex.com/client/introduction).

## Development

### URL parameters

_overpass turbo_ can be linked from other applications by using [URL parameters](https://wiki.openstreetmap.org/wiki/Overpass_turbo/Development#URL_Parameters).
For example, one can provide a query to load, set the initial map location, or instruct turbo to load a [template](https://wiki.openstreetmap.org/wiki/Overpass_turbo/Templates).

### geocoding

Two geocoders are used, both behind the common interface in `js/geocoding.ts`:

- [Nominatim](https://nominatim.openstreetmap.org/) resolves the `{{geocodeId}}`, `{{geocodeArea}}`, `{{geocodeBbox}}` and `{{geocodeCoords}}` shortcuts
- [osmnames](https://osmnames.org/) backs the autocompletion of the map search box, as the [Nominatim usage policy](https://operations.osmfoundation.org/policies/nominatim/) forbids autocomplete style querying

### git-branches

Development is done in the _master_ branch, stable releases are marked with git tags, the _gh-pages_ branch contains static builds of the releases.

### install & run

0. Install [pnpm](https://pnpm.io/installation), e.g. via `npm install -g pnpm`.
1. `pnpm install`
2. `pnpm dev` for a development server listening at http://localhost:5173
3. `pnpm build` for a minified build in `./dist`
4. `pnpm preview` to serve the production build locally

### test & lint

- `pnpm test` runs the [Vitest](https://vitest.dev/) test suite
- `pnpm check` runs the format, lint, and type checks (as done in CI)
- `pnpm format` formats the code in place, `pnpm lint` lints it

Formatting is applied automatically to staged files by the pre-commit hook.
Run `pnpm exec vp config` once after cloning to install it.

## See Also

- [Ultra](https://gitlab.com/trailstash/ultra) is a re-imagining of Overpass turbo powered by [MapLibre GL JS](https://wiki.openstreetmap.org/wiki/MapLibre_GL_JS) which allows for visualizing large datasets and complex styling.
- [QuickOSM](http://plugins.qgis.org/plugins/QuickOSM/) is a QGIS plugin to fetch OSM data with the Overpass API.