Getting Started

Upload spatial data and analyze it with natural language.

Interface Layout
1
2
3
Views
Map / Attributes / Results
Center Panel
AI Chat
Right Panel
Upload or Browse

Upload a Shapefile, GeoJSON, KML, GeoTIFF — or browse 90+ sample datasets in the Library (view 5).

Ask

Type a prompt or click a suggestion card. Try "Show summary statistics" or "Buffer by 500m".

View

Map updates live. Charts in Results tab. Data in Attributes. Style layers via Layers panel.

Supported Formats
FormatExtensionsType
Shapefile.zip (.shp, .shx, .dbf)Vector
GeoJSON.geojson, .jsonVector
KML.kmlVector
KMZ.kmzVector
GPX.gpxVector
GeoPackage.gpkgVector
GeoTIFF.tif, .tiffRaster
ASCII Grid.ascRaster

Features

Everything GeoPilot can do — and how to use it.

AI & Chat

Switch between AI models (Gemini Flash, Gemini Pro) for different speed/quality tradeoffs.

How to useClick the model name at the bottom of the chat input to open the model picker.

Enable real-time web search to ground AI responses with current data from the internet.

How to useClick the "Web" toggle button in the chat input toolbar.

Dictate prompts using your microphone instead of typing. Supports multiple languages.

How to useClick the microphone icon next to the Send button. Allow microphone access when prompted.

Complex tasks are automatically broken into steps. Each step runs independently with progress tracking. If a step fails, GeoPilot retries with a fix.

How to useJust ask a complex question — the stepper UI appears automatically showing each step's progress.

Clickable prompt cards shown when the chat is empty, personalized to your selected domain.

How to useClick any suggestion card to send it immediately, or type your own prompt.

Rate AI responses with thumbs up/down. Negative feedback lets you add a comment about what went wrong.

How to useHover over any AI response to see the thumbs up/down buttons.
Data Management

90+ curated datasets including world countries, states, cities, airports, roads, and railroads from Natural Earth. One-click load onto the map.

How to useClick the Library icon (view 5) in the left sidebar, or press "5" on your keyboard.

Files are automatically saved to cloud storage (Google Cloud). Access your uploaded files from any device.

How to useClick the Cloud Uploads icon (view 4) in the sidebar. Files auto-delete after 30 days on the free plan.

Import spreadsheets (CSV, Excel) as map data. Specify which columns contain latitude/longitude coordinates.

How to useClick the CSV button in the chat toolbar, select your file, and map the coordinate columns.

Save your entire session (layers, chat history, results, map view) as a .geopilot.json file. Load it later to resume exactly where you left off.

How to useUse the File menu in the navbar: File > Save Project / Load Project.

Browse and search your past prompts and AI responses. Click any entry to see the full details.

How to useClick the History icon (view 6) in the left sidebar, or press "6" on your keyboard.
Map & Visualization

Customize each layer's appearance: fill color, stroke color, opacity, line width, and dash pattern (solid, dashed, dotted).

How to useClick "Layers" in the chat toolbar, then expand a layer to see its styling controls.

Draw points, lines, polygons, rectangles, and circles directly on the map. Drawn features become a new layer for analysis.

How to useClick the Draw button in the chat toolbar to enter drawing mode. Select a shape type and draw on the map.

Switch between Outdoors, Satellite, Streets, and Dark map base layers.

How to useClick the map style button in the top-right of the map.

Generate PDF reports from your analysis including map screenshots, charts, data tables, and layer summaries.

How to useClick Analysis > Generate Report in the navbar. Choose a template (Basic or Detailed).
MCP Tools (Advanced)

Simulate water distribution networks. Analyze pipe pressures, flow rates, water age, and pipe break impacts using .inp files.

How to useClick "MCP" in the chat toolbar, enable EPANET, then upload a .inp file or ask GeoPilot to build a network.

Model stormwater drainage systems. Simulate rainfall-runoff, node flooding, and subcatchment analysis.

How to useEnable SWMM in the MCP panel and upload your .inp drainage model file.

Simulate groundwater flow. Calculate hydraulic heads, drawdown, and water balance using FloPy.

How to useEnable MODFLOW in the MCP panel and describe your groundwater model parameters.
DEM & Terrain

GeoPilot automatically downloads Copernicus 30m DEM from AWS when you need terrain analysis. No upload required — just load a vector layer and ask for slope, watershed, or elevation analysis.

How to useLoad any vector layer, then ask: "Calculate slope from DEM" or "Delineate watershed". GeoPilot downloads the DEM for your area automatically.

Upload your own GeoTIFF or ASCII Grid raster for custom terrain analysis. The DEM variables are automatically injected into the analysis environment.

How to useClick "Upload" in the toolbar and select a .tif or .asc file. The raster appears as a map overlay.
Account & Settings

Track your prompt usage against your plan limits. Warnings appear when you are running low. Free plan: 20 prompts/day. Paid plans: 200-unlimited/month.

How to useClick your profile icon in the bottom-left sidebar to see usage. A yellow/red banner appears in chat when quota is low.

Generate a public link to your current map view. Recipients see your layers and styling without needing an account.

How to useClick the Share button in the navbar. Add a title and click Generate Link.

Brief pop-up messages confirm actions like successful analysis, file uploads, and errors — separate from the chat thread.

How to useToasts appear automatically in the top-right corner. They dismiss after a few seconds.

Tools Reference

186 tools in 28 categories

Geoprocessing
ClipClip features to boundary of second layer
DissolveDissolve features by common attribute
UnionMerge/union all layers together
IntersectFind intersection of two layers
DifferenceErase/subtract second layer from active layer
CRS TransformReproject data to any CRS (UTM, State Plane, custom EPSG)
BufferCreate buffer zones around features
CentroidConvert polygons to center points
SimplifySimplify geometries to reduce file size
Fix GeometryFix invalid geometries using make_valid
ReprojectReproject data to WGS84 (EPSG:4326)
Voronoi PolygonsCreate Voronoi/Thiessen polygons from points
Convex HullCreate convex hull polygon enclosing all features
Delaunay TriangulationCreate Delaunay mesh from points
Bounding BoxCreate rectangular bounding box around features
Split GeometrySplit features by a line or polygon boundary
Snap VerticesSnap vertices to nearby features within tolerance
Merge LinesMerge disconnected line segments into contiguous lines
Lines to PolygonsConvert closed line boundaries into polygons
Rotate FeaturesRotate features by angle around centroid
Scale FeaturesScale features by X/Y factor
Shift FeaturesTranslate/move features by X/Y offset
Fill DepressionsFill DEM depressions and resolve flats
Breach DepressionsBreach DEM depressions (least-cost)
Flow Direction (D8)Calculate D8 flow direction from DEM
Flow Accumulation (D8)Calculate D8 flow accumulation from DEM
D-inf Flow DirectionD-infinity multi-directional flow
D-inf Flow AccumulationD-infinity flow accumulation
FD8 Flow DirectionFD8 (Freeman) multi-flow direction
FD8 Flow AccumulationFD8 flow accumulation
Sink DepthCalculate depth of each depression/sink
Flood Fill OrderOrder in which depressions fill during flooding
Depression UncertaintyMonte Carlo stochastic depression analysis
Delineate WatershedDelineate watershed/catchment boundaries from DEM
Pour Point BasinDelineate catchment from a pour point
Sub-basinsDelineate sub-basins within the watershed
Equal-area Sub-basinsDivide watershed into equal-area sub-basins
Unnest BasinsRemove nested basins to get non-overlapping set
Longest Flow PathFind the longest flow path in watershed
Max Upslope FlowMaximum upslope flow path length per cell
Avg Upslope FlowAverage upslope flow path length
Distance to StreamDownslope distance to nearest stream
Trace Flow PathsTrace flow paths from points downstream
Extract StreamsExtract stream/river network from DEM
Strahler OrderCalculate Strahler stream order
Horton OrderCalculate Horton stream ordering
Shreve MagnitudeCalculate Shreve stream magnitude
Hack OrderCalculate Hack stream order (longest path)
Stream Link IDsAssign unique IDs to each stream link
Stream Link LengthCalculate length of each stream link
Stream Link SlopeCalculate slope of each stream link
Water BalanceCalculate IWA water balance from pipe network
Pipe ConditionAnalyze pipes by age, material, diameter
DMA AnalysisCompare inflow vs outflow per DMA
Leakage PriorityIdentify high-risk pipe segments for leakage
Water Table ContourInterpolate well data to groundwater level map
Well Yield MapMap well yield/discharge values
Recharge ZonesDelineate groundwater recharge zones
DRASTIC VulnerabilityCalculate DRASTIC vulnerability index
Weighted OverlayMulti-criteria weighted overlay for site suitability
Distance AnalysisCalculate proximity to target features
Constraint MapMap feasible vs excluded zones
Flood ZonesDelineate flood risk zones from DEM
Flood DepthCalculate flood inundation depth for given water level
Flood ImpactIdentify infrastructure affected by flood zones
HAND Flood MapHeight Above Nearest Drainage flood mapping
Raster Zones to PolygonsConvert raster zones to vector polygons
Raster Cells to PointsConvert raster cells to vector points
Raster Lines to VectorsConvert raster lines to vector lines
Polygons to RasterBurn polygon features into raster grid
Points to RasterBurn point features into raster grid
Lines to RasterBurn line features into raster grid
Euclidean DistanceCreate euclidean distance raster from features
Nearest AllocationAssign each cell to nearest feature
Cost DistanceCost-weighted distance through friction surface
Cost AllocationAssign cells to nearest source by travel cost
Least-Cost PathFind least-cost path between two points
Raster BufferBuffer features in raster space
Build Road GraphBuild routable graph from place name (osmnx)
Graph from BboxBuild graph from bounding box (osmnx)
Graph to GeoDataFrameConvert graph to node/edge GeoDataFrames
OSM by TagDownload OSM features by tag within polygon
Connected ComponentsFind disconnected sub-networks
Min Spanning TreeFind minimum cost tree connecting all nodes
Shortest PathFind shortest path on road network
Service AreaCalculate service area buffers around facilities
Coverage GapIdentify underserved areas outside coverage
Isochrone MapCalculate travel-time zones from a source point
Traveling SalesmanFind optimal route visiting all points (TSP)
Betweenness CentralityFind critical nodes/bottlenecks in network
Degree CentralityIdentify highly connected nodes
Closeness CentralityIdentify most accessible nodes
Network PageRankRank node importance using PageRank
Community DetectionDetect community structure (Louvain)
Analysis
HistogramDistribution of a numeric column
Bar ChartCompare values by category
Pie ChartProportional breakdown by category
Scatter PlotRelationship between two numeric columns
Line ChartTrend across ordered values
Box PlotDistribution spread and outliers
ChoroplethColor the map by a numeric column
HeatmapCreate a heatmap from point features
Cluster MapVisualize spatial clusters with color-coded groups
Chart OverlayPlace pie or bar charts at feature locations on the map
Calculate AreaCalculate area in square kilometers
Calculate LengthCalculate length of line features in km
StatisticsShow summary statistics for all columns
Spatial JoinSpatial join with the second layer
Nearest NeighborFind nearest feature from second layer
KMeans ClusteringCluster features into spatial groups
DBSCAN ClusteringDensity-based spatial clustering (auto-detect)
Hierarchical ClusteringAgglomerative hierarchical clustering
Pairwise DistancesCalculate pairwise distance matrix
Statistical TestsT-test, correlation, normality tests on attributes
KD-Tree LookupFast nearest-neighbor lookup using KD-Tree
Slope/AspectCalculate slope and aspect from DEM
ContoursGenerate elevation contours from DEM
HillshadeGenerate hillshade relief from DEM
Elevation ProfileElevation cross-section profile from DEM
Hypsometric CurveArea-elevation relationship analysis
Viewshed AnalysisVisible area from a point (line of sight)
Height Above StreamHAND model for flood mapping
Terrain RuggednessSurface roughness index from DEM
Topographic PositionRelative topographic position index (TPI)
Topographic WetnessSoil moisture prediction index (TWI)
Sediment TransportErosion potential index
Stream Power IndexChannel erosion index
Plan CurvatureFlow convergence/divergence
Profile CurvatureFlow acceleration
Tangential CurvatureTangential surface curvature
Total CurvatureTotal surface curvature
Aspect VariabilityCircular variance of aspect
Landform ClassificationClassify into 10 geomorphon landforms
Pennock LandformsPennock landform classification
Elevation DeviationDeviation from local mean elevation
Elevation DifferenceDifference from mean in neighborhood
Max Elevation DeviationMax elevation deviation in neighborhood
Elevation PercentileLocal elevation percentile
Surface RoughnessMulti-scale roughness analysis
Normal Vector DeviationRoughness via normal vector angle
Edge DensityLandscape fragmentation analysis
Wind FetchWind fetch distance (open water exposure)
Zonal StatisticsMean/min/max per polygon zone
ReclassifyClassify DEM into elevation zones
Point SamplingExtract raster values at point locations
Clip RasterClip raster to polygon boundary
Raster to VectorConvert raster zones to vector polygons
Vector to RasterRasterize vector features to grid
Mosaic RastersMerge multiple raster tiles into one
ResampleChange raster resolution
Raster CalculatorCustom raster math expressions (map algebra)
Raster HistogramHistogram of raster cell values
Raster Summary StatsMin/max/mean/std for entire raster
Cross TabulationCross-tabulate two categorical rasters
NDVI / Band RatioNormalized difference index from multi-band raster
Band MathCalculate band ratios (NDVI, NDWI) from imagery
Select BandSelect specific band from multi-band raster
Open NetCDFOpen NetCDF/HDF5 multi-dimensional dataset
Open GeoTIFF (xarray)Open GeoTIFF with spatial CRS via rioxarray
Clip Raster (xarray)Clip xarray raster to polygon boundary
Reproject Raster (xarray)Reproject xarray raster to different CRS
Geocode AddressGeocode addresses to lat/lon coordinates
Reverse GeocodeGet addresses from coordinates
Geodesic DistanceCalculate geodesic distance between two points
Great Circle DistanceCalculate great-circle distance
KrigingOrdinary Kriging interpolation (pykrige)
IDW InterpolationInverse Distance Weighting interpolation
Universal KrigingKriging with regional drift/trend
Grid InterpolationInterpolate to regular grid (linear/cubic/nearest)
Kernel DensityKernel density estimation from points
Gaussian SmoothGaussian smoothing for noise reduction
Median FilterMedian filter for noise removal
Edge-Preserving SmoothSmooth while preserving edges
Bilateral FilterSpatial + range smoothing
Laplacian Edge DetectLaplacian edge detection
Sobel Edge DetectSobel edge detection
Prewitt Edge DetectPrewitt edge detection
Texture AnalysisLocal standard deviation texture analysis
Contrast EnhancementHistogram equalization for contrast
Building Footprint AreaCalculate building footprint areas
Building PerimeterCalculate building perimeters
Building ElongationCalculate building elongation ratio
Building CompactnessCircular compactness index
Building CornersCount corners in building footprints
Morphological TessellationGenerate tessellation cells around buildings
OSM DownloadDownload roads, buildings, POIs from OpenStreetMap

Example Prompts

Copy and paste into GeoPilot chat.

Show me the data columns
List all attribute columns
How many features are there?
Count total features
Show summary statistics
Stats for all numeric columns
What is the geometry type?
Check if points/lines/polygons/raster
Filter where population > 10000
Filter by attribute value
Select features within 5km of Delhi
Spatial selection
Find all residential areas
Filter by text attribute
Remove features with null values
Clean data
Buffer all features by 500 meters
Create buffer zones around features
Clip to study area boundary
Cut features using another layer
Dissolve by district name
Merge features sharing an attribute
Erase water bodies from land parcels
Difference/subtract layers
Find the centroid of each polygon
Convert polygons to center points
Simplify geometries to reduce size
Reduce complexity for large files
Fix invalid geometries
Repair broken features with make_valid
Reproject to WGS84
Change coordinate reference system
Spatial join with population data
Join attributes by location
Find nearest hospital to each village
Nearest neighbor analysis
Cluster wells into 5 groups
KMeans spatial clustering
Calculate area in square kilometers
Add area column to polygons
Calculate length of roads in km
Length for line features
Create Voronoi/Thiessen polygons
Service area polygons
Create choropleth map by population
Color map by values
Show bar chart of areas by district
Bar chart comparison
Create a heatmap of points
Density visualization
Plot histogram of elevation values
Distribution chart
Scatter plot of population vs area
Correlation analysis
Create pie chart of land use types
Proportional breakdown
Show box plot of rainfall by district
Spread and outliers
Place pie charts on each district on the map
Chart overlay on map
Download buildings from OpenStreetMap
Get OSM buildings
Get roads within my boundary
OSM road network
Download schools in this area
OSM POI data
Get rivers and water bodies
OSM hydrology
Reproject to UTM zone 43N
Change CRS for accurate measurements
Convert to WGS84
Reproject to EPSG:4326
Add latitude longitude columns
Extract coordinates to columns
Calculate slope and aspect from DEM
Terrain gradient and direction
Generate hillshade
Sun-illuminated relief visualization
Generate elevation contours at 50m interval
Contour lines from DEM
Classify elevation into 5 zones
Reclassify into low/medium/high
Create elevation cross-section profile
Profile along a transect line
Delineate watersheds from DEM
Catchment boundary delineation
Calculate flow accumulation
Where does water collect?
Extract stream network from DEM
River/stream channel extraction
Fill DEM depressions and extract streams
Full hydrology preprocessing
Calculate zonal statistics per district
Mean/min/max elevation per zone
Geocode these addresses to coordinates
Convert addresses to lat/lon
Calculate distance between Mumbai and Delhi
Geodesic distance
Find the nearest city to each point
Nearest neighbor with geocoding
Reverse geocode these coordinates
Get addresses from lat/lon
Interpolate groundwater levels using kriging
Spatial interpolation with pykrige
Calculate zonal statistics from raster
Mean elevation per district
Create IDW interpolation of sample points
Inverse distance weighting surface
Calculate building footprint statistics
Urban morphology analysis with momepy
Build road network graph for Mumbai
OSMnx graph from place name
Find shortest path between two points
Dijkstra shortest path
Calculate 15 minute isochrone from hospital
Travel-time zones
Find optimal route visiting all schools
Traveling salesman problem
Detect communities in the road network
Louvain community detection
Apply Gaussian smoothing to raster
Noise reduction filter
Detect edges in the DEM using Sobel filter
Edge detection
Enhance contrast of satellite imagery
Histogram equalization
Calculate texture roughness of raster
Local standard deviation
Create euclidean distance from rivers
Distance raster from features
Find least-cost path between two points
Cost pathway through friction surface
Allocate cells to nearest hospital by cost
Cost-weighted allocation

Keyboard Shortcuts

Navigation
Switch to Map view
1
Switch to Attributes view
2
Switch to Results view
3
Switch to Cloud Uploads
4
Switch to Sample Library
5
Editing
Undo last operation
Ctrl+Z
Redo operation
Ctrl+Y
Redo (alternative)
Ctrl+Shift+Z
General
Open help menu
?
Open help (alternative)
F1
Close modal / Cancel
Esc
Send message / Execute
Enter
New line in message
Shift+Enter
Previous message from history
Arrow Up

Data & Export

Export Formats
FormatDescription
GeoJSONUniversal format, works everywhere
ShapefileFor traditional GIS software
KMLFor Google Earth
CSVAttribute data as spreadsheet
PNG MapScreenshot of current map view
Sharing

Click Share to generate a public link to your current map view.

Shared maps include all visible layers and styling. Recipients do not need an account.

Share links expire after the session ends unless you have persistent storage on a paid plan.

Tips & FAQ

Tips
  • 1.Be specific"Calculate area in hectares" works better than "get area"
  • 2.Reference columns by name"Filter where DISTRICT = 'Mumbai'"
  • 3.Use Undo freelyAll operations can be undone with Ctrl+Z
  • 4.Check Results tabCharts and visualizations appear there, not in chat
  • 5.Export before refreshingData is stored in browser memory only

Ensure shapefiles are zipped (.zip containing .shp, .shx, .dbf). GeoJSON, KML, and GPX can be uploaded directly. Raster files must be GeoTIFF (.tif) or ASCII Grid (.asc).

Column names are case-sensitive. Ask "Show me the columns" to see exact names, then reference them precisely in your commands.

Try rephrasing with simpler terms, break the task into smaller steps, or check if your data has valid geometries by asking "Fix invalid geometries".

Layers persist when switching between Map/Attributes/Results. If the map is blank, check that the layer is toggled on in the Layers panel.

Your data is processed in a secure cloud environment. Cloud uploads are stored in Google Cloud Storage and auto-delete after 30 days on the free plan. Always export important work.

Click the model name (e.g., "Gemini 2.5 Pro") at the bottom of the chat input. A dropdown shows available models with descriptions. Flash is faster, Pro is more capable.

Model Context Protocol (MCP) tools are specialized simulators: EPANET for water networks, SWMM for stormwater, MODFLOW for groundwater. Enable them via the "MCP" button in the chat toolbar.

When you ask for terrain analysis (slope, watershed, elevation), GeoPilot automatically downloads Copernicus 30m DEM tiles from AWS for your area. No upload needed — just have a vector layer loaded to define the area.

Click the Cloud icon (view 4) in the left sidebar. Files uploaded during analysis are stored in Google Cloud Storage. Free plan files expire after 30 days.

Yes. Use File > Save Project to download a .geopilot.json file with all your layers, chat history, results, and map position. Use File > Load Project to restore it later.

Click "Layers" in the chat toolbar, then expand any layer. You can change fill color, stroke color, opacity (0-100%), line width, and dash pattern.

Each AI response has thumbs up/down buttons. Your feedback helps us improve GeoPilot. Thumbs down lets you add a comment about what went wrong.

Email contact@smartbhujal.com or visit smartbhujal.com for help.