Feature-178-enhance-spatial-section

[jh-RLI]

Summary of the discussion

This PR enhances the spatial information of the oemetadata. It includes new keys for extensive spatial information which need to be discussed further. This includes fields for boundingBox to better describe the extend of the data and also crs information for better reusability of the data.

The "extent" field was reworked to be able to link to external resources that define region names like "Europe" and provide additional information. An @id key was introduced.

The "resolution" was also reworked to make the information more machine readable and also more clear to the user as fields that must hold non atomic information seems to raise confusion as the use case is not well specified.

The original objective of this PR is to resolve the "location" key and introduce more explicit "lat" "lon" key. To keep the human readable address information i suggest to add a address field.

"spatial": {
    "location": {
        "address": "", 
        "@id": "", 
        "latitude": "", 
        "longitude": "" },
    "extent": {
        "name": "", 
        "@id": "", 
        "resolutionValue": "", 
        "resolutionUnit": "", 
        "boundingBox": [,,,], 
        "crs": ""}}

Type of change (CHANGELOG.md)

Updated

• Refactor the spatial section and add new keys for location: 'address', '@id', 'latitude', 'longitude' and for extent: 'name', '@id', 'resolutionValue', 'resolutionUnit', 'boundingBox', 'crs' (#179)

Workflow checklist

Automation

Closes #178

PR-Assignee

• 🐙 Follow the workflow in CONTRIBUTING.md
• 📝 Update the CHANGELOG.md
• 📙 Update the documentation

Reviewer

• 🐙 Follow the Reviewer Guidelines
• 🐙 Provided feedback and show sufficient appreciation for the work done

[Ludee]

"spatial": {
    "location": {
        "address": "", 
        "@id": "", 
        "latitude": "", 
        "longitude": "" },
    "extent": {
        "name": "", 
        "@id": "", 
        "boundingBox": [,,,], 
        "resolutionValue": "", 
        "resolutionUnit": "", 
        "crs": ""}}

[Ludee]

"spatial": {
    "location": {
        "address": "Rudower Chaussee 12, 12489 Berlin", 
        "@id": "https://www.wikidata.org/wiki/Q77077223", 
        "latitude": "52.432822", 
        "longitude": "13.5351004" },
    "extent": {
        "name": null, 
        "@id": null, 
        "boundingBox": null, 
        "resolutionValue": null, 
        "resolutionUnit": null, 
        "crs": null}}

[Ludee]

"spatial": {
    "location": {
        "address": null, 
        "@id": null, 
        "latitude": null, 
        "longitude": null },
    "extent": {
        "name": "Berlin", 
        "@id": "https://www.wikidata.org/wiki/Q64", 
        "boundingBox": [13.08825, 52.33859, 13.76104, 52.6754], 
        "resolutionValue": "100", 
        "resolutionUnit": "m", 
        "crs": "EPSG:4326"}}

[minLon (W), minLat (S), maxLon (E), maxLat (N)]
13.08825, 52.33859, 13.76104, 52.6754
coordinates of easternmost point 52.43766, 13.76104
coordinates of northernmost point 52.6754, 13.47944
coordinates of southernmost point 52.33859, 13.64817
coordinates of westernmost point 52.41961, 13.08825

[Ludee]

"spatial": {
    "location": {
        "address": null, 
        "@id": null, 
        "latitude": null, 
        "longitude": null },
    "extent": {
        "name": "Germany", 
        "@id": "https://www.wikidata.org/wiki/Q183", 
        "boundingBox": null, 
        "resolutionValue": null, 
        "resolutionUnit": "federal state", 
        "crs": null}}

[Ludee]

Nice concept! Thanks a lot @jh-RLI and @christian-rli