/ogcapi-movingfeatures

OpenAPI for MovingFeatures

Primary LanguageHTMLOtherNOASSERTION

OGC API - Moving Features

This GitHub repository contains the OGC API - Moving Features for providing query and access to geospatial data and services, especially movement data.

The OGC API - Moving Features standard is part of the OGC API suite of standards. OGC API standards define modular API building blocks to spatially enable Web APIs in a consistent way. OpenAPI is used to define the reusable API building blocks.

Overview of OGC API - Moving Features - Part 1: Features extension

Catalog of Moving Feature Collection

GET /collections

Retrieve catalogs of moving features collection.

POST /collections

Register metadata about a collection of moving features.

GET /collections/{collectionId}

Access metadata about the collection with id collectionId.

DELETE /collections/{collectionId}

The collection catalog with id collectionId and including metadata and moving features SHOULD be deleted.

PUT /collections/{collectionId}

Replace metadata about the collection with id collectionId.

MovingFeature

GET /collections/{collectionId}/items

Retrieve moving feature collection to access the static information of the moving feature by simple filtering and a limit.

POST /collections/{collectionId}/items

Insert a set of moving features or a moving feature into a collection with id collectionId.

GET /collections/{collectionId}/items/{mFeatureId}

Access the static data of the moving feature with id mFeatureId. The static data of a moving feature is not included temporal geometries and temporal properties.

DELETE /collections/{collectionId}/items/{mFeatureId}

Delete a single moving feature with id mFeatureId and including temporal geometries and properties.

TemporalGeometry

GET /collections/{collectionId}/items/{mFeatureId}/tgeometries

Retrieve the movement data of the single moving feature with id mFeatureId.

POST /collections/{collectionId}/items/{mFeatureId}/tgeometries

Add movement data into the moving feature with id mFeatureId.

DELETE /collections/{collectionId}/items/{mFeatureId}/tgeometries/{tGeometryId}

Delete a singe temporal geometry with id tGeometryId.

TemporalProperty

GET /collections/{collectionId}/items/{mFeatureId}/tproperties

Retrieve the static information of the temporal property data that included a single moving feature with id mFeatureId. The static data of a temporal property is not included temporal values (property values).

POST /collections/{collectionId}/items/{mFeatureId}/tproperties

Add temporal property data into a moving feature with id mFeatureId.

GET /collections/{collectionId}/items/{mFeatureId}/tproperties/{tPropertyName}

Retrieve a temporal values with a specified name tPropertyName of temporal property.

POST /collections/{collectionId}/items/{mFeatureId}/tproperties/{tPropertyName}

Add more temporal values data into a temporal property with id tPropertyName.

Using the standard

A draft of the OGC API - Moving Features - Part 1: Features extension standard is available:

Those who want to just see the endpoints and responses can explore the generic OpenAPI definition on Swagger:

There have been several implementations of the draft standard, though they are against different versions of the evolving draft:

  • T.B.D

Contributing

The contributor understands that any contributions, if accepted by the OGC Membership, shall be incorporated into OGC API - Moving Features standards documents and that all copyright and intellectual property shall be vested to the OGC.

The OGC's Moving Features Standards Working Group (SWG) is the group at OGC responsible for the stewardship of the standard, but is working to do as much work in public as possible.

Pull Requests from contributors are welcomed. However, please note that by sending a Pull Request or Commit to this GitHub repository, you are agreeing to the terms in the Observer Agreement https://portal.ogc.org/files/?artifact_id=92169