components:
  headers:
    API-Version:
      description: Versie van de API
      example: 1.0.0
      required: true
      schema:
        example: 1.0.0
        type: string
    Content-Crs:
      description: De CRS van de geometrie in de respons
      example: http://www.opengis.net/def/crs/EPSG/0/28992
      required: true
      schema:
        example: http://www.opengis.net/def/crs/EPSG/0/28992
        format: uri
        type: string
  responses:
    BadRequest:
      content:
        application/problem+json:
          schema:
            description: Standaardformaat (`application/problem+json`) voor probleemdetails
              in HTTP API's (RFC 7807).
            properties:
              detail:
                description: Mens-leesbare uitleg van dit specifieke probleem.
                example: Geen verbinding met de database
                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: 403
                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
      description: Bad request
    Forbidden:
      content:
        application/problem+json:
          schema:
            description: Standaardformaat (`application/problem+json`) voor probleemdetails
              in HTTP API's (RFC 7807).
            properties:
              detail:
                description: Mens-leesbare uitleg van dit specifieke probleem.
                example: Geen verbinding met de database
                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: 403
                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
      description: Forbidden
    NotFound:
      content:
        application/problem+json:
          schema:
            description: Standaardformaat (`application/problem+json`) voor probleemdetails
              in HTTP API's (RFC 7807).
            properties:
              detail:
                description: Mens-leesbare uitleg van dit specifieke probleem.
                example: Geen verbinding met de database
                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: 403
                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
      description: Not found
    UnprocessableContent:
      content:
        application/problem+json:
          schema:
            description: Standaardformaat (`application/problem+json`) voor probleemdetails
              in HTTP API's (RFC 7807).
            properties:
              detail:
                description: Mens-leesbare uitleg van dit specifieke probleem.
                example: Geen verbinding met de database
                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: 403
                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
      description: Unprocessable content
  schemas:
    CRSs:
      description: De URIs van alle in deze API ondersteunde CRS-en
      properties:
        crs:
          items:
            example: http://www.opengis.net/def/crs/EPSG/0/28992
            format: uri
            type: string
          type: array
      title: Ondersteunde CRS-en
      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:
      - properties:
          coordinates:
            items:
              type: number
            minItems: 2
            type: array
          type:
            enum:
            - Point
            type: string
        required:
        - type
        - coordinates
        type: object
      - properties:
          coordinates:
            items:
              items:
                type: number
              minItems: 2
              type: array
            minItems: 2
            type: array
          type:
            enum:
            - LineString
            type: string
        required:
        - type
        - coordinates
        type: object
      - properties:
          coordinates:
            items:
              items:
                items:
                  type: number
                minItems: 2
                type: array
              minItems: 4
              type: array
            type: array
          type:
            enum:
            - Polygon
            type: string
        required:
        - type
        - coordinates
        type: object
      - properties:
          coordinates:
            items:
              items:
                type: number
              minItems: 2
              type: array
            type: array
          type:
            enum:
            - MultiPoint
            type: string
        required:
        - type
        - coordinates
        type: object
      - properties:
          coordinates:
            items:
              items:
                items:
                  type: number
                minItems: 2
                type: array
              minItems: 2
              type: array
            type: array
          type:
            enum:
            - MultiLineString
            type: string
        required:
        - type
        - coordinates
        type: object
      - properties:
          coordinates:
            items:
              items:
                items:
                  items:
                    type: number
                  minItems: 2
                  type: array
                minItems: 4
                type: array
              type: array
            type: array
          type:
            enum:
            - MultiPolygon
            type: string
        required:
        - type
        - coordinates
        type: object
      title: GeoJSON Geometry
    Health:
      description: Health
      properties:
        app-health:
          properties:
            status:
              enum:
              - UP
              - DOWN
              type: string
          type: object
      type: object
    Info:
      description: Info
      properties:
        app:
          properties:
            description:
              type: string
            name:
              type: string
            version:
              type: string
          type: object
      required:
      - app
      type: object
    LineString:
      properties:
        coordinates:
          items:
            items:
              type: number
            minItems: 2
            type: array
          minItems: 2
          type: array
        type:
          enum:
          - LineString
          type: string
      required:
      - type
      - coordinates
      type: object
    MultiLineString:
      properties:
        coordinates:
          items:
            items:
              items:
                type: number
              minItems: 2
              type: array
            minItems: 2
            type: array
          type: array
        type:
          enum:
          - MultiLineString
          type: string
      required:
      - type
      - coordinates
      type: object
    MultiPoint:
      properties:
        coordinates:
          items:
            items:
              type: number
            minItems: 2
            type: array
          type: array
        type:
          enum:
          - MultiPoint
          type: string
      required:
      - type
      - coordinates
      type: object
    MultiPolygon:
      properties:
        coordinates:
          items:
            items:
              items:
                items:
                  type: number
                minItems: 2
                type: array
              minItems: 4
              type: array
            type: array
          type: array
        type:
          enum:
          - MultiPolygon
          type: string
      required:
      - type
      - coordinates
      type: object
    OpenApiSchemaJson:
      description: Het JSON schema van de OpenAPI specificatie.
      type: object
    OpenApiSchemaYaml:
      description: Het YAML schema van de OpenAPI specificatie.
      type: object
    Point:
      properties:
        coordinates:
          items:
            type: number
          minItems: 2
          type: array
        type:
          enum:
          - Point
          type: string
      required:
      - type
      - coordinates
      type: object
    Polygon:
      properties:
        coordinates:
          items:
            items:
              items:
                type: number
              minItems: 2
              type: array
            minItems: 4
            type: array
          type: array
        type:
          enum:
          - Polygon
          type: string
      required:
      - type
      - coordinates
      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: Geen verbinding met de database
          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: 403
          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
  securitySchemes:
    apiKey:
      description: "De API-key die je hebt aangevraagd op het ontwikkelaarsportaal
        \n(https://aandeslagmetdeomgevingswet.nl/ontwikkelaarsportaal/formulieren/api-key-aanvragen-0/)
        \ndient bij elke request naar de API via de `x-api-key` request header meegestuurd
        te worden. \nIndien deze niet juist wordt meegestuurd, of het een ongeldige
        key betreft, zul je de\nfoutmelding `403 Forbidden` terugkrijgen.\n"
      in: header
      name: x-api-key
      type: apiKey
externalDocs:
  url: https://aandeslagmetdeomgevingswet.nl/ontwikkelaarsportaal/api-register/api/omgevingsdocumenten-geometrie-opvragen/
info:
  contact:
    name: Kadaster DSO - Team Ozon
    url: https://aandeslagmetdeomgevingswet.nl/ontwikkelaarsportaal/services/contact/
  description: De geometrieën opvragen API ontsluit alle in het DSO bekende geometrieën
    op basis van hun identificatie. De geometrie die hoort bij een bepaalde identificatie
    verandert nooit. Alle op te vragen resources zijn dan ook statisch.
  termsOfService: https://aandeslagmetdeomgevingswet.nl/ontwikkelaarsportaal/services/fair-use-policy/
  title: Geometrieën opvragen
  version: 1.1.0
openapi: 3.0.3
paths:
  /app-health:
    get:
      operationId: getHealth
      responses:
        "200":
          content:
            application/json:
              schema:
                description: Health
                properties:
                  app-health:
                    properties:
                      status:
                        enum:
                        - UP
                        - DOWN
                        type: string
                    type: object
                type: object
          description: Health
          headers:
            API-Version:
              description: Versie van de API
              example: 1.0.0
              required: true
              schema:
                example: 1.0.0
                type: string
      summary: Health info
      tags:
      - Meta
  /app-info:
    get:
      operationId: getInfo
      responses:
        "200":
          content:
            application/json:
              schema:
                description: Info
                properties:
                  app:
                    properties:
                      description:
                        type: string
                      name:
                        type: string
                      version:
                        type: string
                    type: object
                required:
                - app
                type: object
          description: Info
          headers:
            API-Version:
              description: Versie van de API
              example: 1.0.0
              required: true
              schema:
                example: 1.0.0
                type: string
      summary: Applicatie info
      tags:
      - Meta
  /crss:
    get:
      description: |
        Deze API ondersteunt alleen de CRS-en die terugkomen op een request naar dit endpoint.
      operationId: getCrss
      responses:
        "200":
          content:
            application/json:
              schema:
                description: De URIs van alle in deze API ondersteunde CRS-en
                properties:
                  crs:
                    items:
                      example: http://www.opengis.net/def/crs/EPSG/0/28992
                      format: uri
                      type: string
                    type: array
                title: Ondersteunde CRS-en
                type: object
          description: OK
          headers:
            API-Version:
              description: Versie van de API
              example: 1.0.0
              required: true
              schema:
                example: 1.0.0
                type: string
      summary: Ondersteunde CRS-en opvragen
      tags:
      - Geometrieën
  /geometrieen/{geometrieIdentificatie}:
    get:
      description: "De geometrie met de gevraagde identificatie wordt uitgeleverd
        in GeoJson format.\n\nLet op: \n\n- Als er in een geometrie, zoals deze bij
        het DSO is aangeleverd, achterliggende nullen \n  (trailing zeros) in een
        coordinaat zitten, worden deze niet in de uitgeleverde GeoJson \n  meegenomen.
        Bijvoorbeeld `130000.400` zal in de GeoJson respons `130000.4` zijn.\n\n-
        Volgens de Geospatial Module van de Nederlandse API strategie is CRS84 de
        default CRS. \n  Deze API ondersteunt echter geen CRS84, dus zal een request
        zonder `crs` parameter \n  resulteren in een 422 respons. \n"
      operationId: getGeometrie
      parameters:
      - example: 91edb05d-8a46-4aec-b600-6fa86777befc
        explode: false
        in: path
        name: geometrieIdentificatie
        required: true
        schema:
          type: string
        style: simple
      - example: http://www.opengis.net/def/crs/EPSG/0/28992
        explode: false
        in: query
        name: crs
        required: false
        schema:
          format: uri
          type: string
        style: form
      responses:
        "200":
          content:
            application/json:
              schema:
                description: Geometrie in GeoJSON formaat (RFC 7946).
                externalDocs:
                  description: RFC 7946 - The GeoJSON Format
                  url: https://tools.ietf.org/html/rfc7946
                oneOf:
                - properties:
                    coordinates:
                      items:
                        type: number
                      minItems: 2
                      type: array
                    type:
                      enum:
                      - Point
                      type: string
                  required:
                  - type
                  - coordinates
                  type: object
                - properties:
                    coordinates:
                      items:
                        items:
                          type: number
                        minItems: 2
                        type: array
                      minItems: 2
                      type: array
                    type:
                      enum:
                      - LineString
                      type: string
                  required:
                  - type
                  - coordinates
                  type: object
                - properties:
                    coordinates:
                      items:
                        items:
                          items:
                            type: number
                          minItems: 2
                          type: array
                        minItems: 4
                        type: array
                      type: array
                    type:
                      enum:
                      - Polygon
                      type: string
                  required:
                  - type
                  - coordinates
                  type: object
                - properties:
                    coordinates:
                      items:
                        items:
                          type: number
                        minItems: 2
                        type: array
                      type: array
                    type:
                      enum:
                      - MultiPoint
                      type: string
                  required:
                  - type
                  - coordinates
                  type: object
                - properties:
                    coordinates:
                      items:
                        items:
                          items:
                            type: number
                          minItems: 2
                          type: array
                        minItems: 2
                        type: array
                      type: array
                    type:
                      enum:
                      - MultiLineString
                      type: string
                  required:
                  - type
                  - coordinates
                  type: object
                - properties:
                    coordinates:
                      items:
                        items:
                          items:
                            items:
                              type: number
                            minItems: 2
                            type: array
                          minItems: 4
                          type: array
                        type: array
                      type: array
                    type:
                      enum:
                      - MultiPolygon
                      type: string
                  required:
                  - type
                  - coordinates
                  type: object
                title: GeoJSON Geometry
          description: OK
          headers:
            API-Version:
              description: Versie van de API
              example: 1.0.0
              required: true
              schema:
                example: 1.0.0
                type: string
            Content-Crs:
              description: De CRS van de geometrie in de respons
              example: http://www.opengis.net/def/crs/EPSG/0/28992
              required: true
              schema:
                example: http://www.opengis.net/def/crs/EPSG/0/28992
                format: uri
                type: string
        "400":
          content:
            application/problem+json:
              schema:
                description: Standaardformaat (`application/problem+json`) voor probleemdetails
                  in HTTP API's (RFC 7807).
                properties:
                  detail:
                    description: Mens-leesbare uitleg van dit specifieke probleem.
                    example: Geen verbinding met de database
                    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: 403
                    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
          description: Bad request
        "403":
          content:
            application/problem+json:
              schema:
                description: Standaardformaat (`application/problem+json`) voor probleemdetails
                  in HTTP API's (RFC 7807).
                properties:
                  detail:
                    description: Mens-leesbare uitleg van dit specifieke probleem.
                    example: Geen verbinding met de database
                    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: 403
                    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
          description: Forbidden
        "404":
          content:
            application/problem+json:
              schema:
                description: Standaardformaat (`application/problem+json`) voor probleemdetails
                  in HTTP API's (RFC 7807).
                properties:
                  detail:
                    description: Mens-leesbare uitleg van dit specifieke probleem.
                    example: Geen verbinding met de database
                    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: 403
                    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
          description: Not found
        "422":
          content:
            application/problem+json:
              schema:
                description: Standaardformaat (`application/problem+json`) voor probleemdetails
                  in HTTP API's (RFC 7807).
                properties:
                  detail:
                    description: Mens-leesbare uitleg van dit specifieke probleem.
                    example: Geen verbinding met de database
                    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: 403
                    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
          description: Unprocessable content
      summary: Een geometrie opvragen
      tags:
      - Geometrieën
  /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.
                type: object
          description: OK
          headers:
            API-Version:
              description: Versie van de API
              example: 1.0.0
              required: true
              schema:
                example: 1.0.0
                type: string
      summary: De OpenAPI specificatie in JSON-formaat
      tags:
      - Meta
      x-auth-type: None
  /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.
                type: object
          description: OK
          headers:
            API-Version:
              description: Versie van de API
              example: 1.0.0
              required: true
              schema:
                example: 1.0.0
                type: string
      summary: De API-specificatie in YAML-formaat
      tags:
      - Meta
      x-auth-type: None
security:
- apiKey: []
servers:
- description: De API op het huidige domein
  url: /publiek/omgevingsdocumenten/api/geometrieopvragen/v1
- description: De API op de productieomgeving van het DSO
  url: https://service.omgevingswet.overheid.nl/publiek/omgevingsdocumenten/api/geometrieopvragen/v1
- description: De API op de pre-productie omgeving van het DSO
  url: https://service.pre.omgevingswet.overheid.nl/publiek/omgevingsdocumenten/api/geometrieopvragen/v1
tags:
- description: Geometrieën uit (ontwerp-) omgevingsdocumenten en vergunningen
  name: Geometrieën
- description: Operaties die niet domeinspecifiek zijn, maar over de applicatie gaan.
  name: Meta
