NL:UMap/Handleiding/Remote data

From OpenStreetMap Wiki
Jump to navigation Jump to search

Met de Remote data-functie kan een uMap-laag data laden van een externe URL in plaats van opgeslagen data te gebruiken. Zo blijft de kaart automatisch up-to-date zonder dat je de laag opnieuw hoeft te uploaden.

Instelling

Open de laaginstellingen via het potloodpictogram naast de laagnaam → tabblad Remote data.

Instelling Uitleg
URL De URL waarvan de data geladen wordt.
Formaat Het bestandsformaat: GeoJSON, CSV, GPX, KML of OSM.
Dynamisch laden Herlaadt de data telkens wanneer de gebruiker verschuift of inzoomt.
Proxy Stuurt de request via de uMap-server. Gebruik dit wanneer de externe bron geen CORS-headers heeft.
Licentie Optionele vermelding van de databron.

Ondersteunde formaten

  • GeoJSON — meest gebruikte formaat voor geografische vectordata.
  • CSV — tabeldata met kolommen voor coördinaten.
  • GPX — GPS-tracks en -waypoints.
  • KML — Google Earth-formaat.
  • OSM — OpenStreetMap XML-formaat.

De {bbox}-variabele

In de URL kan je {bbox} gebruiken als dynamische variabele. uMap vervangt deze bij elke laadbeurt door de coördinaten van het huidige kaartvenster in het formaat west,zuid,oost,noord (EPSG:4326).

Dit is nuttig voor diensten die data per bounding box filteren, zoals WFS-endpoints of Overpass API.

Voorbeeld met Overpass API:

https://overpass-api.de/api/interpreter?data=[out:json][bbox:{bbox}];node[amenity=bench];out;

Statische GeoJSON hosten

Een veelgebruikte aanpak is het hosten van een GeoJSON-bestand op een publieke URL en die in uMap laden. Voordelen:

  • De data wordt dagelijks automatisch bijgewerkt via een script (bv. GitHub Actions of Forgejo Actions).
  • uMap laadt altijd de meest recente versie.
  • De geometrie en eigenschappen kunnen verrijkt worden met data uit andere bronnen voor het publiceren.

Gratis hostingopties voor statische GeoJSON:

  • GitHub Pages — via een repository met een gh-pages branch.
  • Codeberg Pages — via een repository met een pages branch.

WFS als databron

Een Web Feature Service (WFS) kan GeoJSON teruggeven via de parameter outputFormat=application/json.

Voorbeeld:

https://geo.api.vlaanderen.be/POI/wfs?service=WFS&version=2.0.0&request=GetFeature&typeName=POI%3APOI&count=10000&outputFormat=application%2Fjson&srsName=EPSG%3A4326&CQL_FILTER=GEMEENTE+IN+('Leuven','Gent','Oostende')+AND+PRODUCT%3D'Conformiteitsattest'

Let op: In WFS 2.0 kunnen de parameters CQL_FILTER en BBOX niet altijd gecombineerd worden. Gebruik in dat geval een eigen proxy-endpoint dat de parameters samenvoegt voor het doorsturen naar de WFS.

Beperkingen

  • CORS — Niet alle externe diensten staan requests vanuit uMap toe. Schakel Proxy in als de data niet laadt.
  • Bestandsgrootte — Zeer grote bestanden vertragen de kaart. Beperk de data via bbox-filtering, vereenvoudig de geometrie voor het publiceren of maak de zichtbaarheid van de kaartlaag schaalafhankelijk.
  • Verversing — Zonder Dynamisch laden wordt de data slechts één keer geladen bij het openen van de kaart.

Zie ook

Retrieved from "https://wiki.openstreetmap.org/w/index.php?title=NL:UMap/Handleiding/Remote_data&oldid=3045036"