ruimtelijke-plannen.yaml

swagger: "2.0"
info:
  version: "1.0.0"
  title: "Ruimtelijke Plannen API"
host: "data.pdok.nl"
basePath: "/rp/api/v1"
schemes:
- "https"
consumes:
- "application/json"
produces:
- "application/hal+json"
- "application/problem+json"
x-ldpath-namespaces:
  nen3610: http://data.informatiehuisruimte.nl/def/nen3610#
  skos: http://www.w3.org/2004/02/skos/core#
  dcterms: http://purl.org/dc/terms/
  ro: http://data.informatiehuisruimte.nl/def/ro#
  pdok: http://data.pdok.nl/def/pdok#
  geo: http://www.opengis.net/ont/geosparql#
parameters:
  id:
    name: id
    in: path
    description: Identifier
    required: true
    type: string
  contentCrs:
    name: "Content-Crs"
    in: "header"
    required: false
    type: "string"
    description: "CRS van de meegegeven geometrie"
    default: "epsg:4326"
    enum:
    - "epsg:4326"
    - "epsg:28992"
  acceptCrs:
    name: "Accept-Crs"
    in: "header"
    required: false
    type: "string"
    description: "Gewenste CRS van de coördinaten in de response"
    default: "epsg:4326"
    enum:
    - "epsg:4326"
    - "epsg:28992"
  bestemmingsplangebied:
    name: "bestemmingsplangebied"
    in: "query"
    required: false
    type: "string"
    description: "Filteren op bestemmingsplangebied"
  bestemmingsvlak:
    name: "bestemmingsvlak"
    in: "query"
    required: false
    type: "string"
    description: "Filteren op bestemmingsvlak"
  functieaanduiding:
    name: "functieaanduiding"
    in: "query"
    required: false
    type: "string"
    description: "Filteren op functieaanduiding"
  gebiedsaanduiding:
    name: "gebiedsaanduiding"
    in: "query"
    required: false
    type: "string"
    description: "Filteren op gebiedsaanduiding"
  maatvoering:
    name: "maatvoering"
    in: "query"
    required: false
    type: "string"
    description: "Filteren op maatvoering"
  bouwaanduiding:
    name: "bouwaanduiding"
    in: "query"
    required: false
    type: "string"
    description: "Filteren op bouwaanduiding"
  figuur:
    name: "figuur"
    in: "query"
    required: false
    type: "string"
    description: "Filteren op figuur"
  bouwvlak:
    name: "bouwvlak"
    in: "query"
    required: false
    type: "string"
    description: "Filteren op bouwvlak"
  tekst:
    name: "tekst"
    in: "query"
    required: false
    type: "string"
    description: "Filteren op tekst"      
paths:
  /_zoek:
    x-product: zoek
    post:
      tags:
      - "Globale zoekfunctie"
      summary: "Zoeken in alle collecties op hoofdniveau"
      parameters:
      - $ref: '#/parameters/contentCrs'
      - $ref: '#/parameters/acceptCrs'
      - name: "body"
        in: "body"
        required: true
        schema:
          type: "object"
          properties:
            _geo:
              type: "object"
              properties:
                intersects:
                  $ref: "#/definitions/GeoJSON"
      responses:
        200:
          description: "Status 200"
          schema:
            required:
            - "_embedded"
            type: "object"
            properties:
              _embedded:
                required:
                - "resultaten"
                type: "object"
                properties:
                  resultaten:
                    type: "array"
                    x-result-ref: collection
                    items:
                      $ref: "#/definitions/SearchResult"
              _links:
                required:
                - "self"
                type: "object"
                properties:
                  self:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar huidige pagina"
                    properties:
                      href:
                        type: "string"
                        x-relative-link:
                          pattern: /_zoek
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/_zoek"
                  next:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar volgende pagina (niet aanwezig\
                      \ als er geen volgende pagina is)"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/_zoek?page=2"
          headers:
            Content-Crs:
              type: "string"
              description: "CRS van de teruggegeven geometrieën"
        400:
          description: "Bad request. Je request body is geen geldige JSON of de query\
            \ wordt niet ondersteund door de API."
          schema:
            $ref: "#/definitions/Error"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /bestemmingsplangebieden:
    x-product: bestemmingsplangebied
    get:
      tags:
      - "Bestemmingsplangebieden"
      summary: "bestemmingsplangebieden collectie"
      parameters:
      - $ref: '#/parameters/acceptCrs'
      - $ref: '#/parameters/bestemmingsvlak'
      - $ref: '#/parameters/functieaanduiding'
      - $ref: '#/parameters/gebiedsaanduiding'
      - $ref: '#/parameters/maatvoering'
      - $ref: '#/parameters/bouwaanduiding'
      - $ref: '#/parameters/figuur'
      - $ref: '#/parameters/bouwvlak'
      - $ref: '#/parameters/tekst'
      - name: "type"
        in: "query"
        required: false
        type: "string"
        description: "Filteren op type plan"
        enum:
        - "bestemmingsplan"
        default: "bestemmingsplan"
      - name: "beleidsmatigVerantwoordelijkeOverheid.type"
        in: "query"
        required: false
        type: "string"
        description: "Filteren op beleidsmatig verantwoordelijke overheid"
        enum:
        - "GemeentelijkeOverheid"
        - "Deelgemeente_Stadsdeel"
        - "ProvincialeOverheid"
        - "NationaleOverheid"
      - name: "status"
        in: "query"
        required: false
        type: "string"
        description: "Filteren op status van een plan"
        enum:
        - "concept"
        - "voorontwerp"
        - "ontwerp"
        - "vastgesteld"
        - "geconsolideerd"
      responses:
        200:
          description: "Status 200"
          schema:
            required:
            - "_embedded"
            - "_links"
            type: "object"
            properties:
              _embedded:
                required:
                - "bestemmingsplangebieden"
                type: "object"
                properties:
                  bestemmingsplangebieden:
                    type: "array"
                    x-result-ref: collection
                    items:
                      $ref: "#/definitions/Bestemmingsplangebied"
              _links:
                required:
                - "self"
                type: "object"
                properties:
                  self:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar huidige pagina"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden"
                        x-relative-link:
                          pattern: /bestemmingsplangebieden
#                  next:
#                    required:
#                    - "href"
#                    type: "object"
#                    description: "Absolute link naar volgende pagina (niet aanwezig\
#                      \ als er geen volgende pagina is)"
#                    properties:
#                      href:
#                        type: "string"
#                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden?page=2"
          headers:
            Content-Crs:
              type: "string"
              description: "CRS van de teruggegeven geometrieën"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /bestemmingsplangebieden/_zoek:
    post:
      tags:
      - "Bestemmingsplangebieden"
      summary: "Zoeken binnen bestemmingsplangebieden"
      parameters:
      - $ref: '#/parameters/acceptCrs'
      - name: "type"
        in: "query"
        required: false
        type: "string"
        description: "Filteren op type plan"
        enum:
        - "bestemmingsplan"
        default: "bestemmingsplan"
      - name: "beleidsmatigVerantwoordelijkeOverheid.type"
        in: "query"
        required: false
        type: "string"
        description: "Filteren op beleidsmatig verantwoordelijke overheid"
        enum:
        - "GemeentelijkeOverheid"
        - "Deelgemeente_Stadsdeel"
        - "ProvincialeOverheid"
        - "NationaleOverheid"
      - name: "status"
        in: "query"
        required: false
        type: "string"
        description: "Filteren op status van een plan"
        enum:
        - "concept"
        - "voorontwerp"
        - "ontwerp"
        - "vastgesteld"
        - "geconsolideerd"
      - name: "body"
        in: "body"
        required: false
        schema:
          type: "object"
          properties:
            _geo:
              type: "object"
              properties:
                intersects:
                  $ref: "#/definitions/GeoJSON"
      responses:
        200:
          description: "Status 200"
          schema:
            required:
            - "_embedded"
            - "_links"
            type: "object"
            properties:
              _embedded:
                required:
                - "bestemmingsplangebieden"
                type: "object"
                properties:
                  bestemmingsplangebieden:
                    type: "array"
                    x-result-ref: collection
                    items:
                      $ref: "#/definitions/Bestemmingsplangebied"
              _links:
                required:
                - "self"
                type: "object"
                properties:
                  self:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar huidige pagina"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden"
                  next:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar volgende pagina (niet aanwezig\
                      \ als er geen volgende pagina is)"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden?page=2"
          headers:
            Content-Crs:
              type: "string"
              description: "CRS van de teruggegeven geometrieën"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /bestemmingsplangebieden/{id}:
    x-product: bestemmingsplangebied
    get:
      tags:
      - "Bestemmingsplangebieden"
      summary: "bestemmingsplangebied resource"
      parameters:
      - $ref: '#/parameters/id'
      - $ref: '#/parameters/acceptCrs'
      responses:
        200:
          description: "Status 200"
          schema:
            $ref: "#/definitions/Bestemmingsplangebied"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /teksten:
    x-product: tekst
    get:
      tags:
      - "Teksten"
      summary: "teksten collectie"
      parameters:
      - $ref: '#/parameters/bestemmingsplangebied'
      - $ref: '#/parameters/bestemmingsvlak'
      - $ref: '#/parameters/functieaanduiding'
      - $ref: '#/parameters/gebiedsaanduiding'
      - $ref: '#/parameters/maatvoering'
      - $ref: '#/parameters/bouwaanduiding'
      - $ref: '#/parameters/figuur'
      - $ref: '#/parameters/bouwvlak'
      responses:
        200:
          description: "Status 200"
          schema:
            required:
            - "_embedded"
            - "_links"
            type: "object"
            properties:
              _embedded:
                required:
                - "teksten"
                type: "object"
                properties:
                  teksten:
                    type: "array"
                    x-result-ref: collection
                    items:
                      $ref: "#/definitions/Tekst"
              _links:
                required:
                - "self"
                type: "object"
                properties:
                  self:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar huidige pagina"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten"
                        x-relative-link:
                          pattern: /teksten
#                  next:
#                    required:
#                    - "href"
#                    type: "object"
#                    description: "Absolute link naar volgende pagina (niet aanwezig\
#                      \ als er geen volgende pagina is)"
#                    properties:
#                      href:
#                        type: "string"
#                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten?page=2"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /teksten/{id}:
    get:
      tags:
      - "Teksten"
      summary: "tekst"
      parameters:
      - $ref: '#/parameters/id'
      responses:
        200:
          description: "Status 200"
          schema:
            $ref: "#/definitions/Tekst"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /bestemmingsvlakken:
    x-product: bestemmingsvlak
    get:
      tags:
      - "Bestemmingsvlakken"
      summary: "bestemmingsvlakken collectie"
      parameters:
      - $ref: '#/parameters/acceptCrs'
      - $ref: '#/parameters/bestemmingsplangebied'
      # - $ref: '#/parameters/functieaanduiding'
      # - $ref: '#/parameters/gebiedsaanduiding'
      # - $ref: '#/parameters/maatvoering'
      # - $ref: '#/parameters/bouwaanduiding'
      # - $ref: '#/parameters/figuur'
      # - $ref: '#/parameters/bouwvlak'
      # - $ref: '#/parameters/tekst'
      responses:
        200:
          description: "Status 200"
          schema:
            required:
            - "_embedded"
            - "_links"
            type: "object"
            properties:
              _embedded:
                required:
                - "bestemmingsvlakken"
                type: "object"
                properties:
                  bestemmingsvlakken:
                    type: "array"
                    x-result-ref: collection
                    items:
                      $ref: "#/definitions/Bestemmingsvlak"
              _links:
                required:
                - "self"
                type: "object"
                properties:
                  self:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar huidige pagina"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsvlakken"
                  next:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar volgende pagina (niet aanwezig\
                      \ als er geen volgende pagina is)"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsvlakken?page=2"
          headers:
            Content-Crs:
              type: "string"
              description: "CRS van de teruggegeven geometrieën"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /bestemmingsvlakken/{id}:
    x-product: bestemmingsvlak
    get:
      tags:
      - "Bestemmingsvlakken"
      summary: "bestemmingsvlakken resource"
      parameters:
      - $ref: '#/parameters/acceptCrs'
      - $ref: '#/parameters/id'
      responses:
        200:
          description: "Status 200"
          schema:
            $ref: "#/definitions/Bestemmingsvlak"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /functieaanduidingen:
    get:
      tags:
      - "Functieaanduidingen"
      summary: "functieaanduidingen collectie"
      parameters:
      - $ref: '#/parameters/acceptCrs'
      - $ref: '#/parameters/bestemmingsplangebied'
      # - $ref: '#/parameters/bestemmingsvlak'
      # - $ref: '#/parameters/gebiedsaanduiding'
      # - $ref: '#/parameters/tekst'
      responses:
        200:
          description: "Status 200"
          schema:
            required:
            - "_embedded"
            type: "object"
            properties:
              _embedded:
                required:
                - "functieaanduidingen"
                type: "object"
                properties:
                  functieaanduidingen:
                    type: array
                    x-result-ref: collection
                    items:
                      $ref: "#/definitions/Functieaanduiding"
              _links:
                required:
                - "self"
                type: "object"
                properties:
                  self:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar huidige pagina"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/functieaanduidingen"
                  next:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar volgende pagina (niet aanwezig\
                      \ als er geen volgende pagina is)"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/functieaanduidingen?page=2"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /functieaanduidingen/{id}:
    get:
      tags:
      - "Functieaanduidingen"
      summary: "functieaanduidingen resource"
      parameters:
      - $ref: '#/parameters/id'
      - $ref: '#/parameters/acceptCrs'
      responses:
        200:
          description: "Status 200"
          schema:
            $ref: "#/definitions/Functieaanduiding"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /gebiedsaanduidingen:
    get:
      tags:
      - "Gebiedsaanduidingen"
      summary: "gebiedsaanduidingen collectie"
      parameters:
      - $ref: '#/parameters/acceptCrs'
      - $ref: '#/parameters/bestemmingsplangebied'
      # - $ref: '#/parameters/bestemmingsvlak'
      # - $ref: '#/parameters/functieaanduiding'
      # - $ref: '#/parameters/maatvoering'
      # - $ref: '#/parameters/bouwaanduiding'
      # - $ref: '#/parameters/figuur'
      # - $ref: '#/parameters/tekst'
      responses:
        200:
          description: "Status 200"
          schema:
            required:
            - "_embedded"
            type: "object"
            properties:
              _embedded:
                required:
                - "gebiedsaanduidingen"
                type: "object"
                properties:
                  gebiedsaanduidingen:
                    type: array
                    x-result-ref: collection
                    items:
                      $ref: "#/definitions/Gebiedsaanduiding"
              _links:
                required:
                - "self"
                type: "object"
                properties:
                  self:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar huidige pagina"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/gebiedsaanduidingen"
                  next:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar volgende pagina (niet aanwezig\
                      \ als er geen volgende pagina is)"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/gebiedsaanduidingen?page=2"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /gebiedsaanduidingen/{id}:
    get:
      tags:
      - "Gebiedsaanduidingen"
      summary: "gebiedsaanduidingen resource"
      parameters:
      - $ref: '#/parameters/id'
      - $ref: '#/parameters/acceptCrs'
      responses:
        200:
          description: "Status 200"
          schema:
            $ref: "#/definitions/Gebiedsaanduiding"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /maatvoeringen:
    get:
      tags:
      - "Maatvoeringen"
      summary: "maatvoeringen collectie"
      parameters:
      - $ref: '#/parameters/acceptCrs'
      - $ref: '#/parameters/bestemmingsplangebied'
      # - $ref: '#/parameters/bestemmingsvlak'
      # - $ref: '#/parameters/gebiedsaanduiding'
      # - $ref: '#/parameters/bouwvlak'
      # - $ref: '#/parameters/tekst'      
      responses:
        200:
          description: "Status 200"
          schema:
            required:
            - "_embedded"
            type: "object"
            properties:
              _embedded:
                required:
                - "maatvoeringen"
                type: "object"
                properties:
                  maatvoeringen:
                    type: array
                    x-result-ref: collection
                    items:
                      $ref: "#/definitions/Maatvoering"
              _links:
                required:
                - "self"
                type: "object"
                properties:
                  self:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar huidige pagina"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/maatvoeringen"
                  next:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar volgende pagina (niet aanwezig\
                      \ als er geen volgende pagina is)"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/maatvoeringen?page=2"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /maatvoeringen/{id}:
    get:
      tags:
      - "Maatvoeringen"
      summary: "maatvoeringen resource"
      parameters:
      - $ref: '#/parameters/id'
      - $ref: '#/parameters/acceptCrs'
      responses:
        200:
          description: "Status 200"
          schema:
            $ref: "#/definitions/Maatvoering"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /bouwaanduidingen:
    get:
      tags:
      - "Bouwaanduidingen"
      summary: "bouwaanduidingen collectie"
      parameters:
      - $ref: '#/parameters/acceptCrs'
      - $ref: '#/parameters/bestemmingsplangebied'
      # - $ref: '#/parameters/bestemmingsvlak'
      # - $ref: '#/parameters/gebiedsaanduiding'
      # - $ref: '#/parameters/bouwvlak'
      # - $ref: '#/parameters/tekst'      
      responses:
        200:
          description: "Status 200"
          schema:
            required:
            - "_embedded"
            type: "object"
            properties:
              _embedded:
                required:
                - "bouwaanduidingen"
                type: "object"
                properties:
                  bouwaanduidingen:
                    type: array
                    x-result-ref: collection
                    items:
                      $ref: "#/definitions/Bouwaanduiding"
              _links:
                required:
                - "self"
                type: "object"
                properties:
                  self:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar huidige pagina"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwaanduidingen"
                  next:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar volgende pagina (niet aanwezig\
                      \ als er geen volgende pagina is)"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwaanduidingen?page=2"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /bouwaanduidingen/{id}:
    get:
      tags:
      - "Bouwaanduidingen"
      summary: "bouwaanduidingen resource"
      parameters:
      - $ref: '#/parameters/id'
      - $ref: '#/parameters/acceptCrs'
      responses:
        200:
          description: "Status 200"
          schema:
            $ref: "#/definitions/Bouwaanduiding"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /figuren:
    get:
      tags:
      - "Figuren"
      summary: "figuren collectie"
      parameters:
      - $ref: '#/parameters/bestemmingsplangebied'
      # - $ref: '#/parameters/bestemmingsvlak'
      # - $ref: '#/parameters/gebiedsaanduiding'
      # - $ref: '#/parameters/bouwvlak'
      # - $ref: '#/parameters/tekst'      
      responses:
        200:
          description: "Status 200"
          schema:
            required:
            - "_embedded"
            type: "object"
            properties:
              _embedded:
                required:
                - "figuren"
                type: "object"
                properties:
                  figuren:
                    type: array
                    x-result-ref: collection
                    items:
                      $ref: "#/definitions/Figuur"
              _links:
                required:
                - "self"
                type: "object"
                properties:
                  self:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar huidige pagina"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/figuren"
                  next:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar volgende pagina (niet aanwezig\
                      \ als er geen volgende pagina is)"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/figuren?page=2"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /figuren/{id}:
    get:
      tags:
      - "Figuren"
      summary: "figuren resource"
      parameters:
      - $ref: '#/parameters/id'
      - $ref: '#/parameters/acceptCrs'
      responses:
        200:
          description: "Status 200"
          schema:
            $ref: "#/definitions/Figuur"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /bouwvlakken:
    get:
      tags:
      - "Bouwvlakken"
      summary: "bouwvlakken collectie"
      parameters:
      - $ref: '#/parameters/acceptCrs'
      - $ref: '#/parameters/bestemmingsplangebied'
      - $ref: '#/parameters/bestemmingsvlak'
      - $ref: '#/parameters/tekst'
      - $ref: '#/parameters/maatvoering'
      - $ref: '#/parameters/bouwaanduiding'
      - $ref: '#/parameters/figuur'
      responses:
        200:
          description: "Status 200"
          schema:
            required:
            - "_embedded"
            type: "object"
            properties:
              _embedded:
                required:
                - "bouwvlakken"
                type: "object"
                properties:
                  bouwvlakken:
                    type: array
                    x-result-ref: collection
                    items:
                      $ref: "#/definitions/Bouwvlak"
              _links:
                required:
                - "self"
                type: "object"
                properties:
                  self:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar huidige pagina"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwvlakken"
                  next:
                    required:
                    - "href"
                    type: "object"
                    description: "Absolute link naar volgende pagina (niet aanwezig\
                      \ als er geen volgende pagina is)"
                    properties:
                      href:
                        type: "string"
                        example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwvlakken?page=2"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
  /bouwvlakken/{id}:
    get:
      tags:
      - "Bouwvlakken"
      summary: "bouwvlakken resource"
      parameters:
      - $ref: '#/parameters/id'
      - $ref: '#/parameters/acceptCrs'
      responses:
        200:
          description: "Status 200"
          schema:
            $ref: "#/definitions/Bouwvlak"
        401:
          description: "Unauthorized. Je hebt waarschijnlijk geen geldige `X-Api-Key`\
            \ header meegestuurd."
          schema:
            $ref: "#/definitions/Error"
        403:
          description: "Forbidden. Je hebt geen rechten om deze URL te benaderen."
          schema:
            $ref: "#/definitions/Error"
        404:
          description: "Status 404"
          schema:
            $ref: "#/definitions/Error"
        406:
          description: "Not Acceptable. Je hebt waarschijnlijk een gewenst formaat\
            \ met de `Accept` header verstuurd welke niet ondersteund wordt. De API\
            \ kan momenteel alleen `application/hal+json` terugsturen."
          schema:
            $ref: "#/definitions/Error"
        503:
          description: "Service Unavailable. Er vindt mogelijk (gepland) onderhoud\
            \ of een storing plaats."
          schema:
            $ref: "#/definitions/Error"
          headers:
            Retry-After:
              type: "string"
              format: "date-time"
              description: "Tijdstip waarop verwacht is dat de service weer beschikbaar\
                \ zal zijn."
              x-example: "Sun, 28 Nov 2017 16:41:41 GMT"
definitions:
  Bestemmingsplangebied:
    type: "object"
    required:
    - "_links"
    - "id"
    - "type"
    properties:
      _links:
        required:
        - "self"
        type: "object"
        x-exclude-empty-and-null-value-properties: true
        properties:
          self:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden/759"
                x-relative-link:
                  pattern: /bestemmingsplangebieden/$1
                  x-ldpath: "fn:concat(nen3610:identificatie / nen3610:namespace, \".\", nen3610:identificatie / nen3610:lokaalID, \"-\", nen3610:identificatie / nen3610:versie) :: xsd:string"
          externPlan:
            type: "object"
            x-ldpath: "(ro:vervangt|ro:muteert|ro:tenGevolgeVan)"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden/758"
                x-relative-link:
                  pattern: /bestemmingsplangebieden/$1
                  x-ldpath: "ro:identificatieExternPlan :: xsd:string"
                  x-href-required: false
          bestemmingsvlakken:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsvlakken?bestemmingsplangebied=759"
                x-relative-link:
                  pattern: /bestemmingsvlakken?bestemmingsplangebied=$1
                  x-ldpath: "fn:concat(nen3610:identificatie / nen3610:namespace, \".\", nen3610:identificatie / nen3610:lokaalID, \"-\", nen3610:identificatie / nen3610:versie) :: xsd:string"
#          functieaanduidingen:
#            type: "object"
#            properties:
#              href:
#                type: "string"
#                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/functieaanduidingen?bestemmingsplangebied=759"
#          gebiedsaanduidingen:
#            type: "object"
#            properties:
#              href:
#                type: "string"
#                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/gebiedsaanduidingen?bestemmingsplangebied=759"
#          maatvoeringen:
#            type: "object"
#            properties:
#              href:
#                type: "string"
#                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/maatvoeringen?bestemmingsplangebied=759"
#          bouwaanduidingen:
#            type: "object"
#            properties:
#              href:
#                type: "string"
#                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwaanduidingen?bestemmingsplangebied=759"
#          figuren:
#            type: "object"
#            properties:
#              href:
#                type: "string"
#                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/figuren?bestemmingsplangebied=759"
#          bouwvlakken:
#            type: "object"
#            properties:
#              href:
#                type: "string"
#                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwvlakken?bestemmingsplangebied=759"
          teksten:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten?bestemmingsplangebied=759"
                x-relative-link:
                  pattern: /teksten?bestemmingsplangebied=$1
                  x-ldpath: "fn:concat(nen3610:identificatie / nen3610:namespace, \".\", nen3610:identificatie / nen3610:lokaalID, \"-\", nen3610:identificatie / nen3610:versie) :: xsd:string"
      id:
        type: "string"
        example: "NL.IMRO.0268.BPa10500-VG01"
        x-ldpath: "fn:concat(nen3610:identificatie / nen3610:namespace, \".\", nen3610:identificatie / nen3610:lokaalID, \"-\", nen3610:identificatie / nen3610:versie) :: xsd:string"
      type:
        type: "string"
        enum:
        - "bestemmingsplan"
        - "inpassingsplan"
        - "rijksbestemmingsplan"
        - "uitwerkingsplan"
        - "wijzigingsplan"
        example: "bestemmingsplan"
        x-ldpath: "rdf:type / dcterms:subject / skos:notation :: xsd:string"
      beleidsmatigVerantwoordelijkeOverheid:
        type: object
        properties:
          type:
            type: "string"
            enum:
            - "gemeentelijke overheid"
            - "deelgemeente/stadsdeel"
            - "provinciale overheid"
            - "nationale overheid"
            example: "gemeentelijke overheid"
            x-ldpath: "ro:beleidsmatigVerantwoordelijkeOverheid / rdf:type / rdfs:label :: xsd:string"
          code:
            type: "string"
            description: "CBS-code van de beleidsmatig verantwoordelijke overheid. Altijd 4 cijfers, indien nodig aangevuld met voorloopnullen."
            example: "0000"
            x-ldpath: "ro:beleidsmatigVerantwoordelijkeOverheid / ro:code :: xsd:string"
          naam:
            type: "array"
            x-ldpath: "ro:beleidsmatigVerantwoordelijkeOverheid / ro:naamOverheid"
            items:
              type: "string"
              example: "gemeente Nijmegen"
      naam:
        type: "string"
        example: "Nijmegen Westkanaaldijk 2016"
        x-ldpath: "ro:naam :: xsd:string"
      locatieNaam:
        type: "string"
        example: "TODO"
        x-ldpath: "ro:locatienaam"
      planstatusInfo:
        type: "object"
        properties:
          planstatus:
            type: "string"
            enum:
            - "concept"
            - "voorontwerp"
            - "ontwerp"
            - "vastgesteld"
            - "geconsolideerd"
            example: "vastgesteld"
            x-ldpath: "ro:planstatus / ro:status :: xsd:string"
          datum:
            type: "string"
            example: "TODO: xsd:date wordt nog niet ondersteund door grid-api?"
#            format: "date"
            x-ldpath: "ro:planstatus / ro:datum :: xsd:date"
      verwijzingNaarVaststellingsbesluit:
        type: "string"
        example: "TODO: URL onderdeel van `vaststellingsbesluit`? Is dit een link naar een API resource of naar een extern document (bijv. pdf)`?"
        x-ldpath: "ro:vaststellingsbesluit"
      besluitnummer:
        type: "string"
        example: "TODO: besluitnummer is onderdeel van `vaststellingsbesluit`?"
        x-ldpath: "ro:vaststellingsbesluit / ro:besluitnummer :: xsd:string"
      verwijzingNorm:
        type: "array"
        x-ldpath: "ro:norm / skos:notation"
        items:
          type: "string"
          example: "IMRO2012"
      geometrie:
        type: object
        # $ref: "#/definitions/GeoJSON"
        x-type: geometry
        x-ldpath: "geo:hasGeometry / geo:asWKT :: geo:wktLiteral"
  Tekst:
    type: "object"
    required:
    - "titel"
    - "volgnummer"
    - "_links"
    properties:
      titel:
        type: "string"
        example: "1.0: Hoofdstuk 1"
        x-ldpath: "ro:titel / ro:titelnaam :: xsd:string"
      inhoud:
        type: "string"
        description: "Inhoud van van het tekstblok. Voor de Ruimtelijke Plannen is dit XHTML, voor LVBB wellicht XML en voor andere informatiehuizen wellicht plain text. Hoe een client dit moet behandelen wordt in de verbeelding afgehandeld."
        example: "<p>Dit is een paragraaf met een <a href=\"https://www.google.com\">Linkje naar Google</a>.</p>"
        x-ldpath: "ro:tekst :: xsd:string"
      volgnummer:
        type: "integer"
        example: "42"
        x-ldpath: "ro:volgnummer :: xsd:string"
      _links:
        required:
        - "self"
        type: "object"
        x-exclude-empty-and-null-value-properties: true
        properties:
          self:
            required:
            - "href"
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten/429"
                x-relative-link:
                  pattern: "/teksten/$1"
                  x-ldpath: 'fn:keepAfterLast(., "/") :: xsd:string'
          parent:
            type: "object"
            x-ldpath: "ro:ouder"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten/428"
                x-relative-link:
                  pattern: "/teksten/$1"
                  x-ldpath: 'fn:keepAfterLast(., "/") :: xsd:string'
#             title:
#               type: "string"
#               example: "1.0: Hoofdstuk 1"
          bestemmingsplangebieden:
           type: "object"
           properties:
             href:
               type: "string"
               example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden?tekst=429"
               x-relative-link:
                 pattern: "/bestemmingsplangebieden?tekst=$1"
                 x-ldpath: 'fn:keepAfterLast(., "/") :: xsd:string'
        #   children:
        #     type: "array"
        #     items:
        #       required:
        #       - "href"
        #       type: "object"
        #       properties:
        #         href:
        #           type: "string"
        #           example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten/430"
        #         title:
        #           type: "string"
        #           example: "1.1.1: Hoofstuk 1.1.1"
        #   bestemmingsvlakken:
        #     type: "object"
        #     properties:
        #       href:
        #         type: "string"
        #         example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsvlakken?tekst=429"
        #   functieaanduidingen:
        #     type: "object"
        #     properties:
        #       href:
        #         type: "string"
        #         example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/functieaanduidingen?tekst=429"
        #   gebiedsaanduidingen:
        #     type: "object"
        #     properties:
        #       href:
        #         type: "string"
        #         example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/gebiedsaanduidingen?tekst=429"
        #   maatvoeringen:
        #     type: "object"
        #     properties:
        #       href:
        #         type: "string"
        #         example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/maatvoeringen?tekst=429"
        #   bouwaanduidingen:
        #     type: "object"
        #     properties:
        #       href:
        #         type: "string"
        #         example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwaanduidingen?tekst=429"
        #   figuren:
        #     type: "object"
        #     properties:
        #       href:
        #         type: "string"
        #         example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/figuren?tekst=429"
        #   bouwvlakken:
        #     type: "object"
        #     properties:
        #       href:
        #         type: "string"
        #         example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwvlakken?tekst=429"
  Bestemmingsvlak:
    type: "object"
    required:
    - "_links"
    - "type"
    properties:
      _links:
        required:
        - "self"
        type: "object"
        properties:
          self:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsvlakken/NL.IMRO.423d9f5d924c4f76a001a94f8ca284b4"
                x-grid-link:
                  pattern: /bestemmingsvlakken/$1
                  x-ldpath: "fn:concat(nen3610:identificatie / nen3610:namespace, \".\", nen3610:identificatie / nen3610:lokaalID) :: xsd:string"
          # bestemmingsplangebieden:
          #   type: "object"
          #   properties:
          #     href:
          #       type: "string"
          #       example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden?bestemmingsvlak=94"
          # functieaanduidingen:
          #   type: "object"
          #   properties:
          #     href:
          #       type: "string"
          #       example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/functieaanduidingen?bestemmingsvlak=94"
          # gebiedsaanduidingen:
          #   type: "object"
          #   properties:
          #     href:
          #       type: "string"
          #       example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/gebiedsaanduidingen?bestemmingsvlak=94"
          # maatvoeringen:
          #   type: "object"
          #   properties:
          #     href:
          #       type: "string"
          #       example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/maatvoeringen?bestemmingsvlak=94"
          # bouwaanduidingen:
          #   type: "object"
          #   properties:
          #     href:
          #       type: "string"
          #       example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwaanduidingen?bestemmingsvlak=94"
          # figuren:
          #   type: "object"
          #   properties:
          #     href:
          #       type: "string"
          #       example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/figuren?bestemmingsvlak=94"
          # bouwvlakken:
          #   type: "object"
          #   properties:
          #     href:
          #       type: "string"
          #       example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwvlakken?bestemmingsvlak=94"
          # teksten:
          #   type: "object"
          #   properties:
          #     href:
          #       type: "string"
          #       example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten?bestemmingsvlak=94"
      id:
        type: "string"
        example: "NL.IMRO.423d9f5d924c4f76a001a94f8ca284b4"
        x-ldpath: "fn:concat(nen3610:identificatie / nen3610:namespace, \".\", nen3610:identificatie / nen3610:lokaalID) :: xsd:string"
      type:
        type: "string"
        enum:
        - "enkelbestemming"
        - "dubbelbestemming"
        example: "enkelbestemming"
        x-ldpath: "rdf:type[rdfs:subClassOf is ro:Bestemmingsvlak] :: xsd:string"
      naam:
        type: "string"
        example: "Enkelbestemming Bedrijventerrein"
        x-ldpath: "ro:naam :: xsd:string"
      bestemmingshoofdgroep:
        type: "string"
        example: "Natuur"
        x-ldpath: "ro:bestemmingshoofdgroep :: xsd:string"
      artikelnummer:
        type: "string"
        example: "43"
        x-ldpath: "ro:artikelnummer :: xsd:string"
      # labelInfo:
      #   type: "string"
      #   example: "TODO VERBEELDING"
      geometrie:
        type: object
        # $ref: "#/definitions/GeoJSON"
        x-type: geometry
        x-ldpath: "geo:hasGeometry / geo:asWKT :: geo:wktLiteral"
  Functieaanduiding:
    type: "object"
    required:
    - "_links"
    properties:
      _links:
        required:
        - "self"
        type: "object"
        properties:
          self:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/functieaanduidingen/94"
          teksten:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten?functieaanduiding=94"
          bestemmingsplangebieden:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden?functieaanduiding=94"
          bestemmingsvlakken:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsvlakken?functieaanduiding=94"
          gebiedsaanduidingen:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/gebiedsaanduidingen?functieaanduiding=94"
          figuren:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/figuren?functieaanduiding=94"
      id:
        type: "string"
        example: "NL.IMRO.3e542fd876e84c3db419b4e2d3f11089"
        x-ldpath: "fn:concat(nen3610:identificatie / nen3610:namespace, \".\", nen3610:identificatie / nen3610:lokaalID) :: xsd:string"
      naam:
        type: "string"
        x-ldpath: "ro:naam"
    #   labelInfo:
    #     type: "string"
    #     example: "TODO"
      geometrie:
        $ref: "#/definitions/GeoJSON"
  Gebiedsaanduiding:
    type: "object"
    required:
    - "_links"
    properties:
      id:
        type: "string"
        example: "TODO"
      gebiedsaanduidinggroep:
        type: "string"
        example: "overige zone"
      artikelnummer:
        type: "string"
        example: "18.1"
      labelInfo:
        type: "string"
        example: "Gebiedsaanduiding overige zone - .geluidgezoneerd industrieterrein"
      geometrie:
        $ref: "#/definitions/GeoJSON"
      _links:
        required:
        - "self"
        type: "object"
        properties:
          self:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/gebiedsaanduidingen/94"
          bestemmingsplangebieden:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden?gebiedsaanduiding=94"
          bestemmingsvlakken:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsvlakken?gebiedsaanduiding=94"
          teksten:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten?gebiedsaanduiding=94"
          functieaanduidingen:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/functieaanduidingen?gebiedsaanduiding=94"
          maatvoeringen:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/maatvoeringen?gebiedsaanduiding=94"
          bouwaanduidingen:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwaanduidingen?gebiedsaanduiding=94"
          figuren:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/figuren?gebiedsaanduiding=94"
  Maatvoering:
    type: "object"
    properties:
      id:
        type: "string"
        example: "NL.IMRO.c233eb4c242c4d01bb41f41b983b1e95"
      symboolInfo:
        type: "string"
        example: "s130h"
      maatvoeringInfo:
        type: "string"
        example: "Maximum bouwhoogte (m): 18"
      geometrie:
        $ref: "#/definitions/GeoJSON"
      _links:
        required:
        - "self"
        type: "object"
        properties:
          self:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/maatvoeringen/94"
          bestemmingsplangebieden:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden?maatvoering=94"
          bestemmingsvlakken:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsvlakken?maatvoering=94"
          teksten:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten?maatvoering=94"
          gebiedsaanduidingen:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/gebiedsaanduidingen?maatvoering=94"
          bouwvlakken:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwvlakken?maatvoering=94"
  Bouwaanduiding:
    type: "object"
    properties:
      id:
        type: "string"
        example: "TODO"
      labelInfo:
        type: "string"
        example: "TODO"
      geometrie:
        $ref: "#/definitions/GeoJSON"
        x-ldpath: "rdf:type / dcterms:subject / skos:notation :: xsd:string"
      _links:
        required:
        - "self"
        type: "object"
        properties:
          self:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwaanduidingen/94"
                x-relative-link:
                  pattern: /bestemmingsplangebieden/$1
                  x-ldpath: "fn:concat(nen3610:identificatie / nen3610:lokaalID, \"-\", nen3610:identificatie / nen3610:versie) :: xsd:string"

                # context-sensitive links
                # looks up a specific x-relative-link object by comparing "id" with reference to a field
                #                x-grid-context-links:
                #                  - id: "bestemmingsplangebied"
                #                    x-relative-link:
                #                      pattern: /bestemmingsplangebieden/$1
                #                      x-ldpath: "fn:concat(nen3610:identificatie / nen3610:lokaalID, \"-\", nen3610:identificatie / nen3610:versie) :: xsd:string"
                #                  - id: "bestemmingsvlak"
                #                    x-relative-link:
                #                      pattern: /bestemmingsvlakken/$1
                #                      x-ldpath: "fn:concat(nen3610:identificatie / nen3610:lokaalID, \"-\", nen3610:identificatie / nen3610:versie) :: xsd:string"

              title:
                type: "string"
                description: "Human-readable titel van de link"
                x-ldpath: "ro:naam :: xsd:string"
                example: "Kamergewverh VSG1"
          bestemmingsplangebieden:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden?bouwaanduiding=94"
          bestemmingsvlakken:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsvlakken?bouwaanduiding=94"
          teksten:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten?bouwaanduiding=94"
          gebiedsaanduidingen:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/gebiedsaanduidingen?bouwaanduiding=94"
          bouwvlakken:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwvlakken?bouwaanduiding=94"
  Figuur:
    type: "object"
    required:
    - "_links"
    properties:
      id:
        type: "string"
        example: "NL.IMRO.6ba21d351eda49a9808e79b3617f4dcf"
      labelInfo:
        type: "string"
        example: "TODO"
      geometrie:
        $ref: "#/definitions/GeoJSON"
      _links:
        required:
        - "self"
        type: "object"
        properties:
          self:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/figuren/94"
          bestemmingsplangebieden:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden?figuur=94"
          bestemmingsvlakken:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsvlakken?figuur=94"
          teksten:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten?figuur=94"
          gebiedsaanduidingen:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/gebiedsaanduidingen?figuur=94"
          bouwvlakken:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwvlakken?figuur=94"
  Bouwvlak:
    type: "object"
    properties:
      id:
        type: "string"
        example: "TODO"
      geometrie:
        $ref: "#/definitions/GeoJSON"
      _links:
        required:
        - "self"
        type: "object"
        properties:
          self:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwvlakken/94"
          bestemmingsplangebieden:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsplangebieden?bouwvlak=94"
          bestemmingsvlakken:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bestemmingsvlakken?bouwvlak=94"
          teksten:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/teksten?bouwvlak=94"
          maatvoeringen:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/maatvoeringen?bouwvlak=94"
          bouwaanduidingen:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/bouwaanduidingen?bouwvlak=94"
          figuren:
            type: "object"
            properties:
              href:
                type: "string"
                example: "https://data.pdok.nl/ruimtelijke-plannen/api/v1/figuren?bouwvlak=94"
  SearchResult:
    type: "object"
    required:
    - "_links"
    - "type"
    properties:
      type:
        type: "string"
        enum:
        - "bestemmingsplangebied"
        - "bestemmingsvlak"
        - "dossier"
        - "tekst"
        x-ldpath: "rdf:type / dcterms:subject / skos:notation :: xsd:string"
      _links:
        required:
        - "self"
        type: "object"
        properties:
          self:
            required:
            - "href"
            - "title"
            type: "object"
            properties:
              href:
                type: "string"
                x-relative-link:
                  pattern: /bestemmingsplangebieden/$1
                  x-ldpath: "fn:concat(nen3610:identificatie / nen3610:lokaalID, \"-\", nen3610:identificatie / nen3610:versie) :: xsd:string"

                # context-sensitive links
                # looks up a specific x-relative-link object by comparing "id" with reference to a field
#                x-grid-context-links:
#                  - id: "bestemmingsplangebied"
#                    x-relative-link:
#                      pattern: /bestemmingsplangebieden/$1
#                      x-ldpath: "fn:concat(nen3610:identificatie / nen3610:lokaalID, \"-\", nen3610:identificatie / nen3610:versie) :: xsd:string"
#                  - id: "bestemmingsvlak"
#                    x-relative-link:
#                      pattern: /bestemmingsvlakken/$1
#                      x-ldpath: "fn:concat(nen3610:identificatie / nen3610:lokaalID, \"-\", nen3610:identificatie / nen3610:versie) :: xsd:string"

              title:
                type: "string"
                x-ldpath: "ro:naam :: xsd:string"
                description: "Human-readable titel van de link"
                example: "Kamergewverh VSG1"
  GeoJSON:
    type: "object"
    required:
    - "coordinates"
    - "type"
    properties:
      type:
        type: "string"
        enum:
        - "Point"
        - "Polygon"
        - "LineString"
        - "MultiPoint"
        - "MultiLineString"
        - "MultiPolygon"
        example: "Polygon"
      coordinates:
        type: "array"
# do *not* set type of array content explicitly (because it may vary and depend on whether
# this Geo object describes point or polygon or multi-point, or.. etc)
        description: "Array met coördinaten behorende bij dit GeoJSON object. De structuur van de array hangt af van het `type`."
        example: [[[5.858910083770752,51.84376540294041],[5.85968255996704,51.84259879644993],[5.860852003097533,51.84413658957469],[5.858910083770752,51.84376540294041]]]
  Error:
    type: "object"
    required:
    - "detail"
    - "instance"
    - "status"
    - "title"
    - "type"
    properties:
      type:
        type: "string"
        description: "URI naar een pagina met meer informatie over deze foutmelding\
          \ voor de ontwikkelaar."
        default: "about:blank"
        example: "about:blank"
      title:
        type: "string"
      status:
        type: "integer"
        example: 404
      detail:
        type: "string"
      instance:
        type: "string"