NL:UMap/Handleiding/Overpass

Met de Overpass API kan je realtime OpenStreetMap-data laden in een uMap-laag. De data wordt automatisch bijgewerkt wanneer OSM-data wijzigt, zonder dat je de kaart opnieuw hoeft te bewerken.

Dit is nuttig voor data die regelmatig verandert, zoals winkels, parkings, fietsstallingen, openbare toiletten, enz.

Stap 1: Query opstellen in Overpass Turbo

Ga naar overpass-turbo.eu en stel een query op. Gebruik de Assistent-tab voor eenvoudige zoekopdrachten, of schrijf de query manueel.

Voorbeeld: alle fietsstallingen in het zichtbare kaartvenster:

[out:json][timeout:25];
(
  node["amenity"="bicycle_parking"]({south},{west},{north},{east});
  way["amenity"="bicycle_parking"]({south},{west},{north},{east});
);
out center;

De variabelen {south}, {west}, {north} en {east} worden door uMap automatisch vervangen door de coördinaten van het zichtbare kaartvenster.

Klik op Uitvoeren om de query te testen.

Stap 2: Query exporteren als URL

Klik in overpass-turbo.eu op Exporteer → Query → Kopieer als compacte query.

Bouw daarna de volledige URL op door de query te laten voorafgaan door het Overpass-endpoint:

https://overpass-api.de/api/interpreter?data=

Voorbeeld van een volledige URL:

https://overpass-api.de/api/interpreter?data=[out:json][timeout:25];(node["amenity"="bicycle_parking"]({south},{west},{north},{east});way["amenity"="bicycle_parking"]({south},{west},{north},{east}););out%20center;

Stap 3: Instellen als Remote data in uMap

1. Maak een nieuwe laag aan of open de instellingen van een bestaande laag.
2. Ga naar het tabblad Remote data.
3. Plak de URL in het URL-veld.
4. Stel het formaat in op OSM.
5. Vink Dynamisch laden aan — zo herlaadt de data bij elke verschuiving of zoom.
6. Stel een Min zoom in (aanbevolen: 13 of hoger) om te vermijden dat de query voor een te groot gebied uitgevoerd wordt.
7. Sla de laag op.

Aandachtspunten

• Stel altijd een Min zoom in bij dense datasets. Een query zonder zoombeperking voor heel België kan de Overpass-server overbelasten en een time-out veroorzaken.
• De [timeout:25] parameter in de query bepaalt hoelang de Overpass-server wacht. Verhoog dit bij complexe queries.
• Overpass-data is enkel zo actueel als de OSM-database. Wijzigingen in OSM zijn doorgaans binnen enkele minuten zichtbaar.
• Voor data die niet of nauwelijks verandert is eenmalig importeren efficiënter.

Zie ook

• Remote data
• Importeren van kaartgegevens
• Zoomniveaus en laagzichtbaarheid
• Overpass Turbo — online editor voor Overpass-queries
• Overpass-queries in uMap (Frans)
• Overpass-queries in uMap (Duits)