https://github.com/opengeospatial/ogcapi-movingfeatures
OGC API - Moving Features
https://github.com/opengeospatial/ogcapi-movingfeatures
movingfeature movingobject ogc ogc-api ogc-movingfeature
Last synced: 2 months ago
JSON representation
OGC API - Moving Features
- Host: GitHub
- URL: https://github.com/opengeospatial/ogcapi-movingfeatures
- Owner: opengeospatial
- License: other
- Created: 2021-07-01T13:36:00.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2024-11-25T06:48:55.000Z (over 1 year ago)
- Last Synced: 2024-11-25T07:30:48.150Z (over 1 year ago)
- Topics: movingfeature, movingobject, ogc, ogc-api, ogc-movingfeature
- Language: CSS
- Homepage: https://ogcapi.ogc.org/movingfeatures/
- Size: 71.1 MB
- Stars: 8
- Watchers: 11
- Forks: 8
- Open Issues: 18
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# 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](https://ogcapi.ogc.org/movingfeatures/) Standard is part of the OGC API suite of standards.
[OGC API Standards](https://ogcapi.ogc.org) define modular API building blocks to spatially enable Web APIs in a consistent way.
[OpenAPI](http://openapis.org) is used to define the reusable API building blocks.
## Overview of OGC API - Moving Features - Part 1: Core
The summary of the OGC API – MovingFeatures – Part 1: Core is described in the below table.
| URL Path | Supported HTTP(s) Methods |
|-----------------------------------------------------------------|---------------------------|
| /collections/{c_id} | GET,DELETE,PUT |
| /collections/{c_id}/items | GET,POST |
| /collections/{c_id}/items/{mf_id} | GET,DELETE |
| /collections/{c_id}/items/{mf_id}/tgsequence | GET,POST |
| /collections/{c_id}/items/{mf_id}/tgsequence/{tg_id} | DELETE |
| /collections/{c_id}/items/{mf_id}/tgsequence/{tg_id}/{tg_query} | GET |
| /collections/{c_id}/items/{mf_id}/tproperties | GET,POST |
| /collections/{c_id}/items/{mf_id}/tproperties/{tp_name} | GET,POST,DELETE |
| /collections/{c_id}/items/{mf_id}/tproperties/{tp_name}/{tv_id} | DELETE |
MovingFeatures Collection Catalog
```
GET /collections
```
Retrieve catalogs of a 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}`.
MovingFeatures
MovingFeature
```
GET /collections/{collectionId}/items
```
Retrieve the 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}`.
TemporalGeometrySequence
```
GET /collections/{collectionId}/items/{mFeatureId}/tgsequence
```
Retrieve the movement data of the single moving feature with id `{mFeatureId}`.
```
POST /collections/{collectionId}/items/{mFeatureId}/tgsequence
```
Add movement data into the moving feature with id `{mFeatureId}`.
```
DELETE /collections/{collectionId}/items/{mFeatureId}/tgsequence/{tGeometryId}
```
Delete a single temporal geometry with id `{tGeometryId}`.
TemporalGeometryQuery
```
GET /collections/{collectionId}/items/{mFeatureId}/tgsequence/{tGeometryId}/distance
```
Get a time-to-distance curve of a temporal primitive geometry with id `{tGeometryId}`.
```
GET /collections/{collectionId}/items/{mFeatureId}/tgsequence/{tGeometryId}/velocity
```
Get a time-to-velocity curve of a temporal primitive geometry with id `{tGeometryId}`.
```
GET /collections/{collectionId}/items/{mFeatureId}/tgsequence/{tGeometryId}/acceleration
```
Get a time-to-acceleration curve of a temporal primitive geometry with id `{tGeometryId}`.
TemporalProperties
```
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 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}`.
```
DELETE /collections/{collectionId}/items/{mFeatureId}/tproperties/{tPropertyName}
```
Delete a single temporal property with id `{tPropertyName}`.
```
DELETE /collections/{collectionId}/items/{mFeatureId}/tproperties/{tPropertyName}/{tValueId}
```
Delete a single temporal primitive value with id `{tValueId}`.
## Building the Standard document
```
git clone https://github.com/opengeospatial/ogcapi-movingfeatures.git
cd ogcapi-movingfeatures
docker pull metanorma/metanorma
docker run -v "$(pwd)":/metanorma -v ${HOME}/.fontist/fonts/:/config/fonts metanorma/metanorma metanorma compile --agree-to-terms -t ogc -x html,pdf standard/document.adoc
```
## Using the Standard
An **OGC API - Moving Features - Part 1: Core** Standard is available:
* [HTML version](https://docs.ogc.org/is/22-003r3/22-003r3.html)
* [PDF version](https://docs.ogc.org/is/22-003r3/22-003r3.pdf)
Those who want to just see the endpoints and responses can explore the generic OpenAPI definition on Swagger:
* [OpenAPI (generated by Redocly)](https://developer.ogc.org/api/movingfeatures/index.html)
* [OpenAPI (examples on SwaggerHub)](https://app.swaggerhub.com/apis/OGC/ogcapi-movingfeatures-1-example-1/1.0.0)
There have been several implementations of the Standard, though they are against different versions of the evolving draft:
* [Implementation](https://github.com/opengeospatial/ogcapi-movingfeatures/blob/master/implementations.adoc)
## 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.
* [Moving Features Standards Working Group Charter](https://www.ogc.org/projects/groups/movfeatswg)
* [Open issues](https://github.com/opengeospatial/ogcapi-movingfeatures/issues)
* [Copy of License Language](https://github.com/opengeospatial/ogcapi-movingfeatures/blob/master/LICENSE)
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