Understanding Azure Maps Transactions

When you use Azure Maps Services, the API requests you make generate transactions. Your transaction usage is available for review in your Azure portal Metrics report. For more information, see View Azure Maps API usage metrics. These transactions can be either billable or nonbillable usage, depending on the service and the feature. It’s important to understand which usage generates a billable transaction and how it’s calculated so you can plan and budget for the costs associated with using Azure Maps. Billable transactions show up in your Cost Analysis report within the Azure portal.

Note

Azure Maps Gen1 pricing tier retirement

Gen1 pricing tier is now deprecated and will be retired on 9/15/26. Gen2 pricing tier replaces Gen1 (both S0 and S1) pricing tier. If your Azure Maps account has Gen1 pricing tier selected, you can switch to Gen2 pricing tier before it’s retired, otherwise it will automatically be updated. For more information, see Manage the pricing tier of your Azure Maps account.

Azure Maps Transaction information by service

The following table summarizes the Azure Maps services that generate transactions, billable and nonbillable, along with any notable aspects that are helpful to understand in how the number of transactions are calculated.

Note

For Azure Maps pricing information and free offering details, see Azure Maps Pricing.

Azure Maps Service Billable Transaction Calculation Meter
Data service (Deprecated1) Yes, except for MapDataStorageService.GetDataStatus and MapDataStorageService.GetUserData, which are nonbillable One request = 1 transaction
  • Location Insights Data (Gen2 pricing)
Data registry Yes One request = 1 transaction
  • Location Insights Data (Gen2 pricing)
Geolocation Yes One request = 1 transaction
  • Location Insights Geolocation (Gen2 pricing)
  • Standard S1 Geolocation Transactions (Gen1 S1 pricing)
  • Standard Geolocation Transactions (Gen1 S0 pricing)
Render Yes, except Get Copyright API, Get Attribution API and Terra maps (MapTile.GetTerraTile and layer=terra) which are nonbillable.
  • 15 tiles = 1 transaction
  • One request for Get Copyright = 1 transaction
  • One request for Get Map Attribution = 1 transaction
  • One request for Get Static Map = 1 transaction
  • One request for Get Map Tileset = 1 transaction

For Creator related usage, see the Creator table.
  • Maps Base Map Tiles (Gen2 pricing)
  • Maps Imagery Tiles (Gen2 pricing)
  • Maps Static Map Images (Gen2 pricing)
  • Maps Weather Tiles (Gen2 pricing)
  • Standard Hybrid Aerial Imagery Transactions (Gen1 S0 pricing)
  • Standard Aerial Imagery Transactions (Gen1 S0 pricing)
  • Standard S1 Aerial Imagery Transactions (Gen1 S1 pricing)
  • Standard S1 Hybrid Aerial Imagery Transactions (Gen1 S1 pricing)
  • Standard S1 Rendering Transactions (Gen1 S1 pricing)
  • Standard S1 Tile Transactions (Gen1 S1 pricing)
  • Standard S1 Weather Tile Transactions (Gen1 S1 pricing)
  • Standard Tile Transactions (Gen1 S0 pricing)
  • Standard Weather Tile Transactions (Gen1 S0 pricing)
  • Maps Copyright (Gen2 pricing, Gen1 S0 pricing and Gen1 S1 pricing)
Route Yes One request = 1 transaction
  • If using the Route Matrix, each cell in the Route Matrix request generates a billable Route transaction.
  • If using Batch Directions, each origin/destination coordinate pair in the Batch request call generates a billable Route transaction. Note, the billable Route transaction usage results generated by the batch request has -Batch appended to the API name of your Azure portal metrics report.
  • Location Insights Routing (Gen2 pricing)
  • Standard S1 Routing Transactions (Gen1 S1 pricing)
  • Standard Services API Transactions (Gen1 S0 pricing)
Search v1
Search v2
Yes One request = 1 transaction.
  • If using Batch Search, each location in the Batch request generates a billable Search transaction. Note, the billable Search transaction usage results generated by the batch request has -Batch appended to the API name of your Azure portal metrics report.
  • Location Insights Search
  • Standard S1 Search Transactions (Gen1 S1 pricing)
  • Standard Services API Transactions (Gen1 S0 pricing)
Spatial Yes, except for Spatial.GetBoundingBox, Spatial.PostBoundingBox and Spatial.PostPointInPolygonBatch, which are nonbillable. One request = 1 transaction.
  • If using Geofence, five requests = 1 transaction
  • Location Insights Spatial Calculations (Gen2 pricing)
  • Standard S1 Spatial Transactions (Gen1 S1 pricing)
Timezone Yes One request = 1 transaction
  • Location Insights Timezone (Gen2 pricing)
  • Standard S1 Time Zones Transactions (Gen1 S1 pricing)
  • Standard Time Zones Transactions (Gen1 S0 pricing)
Traffic Yes One request = 1 transaction (except tiles)
15 tiles = 1 transaction
  • Location Insights Traffic (Gen2 pricing)
  • Standard S1 Traffic Transactions (Gen1 S1 pricing)
  • Standard Traffic Transactions (Gen1 S0 pricing)
  • Maps Traffic Tiles (Gen2 pricing)
  • Standard S1 Tile Transactions (Gen1 S1 pricing)
  • Standard Tile Transactions (Gen1 S0 pricing)
Weather Yes One request = 1 transaction
  • Location Insights Weather (Gen2 pricing)
  • Standard S1 Weather Transactions (Gen1 S1 pricing)
  • Standard Weather Transactions (Gen1 S0 pricing)

1 The Azure Maps Data service (both v1 and v2) is now deprecated and will be retired on 9/16/24. To avoid service disruptions, all calls to the Data service will need to be updated to use the Azure Maps Data Registry service by 9/16/24. For more information, see How to create data registry.

Azure Maps Creator

Azure Maps Creator Billable Transaction Calculation Meter
Alias No One request = 1 transaction Not applicable
Conversion Part of a provisioned Creator resource and not transactions based. Not transaction-based Map Provisioning (Gen2 pricing)
Dataset Part of a provisioned Creator resource and not transactions based. Not transaction-based Map Provisioning (Gen2 pricing)
Feature State Yes, except for FeatureState.CreateStateset, FeatureState.DeleteStateset, FeatureState.GetStateset, FeatureState.ListStatesets, FeatureState.UpdateStatesets One request = 1 transaction Azure Maps Creator Feature State (Gen2 pricing)
Render Yes, only with GetMapTile with Creator Tileset ID and GetStaticTile.
For everything else for Render, see Render section in the above table.
One request = 1 transaction
One tile = 1 transaction
Azure Maps Creator Map Render (Gen2 pricing)
Tileset Part of a provisioned Creator resource and not transactions based. Not transaction-based Map Provisioning    (Gen2 pricing)
WFS Yes One request = 1 transaction Azure Maps Creator Web Feature (WFS) (Gen2 pricing)

Understand billing transactions

Azure Maps doesn't count billing transactions for:

  • 5xx HTTP Status Codes
  • 401 (Unauthorized)
  • 403 (Forbidden)
  • 408 (Timeout)
  • 429 (TooManyRequests)
  • CORS preflight requests

For more information on billing transactions and other Azure Maps pricing information, see Azure Maps pricing.

Next steps