Features - GeoJSON-LD

speccustomimplcandidate

Kodierung von Features als GeoJSON-LD.

Umfang

Der Baustein Features - GeoJSON-LD ergänzt die GeoJSON-Ausgabe um die folgenden Angaben:

  • Einen JSON-LD-Context, auf den aus den GeoJSON-Ausgaben der Ressourcen Features und
    Feature verwiesen wird. Der Context kann extern liegen oder über die API bereitgestellt
    werden. Dafür muss im ldproxy-Datenverzeichnis der Context unter dem relativen Pfad
    json-ld-contexts/{apiId}/{collectionId}.jsonld liegen. Statt {collectionId}.jsonld kann
    über contextFileName auch ein anderer Dateiname konfiguriert werden. Der Context muss
    mindestens die folgenden Einträge enthalten:
    • "@version": 1.1
    • "geojson": "https://purl.org/geojson/vocab#"
    • "FeatureCollection": "geojson:FeatureCollection"
    • "features": { "@id": "geojson:features", "@container": "@set" }
    • "Feature": "geojson:Feature"
    • "type": "geojson:type"
    • "properties": "@nest"
  • Zusätzlich zur Eigenschaft "type", die in GeoJSON fest mit "Feature" belegt ist, wird "@type" als weitere
    Eigenschaft mit den in der Konfiguration angegeben Werten ergänzt.
  • Zusätzlich zur Eigenschaft "id", wird "@id" als weitere Eigenschaft auf Basis des Wertes aus "id" und dem in
    der Konfiguration angegeben URI-Template ergänzt. Dabei wird {{serviceUrl}} durch die
    Landing-Page-URI der API, {{collectionId}} durch die Collection-ID und {{featureId}}
    durch den Wert von "id" ersetzt.

Pfad-Parameter

NameRessourcenBeschreibung
collectionId
JSON-LD Context
Der Identifikator der Feature Collection.

Konfiguration

Optionen

NameDefaultBeschreibungTypSeit
buildingBlock
Immer GEO_JSON_LD.
string
v2.0
enabled
false
Soll der Baustein aktiviert werden?
boolean
v2.0
contextFileName
null
Dateiname des JSON-LD-Context-Dokuments im Verzeichnis api-resources/json-ld-contexts/{apiId}.
string
v2.0
context
null
Die URI des JSON-LD-Context-Dokuments. Dabei wird {{serviceUrl}} durch die Landing-Page-URI der API und {{collectionId}} durch die Collection-ID ersetzt. Sofern der Context nicht extern liegt, sollte der Wert "/collections//context" sein.
string
v2.0
types
[ "geojson:Feature" ]
Der Wert von "@type" bei den Features der Collection. Dabei wird {{type}} durch den Wert der Property mit role: TYPE ersetzt.
array
v2.0
idTemplate
Der Wert von "@id" bei den Features der Collection. Dabei wird {{serviceUrl}} durch die Landing-Page-URI der API, {{collectionId}} durch die Collection-ID und {{featureId}} durch den Wert von "id" ersetzt.
string
v2.0

Beispiele


- buildingBlock: GEO_JSON_LD
  enabled: true
  context: '{{serviceUrl}}/collections/{{collectionId}}/context'
  types:
  - geojson:Feature
  - sosa:Observation
  idTemplate: '{{serviceUrl}}/collections/{{collectionId}}/items/{{featureId}}'