Skip to content

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