azure-maps
Expert knowledge for Azure Maps development including best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, and integrations & coding patterns. Use when using Azure Maps Web/REST SDKs, geocoding, routing, traffic, weather tiles, or Power BI visual integrations, and other Azure Maps related development tasks. Not for Azure AI Search (use azure-cognitive-search), Azure IoT (use azure-iot), Azure IoT Central (use azure-iot-central), Azure IoT Edge (use azure-iot-edge).
How do I install this agent skill?
npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-mapsIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill serves as a comprehensive documentation index for Azure Maps. It provides the agent with structured links to official Microsoft documentation and defines tools for fetching this content from trusted sources. No security risks were identified.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Azure Maps Skill
This skill provides expert guidance for Azure Maps. Covers 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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools 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_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Best Practices | L35-L44 | Guidance on secure auth, required attribution, routing and search tuning, accessibility, and performance optimization when building Azure Maps web apps. |
| Decision Making | L45-L59 | Guidance on Azure Maps pricing, cost planning, coverage, and how to migrate or replace Bing/Google Maps, Bing SDS, and Power BI maps with Azure Maps services. |
| Architecture & Design Patterns | L60-L65 | 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 | L66-L73 | Coverage limits, data availability, and QPS rate caps for Azure Maps services (geocoding, rendering, routing, traffic, weather), including regional support and tile resolution. |
| Security | L74-L88 | Securing Azure Maps: auth methods (keys, Entra ID, SAS), SPA/web/daemon/device scenarios, Power BI visual access/residency, and private network access via Private Link. |
| Configuration | L89-L116 | Configuring Azure Maps Web SDK behavior: map styles, layers, markers, popups, zoom/tiles, localization, routing models, spatial formats, browser support, and API version migrations. |
| Integrations & Coding Patterns | L117-L174 | Patterns and code samples for integrating Azure Maps via Web/REST SDKs, migrating from Bing/Google, rendering and styling data (layers, drawing, clustering, heatmaps), and using Power BI/Spatial IO. |
Best Practices
| Topic | URL |
|---|---|
| Apply secure authentication best practices in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/authentication-best-practices |
| Show required Azure Maps copyright attribution correctly | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-show-attribution |
| Apply routing best practices with 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
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 |
|---|---|
| Apply Azure Maps QPS rate limits per service | 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 resolution | https://learn.microsoft.com/en-us/azure/azure-maps/render-coverage |
| Check Azure Maps weather service regional coverage | https://learn.microsoft.com/en-us/azure/azure-maps/weather-coverage |
Security
Configuration
Integrations & Coding Patterns
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/microsoftdocs/agent-skills/azure-maps">View azure-maps on skillZs</a>