# 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 Web Feature Service Wfs API
  version: 1.0.0
extends: openapi/microsoft-azure-wfs-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: 8
- target: $.paths['/wfs/datasets/{datasetid}/'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the WFS landing page for a Creator dataset
      effect: read
      questions:
      - What links does the WFS landing page of my Azure Maps Creator dataset provide?
      - Where do I start browsing an indoor map dataset through WFS?
      instructions:
      - text: Get the WFS landing page for dataset {datasetid}.
        slots:
          datasetid: path.datasetid
      - text: Open the Web Feature Service entry point of Creator dataset {datasetid}.
        slots:
          datasetid: path.datasetid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wfs/datasets/{datasetid}/conformance'].get
  update:
    x-apievangelist-phrasing:
      intent: List WFS conformance classes for a dataset
      effect: read
      questions:
      - Which WFS conformance classes does a Creator dataset implement?
      - Can I check which OGC API Features requirements the dataset's WFS meets?
      instructions:
      - text: List the WFS conformance classes for dataset {datasetid}.
        slots:
          datasetid: path.datasetid
      - text: Show the requirements classes the WFS service for {datasetid} conforms to.
        slots:
          datasetid: path.datasetid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wfs/datasets/{datasetid}/collections'].get
  update:
    x-apievangelist-phrasing:
      intent: List feature collections in a Creator dataset
      effect: read
      questions:
      - What feature collections, like units or levels, does my indoor dataset contain?
      - How do I see all the collections in a Creator dataset?
      instructions:
      - text: List the feature collections in dataset {datasetid}.
        slots:
          datasetid: path.datasetid
      - text: Describe every WFS collection available in indoor dataset {datasetid}.
        slots:
          datasetid: path.datasetid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wfs/datasets/{datasetid}/collections/{collectionId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Describe one feature collection in a dataset
      effect: read
      questions:
      - Can I get the description and links of a single feature collection?
      - What does the unit collection in my Creator dataset look like?
      instructions:
      - text: Describe collection {collectionId} in dataset {datasetid}.
        slots:
          collectionId: path.collectionId
          datasetid: path.datasetid
      - text: Show metadata for WFS collection {collectionId} of dataset {datasetid}.
        slots:
          collectionId: path.collectionId
          datasetid: path.datasetid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wfs/datasets/{datasetid}/collections/{collectionId}/definition'].get
  update:
    x-apievangelist-phrasing:
      intent: Get the schema definition of a feature collection
      effect: read
      questions:
      - Which attributes and geometry type does a feature collection define?
      - Can I get the detailed data model of a Creator collection?
      instructions:
      - text: Get the definition of collection {collectionId} in dataset {datasetid}.
        slots:
          collectionId: path.collectionId
          datasetid: path.datasetid
      - text: Show the attribute schema for features in collection {collectionId} of {datasetid}.
        slots:
          collectionId: path.collectionId
          datasetid: path.datasetid
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wfs/datasets/{datasetid}/collections/{collectionId}/items'].get
  update:
    x-apievangelist-phrasing:
      intent: Query features in a collection
      effect: read
      questions:
      - Can I fetch only the indoor features inside a bounding box?
      - Is there a limit on how many features a collection query returns?
      instructions:
      - text: Get features from collection {collectionId} in dataset {datasetid}.
        slots:
          collectionId: path.collectionId
          datasetid: path.datasetid
      - text: Get up to {limit} features of {collectionId} in {datasetid} within bounding box {bbox}.
        slots:
          limit: query.limit
          collectionId: path.collectionId
          datasetid: path.datasetid
          bbox: query.bbox
      - text: Find features in collection {collectionId} of {datasetid} matching {filter}.
        slots:
          collectionId: path.collectionId
          datasetid: path.datasetid
          filter: query.filter
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wfs/datasets/{datasetid}/collections/{collectionId}/items/{featureId}'].get
  update:
    x-apievangelist-phrasing:
      intent: Get a single feature by ID
      effect: read
      questions:
      - How do I retrieve one indoor map feature by its identifier?
      - What geometry and properties does a specific feature carry?
      instructions:
      - text: Get feature {featureId} from collection {collectionId} in dataset {datasetid}.
        slots:
          featureId: path.featureId
          collectionId: path.collectionId
          datasetid: path.datasetid
      - text: Show the details of indoor feature {featureId} in {collectionId}.
        slots:
          featureId: path.featureId
          collectionId: path.collectionId
      method: generated
      generated: '2026-09-26'
- target: $.paths['/wfs/datasets/{datasetid}/collections/{collectionId}/items/{featureId}'].delete
  update:
    x-apievangelist-phrasing:
      intent: Delete a feature from a dataset collection
      effect: destructive
      questions:
      - Can I delete a single feature from a Creator dataset collection?
      - Is removing an indoor feature through WFS permanent?
      instructions:
      - text: Delete feature {featureId} from collection {collectionId} in dataset {datasetid}.
        slots:
          featureId: path.featureId
          collectionId: path.collectionId
          datasetid: path.datasetid
      - text: Remove indoor map feature {featureId} of {collectionId}.
        slots:
          featureId: path.featureId
          collectionId: path.collectionId
      method: generated
      generated: '2026-09-26'