Map Panel¶
The AI-Hydro map panel renders geospatial analysis outputs as interactive layers inside VS Code β watershed boundaries, TWI grids, gauge networks, GEE tiles, and any file you drop on the canvas appear here automatically. No copy-pasting coordinates into an external tool; no Mapbox token; no QGIS dependency.
The renderer is built on deck.gl (GPU-accelerated) and talks to the extension host over gRPC streaming so the map updates in real time as Python tools push layers.
Opening the Map¶
Click the Map icon in the AI-Hydro activity bar, or run AI-Hydro: Open Map from the command palette (Cmd+Shift+P). The panel opens in editor column 2, side-by-side with the chat.
Tool Ribbon¶
The right-edge ribbon provides quick access to every map tool. Click an icon to open its panel; click again to collapse. Only one panel is open at a time.
| Icon | Tool | Guide page |
|---|---|---|
| πΊοΈ | Basemap | Basemaps |
| π | Layers | Layers & Symbology |
| π§ | Gallery (Mine / Starred / Community) | Hydrography & Gallery |
| π | Hydrography | Hydrography & Gallery |
| βΆ | Fit extent | Zooms to all visible layers |
| π | Search | Hydrography & Gallery |
| βοΈ | Draw | Draw & Measure |
| π | Measure | Draw & Measure |
| π¬ | Annotations | Smart Annotations |
| π | Transect | Transect Profiles |
| β© | Swipe | Swipe Comparison |
| πΌοΈ | Map Plate | Map Plate Composer |
Basemaps¶
All basemaps are free β no API token required.
Hydrology-focused¶
| Basemap | Best for |
|---|---|
| USGS Topo (default) | Watershed context, roads, terrain names |
| USGS Imagery | Aerial / satellite verification |
| USGS Shaded Relief | Terrain hillshading |
| Esri Hillshade | High-resolution DEM shading |
| Esri Ocean | Bathymetry and coastal work |
General purpose¶
Carto Voyager Β· Carto Dark Β· Carto Light Β· Stadia Terrain Β· Esri World Topo Β· Esri Satellite Β· Humanitarian (HOT).
Note on OpenStreetMap direct: tile.openstreetmap.org disallows embedded-app traffic. Use Carto or HOT basemaps β both are OSM-derived and permit this use case.
Map Status Bar¶
The bar at the bottom of the map shows:
| Element | Detail |
|---|---|
| Scale bar | Physical distance per pixel at current zoom and latitude |
| Coordinates | Cursor position β click to cycle between decimal (45.4981Β°N), DMS (45Β°29β²53.2β³N), and UTM |
| Bearing indicator | Compass needle; click to reset north |
| Zoom controls | +/β buttons |
| Attribution | Basemap source links (required by tile licences) |
Feature Pages¶
| Page | What it covers |
|---|---|
| Layers & Symbology | Loading files, layer types, symbology editor, GeoTIFF support, Python tool layers |
| Draw & Measure | Vector draw tool, measure distances and areas, ROI for analysis |
| Smart Annotations | Pins, polygons, notes, collections, batch agent analysis, multi-format export |
| Transect Profiles | Profile charts, geomorphic metrics, overlay mode, batch analysis, export formats |
| Swipe Comparison | Side-by-side layer comparison with a draggable divider |
| Map Plate Composer | Publication-quality map figures β templates, cartographic elements, print export |
| Feature Inspector | Click-to-inspect vector properties and raster values, Quick Delineate |
| Hydrography & Gallery | MERIT rivers, WBD boundaries, gauges, dams; personal Gallery (save/import scenes, transects, annotations), bookmarks, community catalog |
| Agent Integration | Python bridge, show_on_map, agent orchestration tools, workspace persistence |