# 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 Route API
  version: 1.0.0
extends: openapi/microsoft-azure-route-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['/route/matrix/{format}'].post
  update:
    x-apievangelist-phrasing:
      intent: Calculate a travel time matrix between locations
      effect: read
      questions:
      - Can I get travel times and distances between every origin and every destination in one request?
      - Which pricing tier do I need for matrix routing in Azure Maps?
      - Is it possible to compute a route matrix for trucks with a given vehicle weight?
      instructions:
      - text: Compute a route matrix in {format} from origins {origins} to destinations {destinations}.
        slots:
          format: path.format
          origins: requestBody.origins
          destinations: requestBody.destinations
      - text: Build a {travelMode} travel-time matrix in {format} from {origins} to {destinations}, departing at {departAt}.
        slots:
          travelMode: query.travelMode
          format: path.format
          origins: requestBody.origins
          destinations: requestBody.destinations
          departAt: query.departAt
      method: generated
      generated: '2026-09-26'
- target: $.paths['/route/directions/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get driving directions between waypoints
      effect: read
      questions:
      - How do I get turn-by-turn directions between two coordinates with Azure Maps?
      - Can I request alternative routes and avoid toll roads in a simple directions call?
      - What's the quickest way to get an ETA with live traffic for a route given as a coordinate string?
      instructions:
      - text: Get directions in {format} for the waypoints {query}.
        slots:
          format: path.format
          query: query.query
      - text: Route {query} by {travelMode} in {format}, avoiding {avoid}, with up to {maxAlternatives} alternatives.
        slots:
          query: query.query
          travelMode: query.travelMode
          format: path.format
          avoid: query.avoid
          maxAlternatives: query.maxAlternatives
      method: generated
      generated: '2026-09-26'
- target: $.paths['/route/directions/{format}'].post
  update:
    x-apievangelist-phrasing:
      intent: Get directions with supporting points or avoid areas
      effect: read
      questions:
      - Can I reconstruct a route along a set of supporting points I already have?
      - How can I route around specific polygon areas I want to avoid?
      instructions:
      - text: Get directions in {format} for {query} that avoid the areas {avoidAreas}.
        slots:
          format: path.format
          query: query.query
          avoidAreas: requestBody.avoidAreas
      - text: Compute a route in {format} for {query} following the supporting points {supportingPoints}.
        slots:
          format: path.format
          query: query.query
          supportingPoints: requestBody.supportingPoints
      method: generated
      generated: '2026-09-26'
- target: $.paths['/route/range/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Calculate a reachable range (isochrone)
      effect: read
      questions:
      - What area can I reach from a point within 30 minutes of driving?
      - Can I draw an isochrone based on a remaining EV battery budget in kWh?
      - Is there a way to see how far a vehicle can go on a given distance budget?
      instructions:
      - text: Calculate the area reachable from {query} within {timeBudgetInSec} seconds, returned as {format}.
        slots:
          query: query.query
          timeBudgetInSec: query.timeBudgetInSec
          format: path.format
      - text: Draw the reachable range in {format} from {query} with an energy budget of {energyBudgetInkWh} kWh.
        slots:
          format: path.format
          query: query.query
          energyBudgetInkWh: query.energyBudgetInkWh
      method: generated
      generated: '2026-09-26'
- target: $.paths['/route/directions/batch/{format}'].post
  update:
    x-apievangelist-phrasing:
      intent: Submit a batch of route directions queries
      effect: read
      questions:
      - Can I send many route directions queries in a single batch request?
      - How do I run hundreds of directions lookups at once instead of one by one?
      instructions:
      - text: Run these route directions queries {batchItems} as one batch in {format}.
        slots:
          batchItems: requestBody.batchItems
          format: path.format
      - text: Submit a directions batch in {format} with the items {batchItems}.
        slots:
          format: path.format
          batchItems: requestBody.batchItems
      method: generated
      generated: '2026-09-26'