# 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 Programmable Connectivity Device Location…
  version: 1.0.0
extends: openapi/microsoft-azure-device-location-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: 1
- target: $.paths['/device-location/location:verify'].post
  update:
    x-apievangelist-phrasing:
      intent: Verify a device is within a location area
      effect: read
      questions:
      - Can I confirm through the mobile network that a phone is near a given latitude and longitude?
      - How precise can a device location check be, in kilometers?
      instructions:
      - text: Verify device {device} is within {accuracy} km of {latitude}, {longitude} on network {networkIdentifier} via gateway {apcGatewayId}.
        slots:
          device: requestBody.device
          accuracy: requestBody.accuracy
          latitude: requestBody.latitude
          longitude: requestBody.longitude
          networkIdentifier: requestBody.networkIdentifier
          apcGatewayId: header.apc-gateway-id
      - text: Check whether device {device} is at {latitude}, {longitude}.
        slots:
          device: requestBody.device
          latitude: requestBody.latitude
          longitude: requestBody.longitude
      method: generated
      generated: '2026-09-26'