Microsoft Azure Azure Maps Geocoding Service — Geocode

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Azure Maps Geocoding Service — Geocode
  description: 'Microsoft Azure Azure Maps Geocoding Service — Geocode. 2 operations. Lead operation: Microsoft Azure Get
    Geocode. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Geocode
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    MICROSOFT_AZURE_API_KEY: MICROSOFT_AZURE_API_KEY
capability:
  consumes:
  - type: http
    namespace: azure-maps-geocoding-service-geocode
    baseUri: https://atlas.microsoft.com
    description: Microsoft Azure Azure Maps Geocoding Service — Geocode business capability. Self-contained, no shared references.
    resources:
    - name: geocode
      path: /geocode
      operations:
      - name: microsoftazuresearchgetgeocoding
        method: GET
        description: Microsoft Azure Get Geocode
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: query
          in: query
          type: string
          description: A string that contains information about a location, such as an address or landmark name.
        - name: addressLine
          in: query
          type: string
          description: The official street line of an address relative to the area, as specified by the locality, or postalCode,
            properties. Typical use of this element would be to pr
        - name: countryRegionSet
          in: query
          type: array
          description: Comma separated string of country or region codes(ISO 3166-1 Alpha-2), e.g. FR,ES. This will limit
            the search to the specified countries. Only the first country
        - name: adminDistrict
          in: query
          type: string
          description: The country subdivision portion of an address, such as WA.
        - name: adminDistrict2
          in: query
          type: string
          description: The county for the structured address, such as King.
        - name: adminDistrict3
          in: query
          type: string
          description: The named area for the structured address.
        - name: locality
          in: query
          type: string
          description: The locality portion of an address, such as Seattle.
        - name: postalCode
          in: query
          type: string
          description: The postal code portion of an address.
        - name: strictMatch
          in: query
          type: string
          description: Restrict the geocoding result to the country or region that is specified in the countryRegionSet field
            and the state, province or territory specified in the adm
    - name: geocode-batch
      path: /geocode/batch
      operations:
      - name: microsoftazuresearchgetgeocodingbatch
        method: POST
        description: Microsoft Azure Post Geocode Batch
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: geocodingBatchRequestBody
          in: body
          type: string
          description: The list of address geocoding queries/requests to process. The list can contain a max of 100 queries
            and must contain at least 1 query.
          required: true
  exposes:
  - type: rest
    namespace: azure-maps-geocoding-service-geocode-rest
    port: 8080
    description: REST adapter for Microsoft Azure Azure Maps Geocoding Service — Geocode. One Spectral-compliant resource
      per consumed operation, prefixed with /v1.
    resources:
    - path: /v1/geocode
      name: geocode
      description: REST surface for geocode.
      operations:
      - method: GET
        name: microsoftazuresearchgetgeocoding
        description: Microsoft Azure Get Geocode
        call: azure-maps-geocoding-service-geocode.microsoftazuresearchgetgeocoding
        with:
          query: rest.query
          addressLine: rest.addressLine
          countryRegionSet: rest.countryRegionSet
          adminDistrict: rest.adminDistrict
          adminDistrict2: rest.adminDistrict2
          adminDistrict3: rest.adminDistrict3
          locality: rest.locality
          postalCode: rest.postalCode
          strictMatch: rest.strictMatch
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/geocode/batch
      name: geocode-batch
      description: REST surface for geocode-batch.
      operations:
      - method: POST
        name: microsoftazuresearchgetgeocodingbatch
        description: Microsoft Azure Post Geocode Batch
        call: azure-maps-geocoding-service-geocode.microsoftazuresearchgetgeocodingbatch
        with:
          geocodingBatchRequestBody: rest.geocodingBatchRequestBody
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: azure-maps-geocoding-service-geocode-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Azure Maps Geocoding Service — Geocode. One tool per consumed operation,
      routed inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-get-geocode
      description: Microsoft Azure Get Geocode
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-maps-geocoding-service-geocode.microsoftazuresearchgetgeocoding
      with:
        query: tools.query
        addressLine: tools.addressLine
        countryRegionSet: tools.countryRegionSet
        adminDistrict: tools.adminDistrict
        adminDistrict2: tools.adminDistrict2
        adminDistrict3: tools.adminDistrict3
        locality: tools.locality
        postalCode: tools.postalCode
        strictMatch: tools.strictMatch
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-post-geocode-batch
      description: Microsoft Azure Post Geocode Batch
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: azure-maps-geocoding-service-geocode.microsoftazuresearchgetgeocodingbatch
      with:
        geocodingBatchRequestBody: tools.geocodingBatchRequestBody
      outputParameters:
      - type: object
        mapping: $.