components:
  examples:
    activiteitIdentificatieZoekVoorbeeld:
      summary: Zoekobject voor activiteitIdentificatie
      value:
        geometrie:
          coordinates:
          - - - 120581.444
              - 487991.742
            - - 121745.144
              - 487991.742
            - - 121745.144
              - 489095.64
            - - 120581.444
              - 489095.64
            - - 120581.444
              - 487991.742
          type: Polygon
        spatialOperator: intersects
    locatieIdentificatiesEnGeoZoekobjectVoorbeeld:
      summary: Zoekobject voor zoeken op combinatie van geometrie en locatie identificaties
      value:
        geo:
          geometrie:
            coordinates:
            - - - 136859
                - 423253
              - - 136880
                - 423811
              - - 138214
                - 423627
              - - 138186
                - 423627
              - - 136859
                - 423253
            type: Polygon
        locatieIdentificaties:
        - nl.imow-gm0000.gebied.test
        - nl.imow-gm0000.gebiedengroep.test
    locatieZoekobjectVoorbeeld:
      summary: Zoekobject voor locatie
      value:
        geo:
          geometrie:
            coordinates:
            - 188193
            - 503793
            type: Point
          spatialOperator: intersects
        locatieIdentificaties:
        - nl.imow-gm0000.gebied.test
    primaireLocatieZoekobjectVoorbeeld:
      summary: Zoekobject voor primairelocatie
      value:
        geo:
          geometrie:
            coordinates:
            - - - 136859
                - 423253
              - - 136880
                - 423811
              - - 138214
                - 423627
              - - 138186
                - 423627
              - - 136859
                - 423253
            type: Polygon
        locatieIdentificaties:
        - nl.imow-gm0000.gebied.test
        - nl.imow-gm0000.gebiedengroep.test
  headers:
    API-Version:
      description: De versie van de API
      example: 1.0.0
      explode: false
      schema:
        example: 1.0.0
        type: string
      style: simple
    X-Pagination-Count:
      description: Totaal aantal pagina's.
      example: 3
      explode: false
      required: false
      schema:
        example: 3
        type: integer
      style: simple
    X-Pagination-Limit:
      description: Objecten per pagina.
      example: 3
      explode: false
      required: false
      schema:
        example: 3
        type: integer
      style: simple
    X-Pagination-Page:
      description: Huidige pagina.
      example: 1
      explode: false
      required: false
      schema:
        example: 1
        type: integer
      style: simple
    X-Total-Count:
      description: Totaal aantal objecten.
      example: 100
      explode: false
      required: false
      schema:
        example: 100
        type: integer
      style: simple
  parameters:
    ContentCrsHeader:
      description: Content-Crs
      explode: false
      in: header
      name: Content-Crs
      required: true
      schema:
        default: EPSG:28992
        enum:
        - EPSG:28992
        example: EPSG:28992
        type: string
      style: simple
    Page:
      explode: true
      in: query
      name: page
      required: false
      schema:
        example: 0
        format: int32
        minimum: 0
        type: integer
      style: form
    Size:
      description: De pagesize moet minimaal een waarde van 1 hebben en maximaal een
        waarde van 200.
      explode: true
      in: query
      name: size
      required: false
      schema:
        default: 20
        example: 20
        format: int32
        maximum: 200
        minimum: 1
        type: integer
      style: form
    Sort:
      explode: true
      in: query
      name: sort
      required: false
      schema:
        example: desc
        type: string
      style: form
    StatusFilter:
      description: |
        Geef aan om actieve, beëindigde of alle activiteitversies te ontvangen, bij geen keuze (null) wordt de standaardselectie 'actief' gehanteerd.
      explode: false
      in: query
      name: status
      required: false
      schema:
        items:
          $ref: '#/components/schemas/StatusFilterEnum'
        type: array
      style: form
    beschikbaarOp:
      description: |
        Een tijdreisparameter langs de 'beschikbaar'-tijdsas.  Deze tijdreis toont de versie van het object die beschikbaar is op de opgegeven datumtijd in de Europe/Amsterdam tijdszone.  Wanneer deze parameter niet opgegeven wordt, dan wordt een tijdreisvraag gesteld met als parameter 'nu', d.w.z. de huidige datumtijd in de Europe/Amsterdam tijdszone. De tijdreisparameter wordt doorgegeven aan onderliggende hal-links.
      explode: true
      in: query
      name: beschikbaarOp
      required: false
      schema:
        example: "2022-07-07T11:34:01Z"
        format: date-time
        type: string
      style: form
    geldigOp:
      description: |
        Een tijdreisparameter langs de geldigheids-tijdsas.  Deze tijdreis toont de versie van het object die op de opgegeven datum materieel geldig is.  Wanneer deze parameter niet opgegeven wordt, dan wordt een tijdreisvraag gesteld met als parameter 'vandaag'. Een gecombineerde tijdreisvraag langs 'geldigOp' en 'inWerkingOp' geeft de versie van het object die op de opgegeven datum juridisch geldig is. De tijdreisparameter wordt doorgegeven aan onderliggende hal-links.
      explode: true
      in: query
      name: geldigOp
      required: false
      schema:
        example: "2020-05-09"
        format: date
        type: string
      style: form
    inWerkingOp:
      description: |
        Een tijdreisparameter langs de juridische-werking-tijdsas.  Deze tijdreis toont de versie van het object die op de opgegeven datum juridisch in werking is.  Wanneer deze parameter niet opgegeven wordt, dan wordt een tijdreisvraag gesteld met als parameter 'vandaag'. Een gecombineerde tijdreisvraag langs 'geldigOp' en 'inWerkingOp' geeft de versie van het object die op de opgegeven datum juridisch geldig is. De tijdreisparameter wordt doorgegeven aan onderliggende hal-links.
      explode: true
      in: query
      name: inWerkingOp
      required: false
      schema:
        example: "2020-05-08"
        format: date
        type: string
      style: form
    synchroniseerMetTileset:
      description: |
        Voer een tijdreis uit langs de beschikbaarheids-as naar het moment dat de huidige tileset aangevraagd werd. Hiermee garandeer je dat de data die je opvraagt correspondeert met het kaartbeeld dat in de huidige tileset weergegeven wordt. Er kan een tijdreis uitgevoerd worden naar het moment van aanvragen van een van beide tilesets:
          - normaal: tijdreis naar het aanvraagmoment van de tileset bij de actueel geldige gegevens; wanneer geen tijdreis gedaan wordt langs de geldigheids- of beschikbaarheidsas dien je 'normaal' te gebruiken;
          - volledig: tijdreis naar het aanvraagmoment van de tileset bij alle gegevens, ook historische, toekomstige, en niet meer geldige gegevens; wanneer een tijdreis gedaan wordt langs de geldigheids- of beschikbaarheidsas dien je 'volledig' te gebruiken.
        Combineren van deze parameter met een expliciete tijdreis langs de beschikbaarOp tijdsas is niet mogelijk.  Wanneer beide parameters meegegeven worden, dan krijgt de expliciete beschikbaarOp-parameter voorrang boven deze parameter.
      explode: true
      in: query
      name: synchroniseerMetTileset
      required: false
      schema:
        enum:
        - normaal
        - volledig
        type: string
      style: form
  responses:
    BadRequest:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem400'
      description: Bad request
    NotAcceptable:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem406'
      description: Not acceptable
    NotFound:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem404'
      description: Not found
    PreconditionFailed:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem412'
      description: Precondition failed
    ServerError:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem500'
      description: Internal Server Error
    Unprocessable:
      content:
        application/problem+json:
          schema:
            $ref: '#/components/schemas/Problem422'
      description: Unprocessable
  schemas:
    ActiviteitHalCollectionLinks:
      properties:
        heeftJuridischeBron:
          description: uri voor het opvragen van de juridische bron
          properties:
            href:
              $ref: '#/components/schemas/Href'
          type: object
        heeftRegeltekst:
          description: uri voor het opvragen van de regeltekst
          properties:
            href:
              $ref: '#/components/schemas/Href'
          type: object
        self:
          description: uri van de api aanroep die tot dit resultaat heeft geleid
          properties:
            href:
              $ref: '#/components/schemas/Href'
          type: object
      type: object
    ActiviteitLocatie:
      description: |
        De Locatie van de ActiviteitVersie, afgeleid via de ActiviteitLocatieaanduiding van de Juridische Regel. De tijdslijnen opgenomen in deze relatie zijn de tijdslijnen van de Juridische Regel, voorzover deze binnen de tijdslijnen van deze ActiviteitVersie vallen.
      properties:
        geregistreerdMet:
          $ref: '#/components/schemas/Registratiegegevens'
        identificatie:
          $ref: '#/components/schemas/Identificatie'
        juridischeRegelIdentificatie:
          $ref: '#/components/schemas/Identificatie'
      required:
      - geregistreerdMet
      - identificatie
      - juridischeRegelIdentificatie
      title: Locatie
      type: object
    ActiviteitMetGeaggregeerdeLocatieInfo:
      description: |
        De versie van een Activiteit zoals bedoeld in CIMOW, met een minimum aan activiteit locaties in isGereguleerdVoor.  Een versie is een voorkomen van de activiteit in een periode waarin deze ongewijzigd is gebleven.
      properties:
        _links:
          $ref: '#/components/schemas/ActiviteitHalCollectionLinks'
        bevoegdGezag:
          $ref: '#/components/schemas/BevoegdGezag'
        geregistreerdMet:
          $ref: '#/components/schemas/ActiviteitRegistratiegegevens'
        gerelateerd:
          items:
            $ref: '#/components/schemas/Identificatie'
          type: array
        groep:
          properties:
            code:
              type: string
            waarde:
              type: string
          required:
          - code
          - waarde
          type: object
        identificatie:
          $ref: '#/components/schemas/Identificatie'
        is:
          $ref: '#/components/schemas/Identificatie'
        isGereguleerdVoor:
          description: |
            Deze specifieke activiteit is gereguleerd voor deze specifieke locatie(s). Deze locaties zijn afgeleide gegevens, afgeleid van ActiviteitLocatieaanduidingen (zie CIMOW). Om de specifiek geldige versie van de locatie te verkrijgen kan een aparte (tijdreis)vraag gedaan worden op de locatie-resource.
          items:
            $ref: '#/components/schemas/GeaggregeerdeLocatieInfo'
          type: array
        laatsteWijzigingOp:
          example: "2020-05-08"
          format: date
          type: string
        naam:
          example: Vellen van een houtopstand
          type: string
        oin:
          deprecated: true
          description: |
            Extra gegeven (niet van een activiteit). Het OrganisatieIdentificatieNummer van het bevoegd gezag van deze activiteit op het moment van opvragen. Het OIN is ongeversioneerd, en Ozon garandeert niet dat dit juist is op het moment van opvragen.
          example: "00000001807288111000"
          type: string
      required:
      - _links
      - geregistreerdMet
      - groep
      - identificatie
      - laatsteWijzigingOp
      - naam
      title: Activiteit met geaggregeerde locatie informatie
      type: object
    ActiviteitRegistratiegegevens:
      description: |
        De registratiegegevens bevatten de tijdslijnen van dit object conform NEN3610:2021.
      properties:
        beginGeldigheid:
          example: "2020-05-05"
          format: date
          type: string
        eindGeldigheid:
          example: "2020-07-05"
          format: date
          type: string
        status:
          description: "De status van een object is een aanduiding waarmee aangegeven
            kan worden dat de OW-informatie, in deze versie van het object, niet meer
            geldig is. \nDit geeft bijvoorbeeld aan of deze activiteit beëindigd ('B')
            is. Het ontbreken van de status betekent dat de versie van het object
            niet is beëindigd.\n"
          enum:
          - B
          type: string
        versie:
          example: 1
          type: integer
      required:
      - beginGeldigheid
      - versie
      title: Minimum activiteit Registratiegegevens van activiteit
      type: object
    ActiviteitRegistratiegegevensVanLocatie:
      description: |
        De registratiegegevens bevatten de tijdslijnen van dit object conform NEN3610:2021.
      properties:
        beginGeldigheid:
          example: "2020-05-05"
          format: date
          type: string
        eindGeldigheid:
          example: "2020-07-05"
          format: date
          type: string
      required:
      - beginGeldigheid
      title: Minimum activiteit Registratiegegevens van locatie
      type: object
    ActiviteitenMetGeaggregeerdeLocatieInfo:
      properties:
        _embedded:
          properties:
            activiteiten:
              items:
                $ref: '#/components/schemas/ActiviteitMetGeaggregeerdeLocatieInfo'
              type: array
          required:
          - activiteiten
          type: object
        _links:
          $ref: '#/components/schemas/HalPaginationLinks'
        page:
          $ref: '#/components/schemas/Page'
      required:
      - _embedded
      - _links
      - page
      type: object
    AppHealthResponse:
      properties:
        app-health:
          properties:
            status:
              $ref: '#/components/schemas/AppHealthStatus'
          required:
          - status
          title: AppHealth
          type: object
      required:
      - app-health
      title: AppHealthResponse
      type: object
    AppHealthStatus:
      enum:
      - UP
      - DOWN
      type: string
    BevoegdGezag:
      description: |
        Extra gegeven (niet van een activiteit). Dit wordt afgeleid van het omgevingsdocument ten tijde van muteren van de activiteit (geen rekening houdend met een bv. gemeentelijke herindeling).
      properties:
        bestuurslaag:
          enum:
          - gemeente
          - provincie
          - waterschap
          - ministerie
          title: bestuurslaag
          type: string
        code:
          description: |
            De code van het bevoegd gezag dat deze activiteit indiende, bestaand uit twee letters en twee tot en met vier cijfers.
          example: pv24
          title: code
          type: string
        naam:
          title: naam
          type: string
      required:
      - bestuurslaag
      - code
      - naam
      type: object
    BoundingBox:
      description: De bounding box van de bij de locatie behorende geometrie. Indien
        de locatie een groep is, is de bounding box het resultaat van alle onderliggende
        bounding boxes gecombineerd.
      properties:
        maxX:
          multipleOf: 0.001
          type: number
        maxY:
          multipleOf: 0.001
          type: number
        minX:
          multipleOf: 0.001
          type: number
        minY:
          multipleOf: 0.001
          type: number
      required:
      - maxX
      - maxY
      - minX
      - minY
      type: object
    GeaggregeerdeLocatieInfo:
      description: |
        De Locatie van de ActiviteitVersie, afgeleid via de ActiviteitLocatieaanduiding van de Juridische Regel. De tijdslijnen opgenomen in deze relatie zijn de tijdslijnen van de Juridische Regel, voorzover deze binnen de tijdslijnen van deze ActiviteitVersie vallen.
      properties:
        geregistreerdMet:
          $ref: '#/components/schemas/ActiviteitRegistratiegegevensVanLocatie'
        identificatie:
          $ref: '#/components/schemas/Identificatie'
      required:
      - geregistreerdMet
      - identificatie
      title: GeaggregeerdeLocatieInfo
      type: object
    GeoJsonGeometry:
      description: Geometrie in GeoJSON formaat (RFC 7946).
      externalDocs:
        description: RFC 7946 - The GeoJSON Format
        url: https://tools.ietf.org/html/rfc7946
      oneOf:
      - $ref: '#/components/schemas/GeometryCollection'
      - $ref: '#/components/schemas/Point'
      - $ref: '#/components/schemas/LineString'
      - $ref: '#/components/schemas/Polygon'
      - $ref: '#/components/schemas/MultiPoint'
      - $ref: '#/components/schemas/MultiLineString'
      - $ref: '#/components/schemas/MultiPolygon'
      title: GeoJSON Geometry
    GeoJsonZoekobject:
      description: Zoekobject om te zoeken op geometrie.
      properties:
        geometrie:
          $ref: '#/components/schemas/GeoJsonGeometry'
        spatialOperator:
          default: intersects
          description: |
            Een subset van de ruimtelijke operatoren zoals gedefinieerd in ISO 19125-1:

            - `intersects`: retourneert alle geometrieën die de zoekgeometrie snijden (inclusief overlap, volledig binnen de zoekgeometrie liggen en raken)
            - `interior-intersects`: retourneert alle geometrieën waarvan het binnengebied de zoekgeometrie snijdt (er is sprake van overlap of de geometrie ligt geheel of gedeeltelijk binnen de zoekgeometrie; situaties waarbij alleen de grenzen elkaar raken zijn uitgesloten)
          enum:
          - intersects
          - interior-intersects
          type: string
      type: object
    GeometrieIdentificaties:
      description: Geometrie identificaties
      properties:
        _embedded:
          properties:
            geometrieIdentificaties:
              items:
                type: string
              type: array
          required:
          - geometrieIdentificaties
          type: object
      type: object
    GeometryCollection:
      properties:
        geometries:
          items:
            anyOf:
            - $ref: '#/components/schemas/Point'
            - $ref: '#/components/schemas/LineString'
            - $ref: '#/components/schemas/Polygon'
            - $ref: '#/components/schemas/MultiPoint'
            - $ref: '#/components/schemas/MultiLineString'
            - $ref: '#/components/schemas/MultiPolygon'
          type: array
        type:
          enum:
          - GeometryCollection
          type: string
      required:
      - geometries
      - type
      title: GeoJSON GeometryCollection
      type: object
    HalCollectionLinks:
      properties:
        self:
          description: uri van de api aanroep die tot dit resultaat heeft geleid
          properties:
            href:
              $ref: '#/components/schemas/Href'
          type: object
      type: object
    HalPaginationLinks:
      allOf:
      - $ref: '#/components/schemas/HalCollectionLinks'
      - properties:
          first:
            description: uri voor het opvragen van de eerste pagina van deze collectie
            properties:
              href:
                $ref: '#/components/schemas/Href'
              title:
                example: Eerste pagina
                type: string
            type: object
          last:
            description: uri voor het opvragen van de laatste pagina van deze collectie
            properties:
              href:
                $ref: '#/components/schemas/Href'
              title:
                example: Laatste pagina
                type: string
            type: object
          next:
            description: uri voor het opvragen van de volgende pagina van deze collectie
            properties:
              href:
                $ref: '#/components/schemas/Href'
              title:
                example: Volgende pagina
                type: string
            type: object
          prev:
            description: uri voor het opvragen van de vorige pagina van deze collectie
            properties:
              href:
                $ref: '#/components/schemas/Href'
              title:
                example: Vorige pagina
                type: string
            type: object
        type: object
    HealthResponse:
      properties:
        status:
          $ref: '#/components/schemas/AppHealthStatus'
      required:
      - status
      type: object
    Href:
      example: https://datapunt.voorbeeldgemeente.nl/api/resourcename/123456789
      format: uri
      type: string
    Identificatie:
      description: De unieke identificatie waaronder elk object van dit type bekend
        is.
      title: Identificatie
      type: string
    Info:
      description: Informatie over deze API, bijvoorbeeld de versie van de API en
        de versie van de gebruikte standaarden
      properties:
        app-info:
          properties:
            cimowVersion:
              description: Versie van het CIMOW informatiemodel waar deze API zich
                aan houdt
              type: string
            description:
              description: Mens-leesbare beschrijving van deze API
              type: string
            imowVersion:
              description: versie van het IMOW informatiemodel waar deze API zich
                aan houdt
              type: string
            name:
              description: Mens-leesbare naam van deze API.
              type: string
            stopVersion:
              description: Versie van de STOP/TPOD standaard waar deze API zich aan
                houdt
              type: string
            version:
              description: De versie van deze API zoals te lezen in de API spec en
                overeenkomende met de API-Version response header
              type: string
          type: object
      required:
      - app-info
      type: object
    JuridischeBron:
      description: De juridische bron van een activiteit is altijd de regeling waar
        de definitie van de activiteit in is benoemd. De juridische bron kan als een
        begripsbepaling opgenomen zijn bij de begripsbepalingen of in de lopende tekst
        van een regeltekst.
      properties:
        documentIdentificatie:
          description: Een verwijzing naar de regeling waarin de juridische bron te
            vinden is. De verwijzing is in deze de identificatie van een omgevingsdocument
            (een zogenaamde AKN identificatie)
          example: /akn/nl/act/gm0106/2019/reg456RGL-20201125-112022
          type: string
        regelteksten:
          description: Een lijst van verwijzingen naar regelteksten waarin de eerste
            versie van de activiteit benoemt wordt. De verwijzing is in deze de identificatie
            van een regeltekst (een zogenaamde IMOW identificatie).
          items:
            $ref: '#/components/schemas/Regeltekst'
          type: array
      required:
      - documentIdentificatie
      - regelteksten
      title: Juridische bron
      type: object
    LineString:
      properties:
        bbox:
          items:
            multipleOf: 0.001
            type: number
          minItems: 4
          type: array
        coordinates:
          items:
            items:
              multipleOf: 0.001
              type: number
            minItems: 2
            type: array
          minItems: 2
          type: array
        type:
          enum:
          - LineString
          type: string
      required:
      - coordinates
      - type
      title: GeoJSON LineString
      type: object
    Locatie:
      properties:
        _embedded:
          properties:
            omvat:
              description: Locaties binnen locate groep
              items:
                $ref: '#/components/schemas/Locatie'
              type: array
          type: object
        _links:
          $ref: '#/components/schemas/HalCollectionLinks'
        boundingBox:
          $ref: '#/components/schemas/BoundingBox'
        geometrieIdentificatie:
          example: 4b46ca74-3840-4ce1-91b6-abf749802f6c
          title: Identificatie van de geometrie
          type: string
        geregistreerdMet:
          $ref: '#/components/schemas/Registratiegegevens'
        identificatie:
          $ref: '#/components/schemas/Identificatie'
        noemer:
          title: noemer
          type: string
        status:
          description: |
            De status van een object is een aanduiding waarmee aangegeven kan worden dat de OW-informatie, in deze versie van het object, niet meer geldig is. Dit geeft bijvoorbeeld aan of deze activiteit beeindigd ('B') is.
          enum:
          - B
          - null
          type: string
      required:
      - _links
      - geregistreerdMet
      - identificatie
      title: Locatie
      type: object
    LocatieIdentificatieZoekobject:
      description: Zoekobject voor specifieke Locatie-bevragingen.
      example:
        geo:
          geometrie:
            coordinates:
            - 139784
            - 442870
            type: Point
          spatialOperator: intersects
      properties:
        geo:
          $ref: '#/components/schemas/GeoJsonZoekobject'
      required:
      - geo
      type: object
    LocatieIdentificatiesEnGeoZoekobject:
      description: |
        Zoekobject voor bevragingen op basis van geometrieen en locatie identificaties. Resultaten moeten zich zowel binnen de gegeven geometrie bevinden, als overeenkomen met de één van de opgegeven locatie identificaties.
      example:
        geo:
          geometrie:
            coordinates:
            - 188193
            - 503793
            type: Point
          spatialOperator: intersects
        locatieIdentificaties:
        - nl.imow-gm0000.gebied.test
      properties:
        geo:
          $ref: '#/components/schemas/GeoJsonZoekobject'
        locatieIdentificaties:
          items:
            type: string
          type: array
      required:
      - geo
      - locatieIdentificaties
      type: object
    LocatieIdentificatiesOfGeoZoekobject:
      description: |
        Zoekobject voor bevragingen op basis van geometrie of een of meerdere locatie identificaties. Requests die geen van beide of een geometrie én locatie identificaties bevatten worden afgekeurd.
      example:
        geo:
          geometrie:
            coordinates:
            - 188193
            - 503793
            type: Point
          spatialOperator: intersects
        locatieIdentificaties:
        - nl.imow-gm0000.gebied.test
      properties:
        geo:
          $ref: '#/components/schemas/GeoJsonZoekobject'
        locatieIdentificaties:
          items:
            type: string
          minItems: 1
          type: array
      type: object
    LocatieMetSpatialOperator:
      properties:
        _links:
          $ref: '#/components/schemas/HalCollectionLinks'
        geregistreerdMet:
          $ref: '#/components/schemas/Registratiegegevens'
        identificatie:
          $ref: '#/components/schemas/Identificatie'
        noemer:
          title: noemer
          type: string
        spatialOperator:
          $ref: '#/components/schemas/SpatialRelation'
      required:
      - _links
      - geregistreerdMet
      - identificatie
      title: Locatie
      type: object
    LocatieZoekgebieden:
      description: LocatieZoekgebieden
      properties:
        _embedded:
          properties:
            locatieidentificaties:
              items:
                type: string
              type: array
          required:
          - locaties
          type: object
      type: object
    LocatieZoekobject:
      description: "Zoekobject voor specifieke locatie-bevragingen. \nHet locatiezoekobject
        bevat ofwel 1. alleen een geo bestaande uit een geometrie en een spatialOperator,
        ofwel 2. een geo en een lijst locatie-identificaties.\n1. Wanneer het locatiezoekobject
        alleen GeoJSON bevat met de spatialOperator intersects, dan retourneert de
        zoekopdracht alle locaties die intersecten met de geometrie. Wanneer gevonden
        locaties daarnaast binnen het zoekgebied vallen, bevat de respons de spatialOperator
        'within'.  2. Wanneer het locatiezoekobject zowel GeoJSON als locatie-identificaties
        bevat, dan retourneert de zoekopdracht alleen de locaties waarvan de identificatie
        voorkomt in de gegeven lijst met identificaties, die ook gevonden zijn op
        of binnen de gegeven geometrie.\n"
      example:
        geo:
          geometrie:
            coordinates:
            - 188193
            - 503793
            type: Point
          spatialOperator: intersects
        locatieIdentificaties:
        - nl.imow-gm0000.gebied.test
      properties:
        geo:
          $ref: '#/components/schemas/GeoJsonZoekobject'
        locatieIdentificaties:
          items:
            type: string
          type: array
      required:
      - geo
      type: object
    LocatiesMetSpatialOperator:
      properties:
        _embedded:
          properties:
            locaties:
              items:
                $ref: '#/components/schemas/LocatieMetSpatialOperator'
              type: array
          required:
          - locaties
          type: object
        _links:
          $ref: '#/components/schemas/HalPaginationLinks'
        page:
          $ref: '#/components/schemas/Page'
      required:
      - _links
      - page
      type: object
    MultiLineString:
      properties:
        bbox:
          items:
            multipleOf: 0.001
            type: number
          minItems: 4
          type: array
        coordinates:
          items:
            items:
              items:
                multipleOf: 0.001
                type: number
              minItems: 2
              type: array
            minItems: 2
            type: array
          type: array
        type:
          enum:
          - MultiLineString
          type: string
      required:
      - coordinates
      - type
      title: GeoJSON MultiLineString
      type: object
    MultiPoint:
      properties:
        bbox:
          items:
            multipleOf: 0.001
            type: number
          minItems: 4
          type: array
        coordinates:
          items:
            items:
              multipleOf: 0.001
              type: number
            minItems: 2
            type: array
          type: array
        type:
          enum:
          - MultiPoint
          type: string
      required:
      - coordinates
      - type
      title: GeoJSON MultiPoint
      type: object
    MultiPolygon:
      properties:
        bbox:
          items:
            multipleOf: 0.001
            type: number
          minItems: 4
          type: array
        coordinates:
          items:
            items:
              items:
                items:
                  multipleOf: 0.001
                  type: number
                minItems: 2
                type: array
              minItems: 4
              type: array
            type: array
          type: array
        type:
          enum:
          - MultiPolygon
          type: string
      required:
      - coordinates
      - type
      title: GeoJSON MultiPolygon
      type: object
    Page:
      description: Info voor paginering
      properties:
        number:
          example: 0
          format: int32
          type: integer
        size:
          example: 20
          format: int32
          type: integer
        totalElements:
          example: 1
          format: int32
          type: integer
        totalPages:
          example: 1
          format: int32
          type: integer
      required:
      - number
      - size
      - totalElements
      - totalPages
      type: object
    Point:
      properties:
        bbox:
          items:
            multipleOf: 0.001
            type: number
          minItems: 4
          type: array
        coordinates:
          items:
            multipleOf: 0.001
            type: number
          minItems: 2
          type: array
        type:
          enum:
          - Point
          type: string
      required:
      - coordinates
      - type
      title: GeoJSON Point
      type: object
    Polygon:
      properties:
        bbox:
          items:
            multipleOf: 0.001
            type: number
          minItems: 4
          type: array
        coordinates:
          items:
            items:
              items:
                multipleOf: 0.001
                type: number
              minItems: 2
              type: array
            minItems: 4
            type: array
          type: array
        type:
          enum:
          - Polygon
          type: string
      required:
      - coordinates
      - type
      title: GeoJSON Polygon
      type: object
    PrimaireLocatie:
      properties:
        _links:
          $ref: '#/components/schemas/HalCollectionLinks'
        geregistreerdMet:
          $ref: '#/components/schemas/Registratiegegevens'
        identificatie:
          $ref: '#/components/schemas/Identificatie'
        noemer:
          title: noemer
          type: string
        spatialOperator:
          $ref: '#/components/schemas/SpatialRelation'
      required:
      - _links
      - geregistreerdMet
      - identificatie
      title: PrimaireLocatie
      type: object
    PrimaireLocatieZoekobject:
      description: |
        Zoekobject voor primairelocatie-bevragingen ten behoeve van het bevragen van Vector Tiles.  Het primaireLocatieZoekobject bevat alleen geo en een lijst van primaire locatie-identificaties.  Wanneer met het PrimaireLocatieZoekobject wordt gezocht retourneert de zoekopdracht de locaties waarvan de identificatie voorkomt in de opgegeven lijst met identificaties, die ook gevonden zijn op of binnen de opgegeven geometrie.
      example:
        geo:
          geometrie:
            coordinates:
            - 188193
            - 503793
            type: Point
          spatialOperator: intersects
        locatieIdentificaties:
        - nl.imow-gm0000.gebied.test
      properties:
        geo:
          $ref: '#/components/schemas/GeoJsonZoekobject'
        locatieIdentificaties:
          items:
            type: string
          type: array
      required:
      - geo
      type: object
    PrimaireLocaties:
      properties:
        _embedded:
          properties:
            primairelocaties:
              items:
                $ref: '#/components/schemas/PrimaireLocatie'
              type: array
          required:
          - primairelocaties
          type: object
        _links:
          $ref: '#/components/schemas/HalPaginationLinks'
        page:
          $ref: '#/components/schemas/Page'
      required:
      - _links
      - page
      type: object
    Problem:
      description: Standaardformaat (`application/problem+json`) voor probleemdetails
        in HTTP API''s (RFC 7807).
      properties:
        detail:
          description: Mens-leesbare uitleg van dit specifieke probleem.
          example: Interne server fout
          type: string
        instance:
          description: Absolute URI dat dit specifieke probleem identificeert.
          format: uri
          type: string
        status:
          description: De HTTP statuscode gegenereerd door de server waar het probleem
            zich voordoet.
          example: 500
          exclusiveMaximum: true
          format: int32
          maximum: 600
          minimum: 100
          type: integer
        title:
          description: Een korte samenvatting van het probleemtype bedoeld voor ontwikkelaars.
          type: string
        type:
          default: about:blank
          description: Absolute URI dat het probleemtype identificeert.
          format: uri
          type: string
      type: object
    Problem400:
      description: Standaardformaat (`application/problem+json`) voor probleemdetails
        in HTTP API's (RFC 7807).
      properties:
        detail:
          description: |
            Mens-leesbare uitleg van dit specifieke probleem.
          example: De server kan het verzoek niet verwerken vanwege een clientside
            fout
          type: string
        instance:
          description: |
            Absolute URI dat dit specifieke probleem identificeert.
          format: uri
          type: string
        status:
          description: |
            De HTTP statuscode gegenereerd door de server waar het probleem zich voordoet.
          example: 400
          exclusiveMaximum: true
          format: int32
          maximum: 600
          minimum: 100
          type: integer
        title:
          description: |
            Een korte samenvatting van het probleemtype bedoeld voor ontwikkelaars.
          example: Bad request
          type: string
        type:
          description: |
            Absolute URI dat het probleemtype identificeert.
          format: uri
          type: string
      type: object
    Problem404:
      description: Standaardformaat (`application/problem+json`) voor probleemdetails
        in HTTP API's (RFC 7807).
      properties:
        detail:
          description: |
            Mens-leesbare uitleg van dit specifieke probleem.
          example: De opgevraagde resource kan niet worden gevonden
          type: string
        instance:
          description: |
            Absolute URI dat dit specifieke probleem identificeert.
          format: uri
          type: string
        status:
          description: |
            De HTTP statuscode gegenereerd door de server waar het probleem zich voordoet.
          example: 404
          exclusiveMaximum: true
          format: int32
          maximum: 600
          minimum: 100
          type: integer
        title:
          description: |
            Een korte samenvatting van het probleemtype bedoeld voor ontwikkelaars.
          example: Not found
          type: string
        type:
          description: |
            Absolute URI dat het probleemtype identificeert.
          format: uri
          type: string
      type: object
    Problem406:
      description: Standaardformaat (`application/problem+json`) voor probleemdetails
        in HTTP API's (RFC 7807).
      properties:
        detail:
          description: |
            Mens-leesbare uitleg van dit specifieke probleem.
          example: 'Acceptable representations: [application/hal+json, application/problem+json].'
          type: string
        instance:
          description: |
            Absolute URI dat dit specifieke probleem identificeert.
          format: uri
          type: string
        status:
          description: |
            De HTTP statuscode gegenereerd door de server waar het probleem zich voordoet.
          example: 406
          exclusiveMaximum: true
          format: int32
          maximum: 600
          minimum: 100
          type: integer
        title:
          description: |
            Een korte samenvatting van het probleemtype bedoeld voor ontwikkelaars.
          example: Not Acceptable
          type: string
        type:
          description: |
            Absolute URI dat het probleemtype identificeert.
          format: uri
          type: string
      type: object
    Problem412:
      description: Standaardformaat (`application/problem+json`) voor probleemdetails
        in HTTP API's (RFC 7807).
      properties:
        detail:
          description: |
            Mens-leesbare uitleg van dit specifieke probleem.
          example: Dit verzoek vereist een Content-CRS header.
          type: string
        instance:
          description: |
            Absolute URI dat dit specifieke probleem identificeert.
          format: uri
          type: string
        status:
          description: |
            De HTTP statuscode gegenereerd door de server waar het probleem zich voordoet.
          example: 412
          exclusiveMaximum: true
          format: int32
          maximum: 600
          minimum: 100
          type: integer
        title:
          description: |
            Een korte samenvatting van het probleemtype bedoeld voor ontwikkelaars.
          example: Precondition failed
          type: string
        type:
          description: |
            Absolute URI dat het probleemtype identificeert.
          format: uri
          type: string
      type: object
    Problem422:
      description: Standaardformaat (`application/problem+json`) voor probleemdetails
        in HTTP API's (RFC 7807).
      properties:
        detail:
          description: |
            Mens-leesbare uitleg van dit specifieke probleem.
          example: Het request kan niet worden verwerkt vanwege een invalide geometrie
            of foute CRS code.
          type: string
        instance:
          description: |
            Absolute URI dat dit specifieke probleem identificeert.
          format: uri
          type: string
        status:
          description: |
            De HTTP statuscode gegenereerd door de server waar het probleem zich voordoet.
          example: 422
          exclusiveMaximum: true
          format: int32
          maximum: 600
          minimum: 100
          type: integer
        title:
          description: |
            Een korte samenvatting van het probleemtype bedoeld voor ontwikkelaars.
          example: Not found
          type: string
        type:
          description: |
            Absolute URI dat het probleemtype identificeert.
          format: uri
          type: string
      type: object
    Problem500:
      description: Standaardformaat (`application/problem+json`) voor probleemdetails
        in HTTP API's (RFC 7807).
      properties:
        detail:
          description: |
            Mens-leesbare uitleg van dit specifieke probleem.
          example: Er is een technische fout opgetreden
          type: string
        instance:
          description: |
            Absolute URI dat dit specifieke probleem identificeert.
          format: uri
          type: string
        status:
          description: |
            De HTTP statuscode gegenereerd door de server waar het probleem zich voordoet.
          example: 500
          exclusiveMaximum: true
          format: int32
          maximum: 600
          minimum: 100
          type: integer
        title:
          description: |
            Een korte samenvatting van het probleemtype bedoeld voor ontwikkelaars.
          example: Not found
          type: string
        type:
          description: |
            Absolute URI dat het probleemtype identificeert.
          format: uri
          type: string
      type: object
    Procedurestatus:
      description: De status in de procedure; vastgesteld of ontwerp
      enum:
      - vastgesteld
      - ontwerp
      type: string
    Regeltekst:
      description: Een Regeltekst is de kleinste zelfstandige eenheid van (een of
        meer) bij elkaar behorende juridische regels. Deze regels horen onlosmakelijk
        bij elkaar en hebben gezamenlijk één werkingsgebied.
      properties:
        documentIdentificatie:
          type: string
        identificatie:
          $ref: '#/components/schemas/Identificatie'
        label:
          deprecated: true
          description: Het label (bijvoorbeeld 'Artikel') van het bijbehorende documentcomponent.
          title: label
          type: string
        labelXml:
          description: Het label van het bijbehorende documentcomponent in xml formaat.
          title: labelXml
          type: string
        nummer:
          deprecated: true
          description: Het nummer (bijvoorbeeld '1.1') van het bijbehorende documentcomponent.
          title: nummer
          type: string
        nummerXml:
          description: Het nummer van het bijbehorende documentcomponent in xml formaat.
          title: nummerXml
          type: string
        omschrijving:
          description: De letterlijke tekst waarmee de Regeltekst is omschreven, in
            een artikel of een lid. Een Regeltekst is altijd één doorlopend stuk juridische
            tekst, welke juridische regels bevat.
          title: omschrijving
          type: string
        opschrift:
          description: Het opschrift van het bijbehorende documentcomponent.
          title: opschrift
          type: string
        procedurestatus:
          $ref: '#/components/schemas/Procedurestatus'
        wId:
          description: Het WorkID (conform FRBR) van het corresponderende artikel
            in IMOP
          title: wId
          type: string
      required:
      - documentIdentificatie
      - identificatie
      - omschrijving
      - procedurestatus
      - wId
      title: Regeltekst
      type: object
    Regelteksten:
      properties:
        _embedded:
          properties:
            regelteksten:
              items:
                $ref: '#/components/schemas/Regeltekst'
              type: array
          required:
          - regelteksten
          type: object
        _links:
          $ref: '#/components/schemas/HalPaginationLinks'
        page:
          $ref: '#/components/schemas/Page'
      required:
      - _embedded
      - _links
      - page
      type: object
    Registratiegegevens:
      description: |
        Een informatieobject dat de tijdslijnen en versie van een geversioneerd object beschrijft, conform NEN3610:2021, alsmede het veld 'beginInwerking', dat DSO-specifiek is. Voor locaties wordt hierbij de door Ozon afgeleide versionering aangehouden die rekening houdt met indirecte mutaties, zoals een gewijzigde samengestelde geometrie van een locatiegroep (vanwege wijzigingen in de geometrie van een onderliggend item) of wijzigingen in de primair/secundair status van een locatie.
      properties:
        beginGeldigheid:
          example: "2020-05-05"
          format: date
          type: string
        beginInwerking:
          example: "2020-05-08"
          format: date
          type: string
        eindGeldigheid:
          example: "2020-07-05"
          format: date
          type: string
        eindRegistratie:
          description: |
            Moment vanaf wanneer er een nieuwere versie dan deze versie bekend is bij Ozon. Deze versie is vanaf dit moment niet meer actief. Datumtijd in ISO 8601 formaat (yyyy-mm-dd'T'hh:mm:ss.SSSSSS).
          example: 2020-05-08T10:00:01.987654
          pattern: \d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{6}
          type: string
        isPrimair:
          description: |
            Geeft aan of een locatie "primair" is, wat betekent dat er naar wordt verwezen door een OW-object anders dan Locatie zelf.
          example: true
          type: boolean
        status:
          description: |
            De status van een object is een aanduiding waarmee aangegeven kan worden dat de OW-informatie, in deze versie van het object, niet meer geldig is. Dit geeft bijvoorbeeld aan of deze activiteit beeindigd ('B') is.
          enum:
          - B
          - null
          type: string
        subType:
          title: subType
          type: string
        tijdstipRegistratie:
          description: |
            Moment vanaf wanneer deze versie bekend is bij Ozon. Deze versie is actief totdat er een nieuwe versie beschikbaar komt. Datumtijd in ISO 8601 formaat (yyyy-mm-dd'T'hh:mm:ss.SSSSSS).
          example: 2020-05-08T10:00:01.987654
          pattern: \d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}\.\d{6}
          type: string
        versie:
          type: integer
      required:
      - beginGeldigheid
      - beginInwerking
      - tijdstipRegistratie
      title: Registratiegegevens
      type: object
    SpatialRelation:
      description: Een metagegeven dat aangeeft wat de relatie is tussen het opgegeven
        zoekgebied (de geometrie in het request van de API) en de gevonden Locaties,
        zoals geredeneerd vanuit de Locatie (de resource in de response van de API).
      enum:
      - intersects
      - within
      type: string
    StatusFilterEnum:
      default: actief
      enum:
      - actief
      - beeindigd
      example: actief
      type: string
info:
  contact:
    email: beheerdso@kadaster.nl
    name: Kadaster DSO - Team Ozon
    url: https://developer.omgevingswet.overheid.nl/services/contact/
  description: |
    De Omgevingsdocumenten Toepasbaar API ontsluit juridische activiteiten in onderlinge samenhang, aangevuld met bijbehorende informatie zoals locaties. Dit ten behoeve van gebruik voor in het bijzonder Toepasbare Regels (DSO-LV) en de functionele structuur. Deze samenhang tussen de juridische activiteiten vormt de basis voor deze functionele structuur.
    Op de Ontwikkel, Test, Acceptatie en Pre-productieomgeving worden ook omgevingsdocumenten toegevoegd en verwijderd door beheerders voor testdoeleinden binnen en buiten de voorziening.<br/>
    De Omgevingsdocumenten Toepasbaar API volgt de standaarden zoals beschreven in de DSO API-strategie versie 1.1. Zo is het standaard mediatype HAL (`application/hal+json`). Dit is een mediatype voor het weergeven van resources en hun relaties via hyperlinks.
  title: Omgevingsdocumenten Toepasbaar
  version: 7.7.5
openapi: 3.0.0
paths:
  /activiteiten/{identificatie}/juridischebron:
    get:
      operationId: getActiviteitJuridischeBron
      parameters:
      - $ref: '#/components/parameters/geldigOp'
      - $ref: '#/components/parameters/inWerkingOp'
      - $ref: '#/components/parameters/beschikbaarOp'
      - $ref: '#/components/parameters/synchroniseerMetTileset'
      - example: nl.imow-gm0037.activiteit.2019000242example
        explode: false
        in: path
        name: identificatie
        required: true
        schema:
          type: string
        style: simple
      responses:
        "200":
          content:
            application/hal+json:
              schema:
                $ref: '#/components/schemas/JuridischeBron'
          description: OK
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        "400":
          $ref: '#/components/responses/BadRequest'
        "404":
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem404'
          description: Er is geen activiteit met deze identificatie.
        "406":
          $ref: '#/components/responses/NotAcceptable'
        "500":
          $ref: '#/components/responses/ServerError'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: |
        De juridische bron van een activiteit opvragen. De juridische bron is het artikel/lid of de artikelen/leden waar de activiteit als eerste genoemd wordt.
      tags:
      - Activiteiten
  /activiteiten/{identificatie}/regelteksten:
    get:
      operationId: getActiviteitRegelteksten
      parameters:
      - $ref: '#/components/parameters/geldigOp'
      - $ref: '#/components/parameters/inWerkingOp'
      - $ref: '#/components/parameters/beschikbaarOp'
      - $ref: '#/components/parameters/synchroniseerMetTileset'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Size'
      - $ref: '#/components/parameters/Sort'
      - example: nl.imow-gm0037.activiteit.2019000242example
        explode: false
        in: path
        name: identificatie
        required: true
        schema:
          type: string
        style: simple
      responses:
        "200":
          content:
            application/hal+json:
              schema:
                $ref: '#/components/schemas/Regelteksten'
          description: OK
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        "400":
          $ref: '#/components/responses/BadRequest'
        "404":
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem404'
          description: Er is geen activiteit met deze identificatie.
        "406":
          $ref: '#/components/responses/NotAcceptable'
        "500":
          $ref: '#/components/responses/ServerError'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: |
        De regelteksten van een activiteit opvragen. De regeltekten van een activiteit zijn alle regelteksten waarin de activiteit genoemd wordt op het moment van de tijdreisvraag.
      tags:
      - Activiteiten
  /activiteitengeaggregeerd/{identificatie}/levenscyclus:
    get:
      description: |
        Bij elke activiteitversie worden alle locatieversies opgenomen die binnen de levensduur van die activiteitversie actief waren.
        De relatie tussen activiteit en locatie wordt afgeleid via de juridische regel die de relatie vastlegt; de activiteit en locatie hebben een relatie met elkaar in de periode dat de juridische regel juridisch geldig is, en naar zowel de activiteit als de locatie verwijst. De identificatie van de juridische regel die de relatie vastlegt, is opgenomen in de relatie.
        Bij gebruik van de parameter 'gemuteerdSinds' worden alleen activiteiten teruggegeven die sinds die datum  (begin van de dag) ontstaan, gewijzigd, of beëindigd zijn; van die activiteiten worden alleen de versies  teruggegeven waarop ten minste een mutatie is gedaan op of na deze datum. Bij gebruik van de parameter 'beschikbaarOp' worden alleen activiteiten teruggegeven die zijn ontstaan,  gewijzigd, of beëindigd voor die datum (begin van de dag). Van die activiteiten worden alleen de versies  teruggegeven die voor deze datum beschikbaar waren.
      operationId: getActiviteitMetGeaggregeerdeLocatieInfoLevencsyclus
      parameters:
      - $ref: '#/components/parameters/StatusFilter'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Size'
      - $ref: '#/components/parameters/Sort'
      - example: nl.imow-gm0037.activiteit.2019000242example
        explode: false
        in: path
        name: identificatie
        required: true
        schema:
          type: string
        style: simple
      - description: |
          Deze parameter geeft een filtermogelijkheid om alleen activiteiten terug te gegeven die op of na deze datum gemuteerd (d.w.z. opgevoerd, gewijzigd, of beëindigd) zijn, en daarvan alle versies vanaf dat moment. Datum in ISO 8601 formaat (yyyy-mm-dd).
        example: "2019-01-01"
        explode: false
        in: query
        name: gemuteerdSinds
        required: false
        schema:
          format: date
          type: string
        style: form
      - $ref: '#/components/parameters/beschikbaarOp'
      responses:
        "200":
          content:
            application/hal+json:
              schema:
                $ref: '#/components/schemas/ActiviteitenMetGeaggregeerdeLocatieInfo'
          description: OK
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        "400":
          $ref: '#/components/responses/BadRequest'
        "404":
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem404'
          description: Er is geen activiteit met deze identificatie.
        "406":
          $ref: '#/components/responses/NotAcceptable'
        "500":
          $ref: '#/components/responses/ServerError'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: |
        Een specifieke activiteit ophalen op basis van de identificatie
      tags:
      - Activiteiten
  /activiteitengeaggregeerd/levenscyclus:
    get:
      description: |
        Onder de activiteitversie worden de ontdubbelde locatieversies opgenomen die binnen de levensduur van die activiteitversie actief waren.
        Bij gebruik van de parameter 'gemuteerdSinds' worden alleen activiteiten teruggegeven die sinds die datum  (begin van de dag) ontstaan, gewijzigd, of beëindigd zijn; van die activiteiten worden alleen de versies  teruggegeven waarop ten minste een mutatie is gedaan op of na deze datum. Bij gebruik van de parameter 'beschikbaarOp' worden alleen activiteiten teruggegeven die zijn ontstaan,  gewijzigd, of beëindigd voor die datum (begin van de dag). Van die activiteiten worden alleen de versies  teruggegeven die voor deze datum beschikbaar waren.
      operationId: getActiviteitenMetGeaggregeerdeLocatieInfoLevenscyclus
      parameters:
      - $ref: '#/components/parameters/StatusFilter'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Size'
      - $ref: '#/components/parameters/Sort'
      - description: |
          Deze parameter geeft een filtermogelijkheid om alleen activiteiten terug te gegeven die op of na deze datum gemuteerd (d.w.z. opgevoerd, gewijzigd, of beëindigd) zijn, en daarvan alle versies vanaf dat moment. Datum in ISO 8601 formaat (yyyy-mm-dd).
        example: "2019-01-01"
        explode: false
        in: query
        name: gemuteerdSinds
        required: false
        schema:
          format: date
          type: string
        style: form
      - $ref: '#/components/parameters/beschikbaarOp'
      responses:
        "200":
          content:
            application/hal+json:
              schema:
                $ref: '#/components/schemas/ActiviteitenMetGeaggregeerdeLocatieInfo'
          description: OK
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
            X-Pagination-Count:
              $ref: '#/components/headers/X-Pagination-Count'
            X-Pagination-Limit:
              $ref: '#/components/headers/X-Pagination-Limit'
            X-Pagination-Page:
              $ref: '#/components/headers/X-Pagination-Page'
            X-Total-Count:
              $ref: '#/components/headers/X-Total-Count'
        "400":
          $ref: '#/components/responses/BadRequest'
        "406":
          $ref: '#/components/responses/NotAcceptable'
        "500":
          $ref: '#/components/responses/ServerError'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: |
        Activiteiten opvragen met geaggregeerde locatie info.
      tags:
      - Activiteiten
  /activiteitidentificaties/_zoek:
    post:
      description: |
        Activiteit identificaties worden teruggegeven die voldoen aan de zoekobject-parameters.
      operationId: zoekActiviteitIdentificaties
      parameters:
      - $ref: '#/components/parameters/geldigOp'
      - $ref: '#/components/parameters/inWerkingOp'
      - $ref: '#/components/parameters/beschikbaarOp'
      - $ref: '#/components/parameters/synchroniseerMetTileset'
      - $ref: '#/components/parameters/ContentCrsHeader'
      requestBody:
        content:
          application/json:
            examples:
              activiteitIdentificatieZoekVoorbeeld:
                $ref: '#/components/examples/activiteitIdentificatieZoekVoorbeeld'
            schema:
              $ref: '#/components/schemas/GeoJsonZoekobject'
        description: zoekobject
        required: true
      responses:
        "200":
          content:
            application/json:
              schema:
                items:
                  type: string
                type: array
          description: ActiviteitIdentificaties
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        "400":
          $ref: '#/components/responses/BadRequest'
        "406":
          $ref: '#/components/responses/NotAcceptable'
        "412":
          $ref: '#/components/responses/PreconditionFailed'
        "422":
          $ref: '#/components/responses/Unprocessable'
        "500":
          $ref: '#/components/responses/ServerError'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: Activiteit identificaties opvragen die voldoen aan zoekobject-parameters.
      tags:
      - Activiteiten
  /app-health:
    get:
      operationId: getAppHealth
      responses:
        "200":
          content:
            application/json:
              example:
                app-health:
                  status: UP
              schema:
                $ref: '#/components/schemas/AppHealthResponse'
          description: OK
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        "503":
          content:
            application/json:
              example:
                app-health:
                  status: DOWN
              schema:
                $ref: '#/components/schemas/AppHealthResponse'
          description: Service unavailable
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: app-health info
      tags:
      - Meta
  /app-info:
    get:
      operationId: getInfo
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Info'
          description: Info
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: applicatie info
      tags:
      - Meta
  /geometrieidentificaties/_zoek:
    post:
      description: Dit endpoint levert geometrieidentificaties van gebieden/lijnen/punten/ambtsgebieden
        die overeenkomen met de zoekopdracht.
      operationId: zoekGeometrieIdentificaties
      parameters:
      - $ref: '#/components/parameters/geldigOp'
      - $ref: '#/components/parameters/inWerkingOp'
      - $ref: '#/components/parameters/beschikbaarOp'
      - $ref: '#/components/parameters/synchroniseerMetTileset'
      - $ref: '#/components/parameters/ContentCrsHeader'
      requestBody:
        content:
          application/json:
            examples:
              locatieIdentificatiesEnGeoZoekobjectVoorbeeld:
                $ref: '#/components/examples/locatieIdentificatiesEnGeoZoekobjectVoorbeeld'
            schema:
              $ref: '#/components/schemas/LocatieIdentificatiesEnGeoZoekobject'
        description: LocatieIdentificatiesEnGeoZoekobject
        required: true
      responses:
        "200":
          content:
            application/hal+json:
              schema:
                $ref: '#/components/schemas/GeometrieIdentificaties'
          description: Locatie hashes
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        "400":
          $ref: '#/components/responses/BadRequest'
        "406":
          $ref: '#/components/responses/NotAcceptable'
        "412":
          $ref: '#/components/responses/PreconditionFailed'
        "422":
          $ref: '#/components/responses/Unprocessable'
        "500":
          $ref: '#/components/responses/ServerError'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: geometrieidentificaties opvragen die voldoen aan zoekobject-parameters
        ten behoeve van Vector Tile bevraging.
      tags:
      - GeometrieIdentificaties
  /health:
    get:
      deprecated: true
      operationId: getHealth
      responses:
        "200":
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HealthResponse'
          description: OK
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: Dit endpoint levert health informatie uit, maar volgt niet de DSO API-strategie
        en is daarom deprecated met /app-health als vervanger.
      tags:
      - Meta
  /locatieidentificaties/_zoek:
    post:
      operationId: zoekLocatieIdentificaties
      parameters:
      - $ref: '#/components/parameters/ContentCrsHeader'
      - $ref: '#/components/parameters/geldigOp'
      - $ref: '#/components/parameters/inWerkingOp'
      - $ref: '#/components/parameters/beschikbaarOp'
      - $ref: '#/components/parameters/synchroniseerMetTileset'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/LocatieIdentificatiesOfGeoZoekobject'
        description: Zoekobject
        required: true
      responses:
        "200":
          content:
            application/hal+json:
              schema:
                $ref: '#/components/schemas/LocatieZoekgebieden'
          description: OK
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        "400":
          $ref: '#/components/responses/BadRequest'
        "406":
          $ref: '#/components/responses/NotAcceptable'
        "412":
          $ref: '#/components/responses/PreconditionFailed'
        "422":
          $ref: '#/components/responses/Unprocessable'
        "500":
          $ref: '#/components/responses/ServerError'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: Alle locatieIdentificaties opvragen die voldoen aan de geo in het zoekobject
      tags:
      - Locaties
  /locaties/_zoek:
    post:
      description: |
        Locaties worden teruggegeven die voldoen aan de zoekobject-parameters. Sinds versie 7.0.4 worden ook locaties die niet gerelateerd zijn aan activiteiten teruggegeven.
        Zie LocatieZoekobject voor meer informatie.
      operationId: zoekLocaties
      parameters:
      - $ref: '#/components/parameters/geldigOp'
      - $ref: '#/components/parameters/inWerkingOp'
      - $ref: '#/components/parameters/beschikbaarOp'
      - $ref: '#/components/parameters/synchroniseerMetTileset'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Size'
      - $ref: '#/components/parameters/ContentCrsHeader'
      requestBody:
        content:
          application/json:
            examples:
              locatieZoekobjectVoorbeeld:
                $ref: '#/components/examples/locatieZoekobjectVoorbeeld'
            schema:
              $ref: '#/components/schemas/LocatieZoekobject'
        description: LocatieZoekobject
        required: true
      responses:
        "200":
          content:
            application/hal+json:
              schema:
                $ref: '#/components/schemas/LocatiesMetSpatialOperator'
          description: Locaties
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
            X-Pagination-Count:
              $ref: '#/components/headers/X-Pagination-Count'
            X-Pagination-Limit:
              $ref: '#/components/headers/X-Pagination-Limit'
            X-Pagination-Page:
              $ref: '#/components/headers/X-Pagination-Page'
            X-Total-Count:
              $ref: '#/components/headers/X-Total-Count'
        "400":
          $ref: '#/components/responses/BadRequest'
        "406":
          $ref: '#/components/responses/NotAcceptable'
        "412":
          $ref: '#/components/responses/PreconditionFailed'
        "422":
          $ref: '#/components/responses/Unprocessable'
        "500":
          $ref: '#/components/responses/ServerError'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: Locaties opvragen die voldoen aan zoekobject-parameters.
      tags:
      - Locaties
  /locaties/{identificatie}:
    get:
      operationId: getLocatie
      parameters:
      - $ref: '#/components/parameters/geldigOp'
      - $ref: '#/components/parameters/inWerkingOp'
      - $ref: '#/components/parameters/beschikbaarOp'
      - $ref: '#/components/parameters/synchroniseerMetTileset'
      - description: "Standaard worden alle locaties uitgeleverd zoals geregistreerd.
          Met deze parameter kunnen locaties uitgeleverd worden met een andere dan
          de standaardselectie:\n  - `samengesteld`: Locatiegroepen krijgen een geometrie-identificatie,
          welke verwijst naar een geometrie \n    die een samenstelling is van alle
          onderliggende geometrieën.\n    Onderliggende locaties in `omvat` attribuut
          worden niet uitgeleverd.\n"
        explode: true
        in: query
        name: locatieSelectie
        required: false
        schema:
          enum:
          - samengesteld
          type: string
        style: form
      - example: nl.imow-gm0037.gebied.2019000001example
        explode: false
        in: path
        name: identificatie
        required: true
        schema:
          type: string
        style: simple
      responses:
        "200":
          content:
            application/hal+json:
              schema:
                $ref: '#/components/schemas/Locatie'
          description: Locatie
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        "400":
          $ref: '#/components/responses/BadRequest'
        "404":
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem404'
          description: Er is geen locatie met deze identificatie.
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        "406":
          $ref: '#/components/responses/NotAcceptable'
        "500":
          $ref: '#/components/responses/ServerError'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: Een enkele locatie opvragen
      tags:
      - Locaties
  /openapi.json:
    get:
      description: Vraag de OpenAPI specificatie op in JSON formaat.
      operationId: getOpenApiJson
      responses:
        "200":
          content:
            application/json:
              schema:
                description: Het JSON schema van de OpenAPI specificatie.
                title: OpenApiSchemaJson
                type: object
          description: OK
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: De OpenAPI specificatie in JSON-formaat
      tags:
      - Meta
  /openapi.yaml:
    get:
      description: Vraag de OpenAPI specificatie op in YAML formaat.
      operationId: getOpenApiYaml
      responses:
        "200":
          content:
            application/yaml:
              schema:
                description: Het YAML schema van de OpenAPI specificatie.
                title: OpenApiSchemaYaml
                type: object
          description: OK
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: De OpenAPI specificatie in YAML-formaat
      tags:
      - Meta
  /primairelocaties/_zoek:
    post:
      description: "'Primaire locaties' zijn locaties waarnaar andere OW-objecten
        (b.v. juridische activiteiten, gebiedsaanwijzingen)  direct verwijzen. Locaties
        binnen een locatiegroep (gebiedengroep/lijnengroep/puntengroep) zijn 'primair'
        \ alleen als ook een ander OW-object daarnaar verwijst. Als een locatie (gebied/lijn/punt)
        alleen een onderdeel van een locatiegroep is, dan is deze locatie 'secundair'.\nVoor
        locatiegroepen wordt een samengestelde geometrie aangemaakt. Deze heeft ook
        eigen geometrie-identificatie.        \nDit endpoint levert gebieden/lijnen/punten/ambtsgebieden
        die overeenkomen met de zoekopdracht. Voor de gegeven locatie-identificaties
        en geometrie worden teruggegeven alle primaire locaties die overeenkomen met
        een van de identificaties EN intersecten met de geometrie.\nZie PrimaireLocatieZoekobject
        voor meer informatie.\n"
      operationId: zoekPrimaireLocaties
      parameters:
      - $ref: '#/components/parameters/geldigOp'
      - $ref: '#/components/parameters/inWerkingOp'
      - $ref: '#/components/parameters/beschikbaarOp'
      - $ref: '#/components/parameters/synchroniseerMetTileset'
      - $ref: '#/components/parameters/Page'
      - $ref: '#/components/parameters/Size'
      - $ref: '#/components/parameters/ContentCrsHeader'
      requestBody:
        content:
          application/json:
            examples:
              primaireLocatieZoekobjectVoorbeeld:
                $ref: '#/components/examples/primaireLocatieZoekobjectVoorbeeld'
            schema:
              $ref: '#/components/schemas/PrimaireLocatieZoekobject'
        description: PrimaireLocatieZoekobject
        required: true
      responses:
        "200":
          content:
            application/hal+json:
              schema:
                $ref: '#/components/schemas/PrimaireLocaties'
          description: Primaire Locaties
          headers:
            API-Version:
              $ref: '#/components/headers/API-Version'
            X-Pagination-Count:
              $ref: '#/components/headers/X-Pagination-Count'
            X-Pagination-Limit:
              $ref: '#/components/headers/X-Pagination-Limit'
            X-Pagination-Page:
              $ref: '#/components/headers/X-Pagination-Page'
            X-Total-Count:
              $ref: '#/components/headers/X-Total-Count'
        "400":
          $ref: '#/components/responses/BadRequest'
        "406":
          $ref: '#/components/responses/NotAcceptable'
        "412":
          $ref: '#/components/responses/PreconditionFailed'
        "422":
          $ref: '#/components/responses/Unprocessable'
        "500":
          $ref: '#/components/responses/ServerError'
        default:
          content:
            application/problem+json:
              schema:
                $ref: '#/components/schemas/Problem'
          description: Onverwacht probleem
      summary: Primaire locaties opvragen die voldoen aan zoekobject-parameters ten
        behoeve van Vector Tile bevraging.
      tags:
      - Locaties
servers:
- description: basePath
  url: /publiek/omgevingsdocumenten/api/toepasbaaropvragen/v7
tags:
- description: Activiteiten bevat activiteit uitspraken die in omgevingsdocumenten
    staan.
  name: Activiteiten
- description: Locaties van Omgevingsdocumentobjecten.
  name: Locaties
- description: GeometrieIdentificaties behorende bij locaties van Omgevingsdocumentobjecten.
  name: GeometrieIdentificaties
- description: Operaties die niet domeinspecifiek zijn, maar over de applicatie gaan.
  name: Meta
