# 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 Geocoding Service Geocode API
  version: 1.0.0
extends: openapi/microsoft-azure-geocode-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: 2
- target: $.paths['/geocode'].get
  update:
    x-apievangelist-phrasing:
      intent: Geocode an address or place
      effect: read
      questions:
      - How do I turn a street address into latitude and longitude?
      - Can I geocode using structured fields like postal code and locality?
      - Is there a way to limit geocoding results to a country or bounding box?
      instructions:
      - text: Geocode the address {query}.
        slots:
          query: query.query
      - text: Find coordinates for {addressLine} in {locality}, postal code {postalCode}.
        slots:
          addressLine: query.addressLine
          locality: query.locality
          postalCode: query.postalCode
      - text: Geocode {query} restricted to countries {countryRegionSet}, top {top} results.
        slots:
          query: query.query
          countryRegionSet: query.countryRegionSet
          top: query.top
      method: generated
      generated: '2026-09-26'
- target: $.paths['/geocode/batch'].post
  update:
    x-apievangelist-phrasing:
      intent: Geocode many addresses in one batch
      effect: read
      questions:
      - Is it possible to geocode a whole list of addresses in a single request?
      - Can I send batched geocoding queries instead of one call per address?
      instructions:
      - text: 'Geocode this batch of addresses: {batchItems}.'
        slots:
          batchItems: requestBody.batchItems
      - text: 'Get coordinates for all these addresses in one batch, results in language {lang}: {batchItems}.'
        slots:
          lang: header.Accept-Language
          batchItems: requestBody.batchItems
      method: generated
      generated: '2026-09-26'