GeoAI Chat Documentation

Complete guide to commands, coordinate systems, and geospatial tools

Quick Start

GeoAI Chat is a command-line interface for geospatial operations. All commands start with a forward slash /.

Tip: You can add multiple points at once and mix different coordinate systems!

New: Use the 🌍 Location button or /location command to access your device's GPS!

Geolocation Features

Get Current Location

Access your device's GPS coordinates

Command:

/location

Button:

Click the 🌍 Location button in the chat interface

Returns: Latitude, Longitude, and GPS accuracy

⚠️ Requirements:
• Browser location permission must be granted
• Device must have GPS or location services enabled
• Works best outdoors or near windows
• May not work on localhost (use HTTPS in production)

Add Current Location

Add your GPS position as a polygon point

Command:

/add-location
Note: Must use /location first to get GPS coordinates
Perfect for field surveys! Walk to each corner, use /add-location, then calculate area.

Polygon Tools

Add Points

Add polygon vertices in any supported projection

WGS84 (default):

/polygon add 6.5 3.4 6.52 3.38

UTM:

/polygon add utm 31 N 500000 720000

Nigeria Mid Belt:

/polygon add nigeria-mid 670000 1000000

Calculate Area

Get polygon area in multiple units

Full command:

/polygon area

Shortcut:

/total
Returns area in m², km², and hectares

Export Polygon

Export your polygon data

GeoJSON format:

/polygon export

CSV format:

/polygon csv

Manage Polygon

Check status or reset

Check status:

/polygon status

Clear all points:

/polygon clear

Coordinate Transformation

WGS84 → UTM

Convert geographic coordinates to UTM

/utm 6.5244 3.3792
Returns: Zone, Hemisphere, Easting, Northing

UTM → WGS84

Convert UTM to geographic coordinates

/geo 31 N 500000 720000
Parameters: zone, hemisphere (N/S), easting, northing

Nigeria Coordinate Systems

All Nigeria systems use the Minna datum (Clarke 1880 RGS ellipsoid). Input coordinates should be in WGS84 for automatic conversion.

Nigeria West Belt

EPSG:26391

/nigeria west 6.5 3.4
Central Meridian: 4°30'E
Coverage: Western Nigeria

Nigeria Mid Belt

EPSG:26392

/nigeria mid 9.0 7.5
Central Meridian: 8°30'E
Coverage: Central Nigeria

Nigeria East Belt

EPSG:26393

/nigeria east 10.5 12.0
Central Meridian: 12°30'E
Coverage: Eastern Nigeria

Minna / UTM 31N

EPSG:26331

/nigeria utm31 6.5 3.4
Zone: 31N
Coverage: Western longitudes

Minna / UTM 32N

EPSG:26332

/nigeria utm32 9.0 7.5
Zone: 32N
Coverage: Eastern longitudes

Supported Projections for Polygon Add

Projection Command Format EPSG
WGS84 (default) /polygon add <lat> <lon> 4326
UTM /polygon add utm <zone> <hem> <e> <n> Varies
Nigeria West Belt /polygon add nigeria-west <e> <n> 26391
Nigeria Mid Belt /polygon add nigeria-mid <e> <n> 26392
Nigeria East Belt /polygon add nigeria-east <e> <n> 26393
Minna / UTM 31N /polygon add minna-utm31 <e> <n> 26331
Minna / UTM 32N /polygon add minna-utm32 <e> <n> 26332

Complete Examples

Example 1: Create Polygon in WGS84

/polygon add 6.5 3.4 6.52 3.38 6.54 3.36 6.52 3.34

/polygon status

/total

/polygon export

Example 2: Mix Multiple Projections

/polygon add 6.5 3.4 // WGS84

/polygon add nigeria-mid 670000 1000000 // Nigeria Mid Belt

/polygon add utm 31 N 500000 720000 // UTM

/total

All coordinates are automatically converted to WGS84 for consistent calculations.

Example 3: Coordinate Conversion

/utm 6.5244 3.3792

→ Returns: Zone 31N: 463442.89E, 720912.45N


/nigeria mid 9.0765 7.3986

→ Returns: Nigeria Mid Belt coordinates

🌍

Example 4: Field Survey with GPS

New!

Walk to the first corner of your land:

/location // Get GPS coordinates

/add-location // Add to polygon


Walk to the second corner:

/location

/add-location


Repeat for all corners, then:

/total // Calculate land area

/polygon export // Save for records

Perfect for: Land surveyors, farmers, construction planners, property assessors

Technical Notes

Geolocation API

Uses browser's Geolocation API with high-accuracy mode enabled. GPS accuracy typically ±5-50 meters depending on device and conditions.

Troubleshooting:
  • If denied: Click the 🔒 icon in address bar → Allow location
  • If unavailable: Move outdoors, enable Location Services in device settings
  • If timeout: Wait and retry, or use manual coordinates
  • Localhost: May require allowing location for insecure origins in browser settings

Datum Transformations

Automatic conversion between WGS84 and Minna datums using approximate Molodensky transformation parameters.

Area Calculations

Uses the Shoelace formula with approximate degree-to-meter conversion (1° ≈ 111km). Suitable for small to medium polygons.

Coordinate Precision

Geographic coordinates: 6 decimal places (~0.1m precision). Projected coordinates: 2 decimal places (centimeter precision).

Supported Datums

  • WGS84 (World Geodetic System 1984)
  • Minna (Clarke 1880 RGS ellipsoid)
Start Using GeoAI Chat →