Spatial API — Aevum Encyclopedia

Capabilities

Spatial-First Knowledge Engine

Built for researchers, developers, and data scientists who need precise geographic context attached to semantic knowledge.

🌐

Proximity & Radius Queries

Find articles, entities, or historical events within a dynamic radius of any coordinate. Supports km, miles, and nautical miles.

🔗

Spatial Joins & Topology

Link geographic boundaries (countries, regions, watersheds) to knowledge entries using OGC-compliant spatial relationship operators.

🗺️

Real-time Geo-Indexing

New articles are automatically geotagged and indexed within 15 seconds. Supports WGS84, ETRS89, and custom projections.

📐

3D Coordinate Support

Elevation, depth, and atmospheric layer indexing for geological, oceanographic, and astronomical knowledge domains.

🧩

Vector & Raster Tiles

Generate styled Mapbox/TileJSON compatible vector layers directly from encyclopedia knowledge graphs for custom mapping apps.

⚡

Sub-50ms Latency

Edge-cached spatial index with global CDN distribution. Optimized for high-throughput batch and real-time streaming queries.

Try It

See It in Action

Execute a proximity search around coordinates 48.8566° N, 2.3522° E (Paris) to fetch historical and cultural entries.

spatial-query.curl

# Query articles within 5km of Paris centercurl https://api.aevum.com/v2/spatial/nearest \
    -H "Authorization: Bearer YOUR_API_KEY" \
    -H "Content-Type: application/json" \
    -d '{
  "lat": 48.8566,
  "lon": 2.3522,
  "radius_km": 5,
  "categories": ["history", "architecture", "culture"],
  "limit": 3
}'Response (200 OK)
{  "results": [    { "id": "ae-88421", "title": "Eiffel Tower", "distance_m": 1240, "tags": ["landmark", "1889"] },    { "id": "ae-11903", "title": "Seine River Floods", "distance_m": 890, "tags": ["history", "environment"] },    { "id": "ae-44201", "title": "Louvre Museum", "distance_m": 2100, "tags": ["art", "institution"] }  ],  "query_time_ms": 38}

Reference

Core Endpoints

Production-ready REST APIs with consistent error handling, pagination, and OpenAPI 3.0 compliance.

Method	Endpoint	Description
GET	/v2/spatial/nearest	Retrieve knowledge entries within a geographic radius
POST	/v2/spatial/bounds	Query entries intersecting a custom polygon or bounding box
GET	/v2/spatial/tiles/{z}/{x}/{y}	Stream vector tiles compatible with MapLibre/Mapbox
GET	/v2/spatial/elevation/{lat}/{lon}	Fetch topographic height and depth data for coordinates
POST	/v2/spatial/batch	Process up to 10,000 coordinate queries in a single request

Integrate

Official SDKs & Tools

Ship faster with maintained client libraries, Postman collections, and CLI utilities.

🐍

Python

pip install aevum-spatial

⚡

TypeScript / JS

npm install @aevum/spatial-sdk

🦀

Rust

cargo add aevum-spatial

🔨

CLI Tool

aevum spatial query --help

Geospatial Intelligence for Knowledge at Scale