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.
Upload a Shapefile, GeoJSON, KML, GeoTIFF — or browse 90+ sample datasets in the Library (view 5).
Type a prompt or click a suggestion card. Try "Show summary statistics" or "Buffer by 500m".
Map updates live. Charts in Results tab. Data in Attributes. Style layers via Layers panel.
| Format | Extensions | Type |
|---|---|---|
| Shapefile | .zip (.shp, .shx, .dbf) | Vector |
| GeoJSON | .geojson, .json | Vector |
| KML | .kml | Vector |
| KMZ | .kmz | Vector |
| GPX | .gpx | Vector |
| GeoPackage (first layer) | .gpkg | Vector |
| GeoParquet | .parquet, .geoparquet | Vector |
| DXF (lines, polylines, points, circles, arcs) | .dxf | Vector |
| CSV / Excel with latitude and longitude columns | .csv, .xlsx, .xls | Table |
| EPANET model | .inp | Network |
| GeoTIFF (display only) | .tif, .tiff | Raster |
| ASCII Grid (display only) | .asc | Raster |
Features
Everything GeoPilot can do — and how to use it.
Every request runs the premium AI model - no tiers to choose, no quality tradeoff. All plans use the same model.
Enable real-time web search to ground AI responses with current data from the internet.
Dictate prompts using your microphone instead of typing. Supports multiple languages.
Complex tasks are automatically broken into steps. Each step runs independently with progress tracking. If a step fails, GeoPilot retries with a fix.
Clickable prompt cards shown when the chat is empty, personalized to your selected domain.
Rate AI responses with thumbs up/down. Negative feedback lets you add a comment about what went wrong.
90+ curated datasets including world countries, states, cities, airports, roads, and railroads from Natural Earth. One-click load onto the map.
Files are automatically saved to cloud storage (Google Cloud). Access your uploaded files from any device.
Import spreadsheets (CSV, Excel) as map data. Specify which columns contain latitude/longitude coordinates.
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.
Browse and search your past prompts and AI responses. Click any entry to see the full details.
Customize each layer's appearance: fill color, stroke color, opacity, line width, and dash pattern (solid, dashed, dotted).
Draw points, lines, polygons, rectangles, and circles directly on the map. Drawn features become a new layer for analysis.
Switch between Outdoors, Satellite, Streets, and Dark map base layers.
Generate PDF reports from your analysis including map screenshots, charts, data tables, and layer summaries.
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.
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.
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.
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.
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.
Generate a public link to your current map view. Recipients see your layers and styling without needing an account.
Brief pop-up messages confirm actions like successful analysis, file uploads, and errors — separate from the chat thread.
Tools Reference
85 built-in tools in 14 categories
ClipClip features to the boundary of a second layerIntersectKeep the parts of two layers that overlapUnionCombine two layers into oneDifferenceErase a second layer from the active layerSymmetric DifferenceKeep the parts covered by one layer but not bothSelect by LocationSelect features within, intersecting, containing or disjoint from another layerSplit LinesSplit lines where another layer crosses themBufferBuffer zones in metres, kilometres or milesMulti-ring BufferSeveral buffer rings at set distancesWedge BufferSector-shaped buffers by direction and angleNearest DistanceGround distance from each feature to the nearest feature of another layerJoin by NearestCopy attributes from the nearest feature of another layerDistance MatrixDistances to the nearest N featuresNearest Neighbour StatisticsNearest neighbour distance for each point in a layerSpatial JoinJoin attributes by locationAttribute JoinJoin a table to a layer by a shared keyCount Points in PolygonsNumber of points inside each polygonSum Points in PolygonsSum or average a point attribute inside each polygonDissolveMerge all features, or merge by a shared attributeGroup SummaryCount, sum, mean, min or max per groupCrosstabCross-tabulate two attribute columnsField StatisticsSummary statistics for a columnTop NThe largest or smallest N features by a columnHexbinCount or aggregate points into hexagons of a chosen sizeSquare GridCount or aggregate points into square cellsPoint DensityDensity surface from pointsHeat MapHeat map layer from pointsIDW SurfaceInverse distance weighting surface from point valuesContour LinesContour lines from point valuesContour BandsFilled contour bands from point valuesVoronoi PolygonsVoronoi (Thiessen) polygons from pointsTINTriangulated irregular network from pointsCentroidCentre point of each featureConvex HullConvex hull around featuresConcave HullConcave hull around pointsBounding BoxRectangle around the layer or each featureSimplifyReduce vertices to shrink a layerRepair GeometryMake invalid geometries validRemove DuplicatesDrop duplicate features or pointsSnap Points to LinesMove points onto the nearest lineReproject to UTMReproject to the UTM zone of the dataReproject to EPSGReproject to any EPSG codeReproject to Web MercatorReproject to EPSG:3857Fetch DEMDownload the Copernicus GLO-30 (30 m) DEM for a place or bounding box, up to 12 one-degree tilesCondition DEMFill or breach depressions (WhiteboxTools)HANDHeight above nearest drainage (D8)Flood Depth from HANDDepth for a rise in channel stageStill-water DepthDepth for a water level above sea levelFlood 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 sharesDepth at FeaturesSample flood depth at each featureSample Raster at PointsRead a computed raster value at each pointLoad ModelRead an uploaded EPANET .inp fileTopology AuditFind disconnected parts and other network faultsAllocate DemandSpread a total demand across junctionsRun SimulationDemand-driven or pressure-driven EPANET run (WNTR)Read ResultsPressures, flows and velocities, overall or per timestepPressure and Velocity ChecksJunctions and pipes outside the limits you setSet Junction ElevationsTake junction elevations from a DEM or surveyBulk EditChange a property across many pipes or junctionsK-means ClusteringGroup features into K spatial clustersDBSCAN ClusteringDensity-based clusters, with noise points markedClassifyQuantile, equal interval, natural breaks or standard deviation classesGraduated ColoursColour features by a numeric columnCategorized ColoursColour features by categoryProportional SymbolsSize points by a numeric columnLabelsLabel features with a columnBar ChartCompare values by categoryPie / Donut ChartProportional breakdown by categoryHistogramDistribution of a numeric columnScatter PlotRelationship between two numeric columnsLine ChartTrend across ordered valuesBox PlotDistribution spread and outliersField CalculatorNew or updated columns from an expressionDate and Text OperationsParse dates, split or extract textFilterFilter by value, range or a compound conditionArea and LengthMeasure area, perimeter or lengthSamplingRandom, stratified or every-Nth subsetsOpenStreetMap 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 railroadsFind a PlaceGeocode one place name at a time (Mapbox)Export LayerShapefile (.zip), GeoJSON, KML, CSV or DXFExport Map ImagePNG, JPEG, WebP or PDF with title, legend, scale bar and north arrowPDF ReportReport of the analysis with map, charts and tablesAI ReportShareable written report (10 credits)Example Prompts
Copy and paste into GeoPilot chat.
Keyboard Shortcuts
Data & Export
| Format | Description | Best For |
|---|---|---|
| GeoJSON | Universal format, works everywhere | Web apps, APIs |
| Shapefile | For traditional GIS software | ArcGIS, QGIS |
| KML | For Google Earth | Google Earth |
| CSV | Attribute data as spreadsheet | Excel, Google Sheets |
| DXF | For CAD drawings | AutoCAD, other CAD tools |
| Map image | PNG, JPEG, WebP or PDF with title, legend, scale bar and north arrow | Reports, presentations |
| PDF report | Analysis report with map, charts and tables | Sharing results |
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
- 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.
