Geospatial Agent

12 location-aware endpoints for geocoding, routing, weather, flights, elevation, POI discovery, and more. Each call is a real x402 micropayment ($0.003–$0.05 USDC).

How to call endpoints

All geospatial endpoints are POST. Use the helper script:

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/ENDPOINT '{"key":"value"}'

Workflow strategies

Travel planning — geocode the destination, get weather, find nearby POI, calculate routes between stops, check flight status if flying.

Logistics / delivery — use distance-matrix for fleet dispatch, isochrone for coverage areas, nearby for pickup/drop points.

Location intelligence — geocode an address, get elevation and timezone, find nearby amenities, pull census demographics (pair with the deep-research-x402 skill).

Flight tracking — get flight-status by flight number, airport-info for gate/terminal details.

Always return coordinates, distances, and durations in human-readable format alongside raw numbers.

Available endpoints (12 tools)

Geocoding

Geocode — $0.005 Convert an address or place name to lat/lng coordinates.

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/geocode '{"address":"1600 Pennsylvania Ave, Washington DC"}'

Reverse Geocode — $0.005 Convert lat/lng coordinates to a street address.

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/reverse-geocode '{"lat":38.8977,"lng":-77.0365}'

Routing & Distance

Route — $0.01 Turn-by-turn directions between waypoints with distance and duration. Supports driving, cycling, and walking.

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/route '{"origin":"Los Angeles, CA","destination":"San Francisco, CA","mode":"driving"}'

Distance Matrix — $0.02 Distance and duration matrix between multiple origin-destination pairs. Useful for fleet dispatch and nearest-facility analysis.

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/distance-matrix '{"origins":["Los Angeles, CA","San Diego, CA"],"destinations":["San Francisco, CA","Sacramento, CA"]}'

Isochrone — $0.02 Reachability polygon — the area reachable within N seconds from a point. Great for delivery zones and coverage mapping.

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/isochrone '{"lat":34.0522,"lng":-118.2437,"seconds":1800}'

Weather

Current Weather — $0.01 Current conditions and 24-hour forecast at any coordinates. Temperature, wind, humidity, precipitation.

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/weather '{"lat":34.0522,"lng":-118.2437}'

Weather Alerts — $0.01 Severe weather alerts at coordinates — storms, floods, heat, wind advisories.

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/weather-alerts '{"lat":34.0522,"lng":-118.2437}'

Aviation

Flight Status — $0.05 Real-time flight status including departure/arrival times, gates, aircraft type, and delays.

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/flight-status '{"flight":"AA100"}'

Airport Info — $0.03 Airport details — location, timezone, elevation, IATA/ICAO codes, country.

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/airport-info '{"iata":"LAX"}'

Discovery & Terrain

Nearby POI — $0.005 Find points of interest near coordinates — restaurants, gas stations, hospitals, parks, and more.

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/nearby '{"lat":34.0522,"lng":-118.2437,"type":"restaurant"}'

Elevation — $0.003 Terrain elevation at one or more coordinates. SRTM 30m resolution.

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/elevation '{"coordinates":[{"lat":34.0522,"lng":-118.2437}]}'

Timezone — $0.003 Country and timezone info at coordinates.

bash {baseDir}/scripts/geo.sh POST /api/v1/geo/timezone '{"lat":34.0522,"lng":-118.2437}'

Cost reference

Data sourced from OpenStreetMap, Open-Meteo, AeroDataBox, and OpenRouteService.