# 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 Time Zone Service Timezone API
  version: 1.0.0
extends: openapi/microsoft-azure-timezone-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: 6
- target: $.paths['/timezone/byId/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get time zone info for an IANA zone ID
      effect: read
      questions:
      - What is the current UTC offset and daylight saving rule for an IANA zone like America/New_York?
      - Can I get upcoming DST transitions for a time zone ID over several years?
      instructions:
      - text: Get time zone information for IANA ID {zone_id} as {format}.
        slots:
          zone_id: query.query
          format: path.format
      - text: Show DST transitions for {zone_id} from {from} for {years} years in {format}.
        slots:
          zone_id: query.query
          from: query.transitionsFrom
          years: query.transitionsYears
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timezone/byCoordinates/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get time zone info for a latitude/longitude
      effect: read
      questions:
      - Which time zone is a given latitude and longitude in?
      - Can I find the local time zone and its historical offsets for a map coordinate?
      instructions:
      - text: Get the time zone for coordinates {coordinates} as {format}.
        slots:
          coordinates: query.query
          format: path.format
      - text: Look up the time zone at {coordinates} as of {timestamp}, returning {format}.
        slots:
          coordinates: query.query
          timestamp: query.timeStamp
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timezone/enumWindows/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: List all Windows time zone IDs
      effect: read
      questions:
      - What is the full list of Windows time zone IDs?
      - Can I enumerate every Windows time zone name for a dropdown?
      instructions:
      - text: List all Windows time zone IDs in {format}.
        slots:
          format: path.format
      - text: Enumerate Windows time zones as {format}.
        slots:
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timezone/enumIana/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: List all IANA time zone IDs
      effect: read
      questions:
      - Which IANA time zone IDs are supported?
      - Can I pull the complete IANA zone list to validate user input?
      instructions:
      - text: List all IANA time zone IDs in {format}.
        slots:
          format: path.format
      - text: Enumerate IANA zones as {format}.
        slots:
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timezone/ianaVersion/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the current IANA time zone database version
      effect: read
      questions:
      - What version of the IANA time zone database is the service using?
      - Can I check whether the tz data has been updated to the latest release?
      instructions:
      - text: Get the current IANA version number in {format}.
        slots:
          format: path.format
      - text: Report which tz database release is live, as {format}.
        slots:
          format: path.format
      method: generated
      generated: '2026-09-26'
- target: $.paths['/timezone/windowsToIana/{format}'].get
  update:
    x-apievangelist-phrasing:
      intent: Convert a Windows time zone ID to IANA
      effect: read
      questions:
      - What IANA ID corresponds to a Windows time zone like Pacific Standard Time?
      - Can I narrow a Windows-to-IANA conversion by territory when several IDs match?
      instructions:
      - text: Convert Windows time zone {windows_id} to its IANA ID in {format}.
        slots:
          windows_id: query.query
          format: path.format
      - text: Map Windows zone {windows_id} to IANA for territory {territory}, returning {format}.
        slots:
          windows_id: query.query
          territory: query.territory
          format: path.format
      method: generated
      generated: '2026-09-26'