naftiko: 1.0.0-alpha2
info:
  label: Amazon Location Service API — Maps
  description: 'Amazon Location Service API — Maps. 8 operations. Lead operation: Amazon Location Service Create Map. Self-contained
    Naftiko capability covering one Amazon Location Service business surface.'
  tags:
  - Amazon Location Service
  - Maps
  created: '2026-05-19'
  modified: '2026-05-19'
binds:
- namespace: env
  keys:
    AMAZON_LOCATION_SERVICE_API_KEY: AMAZON_LOCATION_SERVICE_API_KEY
capability:
  consumes:
  - type: http
    namespace: amazon-location-service-maps
    baseUri: https://geo.us-east-1.amazonaws.com
    description: Amazon Location Service API — Maps business capability. Self-contained, no shared references.
    resources:
    - name: maps
      path: /maps
      operations:
      - name: createmap
        method: POST
        description: Amazon Location Service Create Map
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listmaps
        method: GET
        description: Amazon Location Service List Maps
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: maps-MapName
      path: /maps/{MapName}
      operations:
      - name: describemap
        method: GET
        description: Amazon Location Service Describe Map
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: MapName
          in: path
          type: string
          description: The name of the map resource.
          required: true
      - name: deletemap
        method: DELETE
        description: Amazon Location Service Delete Map
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: MapName
          in: path
          type: string
          description: The name of the map resource.
          required: true
    - name: places-v0-indexes-IndexName-search-text
      path: /places/v0/indexes/{IndexName}/search/text
      operations:
      - name: searchplaceindexfortext
        method: POST
        description: Amazon Location Service Search Place Index for Text
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: IndexName
          in: path
          type: string
          description: The name of the place index resource.
          required: true
    - name: tracking-v0-trackers
      path: /tracking/v0/trackers
      operations:
      - name: createtracker
        method: POST
        description: Amazon Location Service Create Tracker
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
      - name: listtrackers
        method: GET
        description: Amazon Location Service List Trackers
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
    - name: tracking-v0-trackers-TrackerName-positions
      path: /tracking/v0/trackers/{TrackerName}/positions
      operations:
      - name: batchupdatedeviceposition
        method: POST
        description: Amazon Location Service Batch Update Device Position
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: TrackerName
          in: path
          type: string
          description: The name of the tracker.
          required: true
    authentication:
      type: apikey
      key: Authorization
      value: '{{env.AMAZON_LOCATION_SERVICE_API_KEY}}'
      placement: header
  exposes:
  - type: rest
    namespace: amazon-location-service-maps-rest
    port: 8080
    description: REST adapter for Amazon Location Service API — Maps. One Spectral-compliant resource per consumed operation,
      prefixed with /v1.
    resources:
    - path: /v1/maps
      name: maps
      description: REST surface for maps.
      operations:
      - method: POST
        name: createmap
        description: Amazon Location Service Create Map
        call: amazon-location-service-maps.createmap
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: listmaps
        description: Amazon Location Service List Maps
        call: amazon-location-service-maps.listmaps
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/maps/{mapname}
      name: maps-mapname
      description: REST surface for maps-MapName.
      operations:
      - method: GET
        name: describemap
        description: Amazon Location Service Describe Map
        call: amazon-location-service-maps.describemap
        with:
          MapName: rest.MapName
        outputParameters:
        - type: object
          mapping: $.
      - method: DELETE
        name: deletemap
        description: Amazon Location Service Delete Map
        call: amazon-location-service-maps.deletemap
        with:
          MapName: rest.MapName
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/places/v0/indexes/{indexname}/search/text
      name: places-v0-indexes-indexname-search-text
      description: REST surface for places-v0-indexes-IndexName-search-text.
      operations:
      - method: POST
        name: searchplaceindexfortext
        description: Amazon Location Service Search Place Index for Text
        call: amazon-location-service-maps.searchplaceindexfortext
        with:
          IndexName: rest.IndexName
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tracking/v0/trackers
      name: tracking-v0-trackers
      description: REST surface for tracking-v0-trackers.
      operations:
      - method: POST
        name: createtracker
        description: Amazon Location Service Create Tracker
        call: amazon-location-service-maps.createtracker
        outputParameters:
        - type: object
          mapping: $.
      - method: GET
        name: listtrackers
        description: Amazon Location Service List Trackers
        call: amazon-location-service-maps.listtrackers
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/tracking/v0/trackers/{trackername}/positions
      name: tracking-v0-trackers-trackername-positions
      description: REST surface for tracking-v0-trackers-TrackerName-positions.
      operations:
      - method: POST
        name: batchupdatedeviceposition
        description: Amazon Location Service Batch Update Device Position
        call: amazon-location-service-maps.batchupdatedeviceposition
        with:
          TrackerName: rest.TrackerName
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: amazon-location-service-maps-mcp
    port: 9090
    transport: http
    description: MCP adapter for Amazon Location Service API — Maps. One tool per consumed operation, routed inline through
      this capability's consumes block.
    tools:
    - name: amazon-location-service-create-map
      description: Amazon Location Service Create Map
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: amazon-location-service-maps.createmap
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-location-service-list-maps
      description: Amazon Location Service List Maps
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amazon-location-service-maps.listmaps
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-location-service-describe-map
      description: Amazon Location Service Describe Map
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amazon-location-service-maps.describemap
      with:
        MapName: tools.MapName
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-location-service-delete-map
      description: Amazon Location Service Delete Map
      hints:
        readOnly: false
        destructive: true
        idempotent: true
      call: amazon-location-service-maps.deletemap
      with:
        MapName: tools.MapName
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-location-service-search-place
      description: Amazon Location Service Search Place Index for Text
      hints:
        readOnly: true
        destructive: false
        idempotent: false
      call: amazon-location-service-maps.searchplaceindexfortext
      with:
        IndexName: tools.IndexName
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-location-service-create-tracker
      description: Amazon Location Service Create Tracker
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: amazon-location-service-maps.createtracker
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-location-service-list-trackers
      description: Amazon Location Service List Trackers
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: amazon-location-service-maps.listtrackers
      outputParameters:
      - type: object
        mapping: $.
    - name: amazon-location-service-batch-update
      description: Amazon Location Service Batch Update Device Position
      hints:
        readOnly: false
        destructive: false
        idempotent: false
      call: amazon-location-service-maps.batchupdatedeviceposition
      with:
        TrackerName: tools.TrackerName
      outputParameters:
      - type: object
        mapping: $.