Admin:Updates voor een park publiceren uit OSM

Hier een hopelijk beknopte maar volledige checklist

We gaan hier uit van een desktop met Windows.

Wat je nodig hebt

• Lees eerst Admin:Bomen uit OSM database exporteren
• Een browser b.v. Google Chrome
• Een editor, b.v. Notepad++
• Een FTP tool om data te uploaden naar OBK, b.v. FileZilla

Query de OSM database met Overpass

• Ga naar Overpass website https://overpass-turbo.eu/ (er zijn er meer, maar dit is the place to go)
• Laad een script (of schrijf een nieuwe, of plak van een andere site, bijv deze Admin:Overpass Scripts.
  • Het script waar je vorige keer mee eindigde staat er weer als je begint.
• Run het script
  • Als het erg druk is kan het even duren voor je script draait, nog drukker? dan kan je script aborten.
  • Middels timeout (in seconden) geef je op hoe lang je verwacht dat het script nodig heeft, maar wees niet te gretig, als je veel tijd vraagt neemt de kans toe dat het script niet of pas laat uitgevoerd wordt.
• Kijk op de kaart (tabblad map) of de datapunten op de kaart staan zoals je verwacht

  • Tip: klik het vergrootglas om de kaart zo aan te passen dat alle opgehaalde data zichtbaar zijn.

• Ga naar de resultaten (tabblad 'data') Selecteer alle text (Ctrl-A) en copieer (Ctrl-C)

Save resultaat naar json bestand

Vooraf: we gebruiken een texteditor die niets aan de data toevoegt, geen opmaakcodes of regeleindes o.i.d., bijv. Notepad++

• Start Notepad++
• Plak alle data in een leeg window (Ctrl-V)
• Save de data naar een .json tekstbestand, als volgt

OBK scripts stellen drie eisen aan de bestandsnaam

Het moet met trees_ beginnen

Dan moet een naam volgen (die al voorkomt in config.js). Achter de 'bekende naam' kan nog iets vrij te kiezen volgen.

Bekende namen zijn nu namen van enkele parken of steden in Zuid-Holland

Als er een nieuw park of nieuwe stad aan OBK wordt toegevoegd, moet een nieuwe sectie aan bestand config.js worden toegevoegd. Nu is obk.htm?madurodam een ongeldige naam.

Het moet op .json eindigen

Dus url obk.htm?leiden wordt intern omgezet in bestandsnaam in trees_leiden.json. Dat bestand wordt dan gedownload.

Maar obk.htm?leiden_filtered_3 is ook goed. Dan wordt trees_leiden_filtered_3.json gedownload

Test het bestand

In folder test

• Upload het bestand naar OBK, naar de test folder
• Bekijk de kaart

(openbomenkaart.org/obk.htm?test='bekende naam'

In folder data

• Vergelijk met het gelijknamige bestand in de publieke folder

(openbomenkaart.org/obk.htm?data='bekende naam'

Controleer bijvoorbeeld of de cirkels niet veel te groot zijn (omdat de decimale punt in de diameter ontbreekt)

Plaats het bestand live

In folder data

• Delete (of archiveer) een eventuele eerdere backup

klik het bestand aan met rechtermuistoets / Kies optie 'delete' / Enter

• Hernoem het bestand dat nu live is

klik het bestand aan met rechtermuistoets / Kies optie 'rename' / Voeg '.bak' toe / Enter

• Upload het nieuwe bestand nogmaals, maar nu naar nu naar folder 'data'

Nu kan iedereen de nieuwe kaart zien

Zonodig: draai update terug

In folder data

• Delete (of archiveer) het laatst ge-uploade bestand

klik het bestand aan met rechtermuistoets / Kies optie 'delete' / Enter

• Hernoem het bestand dat backup was, en weer live wordt

klik het bestand aan met rechtermuistoets / Kies optie 'rename' / Haal '.bak' weg / Enter

Nu kan iedereen de vorige kaart weer zien