GeoStream AI

GEOSTREAM WEB API / TECHNICAL REFERENCE

One spatial platform.
Many service contracts.

GeoStream exposes map, feature, tile, table, asset, live-event, automation and AI capabilities through documented HTTP endpoints. Each resource is resolved in its workspace before access is checked.

MapsFeaturesTilesDataLiveAI

SERVICE CATALOGUE

Services for maps,
data and operations.

Capability endpoints identify available workspaces, resources, operations and security mode. Every service has a version endpoint and returns only its published surface.

01WMS

Build a rendered map image from ordered vector and raster layers, then inspect features or sampled raster values at a map coordinate.

  • GetCapabilities · GetMap · GetFeatureInfo
  • CRS, BBOX, WIDTH, HEIGHT and LAYERS
  • CQL filter and view parameters for vector layers
OUTPUT   XML · PNG · JPEG · GeoJSON
02WFS

Discover feature schemas and read a published vector feature type with spatial and attribute-aware request parameters.

  • GetCapabilities · DescribeFeatureType · GetFeature
  • BBOX, CQL_FILTER, SRSNAME and property selection
  • Read-only profile; WFS-T is not implemented
OUTPUT   XML · GeoJSON · GML 3.2
03WMTS

Discover tile matrix sets and request a published tile by layer, style, matrix, row and column.

  • GetCapabilities · GetTile
  • Workspace-aware layer resolution
  • Tile matrix, row, column and style selection
OUTPUT   XML · PNG · JPEG · WebP · MVT
04XyzService

XyzService

Test XYZ

Request a raster or vector tile with a compact workspace, layer and z/x/y path for browser and client map libraries.

  • GetCapabilities · z / x / y tile route
  • Published zoom, CRS and bounds metadata
  • Gzip preserved for compressed vector tiles
OUTPUT   PNG · JPEG · WebP · MVT
05TableService

TableService

Test tables

Discover a published table, read its operation schema, then perform the allowed data action through explicit request models.

  • GetCapabilities · Describe · GetTable
  • Add · Update · Delete · Batch
  • Parameters validated against the published operation
OUTPUT   JSON capabilities · GeoJSON data
06AssetService

AssetService

Test assets

Discover published assets and retrieve a 3D tileset entry file, terrain metadata or an individual asset file by its relative path.

  • GetCapabilities · tileset.json · asset path
  • Tileset and terrain entry documents
  • Content-Type indicates JSON or binary handling
OUTPUT   JSON · glTF/GLB · 3D Tiles · Quantized Mesh
07AIService

AIService

Test AI

Discover the selected AI layer’s input and output capabilities, then send a request to its provider through the secured GeoStream boundary.

  • GetCapabilities · POST selected AI item
  • Text, image, audio, video, document and structured data inputs
  • Text, image, audio and file output representations
OUTPUT   Provider response Content-Type
08SocketService

SocketService

Discover named channels, open an authorized WebSocket connection and publish a structured message to an allowed channel.

  • GetCapabilities · Connect · Publish
  • Named channel and workspace resolution
  • Real-time fan-out to connected clients
OUTPUT   JSON capabilities · WebSocket messages
09RunnableService

RunnableService

Inspect runnable plugin capabilities and execute an allowed operation with a typed JSON request model.

  • GetCapabilities · Run
  • Runnable ID, method and declared parameters
  • Request and response represented as JSON
OUTPUT   JSON

OPERATION REFERENCE

Request in.
Response out.

Each service begins with a capability document or JSON capability model. Use it to discover valid layers, items, fields, operations and output formats before sending a data request.

ServicePrimary operationsResponse formats
WMSGetCapabilitiesGetMapGetFeatureInfoXML · PNG · JPEG · GeoJSON
WFSGetCapabilitiesDescribeFeatureTypeGetFeatureXML · GeoJSON · GML 3.2
WMTSGetCapabilitiesGetTileXML · PNG · JPEG · WebP · MVT
XyzServiceGetCapabilitiesz/x/y tileJSON · PNG · JPEG · WebP · MVT
TableServiceDescribeGetTableAddUpdateDeleteBatchJSON · GeoJSON
AssetServiceGetCapabilitiestileset.jsonasset pathJSON · binary assets
SocketServiceConnectPublishJSON · WebSocket message
RunnableServiceGetCapabilitiesRunJSON
AIServiceGetCapabilitiesPOST itemProvider response type

WORKSPACE SECURITY

One access decision
for every request.

01

Public

Published resources can be requested without an authentication header.

02

API key

Requests use the workspace’s X-API-Key header.

03

Bearer token

Requests use Authorization: Bearer <token>.

04

Capability first

Capability output identifies the workspace and its security mode before a client requests data.

05

Scoped resources

Items resolve to one workspace, preserving the resource and its access boundary together.

06

Typed contracts

Request parameters and response formats are exposed through service-specific contracts.

BUILD WITH GEOSTREAM

Discover the contract.
Build with confidence.

Open the product