# 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 Service Traffic API
  version: 1.0.0
extends: openapi/microsoft-azure-traffic-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['/traffic/flow/tile/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a traffic flow map tile
      effect: read
      questions:
      - How do I get Azure Maps tiles that color roads by traffic speed?
      - Can I overlay traffic flow tiles at a given zoom and x/y tile?
      instructions:
      - text: Get a traffic flow tile in {format} style {style} at zoom {zoom}, x {x}, y {y}.
        slots:
          format: path.format
          style: query.style
          zoom: query.zoom
          x: query.x
          y: query.y
      - text: Fetch traffic flow tile x {x} y {y} zoom {zoom} as {format} with style {style} and line thickness {thickness}.
        slots:
          format: path.format
          style: query.style
          zoom: query.zoom
          x: query.x
          y: query.y
          thickness: query.thickness
      method: generated
      generated: '2026-09-26'
- target: $.paths['/traffic/flow/segment/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get speed and travel time for a road segment
      effect: read
      questions:
      - What's the current speed and travel time on the road nearest a coordinate?
      - Can I get traffic flow for a road segment in miles per hour?
      instructions:
      - text: Get traffic flow segment near {point} as {format}, style {style}, zoom {zoom}.
        slots:
          point: query.query
          format: path.format
          style: query.style
          zoom: query.zoom
      - text: Report segment speed near {point} in {unit} as {format} with style {style} at zoom {zoom}.
        slots:
          point: query.query
          unit: query.unit
          format: path.format
          style: query.style
          zoom: query.zoom
      method: generated
      generated: '2026-09-26'
- target: $.paths['/traffic/incident/tile/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a traffic incident map tile
      effect: read
      questions:
      - How do I show traffic incident icons on a map as tiles?
      - Can I request incident tiles tied to a specific traffic model?
      instructions:
      - text: Get a traffic incident tile in {format} style {style} at zoom {zoom}, x {x}, y {y}.
        slots:
          format: path.format
          style: query.style
          zoom: query.zoom
          x: query.x
          y: query.y
      - text: Fetch incident tile x {x} y {y} zoom {zoom} as {format}, style {style}, traffic model {t}.
        slots:
          format: path.format
          style: query.style
          zoom: query.zoom
          x: query.x
          y: query.y
          t: query.t
      method: generated
      generated: '2026-09-26'
- target: $.paths['/traffic/incident/detail/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get traffic incident details in an area
      effect: read
      questions:
      - What traffic incidents are inside a given bounding box right now?
      - Can I get incident details in another language?
      instructions:
      - text: Get traffic incidents in box {box} at zoom {zoom}, model {model}, as {format} style {style}.
        slots:
          box: query.boundingbox
          zoom: query.boundingZoom
          model: query.trafficmodelid
          format: path.format
          style: query.style
      - text: List incidents in {box} (zoom {zoom}, model {model}) in {language}, format {format}, style {style}.
        slots:
          box: query.boundingbox
          zoom: query.boundingZoom
          model: query.trafficmodelid
          language: query.language
          format: path.format
          style: query.style
      method: generated
      generated: '2026-09-26'
- target: $.paths['/traffic/incident/viewport/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get traffic viewport and model info
      effect: read
      questions:
      - Which call gives the current traffic model ID and copyright for my map viewport?
      - What should my app call when the map viewport changes to refresh traffic data?
      instructions:
      - text: Get traffic viewport info for box {box} zoom {zoom}, overview {overview} zoom {ozoom}, copyright {copyright}, as {format}.
        slots:
          box: query.boundingbox
          zoom: query.boundingzoom
          overview: query.overviewbox
          ozoom: query.overviewzoom
          copyright: query.copyright
          format: path.format
      - text: Refresh the traffic model ID for viewport {box} at zoom {zoom} with overview {overview} at {ozoom}, copyright {copyright}, format {format}.
        slots:
          box: query.boundingbox
          zoom: query.boundingzoom
          overview: query.overviewbox
          ozoom: query.overviewzoom
          copyright: query.copyright
          format: path.format
      method: generated
      generated: '2026-09-26'