Microsoft Azure Azure Maps Traffic Service — Traffic

naftiko: 1.0.0-alpha2
info:
  label: Microsoft Azure Azure Maps Traffic Service — Traffic
  description: 'Microsoft Azure Azure Maps Traffic Service — Traffic. 5 operations. Lead operation: Microsoft Azure Get Traffic
    Flow Segment Format. Self-contained Naftiko capability covering one Microsoft Azure business surface.'
  tags:
  - Microsoft Azure
  - Traffic
  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-traffic-service-traffic
    baseUri: https://atlas.microsoft.com
    description: Microsoft Azure Azure Maps Traffic Service — Traffic business capability. Self-contained, no shared references.
    resources:
    - name: traffic-flow-segment-format
      path: /traffic/flow/segment/{format}
      operations:
      - name: microsoftazuretrafficgettrafficflowsegment
        method: GET
        description: Microsoft Azure Get Traffic Flow Segment Format
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: style
          in: query
          type: string
          description: The style to be used to render the tile. Valid values are absolute which returns colors reflecting
            the absolute speed measured, relative which returns the speed
          required: true
        - name: query
          in: query
          type: string
          description: Coordinates of the point close to the road segment. They have to be comma-separated and calculated
            using EPSG4326 projection.
          required: true
        - name: unit
          in: query
          type: string
          description: Unit of speed in KMPH or MPH
        - name: thickness
          in: query
          type: integer
          description: The value of the width of the line representing traffic. This value is a multiplier and the accepted
            values range from 1 - 20. The default value is 10.
        - name: openLr
          in: query
          type: boolean
          description: Boolean on whether the response should include OpenLR code
    - name: traffic-flow-tile-format
      path: /traffic/flow/tile/{format}
      operations:
      - name: microsoftazuretrafficgettrafficflowtile
        method: GET
        description: Microsoft Azure Get Traffic Flow Tile Format
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: style
          in: query
          type: string
          description: <p>The style to be used to render the tile.</p>
          required: true
        - name: thickness
          in: query
          type: integer
          description: The value of the width of the line representing traffic. This value is a multiplier and the accepted
            values range from 1 - 20. The default value is 10. This par
    - name: traffic-incident-detail-format
      path: /traffic/incident/detail/{format}
      operations:
      - name: microsoftazuretrafficgettrafficincidentdetail
        method: GET
        description: Microsoft Azure Get Traffic Incident Detail Format
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: style
          in: query
          type: string
          description: The style that will be used to render the tile in Traffic [Incident Tile API](https://docs.microsoft.com/en-us/rest/api/maps/traffic/gettrafficincidenttile).  T
          required: true
        - name: boundingbox
          in: query
          type: string
          description: 'The `boundingbox` is represented by two value pairs describing it''s corners (first pair for lower
            left corner and second for upper right). The pairs can either '
          required: true
        - name: boundingZoom
          in: query
          type: integer
          description: Zoom level for desired tile. 0 to 22 for raster tiles, 0 through 22 for vector tiles
          required: true
        - name: trafficmodelid
          in: query
          type: string
          description: Number referencing traffic model. This can be obtained from the [Viewport API](https://docs.microsoft.com/en-us/rest/api/maps/traffic/gettrafficincidentviewport
          required: true
        - name: language
          in: query
          type: string
          description: '[ISO 639-1 code](https://en.wikipedia.org/wiki/List_of_ISO_639-1_codes) for the output language. Supported
            languages are ar, ca, cs, da, de, el, en, en-GB, en-U'
        - name: projection
          in: query
          type: string
          description: The projection used to specify the coordinates in the request and response. [EPSG900913](http://docs.openlayers.org/library/spherical_mercator.html)
            (default) o
        - name: geometries
          in: query
          type: string
          description: The type of vector geometry added to incidents (returned in the <v> element of the response).
        - name: expandCluster
          in: query
          type: boolean
          description: Boolean to indicate whether to list all traffic incidents in a cluster separately
        - name: originalPosition
          in: query
          type: boolean
          description: Boolean on whether to return the original position of the incident (<op>) as well as the one shifted
            to the beginning of the traffic tube (<op>)
    - name: traffic-incident-tile-format
      path: /traffic/incident/tile/{format}
      operations:
      - name: microsoftazuretrafficgettrafficincidenttile
        method: GET
        description: Microsoft Azure Get Traffic Incident Tile Format
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: style
          in: query
          type: string
          description: The style to be used to render the tile. This parameter is not valid when format is pbf.
          required: true
        - name: t
          in: query
          type: string
          description: Reference value for the state of traffic at a particular time, obtained from the Viewport API call,
            trafficModelId attribute in trafficState field. It is update
    - name: traffic-incident-viewport-format
      path: /traffic/incident/viewport/{format}
      operations:
      - name: microsoftazuretrafficgettrafficincidentviewport
        method: GET
        description: Microsoft Azure Get Traffic Incident Viewport Format
        outputRawFormat: json
        outputParameters:
        - name: result
          type: object
          value: $.
        inputParameters:
        - name: boundingbox
          in: query
          type: string
          description: Bounding box of the map viewport in [EPSG900913](http://docs.openlayers.org/library/spherical_mercator.html)
            projection. The `boundingbox` is represented by two
          required: true
        - name: boundingzoom
          in: query
          type: integer
          description: Zoom level of the map viewport. Used to determine whether the view can be zoomed in.
          required: true
        - name: overviewbox
          in: query
          type: string
          description: Bounding box of the overview map in [EPSG900913](http://docs.openlayers.org/library/spherical_mercator.html)
            projection.<br><br>Used in case the overview box/mi
          required: true
        - name: overviewzoom
          in: query
          type: integer
          description: Zoom level of the overview map. If there is no mini map, use the same zoom level as boundingZoom.
          required: true
        - name: copyright
          in: query
          type: boolean
          description: Determines what copyright information to return. When true the copyright text is returned; when false
            only the copyright index is returned.
          required: true
  exposes:
  - type: rest
    namespace: azure-maps-traffic-service-traffic-rest
    port: 8080
    description: REST adapter for Microsoft Azure Azure Maps Traffic Service — Traffic. One Spectral-compliant resource per
      consumed operation, prefixed with /v1.
    resources:
    - path: /v1/traffic/flow/segment/{format}
      name: traffic-flow-segment-format
      description: REST surface for traffic-flow-segment-format.
      operations:
      - method: GET
        name: microsoftazuretrafficgettrafficflowsegment
        description: Microsoft Azure Get Traffic Flow Segment Format
        call: azure-maps-traffic-service-traffic.microsoftazuretrafficgettrafficflowsegment
        with:
          style: rest.style
          query: rest.query
          unit: rest.unit
          thickness: rest.thickness
          openLr: rest.openLr
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/traffic/flow/tile/{format}
      name: traffic-flow-tile-format
      description: REST surface for traffic-flow-tile-format.
      operations:
      - method: GET
        name: microsoftazuretrafficgettrafficflowtile
        description: Microsoft Azure Get Traffic Flow Tile Format
        call: azure-maps-traffic-service-traffic.microsoftazuretrafficgettrafficflowtile
        with:
          style: rest.style
          thickness: rest.thickness
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/traffic/incident/detail/{format}
      name: traffic-incident-detail-format
      description: REST surface for traffic-incident-detail-format.
      operations:
      - method: GET
        name: microsoftazuretrafficgettrafficincidentdetail
        description: Microsoft Azure Get Traffic Incident Detail Format
        call: azure-maps-traffic-service-traffic.microsoftazuretrafficgettrafficincidentdetail
        with:
          style: rest.style
          boundingbox: rest.boundingbox
          boundingZoom: rest.boundingZoom
          trafficmodelid: rest.trafficmodelid
          language: rest.language
          projection: rest.projection
          geometries: rest.geometries
          expandCluster: rest.expandCluster
          originalPosition: rest.originalPosition
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/traffic/incident/tile/{format}
      name: traffic-incident-tile-format
      description: REST surface for traffic-incident-tile-format.
      operations:
      - method: GET
        name: microsoftazuretrafficgettrafficincidenttile
        description: Microsoft Azure Get Traffic Incident Tile Format
        call: azure-maps-traffic-service-traffic.microsoftazuretrafficgettrafficincidenttile
        with:
          style: rest.style
          t: rest.t
        outputParameters:
        - type: object
          mapping: $.
    - path: /v1/traffic/incident/viewport/{format}
      name: traffic-incident-viewport-format
      description: REST surface for traffic-incident-viewport-format.
      operations:
      - method: GET
        name: microsoftazuretrafficgettrafficincidentviewport
        description: Microsoft Azure Get Traffic Incident Viewport Format
        call: azure-maps-traffic-service-traffic.microsoftazuretrafficgettrafficincidentviewport
        with:
          boundingbox: rest.boundingbox
          boundingzoom: rest.boundingzoom
          overviewbox: rest.overviewbox
          overviewzoom: rest.overviewzoom
          copyright: rest.copyright
        outputParameters:
        - type: object
          mapping: $.
  - type: mcp
    namespace: azure-maps-traffic-service-traffic-mcp
    port: 9090
    transport: http
    description: MCP adapter for Microsoft Azure Azure Maps Traffic Service — Traffic. One tool per consumed operation, routed
      inline through this capability's consumes block.
    tools:
    - name: microsoft-azure-get-traffic-flow
      description: Microsoft Azure Get Traffic Flow Segment Format
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-maps-traffic-service-traffic.microsoftazuretrafficgettrafficflowsegment
      with:
        style: tools.style
        query: tools.query
        unit: tools.unit
        thickness: tools.thickness
        openLr: tools.openLr
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-traffic-flow-2
      description: Microsoft Azure Get Traffic Flow Tile Format
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-maps-traffic-service-traffic.microsoftazuretrafficgettrafficflowtile
      with:
        style: tools.style
        thickness: tools.thickness
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-traffic-incident
      description: Microsoft Azure Get Traffic Incident Detail Format
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-maps-traffic-service-traffic.microsoftazuretrafficgettrafficincidentdetail
      with:
        style: tools.style
        boundingbox: tools.boundingbox
        boundingZoom: tools.boundingZoom
        trafficmodelid: tools.trafficmodelid
        language: tools.language
        projection: tools.projection
        geometries: tools.geometries
        expandCluster: tools.expandCluster
        originalPosition: tools.originalPosition
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-traffic-incident-2
      description: Microsoft Azure Get Traffic Incident Tile Format
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-maps-traffic-service-traffic.microsoftazuretrafficgettrafficincidenttile
      with:
        style: tools.style
        t: tools.t
      outputParameters:
      - type: object
        mapping: $.
    - name: microsoft-azure-get-traffic-incident-3
      description: Microsoft Azure Get Traffic Incident Viewport Format
      hints:
        readOnly: true
        destructive: false
        idempotent: true
      call: azure-maps-traffic-service-traffic.microsoftazuretrafficgettrafficincidentviewport
      with:
        boundingbox: tools.boundingbox
        boundingzoom: tools.boundingzoom
        overviewbox: tools.overviewbox
        overviewzoom: tools.overviewzoom
        copyright: tools.copyright
      outputParameters:
      - type: object
        mapping: $.