azure-maps

name	azure-maps
description	Expert knowledge for Azure Maps development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when using Azure Maps web SDK, search/geocoding, routing/traffic, weather APIs, or migrating from Bing/Google Maps, and other Azure Maps related development tasks. Not for Azure AI Search (use azure-cognitive-search), Azure Digital Twins (use azure-digital-twins), Azure IoT (use azure-iot), Azure IoT Hub (use azure-iot-hub).
compatibility	Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata	{"generated_at":"2026-04-12","generator":"docs2skills/1.0.0"}

Azure Maps Skill

This skill provides expert guidance for Azure Maps. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. It combines local quick-reference content with remote documentation fetching capabilities.

How to Use This Skill

IMPORTANT for Agent: Use the Category Index below to locate relevant sections. For categories with line ranges (e.g., L35-L120), use read_file with the specified lines. For categories with file links (e.g., [security.md](security.md)), use read_file on the linked reference file

IMPORTANT for Agent: If metadata.generated_at is more than 3 months old, suggest the user pull the latest version from the repository. If mcp_microsoftdocs tools are not available, suggest the user install it: Installation Guide

This skill requires network access to fetch documentation content:

• Preferred: Use mcp_microsoftdocs:microsoft_docs_fetch with query string from=learn-agent-skill. Returns Markdown.
• Fallback: Use fetch_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

Category	Lines	Description
Troubleshooting	L36-L40	Diagnosing and fixing common Azure Maps Weather API issues, including authentication, request/response errors, throttling, and configuration or usage problems.
Best Practices	L41-L51	Best practices for Azure Maps apps: auth/security, routing and search usage, static image rendering, performance tuning, accessibility, and correct copyright/attribution.
Decision Making	L52-L64	Guidance on pricing, billing, and migrating maps apps to Azure Maps from Bing, Google, Power BI visuals, and older Azure Maps APIs, including routing, tiles, and search replacements
Architecture & Design Patterns	L65-L70	Designing Azure architectures for elevation data services and multi-itinerary route optimization using Azure Maps, open DEM data, and NVIDIA cuOpt for scalable geospatial solutions
Limits & Quotas	L71-L80	Coverage, limits, and capabilities of Azure Maps services: QPS rate limits, and regional support for geocoding, rendering/tiles, routing, traffic, and weather data.
Security	L81-L95	Securing Azure Maps access: auth methods (keys, SAS, Entra ID), SPA/daemon/device scenarios, Power BI visual governance, and network isolation with Private Link.
Configuration	L96-L120	Configuring Azure Maps web maps, styles, layers, data sources, routing models, localization, browser support, and migrating or updating to newer Azure Maps APIs and services.
Integrations & Coding Patterns	L121-L181	Patterns and code for integrating Azure Maps into web/mobile/Power BI apps, using REST/SDKs, layers, drawing, search/routing/weather, Spatial IO, and migrating from Bing/Google Maps.

Troubleshooting

Topic	URL
Resolve common Azure Maps Weather service issues	https://learn.microsoft.com/en-us/azure/azure-maps/weather-services-faq

Best Practices

Topic	URL
Apply authentication best practices for Azure Maps apps	https://learn.microsoft.com/en-us/azure/azure-maps/authentication-best-practices
Render custom data on Azure Maps static raster images	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-render-custom-data
Show required Azure Maps copyright attribution correctly	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-show-attribution
Apply best practices for Azure Maps Route service	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-use-best-practices-for-routing
Apply best practices for Azure Maps Search	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-use-best-practices-for-search
Implement accessibility features in Azure Maps apps	https://learn.microsoft.com/en-us/azure/azure-maps/map-accessibility
Optimize performance with Azure Maps Web SDK best practices	https://learn.microsoft.com/en-us/azure/azure-maps/web-sdk-best-practices

Decision Making

Topic	URL
Select and manage Azure Maps pricing tiers	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-manage-pricing-tier
Plan migration from Bing Maps Enterprise to Azure Maps	https://learn.microsoft.com/en-us/azure/azure-maps/migrate-bing-maps-overview
Migrate Bing Truck Route API to Azure Maps routing	https://learn.microsoft.com/en-us/azure/azure-maps/migrate-calculate-truck-route
Decide how to migrate from Google Maps to Azure Maps	https://learn.microsoft.com/en-us/azure/azure-maps/migrate-from-google-maps
Migrate Bing Get Imagery Metadata to Azure Maps tiles	https://learn.microsoft.com/en-us/azure/azure-maps/migrate-get-imagery-metadata
Choose Azure Maps and Azure services to replace Bing SDS	https://learn.microsoft.com/en-us/azure/azure-maps/migrate-sds-data-source-management
Decide and migrate from Azure Maps Search v1	https://learn.microsoft.com/en-us/azure/azure-maps/migrate-search-v1-api
Convert Power BI Map visuals to Azure Maps visual	https://learn.microsoft.com/en-us/azure/azure-maps/power-bi-visual-conversion
Interpret Azure Maps transaction billing and usage	https://learn.microsoft.com/en-us/azure/azure-maps/understanding-azure-maps-transactions

Architecture & Design Patterns

Topic	URL
Build elevation data services on Azure using open DEM data	https://learn.microsoft.com/en-us/azure/azure-maps/elevation-data-services
Architect a multi-itinerary optimization service with Azure Maps and NVIDIA cuOpt	https://learn.microsoft.com/en-us/azure/azure-maps/itinerary-optimization-service

Limits & Quotas

Topic	URL
Understand Azure Maps QPS rate limits by pricing tier	https://learn.microsoft.com/en-us/azure/azure-maps/azure-maps-qps-rate-limits
Check Azure Maps geocoding coverage by region	https://learn.microsoft.com/en-us/azure/azure-maps/geocoding-coverage
Understand Azure Maps render coverage and tile detail	https://learn.microsoft.com/en-us/azure/azure-maps/render-coverage
Evaluate Azure Maps routing coverage and capabilities	https://learn.microsoft.com/en-us/azure/azure-maps/routing-coverage
Review Azure Maps traffic data coverage worldwide	https://learn.microsoft.com/en-us/azure/azure-maps/traffic-coverage
Check Azure Maps weather service regional coverage	https://learn.microsoft.com/en-us/azure/azure-maps/weather-coverage

Security

Topic	URL
Configure Azure Maps authentication methods securely	https://learn.microsoft.com/en-us/azure/azure-maps/azure-maps-authentication
Configure authentication methods for Azure Maps accounts	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-manage-authentication
Secure Azure Maps daemon and background applications	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-secure-daemon-app
Secure input-constrained devices using Entra ID and Azure Maps	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-secure-device-code
Secure Azure Maps with SAS token authentication	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-secure-sas-app
Secure non-interactive SPAs for Azure Maps with Entra ID	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-secure-spa-app
Secure Azure Maps SPA with interactive user sign-in	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-secure-spa-users
Secure Azure Maps web apps with interactive sign-in	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-secure-webapp-users
Understand Azure Maps Power BI visual data residency behavior	https://learn.microsoft.com/en-us/azure/azure-maps/power-bi-visual-data-residency
Manage organizational access to Azure Maps Power BI visual	https://learn.microsoft.com/en-us/azure/azure-maps/power-bi-visual-manage-access
Secure Azure Maps access using Private Link endpoints	https://learn.microsoft.com/en-us/azure/azure-maps/private-endpoints

Configuration

Topic	URL
Configure map styles in Azure Maps Web Map Control	https://learn.microsoft.com/en-us/azure/azure-maps/choose-map-style
Configure vehicle consumption models in Azure Maps routing	https://learn.microsoft.com/en-us/azure/azure-maps/consumption-model
Create and manage data sources in Azure Maps Web SDK	https://learn.microsoft.com/en-us/azure/azure-maps/create-data-source-web-sdk
Use Azure Maps extended GeoJSON geometries	https://learn.microsoft.com/en-us/azure/azure-maps/extend-geojson
Provision Azure Maps accounts using ARM templates	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-create-template
Configure Azure Maps global data processing regions	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-manage-consent
Add and configure Bubble layers in Azure Maps	https://learn.microsoft.com/en-us/azure/azure-maps/map-add-bubble-layer
Configure controls on Azure Maps Web maps	https://learn.microsoft.com/en-us/azure/azure-maps/map-add-controls
Add HTML markers and events to Azure Maps	https://learn.microsoft.com/en-us/azure/azure-maps/map-add-custom-html
Add and configure Symbol layers in Azure Maps	https://learn.microsoft.com/en-us/azure/azure-maps/map-add-pin
Add and customize popups on Azure Maps	https://learn.microsoft.com/en-us/azure/azure-maps/map-add-popup
Migrate Azure Maps Route v1.0 APIs to 2025-01-01	https://learn.microsoft.com/en-us/azure/azure-maps/migrate-route-v1-api

Integrations & Coding Patterns

Topic	URL
Use PMTiles custom protocol with Azure Maps	https://learn.microsoft.com/en-us/azure/azure-maps/add-custom-protocol-pmtiles
Migrate Azure Maps Android SDK apps to Web SDK	https://learn.microsoft.com/en-us/azure/azure-maps/android-sdk-migration-guide
Integrate Azure Maps geofence events with Event Grid	https://learn.microsoft.com/en-us/azure/azure-maps/azure-maps-event-grid-integration
Cluster point data with Azure Maps Web SDK	https://learn.microsoft.com/en-us/azure/azure-maps/clustering-point-data-web-sdk
Use data-driven style expressions in Azure Maps	https://learn.microsoft.com/en-us/azure/azure-maps/data-driven-style-expressions-web-sdk
Use Azure Maps drawing tools events	https://learn.microsoft.com/en-us/azure/azure-maps/drawing-tools-events
Use drawing interactions and shortcuts in Azure Maps	https://learn.microsoft.com/en-us/azure/azure-maps/drawing-tools-interactions-keyboard-shortcuts
Integrate Azure Maps using the C# REST SDK	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-dev-guide-csharp-sdk
Integrate Azure Maps using the Java REST SDK	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-dev-guide-java-sdk
Integrate Azure Maps using the JavaScript REST SDK	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-dev-guide-js-sdk
Integrate Azure Maps using the Python REST SDK	https://learn.microsoft.com/en-us/azure/azure-maps/how-to-dev-guide-py-sdk