openapi: 3.0.3
info:
  title: OneAtlas WorldDEM Access elevation/orders 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/orders
  description: "All operations needed to order DEM data:\n  * place orders\n  * show placed orders\n  * download purchased data\n"
paths:
  /elevation/orders:
    post:
      summary: Create New Order
      tags:
      - elevation/orders
      requestBody:
        description: Data to be ordered. Multiple items can be placed in the "items" part. After requesting a price, the response can be sent to order data. Instead of requesting a price first, it is possible to set min-/max-Filter to avoid orders that exceed those limits.
        required: true
        content:
          application/json:
            schema:
              type: object
              anyOf:
              - 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
              - 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
           

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