Services

wis2box provides a number of data access services and mechanisms in providing data to users, applications and beyond.

Discovery Catalogue

The discovery catalogue is powered by OGC API - Records and is located at http://localhost/oapi/collections/discovery-metadata

The OGC API endpoint is located by default at http://localhost/oapi. The discovery catalogue endpoint is located at http://localhost/oapi/collections/discovery-metadata

Below are some examples of working with the discovery catalogue.

Note

  • adding f=json to URLs will provide the equivalent JSON/GeoJSON representations

  • query predicates (datetime, bbox, q, etc.) can be combined

See also

Data access

Data API

wis2box data is made available via OGC API - Features and is located at http://localhost/oapi standards.

The OGC API endpoint is located by default at http://localhost/oapi

Below are some examples of working with the discovery catalogue.

Note

  • the examples below use the mw-mw_met_centre.data.core.weather.surface-based-observations.synop collection as described in the Quickstart with test data. For other dataset collections, use the same query patterns below, substituting the collection id accordingly

Note

  • adding f=json to URLs will provide the equivalent JSON/GeoJSON representations

  • query predicates (datetime, bbox, q, etc.) can be combined

See also

Data access

Management API

The Data API also provides a management API to manage resources in alignment with OGC API - Features - Part 4: Create, Replace, Update and Delete, which is available at http://localhost/oapi/admin.

SpatioTemporal Asset Catalog (STAC)

The wis2box SpatioTemporal Asset Catalog (STAC) endpoint can be found at:

http://localhost/stac

…providing the user with a crawlable catalogue of all data on a wis2box.

Web Accessible Folder (WAF)

The wis2box Web Accessible Folder publich bucket endpoint can be found at:

http://localhost/data/

…providing the user with a crawlable online folder of all data on a wis2box.

Broker

The wis2box broker is powered by MQTT and can be found at:

mqtt://everyone:everyone@localhost:1883

mqtt://localhost:1883

…providing a Pub/Sub capability for event driven subscription and access.

Note

The everyone user is defined by default for public readonly access (origin/#) as per WIS2 Node requirements.

Adding services

wis2box’s architecture allows for additional services as required by adding Docker containers. Examples of additional services include adding a container for a samba share or FTP server. Key considerations for adding services:

  • Storage buckets can be found at http://minio:9000

  • Elasticsearch indexes can be found at the container/URL http://elasticsearch:9200