GeoPilot AI documentation

Supported formats, the tool catalog, how to phrase a request, and the API.

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 (first layer).gpkgVector
GeoParquet.parquet, .geoparquetVector
DXF (lines, polylines, points, circles, arcs).dxfVector
CSV / Excel with latitude and longitude columns.csv, .xlsx, .xlsTable
EPANET model.inpNetwork
GeoTIFF (display only).tif, .tiffRaster
ASCII Grid (display only).ascRaster

Features

Everything GeoPilot can do — and how to use it.

AI & Chat

Every request runs the premium AI model - no tiers to choose, no quality tradeoff. All plans use the same model.

How to useNothing to configure - just chat.

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.

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).
Water Networks

Run water distribution models with the EPANET solver (WNTR): topology audit, demand allocation, demand- or pressure-driven runs, results per timestep, and pressure and velocity checks against the limits you set.

How to useUpload a .inp file in the workspace, then ask, for example "Run this model and list junctions with pressure below 10 m".
Flood Screening & Rasters

For flood screening, GeoPilot downloads the Copernicus GLO-30 (30 m) DEM for a place name or bounding box (up to 12 one-degree tiles). No upload is needed. The download serves the flood steps; there are no slope, aspect or watershed tools.

How to useAsk for a flood question with a place, for example "Map flood depth zones for a 2 m river rise around Accra".

Conditions the DEM, computes height above nearest drainage (HAND), maps depth for a channel rise or a still-water level, cuts depth zones into polygons and flags the features of any layer inside each zone. A screening method: no hydraulic simulation, roughness or hydrograph.

How to useAsk for depth zones, then "Flag the buildings inside the flood zones" or "Count schools per depth band".

Upload a GeoTIFF or ASCII Grid (up to 50 MB) to display it on the map. The built-in tools do not analyse an uploaded raster, and flood screening runs on the downloaded DEM only.

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 credit usage against your plan. Warnings appear when you are running low. Pro includes 300 credits a month and Business 1,500 (pooled). A question uses 1 credit and a full report 10; advanced models count 5 times and top models 10 times. See Pricing for the current plans.

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

85 built-in tools in 14 categories

Geoprocessing
ClipClip features to the boundary of a second layer
IntersectKeep the parts of two layers that overlap
UnionCombine two layers into one
DifferenceErase a second layer from the active layer
Symmetric DifferenceKeep the parts covered by one layer but not both
Select by LocationSelect features within, intersecting, containing or disjoint from another layer
Split LinesSplit lines where another layer crosses them
BufferBuffer zones in metres, kilometres or miles
Multi-ring BufferSeveral buffer rings at set distances
Wedge BufferSector-shaped buffers by direction and angle
Nearest DistanceGround distance from each feature to the nearest feature of another layer
Join by NearestCopy attributes from the nearest feature of another layer
Distance MatrixDistances to the nearest N features
Nearest Neighbour StatisticsNearest neighbour distance for each point in a layer
Spatial JoinJoin attributes by location
Attribute JoinJoin a table to a layer by a shared key
Count Points in PolygonsNumber of points inside each polygon
Sum Points in PolygonsSum or average a point attribute inside each polygon
DissolveMerge all features, or merge by a shared attribute
Group SummaryCount, sum, mean, min or max per group
CrosstabCross-tabulate two attribute columns
Field StatisticsSummary statistics for a column
Top NThe largest or smallest N features by a column
HexbinCount or aggregate points into hexagons of a chosen size
Square GridCount or aggregate points into square cells
Point DensityDensity surface from points
Heat MapHeat map layer from points
IDW SurfaceInverse distance weighting surface from point values
Contour LinesContour lines from point values
Contour BandsFilled contour bands from point values
Voronoi PolygonsVoronoi (Thiessen) polygons from points
TINTriangulated irregular network from points
CentroidCentre point of each feature
Convex HullConvex hull around features
Concave HullConcave hull around points
Bounding BoxRectangle around the layer or each feature
SimplifyReduce vertices to shrink a layer
Repair GeometryMake invalid geometries valid
Remove DuplicatesDrop duplicate features or points
Snap Points to LinesMove points onto the nearest line
Reproject to UTMReproject to the UTM zone of the data
Reproject to EPSGReproject to any EPSG code
Reproject to Web MercatorReproject to EPSG:3857
Fetch DEMDownload the Copernicus GLO-30 (30 m) DEM for a place or bounding box, up to 12 one-degree tiles
Condition DEMFill or breach depressions (WhiteboxTools)
HANDHeight above nearest drainage (D8)
Flood Depth from HANDDepth for a rise in channel stage
Still-water DepthDepth for a water level above sea level
Flood ZonesDepth bands as polygons with area (default 0.5, 1.5 and 3 m)
Flood ExposureFlag the features of any layer inside each depth band, with counts and shares
Depth at FeaturesSample flood depth at each feature
Sample Raster at PointsRead a computed raster value at each point
Load ModelRead an uploaded EPANET .inp file
Topology AuditFind disconnected parts and other network faults
Allocate DemandSpread a total demand across junctions
Run SimulationDemand-driven or pressure-driven EPANET run (WNTR)
Read ResultsPressures, flows and velocities, overall or per timestep
Pressure and Velocity ChecksJunctions and pipes outside the limits you set
Set Junction ElevationsTake junction elevations from a DEM or survey
Bulk EditChange a property across many pipes or junctions
Analysis
K-means ClusteringGroup features into K spatial clusters
DBSCAN ClusteringDensity-based clusters, with noise points marked
ClassifyQuantile, equal interval, natural breaks or standard deviation classes
Graduated ColoursColour features by a numeric column
Categorized ColoursColour features by category
Proportional SymbolsSize points by a numeric column
LabelsLabel features with a column
Bar ChartCompare values by category
Pie / Donut ChartProportional breakdown by category
HistogramDistribution of a numeric column
Scatter PlotRelationship between two numeric columns
Line ChartTrend across ordered values
Box PlotDistribution spread and outliers
Field CalculatorNew or updated columns from an expression
Date and Text OperationsParse dates, split or extract text
FilterFilter by value, range or a compound condition
Area and LengthMeasure area, perimeter or length
SamplingRandom, stratified or every-Nth subsets
OpenStreetMap FeaturesHospitals, schools, parks, bus stops, railway stations, buildings, roads, rivers, land use and more for a bounded area, up to 5,000 features (monthly refresh)
Natural EarthCountry and state boundaries; cities, rivers, lakes, airports and ports; US counties and parks; North American roads and railroads
Find a PlaceGeocode one place name at a time (Mapbox)
Export LayerShapefile (.zip), GeoJSON, KML, CSV or DXF
Export Map ImagePNG, JPEG, WebP or PDF with title, legend, scale bar and north arrow
PDF ReportReport of the analysis with map, charts and tables
AI ReportShareable written report (10 credits)

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
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 population 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
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
Map flood depth zones for a 2 m river rise around Accra
Copernicus DEM, HAND and depth zones
Flag the buildings inside the flood zones
Exposure of any layer by depth band
Show which roads would be under a 3 m still-water level
Still-water ("bathtub") depth
Count the schools in each flood depth band
Exposure summary
Create an IDW surface of groundwater levels from the wells
Inverse distance weighting surface
Draw contour lines every 5 m from the well levels
Contours from point values
Make a 1 km hexbin of the incidents
Hexagon aggregation
Show point density of the complaints
Density surface
Audit the topology of this EPANET model
Disconnected parts and faults
Run the model pressure-driven and list junctions below 10 m
Simulation and pressure check
Set the junction elevations from the DEM
Junction elevations from a DEM
Change the roughness of all cast iron pipes to 90
Bulk edit of pipe properties

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
DXFFor CAD drawings
Map imagePNG, JPEG, WebP or PDF with title, legend, scale bar and north arrow
PDF reportAnalysis report with map, charts and tables
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 freely — All operations can be undone with Ctrl+Z
  • 4.Check Results tab — Charts and visualizations appear there, not in chat
  • 5.Export before refreshing — Data is stored in browser memory only

Zip shapefiles (.zip containing .shp, .shx, .dbf); a bare .shp is refused. GeoJSON, KML, KMZ, GPX, GeoPackage, GeoParquet and DXF upload directly, and CSV or Excel files need latitude and longitude columns. Rasters must be GeoTIFF (.tif) or ASCII Grid (.asc). Each file can be up to 50 MB.

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. Always export important work.

Every user gets the premium AI model on every request - there is no model to pick. All plans run the same top-quality model.

Yes. Upload an EPANET .inp file and ask. GeoPilot runs it with the EPANET solver (through WNTR): topology audit, demand allocation, demand- or pressure-driven runs, results per timestep, pressure and velocity checks, junction elevations from a DEM and bulk edits of pipe properties. It does not trace networks, such as which customers lose supply when a valve closes.

When you ask for flood screening (a river rise or a still-water level), GeoPilot downloads Copernicus GLO-30 (30 m) DEM tiles for a place name or bounding box, up to 12 one-degree tiles. The DEM feeds the flood steps, and its values can be sampled at points. There are no slope, aspect, hillshade or watershed tools.

There are no terrain tools beyond flood screening: no slope, aspect, hillshade, viewshed, watershed delineation, stream extraction or elevation profile. GeoPilot does not analyse satellite imagery (no NDVI) or uploaded rasters. It has no routing, shortest path, isochrones or drive times, no batch geocoding of address lists, no network tracing, no kriging and no H3. It does not do 2D hydraulic flood modelling, read LiDAR, NetCDF or HDF5 files, or supply demographic data. GeoPilot Desktop is not released.

Click the Cloud icon (view 4) in the left sidebar. Files uploaded during analysis are stored in Google Cloud Storage.

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.