A Typescript library for interacting with OGC-compliant services

ogc-client is a Typescript library which implements several OGC standards and will help you interact with them in a user-friendly and consistent way.

Documentation and live demo here!

The following standards are partially implemented:

• WMS - Web Map Service
• WFS - Web Feature Service
• WMTS - Web Map Tile Service
• OGC API (Records and Features)
• OGC API — Connected Systems (CSAPI)
• TMS - Tile Map Service
• STAC API - SpatioTemporal Asset Catalog

1. ogc-client will abstract the service version so you don't have to worry about it
2. ogc-client will handle XML so you only have to deal with native Javascript objects
3. ogc-client will hide the complexity of OGC standards behind straightforward APIs
4. ogc-client will run heavy tasks in a worker to avoid blocking the main thread
5. ogc-client will keep a persistent cache of operations to minimize requests and processing
6. ogc-client will tell you if a service is not usable for CORS-related issues

To install ogc-client, run:

$ npm install --save @camptocamp/ogc-client

To use, import API symbols like so:

import { WmsEndpoint, WfsEndpoint, StacEndpoint } from '@camptocamp/ogc-client';

Note: if you want to disable web worker usage, for example to solve issues with the Referer header on outgoing requests, use:

import { enableFallbackWithoutWorker } from '@camptocamp/ogc-client';

enableFallbackWithoutWorker();

All processing will be done on the main thread after this call, including HTTP requests.

The @camptocamp/ogc-client NPM package is updated on every commit on the main branch under the @dev tag. To use it:

$ npm install --save @camptocamp/ogc-client@dev

A provided application containing the documentation and demo is located in the app folder. To start it locally, clone the repository and run the following commands:

$ npm install
$ cd app
$ npm install
$ npm start

The app is based on Vue.js and will showcase most features implemented in the library. You will need to supply it with valid OGC service urls.

See the examples/ directory for more complete examples, including:

• examples/stac-query.js - Full STAC API query example with spatial and temporal filters

Run examples with:

npm run build
node examples/stac-query.js

The library includes support for the OGC API — Connected Systems standard (Part 1: Feature Resources, Part 2: Dynamic Data). This standard extends the OGC API family into the IoT/sensor domain, providing a REST API for discovering and querying sensor systems, deployments, datastreams, observations, commands, and related resources.

CSAPI is available as an opt-in sub-path export, meaning it is only included in your production bundle if you explicitly import it.

Nothing changes. Use the library exactly as before:

import { OgcApiEndpoint, WmsEndpoint } from '@camptocamp/ogc-client';

CSAPI code will not be included in your bundle.

Add a second import from the CSAPI sub-path:

import { OgcApiEndpoint } from '@camptocamp/ogc-client';
import { createCSAPIBuilder } from '@camptocamp/ogc-client/csapi';

const endpoint = new OgcApiEndpoint('https://api.example.org');

if (await endpoint.hasConnectedSystems) {
  const builder = await createCSAPIBuilder(endpoint, 'weather-stations');
  const systemsUrl = builder.getSystems({ limit: 50 });
  const dsUrl = builder.getDataStreams();
}

The createCSAPIBuilder() factory function connects to the endpoint and discovers available CSAPI resources. The returned CSAPIQueryBuilder provides methods for all 9 resource types: systems, deployments, sampling features, procedures, properties, datastreams, observations, control streams, and commands.

The OGC Connected Systems standard is large — it spans 9 resource types across 2 specification parts with multiple response formats (GeoJSON, SWE Common, SensorML). By isolating CSAPI behind a sub-path export, users who only need WMS/WFS/WMTS/etc. don't pay the bundle-size cost for functionality they're not using. Modern bundlers (Webpack 5+, Vite, Rollup, esbuild) handle this automatically.