Add documentation on import possibilities

This commit is contained in:
pietervdvn 2021-12-03 00:45:31 +01:00
parent d593540e3a
commit 8947aff7ae
4 changed files with 184 additions and 0 deletions

BIN
Docs/AED-import.nl.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 354 KiB

71
Docs/Gebruikersgids.nl.md Normal file
View file

@ -0,0 +1,71 @@
Gebruikersgids MapComplete
==========================
MapComplete is een website waar geodata op basis van [OpenStreetMap](https://osm.org), [Wikidata](https://wikidata.org)
en andere open bronnen wordt gevisualiseerd en aangevuld.
De getoonde geodata is afhankelijk van het thema - zo is er bijvoorbeeld het thema
voor [boekenruilkasten](https://mapcomplete.osm.be/bookcases) [cyclofix](http://mapcomplete.osm.be/cyclofix) die focust
op fietspompen, fietswinkels, ...
MapComplete mag gratis gebruikt worden. Om de data te raadplegen heb je geen account nodig - de webpagina bezoeken is
voldoende.
### Data toevoegen
OpenStreetMap is een gedeelde databank van geodata. Om die correct en up to date te houden, voegen we _enkel_ gegevens
toe waarvan we zeker weten dat die op dit moment ook zo zijn in de echte wereld. Twijfel je dus over een vraag? Sla de
vraag dan over en ga opnieuw ter plaatse kijken. **Beter geen informatie dan foute informatie**.
Daarnaast verwachten we ook dat je op een vriendelijke en correcte manier omgaat met andere leden van de community. Je
kan feedback of vragen krijgen over je aanpassingen - bijvoorbeeld wanneer andere bijdragers denken dat er een
vergissing is gebeurd. Meestal is de vergissing met een paar heen- en weerberichtjes uitgeklaard. Vergissen is
menselijk.
Als je bijdragen grote fouten bevatten, kunnen je wijzigingen ongedaan gemaakt worden door andere leden van
OpenStreetMap. Dit is echter erg uitzonderlijk. Bij herhaaldelijke grote fouten, (vermoeden van) kwaad opzet of
vandalisme kan je account geblokkeerd worden. Merk op dat MapComplete is opgezet om (grote) vergissingen te vermijden,
dus dit is bijna onmogelijk.
Data hergebruiken
-----------------
De getoonde data (locaties van POI, ...) mogen vrij en gratis hergebruikt worden voor alle doeleinden (ook commercieel),
mits de vermelding `Data van OpenStreetMap, vrij beschikbaar onder ODBL` of een gelijkaardige zin. Hiervoor hoef je geen
toestemming te vragen.
Let op: aanpassingen aan de data worden ook als open data beschouwd. Let ook op wanneer je OpenStreetMap-data gaat
mengen uit andere databronnen waar copyright op rust; vaak mag dit niet. Voor meer informatie, zie
de [volledige copyrightnotice](https://osm.org/copyright).
Om de data als computerbestand op te vragen, bestaan
er [verschillende opties](https://learnosm.org/en/osm-data/getting-data/).
Privacy
-------
### Zonder account
Zolang je je niet aanmeldt, worden er geen persoonsgegevens opgeslaan.
Je computer stuurt echter wel een klein berichtje naar [pietervdvn.goatcounter.com](pietervdvn.goatcounter.com), waar
statistieken over de bezoekersaantallen worden bijgehouden. Dit omvat een minimum aan technische gegevens en kan niet
gelinkt worden aan een OSM-gebruikersaccount of persoon door de makers van MapComplete.
### Met account
Wanneer je een account maakt, is dit een account op OpenStreetMap. Voor je een account maakt, gelieve
hun [privacy statement](https://wiki.osmfoundation.org/wiki/Privacy_Policy) te lezen.
Een account maken is gratis, je moet enkel een email-adres en gebruikersnaam opgeven. Je email-adres is niet publiek
zichtbaar, je gebruikersnaam wel.
Je kan opteren om een _pseudoniem_ te gebruiken - je gebruikersnaam hoeft niet je echte naam te zijn. Ook de naam van je
huisdier of iets zelfbedacht mag gerust.
Wanneer je gegevens aanvult via MapComplete, zal je wijziging **publiek zichtbaar** zijn voor iedereen ter wereld. Dit
betekent dus dat iedereen weet dat _gebruikersnaam_ op een bepaalde plaats op een bepaald uur aanwezig was.
**Ben je minderjarig?** Vraag toestemming aan je ouders voordat je een account aanmaakt en kies ervoor om je echte
naam _niet_ te gebruiken.

View file

@ -0,0 +1,113 @@
Data importeren in OpenStreetMap
================================
Om een dataset te importeren, zijn er enkele stappen die doorlopen moeten worden:
0. Geschikte data
1. Licentie nakijken
2. Importeermethode bepalen
3. Community inlichten en Importeren voorbereiden
4. Importeren!
0. Geschikte data
-----------------
Is de data die je wenst te importeren geschikt voor OpenStreetMap? Is ze dus verifieerbaar ter plaatse door een andere contributor? Is ze ietwat permantent?
1. Licentie nakijken
---------------------
Voordat we een dataset in OpenStreetMap kunnen toevoegen, moeten we nagaan of dit wel mag van de oorspronkelijke maker van de dataset.
Is er een licentievermelding bij de databron? Kijk deze dan na of er toestemming is voor hergebruik (ook commercieel) en redistributie.
Indien er een attributie voor de dataset moet zijn, dan kan de bronvermelding in de changeset (als source) aangeduid worden en/of kan de auteur vermeld worden op [deze wikipagina]. **Vraag na of deze bronvermelding voldoende is**
2. Importeermethode bepalen
---------------------------
De volgende vraag is hoe deze data geimporteerd zal worden. Ook hier moeten verschillende vragen beantwoord worden:
1. Wie doet de import?
2. Is een survey nodig?
3. Welke tools worden ingezet?
4. Tagging bepalen
### Wie importeert?
Een ervaren contributor vergelijkt de bestaande OSM-data met de aangeleverde dataset. Duplicaten worden gefiltered en geupdate.
Dit is vooral geschikt voor kleinere dataset (maximaal enkele honderd feaures), maar is sneller (want minder coordinatie is nodig).
Indien een grotere dataset geimporteerd dient te worden, is dit vaak niet meer haalbaar door één enkele persoon.
Als dit het geval is, zal men contributors moeten zoeken om mee te helpen importeren.
Dit kan heel passief (de data online plaatsen en de community er attent op maken dat deze bestaat, in de hoop dat er iemand dit oppikt),
tot actief een groep vrijwilligers zoeken.
Ten slotte kan men hier ook een betaalde kracht voor inhuren - een GIS-expert binnen de organisatie, een jobstudent of een OpenStreetMap-expert die men betaald
### Is een survey nodig?
Indien de dataset oud is of veel fouten bevat, is het wellicht wenslijk om ter plaatse te gaan kijken. Dit hangt sterk af van dataset tot dataset, of men de data op luchtfoto's kan afleiden, via mapillary of OpenStreetCam de situatie ter plaatse kan zien, ...
Vaak helpt het om terreinkennis te hebben, om de import voor te bereiden door alle data te overlopen, toe te voegen waar men zeker van is en enkel de twijfelgevallen over te houden voor import.
### Welke tools worden ingezet?
Indien er één ervaren gebruiker de import doet, zal die wellicht JOSM (of zijn favoriete editor gebruiken).
Voor extreem grote imports (meer dan 1000 objecten) zal men wellicht ook coordineren via een tasking manager (om werkgebieden per contributor af te bakenen).
Voor een import waar survey wenselijk is (ihb indien er verschillende contributors betrokken zijn), kan MapComplete ingezet worden waar de na te zien data ingeladen wordt.
MapComplete kan:
- tegelijk een laag van OpenStreetMap én de te importeren data tonen .
- de te importeren objecten verbergen indien er een OpenStreetMap-object dichtbij is
- aanbieden om het te importeren object toe te voegen indien dit object ontbreekt (*)
- aanbieden om gegevens van het te importeren object over te zetten op een naburig, soortgelijk object (*)
(*) Opties 3 en 4 vereisen een degelijke voorbereiding van de te importeren dataset en zijn niet altijd mogelijk of niet altijd de moeite
Op de screenshot hieronder is een voorbeeld te zien van het importeren van een dataset van Brugse defibrillatoren.
- De vierkante logo's zijn AEDs die in OpenStreetMap gekend zijn
- Een bolletje is een AED die in de Brugse dataset gekend is
- Een bolletje wordt groen gekleurd indien er een AED in OSM gekend is binnen een straal van 25 meter
- In de popup wordt relevante informatie getoond uit de te importeren dataset
![Voorbeeld van importeren](AED-import.nl.png)
Een geavanceerder voorbeeld van een import is het UK-address-importproject.
Hierbij wordt met een dataset van vermoedelijke adressen gewerkt.
Indien er geen gebouw met adres dit vermoedelijke adres omsluit, wordt er gevraagd om dit adres toe te voegen. Door het adres via deze popup toe te voegen, wordt er meteen een INSPIRE-referentie meegegeven.
![](uk_address_import.png)
### Tagging bepalen en filteren voor duplicaten
Ten slotte moet de data ook nog 'vertaald' worden naar het correct OpenStreetMap-formaat.
De softwareprogramma's ook overweg kunnen met het dataformaat. **Geojson** is een veilige keuze, want dit open formaat wordt door veel editors ondersteund. Met QGIS kunnen shapefiles omgezet worden in geojson. Een geojson kan ook als extra laag in MapComplete geladen worden.
Daarnaast moeten de attributen van de data omgezet moeten worden naar de OpenStreetMap-attributen - raadpleeg de wiki voor de correcte tags.
Dit kan bijvoorbeeld met QGIS of met JOSM gedaan worden.
Ten slotte moet men ook voorkomen dat er duplicaten ontstaan: twee objecten in OpenStreetMap die beiden hetzelfde voorwerp voorstellen.
3. Community inlichten en importeren voorbereiden
-------------------------------------------------
Indien er een grote import gaat gebeuren, dient de community hiervan ingelicht te worden. Door dit in de community te bespreken, worden fouten voorkomen. Ook helpt dit om medecontributors warm te maken en niet-betrokken contributors geen verassingen te bezorgen.
Voor een import die enkel in Belgie plaatsvindt, volstaat een email naar talk@osm.be ; voor een globale import moet men ook best naar import@openstreetmap.org sturen.
Voor kleinere datasets is dit slechts een formaliteit - zeker indien de data gedubbelcheckt gaat worden.
Ondertussen kan de import voorbereid worden door op kleine schaal te importeren (bv. een beperkt gebied of een beperkt aantal punten).
Indien er een MapComplete-thema wordt opgezet, kan dit ook al getest worden en naar de community gestuurd worden.
4. Importeren!
--------------
Na enkele weken zijn we hier eindelijk aangeland! Tijd om de data in OpenStreetMap te importeren!

BIN
Docs/uk_address_import.png Normal file

Binary file not shown.

After

Width:  |  Height:  |  Size: 249 KiB