Features - HTMLspecstableimplmature
Kodierung von Features als HTML.
Umfang
Konformitätsklassen
Der Baustein implementiert für die Ressourcen Features und Feature alle Vorgaben der Konformitätsklasse "HTML" von OGC API - Features - Part 1: Core 1.0.
Konfiguration
Optionen
Name | Default | Beschreibung | Typ | Seit |
---|---|---|---|---|
buildingBlock | Immer FEATURES_HTML . | string | v2.0 | |
enabled | true | Soll der Baustein aktiviert werden? | boolean | v2.0 |
mapPosition | AUTO | Mögliche Werte sind TOP , RIGHT und AUTO . AUTO ist der Default, es wählt automatisch TOP wenn verschachtelte Objekte gefunden werden und sonst RIGHT . | string | v2.0 |
featureTitleTemplate | {{id}} | Steuert, wie der Titel eines Features in der HTML-Ausgabe gebildet wird. Standardmäßig ist der Titel der Identifikator. In der Angabe können über die Angabe des Attributnamens in doppelt-geschweiften Klammern Ersetzungspunkte für die Attribute des Features verwendet werden. Es können nur Attribute verwendet werden, die nur einmal pro Feature vorkommen können. Neben einer direkten Ersetzung mit dem Attributwert können auch Filter angewendet werden. Ist ein Attribut null , dann wird der Ersetzungspunkt durch einen leeren String ersetzt. | string | v2.0 |
transformations | {} | Property-Transformationen erfolgen bei der Aufbereitung der Daten für die Rückgabe über die API. Die Datenhaltung selbst bleibt unverändert. Alle Filterausdrücke (siehe queryables in Features) wirken unabhängig von etwaigen Transformationen bei der Ausgabe und müssen auf der Basis der Werte in der Datenhaltung formuliert sein - die Transformationen sind i.A. nicht umkehrbar und eine Berücksichtigung der inversen Transformationen bei Filterausdrücken wäre kompliziert und nur unvollständig möglich. Insofern sollten Eigenschaften, die queryable sein sollen, möglichst bereits in der Datenquelle transformiert sein. Eine Ausnahme sind typischerweise Transformationen in der HTML-Ausgabe, wo direkte Lesbarkeit i.d.R. wichtiger ist als die Filtermöglichkeit. | object | v2.0 |
mapClientType | MAP_LIBRE | Auswahl des in den Ressourcen "Features" und "Feature" zu verwendenden Map-Clients. Der Standard ist MapLibre GL JS. Alternativ wird für 3D-Daten auch CESIUM unterstützt, wenn Features - glTF aktiviert ist. | string | v2.0 |
style | DEFAULT | Ein Style im Style-Repository, der standardmäßig in Karten mit den Features verwendet werden soll. Der Style sollte alle Daten abdecken. Bei DEFAULT wird der defaultStyle aus dem HTML-Baustein verwendet. Handelt es sich bei dem Kartenclient um MapLibre, muss der Style im Mapbox-Format verfügbar sein. Wenn der Style auf NONE gesetzt ist, wird ein einfacher Wireframe Style mit OpenStreetMap als Basiskarte verwendet. Handelt es sich bei dem Kartenclient um Cesium, muss der Style im 3D-Tiles-Format verfügbar sein. Ist der Style auf NONE gesetzt, wird das Standard 3D Tiles Styling verwendet. | string | v2.0 |
removeZoomLevelConstraints | false | Bei true werden aus dem in style angegebenen Style die minzoom - und maxzoom -Angaben bei den Layer-Objekten entfernt, damit die Features in allen Zoomstufen angezeigt werden. Diese Option sollte nicht gewählt werden, wenn der Style unterschiedliche Präsentationen je nach Zoomstufe vorsieht, da ansonsten alle Layer auf allen Zoomstufen gleichzeitig angezeigt werden. | boolean | v2.0 |
geometryProperties | [] | Diese Option wirkt nur für CesiumJS als Map-Client. Als Standard wird die im Provider als PRIMARY_GEOMETRY identifizierte Geometrie für die Darstellung in der Karte verwendet. Diese Option ermöglicht es, mehrere Geometrieeigenschaften anzugeben in einer Liste anzugeben. Die erste Geometrieeigenschaft, die für ein Feature gesetzt ist, wird dabei verwendet. | array | v2.0 |
maximumPageSize | null | Mit dieser Option kann für die HTML-Ausgabe ein eigener Maximalwert für den Parameter limit gesetzt werden. Sofern kein Wert angegeben ist, so gilt der Wert aus dem Baustein "Features Core". Bei der Verwendung von CesiumJS als Map-Client wird ein Wert von 100 empfohlen. | number | v2.0 |
propertyTooltips | true | Bei true werden auf der Seite für einzelne Items für jedes Property mit einer Beschreibung im Provider-Schema Info-Icons mit einem Tooltip angezeigt. | boolean | v2.0 |
propertyTooltipsOnItems | false | Bei true werden auf der Seite für Items für jedes Property mit einer Beschreibung im Provider-Schema Info-Icons mit einem Tooltip angezeigt. | boolean | v2.0 |
defaultProfiles | {} | Erlaubt es, den Standardwert des Profile-Parameters für ein bestimmtes Format zu ändern. Der Schlüssel ist die Art des Profils, z. B. rel oder val . Der Wert ist der Standardprofilwert, z. B. rel-as-uri oder val-as-title . Wenn nur einige oder keine Profilarten festgelegt sind, gelten die Anwendungsstandards. | object | v4.2 |
Beispiele
Beispiel für die Angaben in der Konfigurationsdatei für die gesamte API (aus der API für Topographische Daten in Daraa, Syrien):
- buildingBlock: FEATURES_HTML
enabled: true
style: 'topographic-with-basemap'
Beispiel für die Angaben in der Konfigurationsdatei für eine Feature Collection:
- buildingBlock: FEATURES_HTML
itemLabelFormat: '{{ZI005_FNA}}'
transformations:
F_CODE:
codelist: f_code
ZI001_SDV:
dateFormat: MM/dd/yyyy[', 'HH:mm:ss[' 'z]]
RTY:
codelist: rty
FCSUBTYPE:
codelist: fcsubtype
TRS:
codelist: trs
RIN_ROI:
codelist: roi
ZI016_WTC:
codelist: wtc
RLE:
codelist: rle
LOC:
codelist: loc
Beispiel für die Verwendung von CesiumJS für Gebäudedaten, die teilweise aus Bauteilen zusammengesetzt sind. Als Fallback wird die Bodenplatte verwendet:
- buildingBlock: FEATURES_HTML
mapClientType: CESIUM
geometryProperties:
- consistsOfBuildingPart.lod1Solid
- lod1Solid
- lod1GroundSurface