afbeeldingen toegevoegd en gereorganiseerd

Author: derekvb

.vscode/settings.json

@@ -0,0 +1,5 @@
+{
+    "markdown.copyFiles.destination": {
+        "/docs/**": "${documentWorkspaceFolder}/docs/assets/"
+    }
+}

docs/achtergrondinformatie/Achtergrondinformatie.md

@@ -16,6 +16,7 @@ OGC API's stellen geodata beschikbaar. Wat is geodata, ook wel **ruimtelijke inf
 Wat is ruimtelijke informatie, ook wel geo-informatie genoemd, en wat kun je ermee? Geodata is overal om ons heen. Vaak hoor je dat 80% van alle data over een plek op aarde gaat. 
 
 !!! warning "TO DO"
+    
     Voorbeelden / use cases die de meerwaarde van geodata aantonen. Verschillende vormen van ruimtelijke informatie / geodata 
 
 !!! question "Vraag"
@@ -24,22 +25,28 @@ Wat is ruimtelijke informatie, ook wel geo-informatie genoemd, en wat kun je erm
 
 ## Wat doet het Kadaster / PDOK? 
 
-PDOK is een dataplatform waar gebruikers geodata kunnen vinden en overheidsorganisaties hun geodata kunnen publiceren. PDOK verbindt vraag en aanbod met elkaar. Bij PDOK vind je open datasets van de overheid met actuele geo-informatie. De datasets gaan over allerlei verschillende thema’s, zoals de bodem, mobiliteit en grenzen. En zijn afkomstig van allerlei verschillende overheidsorganisaties, zoals het CBS, ministeries, Rijkswaterstaat en het Kadaster.  
+[PDOK](https://www.pdok.nl/) is hét platform voor hoogwaardige geodata. Op PDOK kunnen gebruikers en specialisten geodata vinden en kunnen overheidsorganisaties hun geodata publiceren. PDOK verbindt vraag en aanbod met elkaar. Bij PDOK vind je open datasets van de overheid met actuele geo-informatie. De datasets gaan over allerlei verschillende thema’s, zoals de bodem, mobiliteit en grenzen. En zijn afkomstig van allerlei verschillende overheidsorganisaties, zoals het CBS, ministeries, Rijkswaterstaat en het Kadaster.  
 
 PDOK is in 2013 ontstaan en is een dienst van het Kadaster. Het Kadaster is de Nederlandse overheidsorganisatie die vastlegt wie welke rechten heeft op al het vastgoed in Nederland. En het Kadaster zorgt dat burgers, bedrijven en overheden gebruik kunnen maken van betrouwbare en actuele geo-informatie.  
 
+![De kracht van PDOK](<../assets/2201_PDOK open data portaal definitief.jpg>)
+
 ## Wat zijn OGC API’s? 
 
 - **Bekijk eerst dit filmpje: <https://www.youtube.com/watch?v=hNmZJ1itqfM>**
 
+![OGC APIs](../assets/ogc-api-youtube.png)
+
 Een OGC API is een gestandaardiseerde interface waarmee gebruikers en systemen geodata kunnen bevragen en bekijken via het internet. Een API, een Application Programming Interface, kan door mensen gebruikt worden om data op te vragen. Maar nog vaker worden API’s gebruikt door systemen (machines) om met elkaar te praten. Ontwikkelaars kunnen op die manier op een eenvoudige manier data van andere bronnen in hun eigen software integreren. Een API is dus een stopcontact voor data. Je hebt, in tegenstelling tot vroeger, geen specifieke kennis over geodata meer nodig om dit te kunnen.  
 
 Een OGC API volgt de OGC API standaard. De standaard schrijft precies voor hoe de interface opgebouwd moet zijn. De OGC API standaard is een open standaard die zeer breed omarmd wordt. De standaard wordt gemaakt door het Open Geospatial Consortium (OGC). Dat is een wereldwijde organisatie die open standaarden maakt voor het geo-informatiedomein.  
 
 Een OGC API bestaat altijd uit dezelfde onderdelen. En de OGC API kent verschillende vormen om data beschikbaar te stellen. Welke vorm je kiest, is afhankelijk van wat je precies met de geodata wil gaan doen. En voor de organisatie die de data aanbiedt met een OGC API is het afhankelijk van hoe ze de data precies beschikbaar willen stellen. 
 
 ### OGC API onderdelen
-TO DO
+
+!!! warning "TO DO"
+
 ![De OGC API building blocks](../assets/ogc-api-building-blocks.png)
 
 | Onderdeel | Beschrijving | Beschikbaar bij PDOK? |
@@ -63,8 +70,6 @@ En gebruikers weten altijd hoe ze de OGC API kunnen gebruiken en op welke manier
 
 Het gebruiken van een standaard bespaart zo heel veel tijd, geld en frustratie. 
 
-TO DO voorbeeld gestandaardiseerd vs. ongestandaardiseerd opnemen? 
-
 De beste standaarden zijn open standaarden. Open standaarden zijn standaarden die door iedereen gebruikt kunnen worden en waar iedereen die wil aan kan bijdragen.  
 
 In Nederland is het vaak verplicht voor overheidsorganisaties om gebruik te maken van open standaarden.  

docs/assets/2201_PDOK open data portaal definitief.jpg

@@ -16,6 +16,8 @@ Een OGC API is een gestandaardiseerde interface voor het bekijken en bevragen va
 Het OGC (Open Geospatial Consortium) is een wereldwijde organisatie die standaarden voor het uitwisselen van geodata maakt. 
 OGC API is een wereldwijde standaard. Dat zorgt ervoor dat iedereen op dezelfde manier geodata kan gebruiken. Dat bespaart een hoop tijd, geld en frustratie. 
 
+![alt text](assets/ogc-api-building-blocks.png)
+
 ## Voor wie is deze leermodule bedoeld?
 
 In eerste instantie is deze leermodule bedoeld voor IT-studenten. Jij bent bijvoorbeeld web developer of data-analist (in opleiding). Je hoeft geen ervaring met geodata te hebben om deze module te kunnen volgen. 
@@ -59,6 +61,10 @@ De stof is opgesplitst in de volgende onderdelen:
 | 4.	Terugblik |  |
 | 5.	Tot slot |  |
 
+!!! warning "TO DO"
+
+	Instructie: hoe deze leermodule te volgen
+
 ## Bijdragen
 
 Heb je suggesties voor verbeteringen of zie je een fout? [Maak een issue aan op GitHub](https://github.com/PDOK/leermodule-ogc-api/issues).