System Operational

Gateway: /api/go

Unified geospatial routing, spatial query, and layer management endpoint. Designed for high-throughput GIS workflows and real-time coordinate processing.

https://api.geoserver.io/api/go

Authentication

All requests to `/api/go` require a valid bearer token passed in the `Authorization` header.

Header Format

Authorization: Bearer gsk_live_••••••••••••••••
Content-Type: application/json
X-Geo-Version: 2.4

cURL Example

# Retrieve active layers
curl -X GET https://api.geoserver.io/api/go/layers \\
  -H "Authorization: Bearer YOUR_API_KEY"

Endpoints

Core geospatial operations available through the gateway.

GET /api/go/layers List available vector & raster layers 
params: {
  format: "geojson|wms|tms",
  bbox: "west,south,east,north",
  limit: 100
}
{
  "total": 42,
  "layers": [
    {
      "id": "us_census_tracts",
      "type": "vector",
      "crs": "EPSG:4326",
      "features": 18402
    }
  ]
}

Notes

  • Supports geojson, wms, tms output formats
  • Pagination via cursor parameter
  • Default limit: 50, max: 500
POST /api/go/query Execute spatial queries (WKT/GeoJSON) 
{
  "operation": "intersect",
  "target": "us_census_tracts",
  "geometry": {
    "type": "Polygon",
    "coordinates": [[...]]
  },
  "properties": ["state_fips", "population"]
}
{
  "query_id": "q_8f3a2b1c",
  "status": "completed",
  "results": {
    "type": "FeatureCollection",
    "features": [ ... ]
  }
}

Notes

  • Accepts GeoJSON or WKT geometry
  • Async processing for >10k features
  • Use query_id for long-running tasks
POST /api/go/process Batch geospatial processing 
{
  "job": "buffer",
  "distance": 500,
  "unit": "meters",
  "input": "layer://roads_highway",
  "output_format": "geojson"
}
{
  "job_id": "j_9x2m4p7q",
  "status": "processing",
  "eta_sec": 12,
  "poll_url": "/api/go/status/j_9x2m4p7q"
}

Notes

  • Supported jobs: buffer, clip, dissolve, centroid
  • Max input size: 250MB
  • Results expire after 24h

Rate Limits & Quotas

Fair usage policies ensure stable performance for all tiers.

Requests / Min

1,000

Standard tier limit

Burst Capacity

3,500

Short-window spikes

Max Payload

250MB

GeoJSON/WKT upload

Error Codes

Standard HTTP responses with geospatial context.

Code Status Description
400 Bad Request Invalid geometry, missing required fields, or malformed WKT/GeoJSON
401 Unauthorized Missing or expired API token. Refresh via dashboard.
429 Too Many Requests Rate limit exceeded. Retry after Retry-After header duration.
500 Internal Error Processing pipeline failure. Check X-Request-ID in logs.