# Generated by API Evangelist (build-phrasing.py). Our phrasing, not observed demand.
overlay: 1.0.0
info:
  title: API Evangelist conversational phrasing for Microsoft Azure Azure Maps Elevation API
  version: 1.0.0
extends: openapi/microsoft-azure-elevation-api-openapi.yml
actions:
- target: $.info
  update:
    x-apievangelist-phrasing:
      method: generated
      generated: '2026-09-26'
      generator: build-phrasing.py
      label: Generated by API Evangelist
      operations: 5
- target: $.paths['/elevation/point/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get elevation for up to 100 points
      effect: read
      questions:
      - What is the ground elevation at a latitude and longitude?
      - How many coordinates can I send in a single GET elevation request?
      instructions:
      - text: Get the elevation at points {points} in {format}.
        slots:
          points: query.points
          format: path.format
      - text: Look up elevation data for coordinates {points}.
        slots:
          points: query.points
      method: generated
      generated: '2026-09-26'
- target: $.paths['/elevation/point/{format}'].post
  update:
    x-apievangelist-phrasing:
      intent: Get elevation for many points in one POST
      effect: read
      questions:
      - Can I send more than 100 coordinates to get their elevations?
      - How do I query elevation for a large batch of lat/lon points?
      instructions:
      - text: Post a batch of coordinates and return their elevations in {format}.
        slots:
          format: path.format
      - text: Query elevations for a long list of points as {format}.
        slots:
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/elevation/line/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get elevation along a polyline
      effect: read
      questions:
      - How do I get an elevation profile along a route?
      - Can I control how many sample points are taken along a line?
      instructions:
      - text: Get elevation along polyline {lines} in {format}.
        slots:
          lines: query.lines
          format: path.format
      - text: Sample {samples} evenly spaced elevations along line {lines}.
        slots:
          samples: query.samples
          lines: query.lines
      method: generated
      generated: '2026-09-26'
- target: $.paths['/elevation/line/{format}'].post
  update:
    x-apievangelist-phrasing:
      intent: Get elevation along a long polyline via POST
      effect: read
      questions:
      - Can I post a polyline with many vertices to get an elevation profile?
      - What is the POST option for elevation along a line?
      instructions:
      - text: Post a polyline and return {samples} elevation samples along it in {format}.
        slots:
          samples: query.samples
          format: path.format
      - text: Query the elevation profile of a long posted line as {format}.
        slots:
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/elevation/lattice/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get an elevation grid within a bounding box
      effect: read
      questions:
      - How do I get elevations on a grid across a rectangular area?
      - What is the maximum number of elevations a bounding box request returns?
      instructions:
      - text: Get elevations in bounding box {bounds} divided into {rows} rows and {columns} columns.
        slots:
          bounds: query.bounds
          rows: query.rows
          columns: query.columns
      - text: Return a {format} elevation lattice for area {bounds}.
        slots:
          format: path.format
          bounds: query.bounds
      method: generated
      generated: '2026-09-26'