# Coverage demoted 2026-10-07 (roadmap#942, PLAN.md Stage A): this file was written by an API Evangelist
# sweep and names no billing unit, meters or pricing category read from the provider — it restates the
# FinOps framework. It is `x-coverage: unmeasured`, and the FOCUS alignment it claimed has been removed.
x-coverage: unmeasured
specification: FinOps Framework
specificationVersion: '1.0'
provider: Azure Maps
providerId: microsoft-azure-maps
publisherName: Azure Maps
serviceCategory: API
created: '2026-05-04'
# Provenance stamped 2026-08-11: this artifact was written by the API Evangelist
# bulk sweep dated 2026-05-04, not harvested from the provider. See roadmap#35.
method: generated
modified: '2026-05-04'
tags:
  - Geocoding
  - Geospatial
  - Location
  - Maps
  - Mobility
  - Routing
  - Traffic
  - Weather
  - FinOps
  - Cost Management
  - FOCUS
description: FinOps framework definition for the Azure Maps API surface. Provides a FOCUS-aligned mapping
  for cost allocation, usage measurement, and unit-economics reporting across the provider's APIs.
principles:
  - name: Visibility
    description: Make API consumption costs visible to engineering, product, and finance teams in near
      real-time.
  - name: Allocation
    description: Tag every chargeable API call with the consuming team, environment, application, and
      feature so cost can be allocated.
  - name: Optimization
    description: Continuously evaluate request patterns, caching, batching, and tier selection to reduce
      cost per useful unit of work.
  - name: Accountability
    description: Establish budget owners and chargeback or showback flows for each consuming team.
domains:
  - name: Understand Usage and Cost
    capabilities:
      - Data Ingestion
      - Allocation
      - Reporting and Analytics
      - Anomaly Management
  - name: Quantify Business Value
    capabilities:
      - Planning and Estimating
      - Forecasting
      - Budgeting
      - Benchmarking
      - Unit Economics
  - name: Optimize Usage and Cost
    capabilities:
      - Architecting for Cloud
      - Rate Optimization
      - Workload Optimization
      - Cloud Sustainability
      - Licensing and SaaS
  - name: Manage the FinOps Practice
    capabilities:
      - FinOps Practice Operations
      - FinOps Education and Enablement
      - Invoicing and Chargeback
      - Onboarding Workloads
      - Intersecting Disciplines
billingModel:
  pricingCategory: Usage-Based
  billingFrequency: Monthly
  billingCurrency: USD
  chargeCategories:
    - Usage
    - Purchase
    - Tax
    - Credit
    - Adjustment
  chargeFrequency: Recurring
focusColumns:
  ServiceName: Azure Maps
  ServiceCategory: Developer Tools / API
  ProviderName: Azure Maps
  PublisherName: Azure Maps
  InvoiceIssuerName: Azure Maps
  PricingCategory: Usage-Based
  PricingUnit: request
  BillingCurrency: USD
  ChargeCategory: Usage
meters:
  - name: api_requests
    description: Count of billable API requests
    unit: request
    aggregation: sum
    dimensions:
      - api
      - endpoint
      - tier
      - region
      - consumer
  - name: data_egress
    description: Bytes returned over the network in API responses
    unit: GB
    aggregation: sum
    dimensions:
      - api
      - region
      - consumer
  - name: compute_seconds
    description: Server-side compute consumed by the request, where applicable
    unit: second
    aggregation: sum
    dimensions:
      - api
      - endpoint
      - tier
apis:
  - name: Azure Maps Search API
    baseURL: https://atlas.microsoft.com
    tags:
      - Address
      - Geocoding
      - POI
      - Reverse Geocoding
      - Search
    serviceName: Azure Maps Search API
    serviceCategory: API
  - name: Azure Maps Route API
    baseURL: https://atlas.microsoft.com
    tags:
      - Directions
      - Isochrone
      - Routing
      - Traffic-Aware
      - Travel Modes
    serviceName: Azure Maps Route API
    serviceCategory: API
  - name: Azure Maps Render API
    baseURL: https://atlas.microsoft.com
    tags:
      - Map Tiles
      - Raster
      - Render
      - Static Images
      - Vector Tiles
    serviceName: Azure Maps Render API
    serviceCategory: API
  - name: Azure Maps Traffic API
    baseURL: https://atlas.microsoft.com
    tags:
      - Flow
      - Incidents
      - Real-Time
      - Traffic
    serviceName: Azure Maps Traffic API
    serviceCategory: API
  - name: Azure Maps Weather API
    baseURL: https://atlas.microsoft.com
    tags:
      - Alerts
      - Forecast
      - Historical
      - Weather
    serviceName: Azure Maps Weather API
    serviceCategory: API
  - name: Azure Maps Timezone API
    baseURL: https://atlas.microsoft.com
    tags:
      - DST
      - IANA
      - Time Zone
      - UTC Offset
    serviceName: Azure Maps Timezone API
    serviceCategory: API
  - name: Azure Maps Geolocation API
    baseURL: https://atlas.microsoft.com
    tags:
      - Country Code
      - Geolocation
      - IP Address
      - Localization
    serviceName: Azure Maps Geolocation API
    serviceCategory: API
  - name: Azure Maps Spatial API
    baseURL: https://atlas.microsoft.com
    tags:
      - Geofencing
      - Point in Polygon
      - Spatial Analysis
      - Spatial Operations
    serviceName: Azure Maps Spatial API
    serviceCategory: API
  - name: Azure Maps Elevation API
    baseURL: https://atlas.microsoft.com
    tags:
      - DEM
      - Elevation
      - Terrain
      - Topography
    serviceName: Azure Maps Elevation API
    serviceCategory: API
  - name: Azure Maps Creator API
    baseURL: https://atlas.microsoft.com
    tags:
      - Creator
      - Indoor Maps
      - Tileset
      - Wayfinding
    serviceName: Azure Maps Creator API
    serviceCategory: API
unitEconomics:
  - name: Cost per 1K Requests
    metric: billed_cost / (api_requests / 1000)
  - name: Cost per Active Consumer
    metric: billed_cost / active_consumers
maintainers:
  - FN: Kin Lane
    email: kin@apievangelist.com