Vector Data And Osm

---
name: vector-data-and-osm
description: "Routes BlenderGIS vector data and OpenStreetMap shapefile
  import/export, Overpass query preflight, elevation/extrusion fields, and OSM
  tag workflows."
disable-model-invocation: true
metadata:
  disco-role: operating
license: GPL 3.0
---

# Vector Data and OSM

Use this sub-skill when a task involves BlenderGIS vector geodata or OpenStreetMap data:

- importing ESRI Shapefile `.shp` data into a Blender scene;
- exporting selected mesh objects or collections back to Shapefile;
- importing local `.osm` XML files;
- querying Overpass for the current BlenderGIS extent;
- choosing DBF fields for elevation, extrusion, or object names;
- configuring OSM tags, Overpass servers, building extrusion, and object separation.

Do **not** use this sub-skill for raster/DEM/image basemaps, terrain mesh post-processing, or camera/render outputs. Route those to the sibling sub-skills for raster/basemaps, terrain analysis, or geocameras. If the scene CRS/origin is missing or broken, route first to `../georeferencing-and-crs/`.

## Read First

1. For end-to-end vector and OSM procedures, read `references/workflows.md`.
2. For exact operator IDs, properties, defaults, and inputs/outputs, read `references/operator-reference.md`.
3. For failures such as broken georeferencing, invalid fields, empty exports, and Overpass timeouts, read `references/troubleshooting.md`.
4. For a no-network Overpass preflight query, run or inspect `scripts/build_overpass_query.py`.

## High-Level Routes

- **Shapefile import:** use `importgis.shapefile_file_dialog` from `View3D > GIS > Import > Shapefile (.shp)` for interactive import, or `importgis.shapefile` for scripted execution after choosing CRS/elevation/extrusion fields.
- **Shapefile export:** use `exportgis.shapefile` from `View3D > GIS > Export > Shapefile (.shp)`; export only mesh objects from the current selection or a collection.
- **Local OSM XML:** use `importgis.osm_file` from `View3D > GIS > Import > Open Street Map xml (.osm)`; it parses local OSM XML and builds nodes, ways, areas, relations, and optionally extruded buildings.
- **Overpass query:** use `importgis.osm_query` from `View3D > GIS > Web geodata > Get OSM`; it requires a valid georeferenced scene and an extent from top orthographic view or one selected reference mesh.
- **OSM preflight without network:** use `scripts/build_overpass_query.py` to construct the exact Overpass QL shape before opening BlenderGIS or contacting a public Overpass server.

## Boundary Reminders

- Scene CRS, origin custom properties, reprojection engine selection, and broken-georef recovery are owned by `../georeferencing-and-crs/`.
- DEMs, georeferenced rasters, ASCII grids, web DEMs, and basemap tiles are owned by `../raster-dem-and-basemaps/`.
- Dropping imported vectors to a terrain mesh, Delaunay/Voronoi terrain creation, and terrain analysis materials are owned by `../terrain-mesh-and-analysis/`.