Spatial Intelligence API

Integrate spatial intelligence into your applications with our NLP-powered API.

Overview

The Spatial Intelligence API extracts named entities (people, organizations, locations) from text and returns enriched GeoJSON with geocoded coordinates.

Base URL

Authentication

All API requests require an API key passed in the X-API-Key header.

curl -X POST https://dev.spatial.kkrl.co.uk/flow/enrich \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"id": "req-001", "text": "Meeting in London"}]}'

Obtaining an API Key

Register at https://dev.spatial.kkrl.co.uk/register to obtain an API key. Keys are tied to a subscription tier that determines your rate limits and quotas.

Endpoints

Health Check

Check if the API is operational. No authentication required.

GET /flow/health

Response:

{
  "status": "healthy",
  "service": "nifi-flow",
  "timestamp": "2026-01-04T12:00:00Z"
}

Entity Enrichment

Extract named entities from text and return enriched GeoJSON with geocoded locations.

POST /flow/enrich
Content-Type: application/json
X-API-Key: YOUR_API_KEY

Request Body:

{
  "items": [
    {"id": "req-001", "text": "Meeting with John Smith at Google in London."}
  ],
  "options": {
    "model": "hybrid"
  }
}

Response (GeoJSON):

{
  "type": "FeatureCollection",
  "features": [
    {
      "type": "Feature",
      "geometry": {
        "type": "Point",
        "coordinates": [-0.1276, 51.5074]
      },
      "properties": {
        "name": "London",
        "entity_type": "LOC",
        "confidence": 0.97
      }
    }
  ],
  "metadata": {
    "entities": [
      {"text": "John Smith", "label": "PER"},
      {"text": "Google", "label": "ORG"},
      {"text": "London", "label": "LOC"}
    ]
  }
}

Entity Types

Rate Limits

Rate limits are enforced per API key based on your subscription tier.

Rate Limit Headers

All responses include rate limit information:

X-RateLimit-Limit: 10000
X-RateLimit-Remaining: 9500
X-RateLimit-Reset: 1704369600

Code Examples

Python

import requests

response = requests.post(
    "https://dev.spatial.kkrl.co.uk/flow/enrich",
    headers={
        "X-API-Key": "YOUR_API_KEY",
        "Content-Type": "application/json"
    },
    json={
        "items": [{"id": "req-001", "text": "Meeting in London with John Smith"}],
        "options": {"model": "hybrid"}
    }
)

data = response.json()
# GeoJSON response with entities in metadata
for entity in data["metadata"]["entities"]:
    print(f"{entity['label']}: {entity['text']}")

JavaScript

const response = await fetch('https://dev.spatial.kkrl.co.uk/flow/enrich', {
  method: 'POST',
  headers: {
    'X-API-Key': 'YOUR_API_KEY',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    items: [{ id: 'req-001', text: 'Meeting in London with John Smith' }],
    options: { model: 'hybrid' }
  })
});

const data = await response.json();
// GeoJSON response with entities in metadata
data.metadata.entities.forEach(e => console.log(`${e.label}: ${e.text}`));

cURL

curl -X POST https://dev.spatial.kkrl.co.uk/flow/enrich \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items": [{"id": "req-001", "text": "Meeting in London with John Smith"}]}' | jq .

Error Codes

Error Response Format

{
  "error": "Rate limit exceeded",
  "retry_after": 60
}

Support

• Email: support@kkrl.co.uk
• Website: https://kkrl.co.uk