Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
36 changes: 21 additions & 15 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,17 +1,23 @@
# API Design Rules Module: Geospatial

## Deze handreiking

### Publicatieversie

https://gitdocumentatie.logius.nl/publicatie/api/mod-geo

### Werkversie

https://logius-standaarden.github.io/API-mod-geospatial/

## Issues

Issues mogen bij het Kennisplatform API's worden ingediend.

https://github.com/Geonovum/KP-APIs/issues
### Links

- NLgov REST API Design Rules (ADR)
- [Formele standaard](https://forumstandaardisatie.nl/open-standaarden/rest-api-design-rules)
- [Gepubliceerde versie](https://gitdocumentatie.logius.nl/publicatie/api/adr/)
- [Werkversie](https://logius-standaarden.github.io/API-Design-Rules/)
- [Repository](https://github.com/Logius-standaarden/API-Design-Rules)

- NLgov Assurance profile for OAuth 2.0 (OAuth)
- [Formele standaard](https://forumstandaardisatie.nl/open-standaarden/nl-gov-assurance-profile-oauth-20)
- [Gepubliceerde versie](https://gitdocumentatie.logius.nl/publicatie/api/oauth/)
- [Werkversie](https://logius-standaarden.github.io/OAuth-NL-profiel/)
- [Repository](https://github.com/Logius-standaarden/OAuth-NL-profiel)

- NLgov Assurance profile for OpenID Connect 1.0 (OIDC)
- [Formele standaard](https://forumstandaardisatie.nl/open-standaarden/nl-gov-assurance-profile-oidc)
- [Gepubliceerde versie](https://gitdocumentatie.logius.nl/publicatie/api/oidc/)
- [Werkversie](https://logius-standaarden.github.io/OIDC-NLGOV/)
- [Repository](https://github.com/Logius-standaarden/OIDC-NLGOV)

Het **Beheermodel** voor deze standaarden is gepubliceerd op: https://gitdocumentatie.logius.nl/publicatie/api/beheermodel/
6 changes: 3 additions & 3 deletions sections/abstract.md
Original file line number Diff line number Diff line change
@@ -1,15 +1,15 @@
This document is part of the *Nederlandse API Strategie*.

The Nederlandse API Strategie consists of [a set of distinct documents](https://www.geonovum.nl/themas/kennisplatform-apis#APIStrategie).
The Nederlandse API Strategie consists of [a set of distinct documents](https://developer.overheid.nl/communities/kennisplatform-apis/#api-strategie).

| Status | Description & Link |
|------------------|------------------------------------------------------------------------------------------------------------------|
| Informative | [Inleiding NL API Strategie](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Inleiding/) |
| Informative | [Architectuur NL API Strategie](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Architectuur/) |
| Informative | [Gebruikerswensen NL API Strategie](https://geonovum.github.io/KP-APIs/API-strategie-algemeen/Gebruikerswensen/) |
| Normative | [API Design Rules (ADR v2.0)](https://gitdocumentatie.logius.nl/publicatie/api/adr/2.0/) |
| Normative | [NLgov REST API Design Rules (ADR v2.2)](https://gitdocumentatie.logius.nl/publicatie/api/adr/2.2/) |
| Normative | [Open API Specification (OAS 3.0)](https://spec.openapis.org/oas/v3.0.1.html) |
| Normative | [NL GOV OAuth profiel](https://gitdocumentatie.logius.nl/publicatie/api/oauth/) |
| Normative | [NLgov Assurance profile for OAuth 2.0](https://gitdocumentatie.logius.nl/publicatie/api/oauth/) |
| Normative | [Digikoppeling REST API koppelvlak specificatie](https://gitdocumentatie.logius.nl/publicatie/dk/restapi/) |
| Normative module | [GEO module v1.0](https://gitdocumentatie.logius.nl/publicatie/api/mod-geo/1.0.2/) |

Expand Down
6 changes: 3 additions & 3 deletions sections/request-response.md
Original file line number Diff line number Diff line change
Expand Up @@ -14,7 +14,7 @@ The Geospatial Module is focused on JSON-based encoding of data. However, consid

## GeoJSON

[[rfc7946]] describes the GeoJSON format, including a convention for describing 2D geometric objects in CRS84 (OGC:CRS84). In the Geospatial module of the API strategy we adopt the GeoJSON conventions for describing geometry objects. The convention is extended to allow alternative projections.
[[RFC7946]] describes the GeoJSON format, including a convention for describing 2D geometric objects in CRS84 (OGC:CRS84). In the Geospatial module of the API strategy we adopt the GeoJSON conventions for describing geometry objects. The convention is extended to allow alternative projections.
The GeoJSON conventions and extensions described in this module apply to both geometry passed in input parameters and responses.

<aside class="note">
Expand Down Expand Up @@ -167,7 +167,7 @@ In case a REST API shall comply to the OGC API Features specification for creati
<dl>
<dt>Statement</dt>
<dd>
For representing geometric information in an API, use the convention for describing geometry as defined in the GeoJSON format [[rfc7946]]. Support GeoJSON as described in <a href="https://docs.ogc.org/DRAFTS/20-002r1.html">OGC API Features part 4</a>, but note that this standard is still in development.
For representing geometric information in an API, use the convention for describing geometry as defined in the GeoJSON format [[RFC7946]]. Support GeoJSON as described in <a href="https://docs.ogc.org/DRAFTS/20-002r1.html">OGC API Features part 4</a>, but note that this standard is still in development.
<aside class="example">
POST feature
<pre><code class="json">
Expand Down Expand Up @@ -284,7 +284,7 @@ In case a REST API shall comply to the OGC API Features specification, e.g. for
<dl>
<dt>Statement</dt>
<dd>
For representing 2D geometric information in an API response, use the convention for describing geometry as defined in the GeoJSON format [[rfc7946]]. Support GeoJSON as described in OGC API Features <a href="https://docs.ogc.org/is/17-069r3/17-069r3.html#_requirements_class_geojson">Requirements class 8.3</a> [[ogcapi-features-1]].
For representing 2D geometric information in an API response, use the convention for describing geometry as defined in the GeoJSON format [[RFC7946]]. Support GeoJSON as described in OGC API Features <a href="https://docs.ogc.org/is/17-069r3/17-069r3.html#_requirements_class_geojson">Requirements class 8.3</a> [[ogcapi-features-1]].
<aside class="example">
Feature
<pre><code class="json">
Expand Down
Loading