Admin:Updates voor een park publiceren uit OSM

Uit wiki.openbomenkaart.org
Naar navigatie springen Naar zoeken springen

Hier een hopelijk beknopte maar volledige checklist

We gaan hier uit van een desktop met Windows.

Lees eerst Admin:Bomen uit OSM database exporteren (een iets minder gedetailleerde versie met plaatjes)

Benodigdheden

Wat je nodig hebt

  • 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

Het script waar je vorige keer mee eindigde staat er weer als je begint.
wijzigingen opslaan in Admin:Overpass Scripts, bijv. afbakening van het gebied, maakt dat andere ook die nieuw versie zullen gebruiken
vorige versies blijven altijd bereikbaar via tabblad 'Geschiedenis'
  • 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 folder 'test'
  • Bekijk de kaart
openbomenkaart.org/obk.htm?test='bekende naam'

In folder data

  • Vergelijk met het gelijknamige bestand in de live 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 folder 'data'
  • Verifieer upload
Controleer of de kaart met updates ook echt verschijnt. Windows Chrome F5 lijkt niet genoeg, Ctrl-F5 herlaadt het bomenbestand, met de nieuwste updates.
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