Microsoft Azure Azure Maps Elevation API — Elevation

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Azure Maps Elevation API — Elevation
  description: 'Microsoft Azure Azure Maps Elevation API — Elevation. 5 operations. Lead operation: Microsoft Azure Get Elevation
    Data At Equally Spaced Locations Within A Bounding Box. Self-contained Naftiko capability covering one Microsoft Azure
    business surface.'
  tags:
  - Microsoft Azure
  - Elevation
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: azure-maps-elevation-elevation
    baseUri: https://atlas.microsoft.com
    description: Microsoft Azure Azure Maps Elevation API — Elevation business capability. Self-contained, no shared references.
    resources:
    - name: elevation-lattice-format
      path: /elevation/lattice/{format}
      operations:
      - name: microsoftazureelevationgetdataforboundingbox
        method: GET
        description: Microsoft Azure Get Elevation Data At Equally Spaced Locations Within A Bounding Box
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: bounds
          in: query
          type: array
          description: The string that represents the rectangular area of a bounding box. The bounds parameter is defined
            by the 4 bounding box coordinates, with WGS84 longitude and l
          required: true
        - name: rows
          in: query
          type: number
          description: Specifies the number of rows to use to divide the bounding box area into a grid. The number of vertices  in
            the grid should be less than 2,000.
          required: true
        - name: columns
          in: query
          type: number
          description: Specifies the number of columns to use to divide the bounding box area into a grid. The number of vertices  in
            the grid should be less than 2,000.
          required: true
    - name: elevation-line-format
      path: /elevation/line/{format}
      operations:
      - name: microsoftazureelevationgetdataforpolyline
        method: GET
        description: Microsoft Azure Get Elevation Data Along A Polyline
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: lines
          in: query
          type: array
          description: The string representation of a polyline path. A polyline is defined by endpoint coordinates,  with
            each endpoint separated by a pipe ('|') character. The polyli
          required: true
        - name: samples
          in: query
          type: number
          description: The samples parameter specifies the number of equally spaced points at which elevation values  should
            be provided along a polyline path. The number of samples s
      - name: microsoftazureelevationpostdataforpolyline
        method: POST
        description: Microsoft Azure Query Elevation Data Along A Polyline
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: linesRequestBody
          in: body
          type: string
          description: The string representation of a polyline path. A polyline is defined by endpoint coordinates,  with
            each endpoint separated by a pipe ('|') character. The polyli
          required: true
        - name: samples
          in: query
          type: number
          description: The samples parameter specifies the number of equally spaced points at which elevation values  should
            be provided along a polyline path. The number of samples s
    - name: elevation-point-format
      path: /elevation/point/{format}
      operations:
      - name: microsoftazureelevationgetdataforpoints
        method: GET
        description: Microsoft Azure Get Elevation Data On One Or More Points
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: points
          in: query
          type: array
          description: The string representation of a list of points. A point is defined in lat/lon WGS84 coordinate reference
            system format.  If multiple points are requested, each o
          required: true
      - name: microsoftazureelevationpostdataforpoints
        method: POST
        description: Microsoft Azure Query Elevation Data For Multiple Points
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: pointsRequestBody
          in: body
          type: string
          description: The string representation of a list of points. A point is defined in lat/lon WGS84 coordinate reference
            system format.  Each points in a list should be separate
          required: true
  exposes:
  - type: rest
    namespace: azure-maps-elevation-elevation-rest
    port: 8080
    description: REST adapter for Microsoft Azure Azure Maps Elevation API — Elevation. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/elevation/lattice/{format}
      name: elevation-lattice-format
      description: REST surface for elevation-lattice-format.
      operations:
      - method: GET
        name: microsoftazureelevationgetdataforboundingbox
        description: Microsoft Azure Get Elevation Data At Equally Spaced Locations Within A Bounding Box
        call: azure-maps-elevation-elevation.microsoftazureelevationgetdataforboundingbox
        with:
          bounds: rest.bounds
          rows: rest.rows
          columns: rest.columns
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/elevation/line/{format}
      name: elevation-line-format
      description: REST surface for elevation-line-format.
      operations:
      - method: GET
        name: microsoftazureelevationgetdataforpolyline
        description: Microsoft Azure Get Elevation Data Along A Polyline
        call: azure-maps-elevation-elevation.microsoftazureelevationgetdataforpolyline
        with:
          lines: rest.lines
          samples: rest.samples
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazureelevationpostdataforpolyline
        description: Microsoft Azure Query Elevation Data Along A Polyline
        call: azure-maps-elevation-elevation.microsoftazureelevationpostdataforpolyline
        with:
          linesRequestBody: rest.linesRequestBody
          samples: rest.samples
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/elevation/point/{format}
      name: elevation-point-format
      description: REST surface for elevation-point-format.
      operations:
      - method: GET
        name: microsoftazureelevationgetdataforpoints
        description: Microsoft Azure Get Elevation Data On One Or More Points
        call: azure-maps-elevation-elevation.microsoftazureelevationgetdataforpoints
        with:
          points: rest.points
        outputParameters:
        - type: object
          mapping: $.
      - method: POST
        name: microsoftazureelevationpostdataforpoints
        description: Microsoft Azure Query Elevation Data For Multiple Points
        call: azure-maps-elevation-elevation.microsoftazureelevationpostdataforpoints
        with:
          pointsRequestBody: rest.pointsRequestBody
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: azure-maps-elevation-elevation-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Azure Maps Elevation API — Elevation. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-get-elevation-data
      description: Microsoft Azure Get Elevation Data At Equally Spaced Locations Within A Bounding Box
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-maps-elevation-elevation.microsoftazureelevationgetdataforboundingbox
      with:
        bounds: tools.bounds
        rows: tools.rows
        columns: tools.columns
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-elevation-data-2
      description: Microsoft Azure Get Elevation Data Along A Polyline
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-maps-elevation-elevation.microsoftazureelevationgetdataforpolyline
      with:
        lines: tools.lines
        samples: tools.samples
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-query-elevation-data
      description: Microsoft Azure Query Elevation Data Along A Polyline
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: azure-maps-elevation-elevation.microsoftazureelevationpostdataforpolyline
      with:
        linesRequestBody: tools.linesRequestBody
        samples: tools.samples
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-elevation-data-3
      description: Microsoft Azure Get Elevation Data On One Or More Points
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-maps-elevation-elevation.microsoftazureelevationgetdataforpoints
      with:
        points: tools.points
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-query-elevation-data-2
      description: Microsoft Azure Query Elevation Data For Multiple Points
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: azure-maps-elevation-elevation.microsoftazureelevationpostdataforpoints
      with:
        pointsRequestBody: tools.pointsRequestBody
      outputParameters:
      - type: object
        mapping: $.