openapi: 3.0.3
info:
  title: OneAtlas WorldDEM Access elevation/price API
  version: 1.0.1
  contact:
    email: dl-geo-webservices@airbus.com
  description: The OneAtlas WorldDEM API is a tool that provides access to high-resolution global elevation data. This data, collected by satellites and processed using advanced technologies, offers a detailed and accurate representation of the Earth's surface. By integrating the WorldDEM API into their applications, users can benefit from precise terrain information for a wide range of use cases, such as urban planning, disaster response, agriculture, and infrastructure development. This API allows developers to easily incorporate elevation data into their projects, enabling them to create more accurate and effective solutions.
servers:
- url: https://sar.api.oneatlas.airbus.com/v1
  description: OneAtlas - Elevation
security:
- basicAuth: []
tags:
- name: elevation/price
  description: 'Endpoint to query to price of an elevation order.

    '
paths:
  /elevation/price:
    post:
      summary: Get the Price of Elevation Item/download Request
      tags:
      - elevation/price
      requestBody:
        description: object that describes the requested data. Multiple items can be placed in the "items" part.
        required: true
        content:
          application/json:
            schema:
              type: object
              required:
              - items
              - kind
              properties:
                kind:
                  type: string
                  enum:
                  - order.item
                  - order
                title:
                  type: string
                  maxLength: 32
                  pattern: ^([a-zA-Z0-9 _-]{0,32})$
                  description: user defined title of an order to ease the identification of an order (max. 32 characters)
                  example: Friedrichshafen
                customer:
                  type: string
                  description: name of the user's end customer (only relevant for resellers)
                  example: Airbus Intelligence Germany
                items:
                  type: array
                  required:
                  - itemType
                  items:
                    type: object
                    required:
                    - aoi
                    - itemType
                    properties:
                      crsCode:
                        type: string
                        example: urn:ogc:def:crs:EPSG::4326
                      itemFormat:
                        type: string
                        description: output format for area (GeoJSON only for Point, GeoTIFF only for Polygon)
                        enum:
                        - GeoTIFF
                        - GeoJSON
                      itemType:
                        type: string
                        enum:
                        - dem.wddsm
                        - dem.wd4o
                        - dem.wddtmlite
                        - dem.wdneo
                        - dem.wd30
                        - dem.wdneodtm
                      aoi:
                        oneOf:
                        - description: The GeoJSON Point
                          type: object
                          required:
                          - type
                          - coordinates
                          properties:
                            type:
                              type: string
                              example: Point
                              enum:
                              - Point
                            coordinates:
                              description: Basic geometry type describing longitude and latitude
                              type: array
                              minItems: 2
                              items:
                                type: number
                              example:
                              - 9.3
                              - 47.7
                        - description: The GeoJSON MultiPoint (currently **not implemented**)
                          type: object
                          required:
                          - type
                          - coordinates
                          properties:
                            type:
                              type: string
                              example: MultiPoint
                              enum:
                              - MultiPoint
                            coordinates:
                              type: array
                              minItems: 1
                              items:
                                description: Basic geometry type describing longitude and latitude
                                type: array
                                minItems: 2
                                items:
                                  type: number
                                example:
                                - 9.3
                                - 47.7
                        - description: The GeoJSON Polygon
                          type: object
                          required:
                          - type
                          - coordinates
                          properties:
                            type:
                              type: string
                              example: Polygon
                              enum:
                              - Polygon
                            coordinates:
                              type: array
                              minItems: 1
                              items:
                                description: Closed ring of four or more positions. First and last position must be identical.
                                type: array
                                minItems: 4
                                items:
                                  description: Basic geometry type describing longitude and latitude
                                  type: array
                                  minItems: 2
                                  items:
                                    type: number
                                  example:
                                  - 9.3
                                  - 47.7
                                example:
                                - - 9.3
                                  - 47.7
                                - - 9.3
                                  - 47.2
                                - - 9.5
                                  - 47.2
                                - - 9.5
                                  - 47.7
                                - - 9.3
                                  - 47.7
                        - description: The GeoJSON MultiPolygon
                          type: object
                          required:
                          - type
                          - coordinates
                          properties:
                            type:
                              type: string
                              example: MultiPolygon
                              enum:
                              - MultiPolygon
                            coordinates:
                              type: array
                              minItems: 1
                              example:
                              - - - 9.3
                                  - 47.7
                                - - 9.4
                                  - 47.7
                                - - 9.4
                                  - 47.65
                                - - 9.3
                                  - 47.7
                              items:
                                type: array
                                minItems: 1
                                items:
                                  description: Closed ring of four or more positions. First and last position must be identical.
                                  type: array
                                  minItems: 4
                                  items:
                                    description: Basic geometry type describing longitude and latitude
                                    type: array
                                    minItems: 2
                                    items:
                                      type: number
                                    example:
                                    - 9.3
                                    - 47.7
                                  example:
                                  - - 9.3
                                    - 47.7
                                  - - 9.3
                                    - 47.2
                                  - - 9.5
                                    - 47.2
                                  - - 9.5
                                    - 47.7
                                  - - 9.3
                                    - 47.7
                        - description: The GeoJSON LineString (currently **not implemented**)
                          type: object
                          required:
                          - type
                          - coordinates
                          properties:
                            type:
                              type: string
                              example: LineString
                              enum:
                              - LineString
                            coordinates:
                              description: String of connected positions
                              type: array
                              minItems: 2
                              items:
                                description: Basic geometry type describing longitude and latitude
                                type: array
                                minItems: 2
                                items:
                                  type: number
                                example:
                                - 9.3
                                - 47.7
                              example:
                              - - 9.3
                                - 47.7
                              - - 9.5
                                - 47.2
                        - description: The GeoJSON MultiLineString (currently **not implemented**)
                          type: object
                          required:
                          - type
                          - coordinates
                          properties:
                            type:
                              type: string
                              example: MultiLineString
                              enum:
                              - MultiLineString
                            coordinates:
                              type: array
                              minItems: 1
                              items:
                                description: String of connected positions
                                type: array
                                minItems: 2
                                items:
                                  description: Basic geometry type describing longitude and latitude
                                  type: array
                                  minItems: 2
                                  items:
                                    type: number
                                  example:
                                  - 9.3
                                  - 47.7
                                example:
                                - - 9.3
                                  - 47.7
                                - - 9.5
                                  - 47.2
                        example:
                          type: Polygon
                          coordinates:
                          - - - 9.3
                              - 47.7
                            - - 9.4
                              - 47.7
                            - - 9.4
                              - 47.65
                            - - 9.3
                              - 47.7
      responses:
        '200':
          description: Object that can be sent to /orders
          content:
            application/json:
              schema:
                description: order object with price included
                allOf:
                - type: object
                  required:
                  - kind
                  - items
                  - price
                  - billableAreaKm2
                  properties:
                    kind:
                      type: string
                      enum:
                      - order.item
                      - order
                    title:
                      type: string
                      maxLength: 32
                      pattern: ^([a-zA-Z0-9 _-]{0,32})$
                      description: user defined title of an order to ease the identification of an order (max. 32 characters)
                      example: Friedrichshafen
                    customer:
                      type: string
                      description: name of the user's end customer (only relevant for resellers)
                      example: Airbus Intelligence Germany
                    items:
                      type: array
                      items:
                        allOf:
                        - type: object
                          required:
                          - aoi
                          - itemType
                          properties:
                            crsCode:
                              type: string
                              example: urn:ogc:def:crs:EPSG::4326
                            itemFormat:
                              type: string
                              description: output format for area (GeoJSON only for Point, GeoTIFF only for Polygon)
                              enum:
                              - GeoTIFF
                              - GeoJSON
                            itemType:
                              type: string
                              enum:
                              - dem.wddsm
                              - dem.wd4o
                              - dem.wddtmlite
                              - dem.wdneo
                              - dem.wd30
                              - dem.wdneodtm
                            aoi:
                              oneOf:
                              - description: The GeoJSON Point
                                type: object
                                required:
                                - type
                                - coordinates
                                properties:
                                  type:
                                    type: string
                                    example: Point
                                    enum:
                                    - Point
                                  coordinates:
                                    description: Basic geometry type describing longitude and latitude
                                    type: array
                                    minItems: 2
                                    items:
                                      type: number
                                    example:
                                    - 9.3
                                    - 47.7
                              - description: The GeoJSON MultiPoint (currently **not implemented**)
                                type: object
                                required:
                                - type
                                - coordinates
                                properties:
                                  type:
                                    type: string
                                    example: MultiPoint
                                    enum:
                                    - MultiPoint
                                  coordinates:
                                    type: array
                                    minItems: 1
                                    items:
                                      description: Basic geometry type describing longitude and latitude
                                      type: array
                                      minItems: 2
                                      items:
                                        type: number
                                      example:
                                      - 9.3
                                      - 47.7
                              - description: The GeoJSON Polygon
                                type: object
                                required:
                                - type
                                - coordinates
                                properties:
                                  type:
                                    type: string
                                    example: Polygon
                                    enum:
                                    - Polygon
                                  coordinates:
                                    type: array
                                    minItems: 1
                                    items:
                                      description: Closed ring of four or more positions. First and last position must be identical.
                                      type: array
                                      minItems: 4
                                      items:
                                        description: Basic geometry type describing longitude and latitude
                                        type: array
                                        minItems: 2
                                        items:
                                          type: number
                                        example:
                                        - 9.3
                                        - 47.7
                                      example:
                                      - - 9.3
                                        - 47.7
                                      - - 9.3
                                        - 47.2
                                      - - 9.5
                                        - 47.2
                                      - - 9.5
                                        - 47.7
                                      - - 9.3
                                        - 47.7
                              - description: The GeoJSON MultiPolygon
                                type: object
                                required:
                                - type
                                - coordinates
                                properties:
                                  type:
                                    type: string
                                    example: MultiPolygon
                                    enum:
                                    - MultiPolygon
                                  coordinates:
                                    type: array
                                    minItems: 1
                                    example:
                                    - - - 9.3
                                        - 47.7
                                      - - 9.4
                                        - 47.7
                                      - - 9.4
                                        - 47.65
                                      - - 9.3
                                        - 47.7
                                    items:
                                      type: array
                                      minItems: 1
                                      items:
                                        description: Closed ring of four or more positions. First and last position must be identical.
                                        type: array
                                        minItems: 4
                                        items:
                                          description: Basic geometry type describing longitude and latitude
                                          type: array
                                          minItems: 2
                                          items:
                                            type: number
                                          example:
                                          - 9.3
                                          - 47.7
                                        example:
                                        - - 9.3
                                          - 47.7
                                        - - 9.3
                                          - 47.2
                                        - - 9.5
                                          - 47.2
                                        - - 9.5
                                          - 47.7
                                        - - 9.3
                                          - 47.7
                              - description: The GeoJSON LineString (currently **not implemented**)
                                type: object
                                required:
                                - type
                                - coordinates
                                properties:
                                  type:
                                    type: string
                                    example: LineString
                                    enum:
                                    - LineString
                                  coordinates:
                                    description: String of connected positions
                                    type: array
                                    minItems: 2
                                    items:
                                      description: Basic geometry type describing longitude and latitude
                                      type: array
                                      minItems: 2
                                      items:
                                        type: number
                                      example:
                                      - 9.3
                                      - 47.7
                                    example:
                                    - - 9.3
                                      - 47.7
                                    - - 9.5
                                      - 47.2
                              - description: The GeoJSON MultiLineString (currently **not implemented**)
                                type: object
                                required:
                                - type
                                - coordinates
                                properties:
                                  type:
                                    type: string
                                    example: MultiLineString
                                    enum:
                                    - MultiLineString
                                  coordinates:
                                    type: array
                                    minItems: 1
                                    items:
                                      description: String of connected positions
                                      type: array
                                      minItems: 2
                                      items:
                                        description: Basic geometry type describing longitude and latitude
                                        type: array
                                        minItems: 2
                                        items:
                                          type: number
                                        example:
                                        - 9.3
                                        - 47.7
                                      example:
                                      - - 9.3
                                        - 47.7
                                      - - 9.5
                                        - 47.2
                              example:
                                type: Polygon
                                coordinates:
                                - - - 9.3
                                    - 47.7
                                  - - 9.4
                                    - 47.7
                                  - - 9.4
                                    - 47.65
                                  - - 9.3
                                    - 47.7
                        - type: object
                          required:
                          - price
                          - areaKm2
                          - billableAreaKm2
                          properties:
                            price:
                              description: Price information
                              type: object
                              required:
                              - amountUnit
                              - amount
                              - amountPerKm2
                              properties:
                                amountUnit:
                                  type: string
                                  enum:
                                  - EUR
                                  - CREDITS
                                  - USD
                                amount:
                                  type: number
                                  example: 83.4
                                amountPerKm2:
                                  type: number
                                  example: 4
                            areaKm2:
                              type: number
                              example: 20.85
                              description: area in km� of AOI
                            billableAreaKm2:
                              type: number
                              example: 15.23
                              description: area (in km�) of AOI with elevation information available and therefore billable
                            discounts:
                              type: object
                              properties:
                                reseller:
                                  allOf:
                                  - description: The reseller discount granted for being a reseller
                                  - type: object
                                    properties:
                                      basePrice:
                                        allOf:
                                        - description: The base price this discount uses for calculations
                                        - description: Price information
                                          type: object
                                          required:
                                          - amountUnit
                                          - amount
                                          - amountPerKm2
                                          properties:
                                            amountUnit:
                                              type: string
                                              enum:
                                              - EUR
                                              - CREDITS
                                              - USD
                                            amount:
                                              type: number
                                              example: 83.4
                                            amountPerKm2:
                                              type: number
                                              example: 4
                                      percentage:
                                        description: Percent value of the discount, used to calculated the deducted amount & amountPerKm2 from the basePrice
                                        minimum: 0
                                        maximum: 100
                                        type: number
                                        example: 34.56
                                      amount:
                                        description: The amount which will be deducted from the basePrice amount
                                        type: number
                                        maximum: 0
                                        example: -123.45
                                      amountPerKm2:
                                        description: The amountPerKm2 which will be deducted from the basePrice amountPerKm2
                                        type: number
                                        maximum: 0
                                        example: -0.5
                                      amountUnit:
                                        type: string
                                        enum:
                                        - EUR
                                        - CREDITS
                                        - USD
                                volume:
                                  allOf:
                                  - description: The volume discount granted depending on the item area
                                  - allOf:
                                    - type: object
                                      properties:
                                        basePrice:
                                          allOf:
                                          - description: The base price this discount uses for calculations
                                          - description: Price information
                                            type: object
                                            required:
                                            - amountUnit
                                            - amount
                                            - amountPerKm2
                                            properties:
                                              amountUnit:
                                                type: string
                                                enum:
                                                - EUR
                                                - CREDITS
                                                - USD
                                              amount:
                                                type: number
                                                example: 83.4
                                              amountPerKm2:
                                                type: number
                                                example: 4
                                        percentage:
                                          description: Percent value of the discount, used to calculated the deducted amount & amountPerKm2 from the basePrice
                                          minimum: 0
                                          maximum: 100
                                          type: number
                                          example: 34.56
                                        amount:
                                          description: The amount which will be deducted from the basePrice amount
                                          type: number
                                          maximum: 0
                                          example: -123.45
                                        amountPerKm2:
                                          description: The amountPerKm2 which will be deducted from the basePrice amountPerKm2
                                          type: number
                                          maximum: 0
                                          example: -0.5
                                        amountUnit:
                                          type: string
                                          enum:
                                          - EUR
                                          - CREDITS
                                          - USD
                                    - type: object
                                      properties:
                                        nextDiscount:
                                          description: The next possible discount

# --- truncated at 32 KB (41 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/airbus-oneatlas/refs/heads/main/openapi/airbus-oneatlas-elevation-price-api-openapi.yml