overpass-turbo

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. It can also used for simple analysis of OSM data.

Getting Started

Just point your browser to overpass-turbo.eu and start running your Overpass queries.

More information about overpass turbo is found in the OSM wiki.

Translating

Translations are managed using the Transifex platform. After signing up, you can go to overpass-turbo's project page, 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 or open an issue ticket.

To download the latest translations from Transifex, run tx pull --all using the Transifex client tx.

Development

URL parameters

overpass turbo can be linked from other applications by using URL parameters. For example, one can provide a query to load, set the initial map location, or instruct turbo to load a template.

geocoding

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

• Nominatim resolves the {{geocodeId}}, {{geocodeArea}}, {{geocodeBbox}} and {{geocodeCoords}} shortcuts
• osmnames backs the autocompletion of the map search box, as the Nominatim usage policy 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

1. Install pnpm, e.g. via npm install -g pnpm.
2. pnpm install
3. pnpm dev for a development server listening at http://localhost:5173
4. pnpm build for a minified build in ./dist
5. pnpm preview to serve the production build locally

test & lint

• pnpm test runs the Vitest 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 is a re-imagining of Overpass turbo powered by MapLibre GL JS which allows for visualizing large datasets and complex styling.
• QuickOSM is a QGIS plugin to fetch OSM data with the Overpass API.