Documentation

Get OpenStreetMap into QGIS, without writing a query

02Agent turns an area of interest into styled QGIS layers. Pick a theme, pick an extent, download. Every screenshot below is a real capture of the plugin's dock, not a mock-up, and the place names in them were resolved by the live geocoder.

Task guides

Five short, illustrated walkthroughs. Start with the first if you have never used the plugin; the rest stand alone.

Guide 1

Your first download

Open the dock, choose a theme and its datasets, and get styled point, line and polygon layers from the current map view.

Guide 2

Download a named place

Type a place name, pick from the ranked geocoder matches, and clip the download to the real administrative boundary instead of a rectangle.

Guide 3

Cover a whole district or city

Extents larger than one polite request are split into a grid of bounded requests, downloaded in sequence and merged back into single layers.

Guide 4

Build a structured query

Combine up to four OSM tags with ANY or ALL matching, scope the geometry, and read the generated Overpass query before you run it.

Guide 5

Commands, styling and agents

Describe a request in plain English, restyle results with 16 map themes, and expose the download endpoints to SmartModeler GIS.

Reference

User & technical manual

The complete manual: query grammar, tag-matching semantics, multipolygon assembly, cache design, security model and every algorithm's parameters.

What it does at a glance

Capability	Detail
Curated presets	30 presets across 15 thematic groups — networks, buildings, land use, green and blue, transit, healthcare, education, heritage and more. Several can run as one request.
Place search	OpenStreetMap Nominatim geocoding with ranked matches; a mapped boundary can be used as the download area itself.
Wide extents	Up to 100 km² in one request, and up to 2,500 km² by splitting into at most 40 bounded requests that are merged automatically.
Structured queries	Up to four validated key/value tag filters, ANY or ALL matching, geometry scope, and a read-only preview of the generated query.
Cartography	16 persistent map styles with native categorized QGIS renderers, plus OSM-highway-aware road widths and a one-click OSM basemap.
Automation	Four stable QGIS Processing algorithms, discoverable by SmartModeler GIS under Agent Protocol v1 with explicit user approval.

Requirements QGIS 3.28 or newer, including QGIS 4. No pip packages, no API keys, no configuration files. Install from the QGIS Plugin Hub and open the dock from the 02Agent toolbar button.