Skip to main content
skill CX Codex

azure-maps — Claude Code skill: what it does, how to install

A skill for Claude Code, Codex, Cursor, GitHub Copilot, and Gemini CLI that brings Azure Maps expertise into the agent context. Covers geocoding, routing, traffic, weather tiles, security patterns, and Web/REST SDK integration.

CC-BY-4.0 178 installs ★ 818 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add MicrosoftDocs/Agent-Skills --skill azure-maps -a claude-code
Open on GitHub

What azure-maps does

The skill gives the agent a structured index of Azure Maps topics — best practices, QPS rate limits, authentication scenarios (shared key, Microsoft Entra ID, SAS), Web SDK configuration, and migration guides from Bing Maps and Google Maps.

Documentation is fetched live from Microsoft Learn using mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage with the from=learn-agent-skill query string. Network access is required; without it the agent falls back to the local quick-reference content only.

Covered areas include routing for trucks, Power BI Visual integration, layer rendering, clustering, heatmaps, and elevation data architecture with open DEM sources. The skill is scoped to Azure Maps — for Azure AI Search, Azure IoT, or Azure IoT Edge, separate skills in the same repository apply.

What it helps with

  • configure Azure Maps authentication with Microsoft Entra ID
  • migrate routing logic from Google Maps to Azure Maps Route API
  • render clustered points and heatmaps with the Azure Maps Web SDK
  • look up QPS rate limits for geocoding and weather services
  • convert a Power BI Map visual to Azure Maps Visual

Example prompts for the agent

  • Set up Azure Maps Entra ID auth for a single-page application
  • Rewrite the truck routing logic using Azure Maps Route API
  • Show me how to add a heatmap layer with the Azure Maps Web SDK

How to install azure-maps

1Skills CLI (Vercel)

npx skills add MicrosoftDocs/Agent-Skills --skill azure-maps -a claude-code

2Manually: put the files in place

~/.claude/skills/azure-maps/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/azure-maps/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about azure-maps

How do I install the azure-maps skill in Claude Code?

Run npx skills add MicrosoftDocs/Agent-Skills --skill azure-maps -a claude-code. The skill file will be placed at ~/.claude/skills/azure-maps/SKILL.md.

What does the azure-maps skill do?

It loads Azure Maps knowledge into the agent: architecture patterns, service limits, security configurations, SDK code samples, and step-by-step migration paths from Bing and Google Maps.

Does the skill work without internet access?

Partly. It fetches documentation from Microsoft Learn at runtime via mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage, so full coverage requires network access.

Source text

SKILL.md · CC-BY-4.0
---
name: azure-maps
description: 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).
compatibility: Requires network access. Uses mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage to retrieve documentation.
metadata:
  generated_at: "2026-10-25"
  generator: "docs2skills/1.0.0"
---
# 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`), 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](https://github.com/MicrosoftDocs/mcp/blob/main/README.md)

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 |
|----------|-------|-------------|
| 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
| Topic | URL |
|-------|-----|
| Choose and manage Azure Maps Gen2 pricing | 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 |
| Migrate Azure Maps Render v1.0 to 2024-04-01 | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-render-v1-api |
| Choose Azure Maps and Azure services to replace Bing SDS | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-sds-data-source-management |
| Convert Power BI Map visuals to Azure Maps visual | https://learn.microsoft.com/en-us/azure/azure-maps/power-bi-visual-conversion |
| Evaluate Azure Maps routing coverage by region | https://learn.microsoft.com/en-us/azure/azure-maps/routing-coverage |
| Check Azure Maps traffic data coverage by region | https://learn.microsoft.com/en-us/azure/azure-maps/traffic-coverage |
| Plan Azure Maps costs using transaction rules | 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 |
|-------|-----|
| 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
| Topic | URL |
|-------|-----|
| Configure Azure Maps authentication and access control | 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 apps using SAS tokens | 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 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 |
| Configure Azure Maps global data processing regions | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-manage-consent |
| Configure and use Azure Maps web map control | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-use-map-control |
| Use Azure Maps map control via npm in Node.js | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-use-npm-package |
| 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 |
| Migrate Azure Maps Search v1 integrations to 2026-01-01 | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-search-v1-api |
| Migrate Azure Maps Traffic v1 service to newer APIs | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-traffic-v1-api |
| Configure Azure Maps drawing tools options | https://learn.microsoft.com/en-us/azure/azure-maps/set-drawing-options |
| Supported spatial formats in Azure Maps Spatial IO | https://learn.microsoft.com/en-us/azure/azure-maps/spatial-io-read-write-spatial-data |
| Delimited and XML spatial data parsing rules in Spatial IO | https://learn.microsoft.com/en-us/azure/azure-maps/spatial-io-supported-data-format-details |
| Check browser support for Azure Maps Web SDK | https://learn.microsoft.com/en-us/azure/azure-maps/supported-browsers |
| Configure Azure Maps localization languages and views | https://learn.microsoft.com/en-us/azure/azure-maps/supported-languages |
| Select and use built-in Azure Maps map styles | https://learn.microsoft.com/en-us/azure/azure-maps/supported-map-styles |
| Use Azure Maps supported search category codes | https://learn.microsoft.com/en-us/azure/azure-maps/supported-search-categories |
| Upgrade Azure Maps Web SDK Map Control to v3 | https://learn.microsoft.com/en-us/azure/azure-maps/web-sdk-migration-guide |
| Configure Azure Maps zoom levels and tile coordinates | https://learn.microsoft.com/en-us/azure/azure-maps/zoom-levels-and-tile-grid |

### 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 |
| Build Azure Maps apps using the C# REST SDK | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-dev-guide-csharp-sdk |
| Build Azure Maps apps 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 |
| Build Azure Maps apps using the Python REST SDK | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-dev-guide-py-sdk |
| Render custom data on Azure Maps static images | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-render-custom-data |
| Request real-time and forecast weather with Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-request-weather-data |
| Use Azure Maps Search APIs for geocoding and POI lookup | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-search-for-address |
| Use image templates and fill patterns in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-use-image-templates-web-sdk |
| Integrate spatial data using Azure Maps Spatial IO | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-use-spatial-io-module |
| Use Azure Maps TypeScript REST SDK modules | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-use-ts-rest-sdk |
| Migrate Azure Maps iOS SDK apps to Web SDK | https://learn.microsoft.com/en-us/azure/azure-maps/ios-sdk-migration-guide |
| Add and customize drawing toolbar in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/map-add-drawing-toolbar |
| Create and customize heat map layers in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/map-add-heat-map-layer |
| Overlay image layers on Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/map-add-image-layer |
| Render line layers with Azure Maps Web SDK | https://learn.microsoft.com/en-us/azure/azure-maps/map-add-line-layer |
| Render polygon and circle layers in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/map-add-shape |
| Add and configure snap grid in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/map-add-snap-grid |
| Add tile layers and overlays in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/map-add-tile-layer |
| Create and animate maps with Azure Maps Web SDK | https://learn.microsoft.com/en-us/azure/azure-maps/map-create |
| Handle Azure Maps Web SDK map events | https://learn.microsoft.com/en-us/azure/azure-maps/map-events |
| Use polygon extrusion layers in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/map-extruded-polygon |
| Perform reverse geocoding in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/map-get-information-from-coordinate |
| Extract GeoJSON from drawn shapes in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/map-get-shape-data |
| Request and display routes with Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/map-route |
| Search locations and show results in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/map-search-location |
| Display traffic flow and incidents in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/map-show-traffic |
| Translate Bing route calculation to Azure Maps routing | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-calculate-route |
| Convert Bing address geocoding to Azure Maps Geocoding | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-find-location-address |
| Migrate Bing reverse geocoding to Azure Maps API | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-find-location-by-point |
| Migrate Bing query-based geocoding to Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-find-location-query |
| Migrate Bing time zone lookups to Azure Maps timezone API | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-find-time-zone |
| Migrate Bing Maps web apps to Azure Maps Web SDK | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-from-bing-maps-web-app |
| Migrate Google Maps web apps to Azure Maps Web SDK | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-from-google-maps-web-app |
| Map Google Maps web services to Azure Maps REST APIs | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-from-google-maps-web-services |
| Migrate Bing Geocode Dataflow to Azure batch geocoding | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-geocode-dataflow |
| Replace Bing Geodata API with Azure Maps Get Polygon | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-geodata |
| Migrate Bing Static Map calls to Azure Static Image | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-get-static-map |
| Migrate Bing traffic incidents to Azure Maps incident details | https://learn.microsoft.com/en-us/azure/azure-maps/migrate-get-traffic-incidents |
| Add and configure marker layers in Azure Maps visual | https://learn.microsoft.com/en-us/azure/azure-maps/power-bi-visual-add-marker-layer |
| Add pie chart layers in Azure Maps Power BI visual | https://learn.microsoft.com/en-us/azure/azure-maps/power-bi-visual-add-pie-chart-layer |
| Use cluster bubble layers in Azure Maps visual | https://learn.microsoft.com/en-us/azure/azure-maps/power-bi-visual-cluster-bubbles |
| Get started with Azure Maps visual in Power BI | https://learn.microsoft.com/en-us/azure/azure-maps/power-bi-visual-get-started |
| Configure layers in Azure Maps Power BI visual | https://learn.microsoft.com/en-us/azure/azure-maps/power-bi-visual-understanding-layers |
| Overlay OGC WMS/WMTS layers in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/spatial-io-add-ogc-map-layer |
| Render data with Spatial IO SimpleDataLayer | https://learn.microsoft.com/en-us/azure/azure-maps/spatial-io-add-simple-data-layer |
| Connect Azure Maps Spatial IO to WFS services | https://learn.microsoft.com/en-us/azure/azure-maps/spatial-io-connect-wfs-service |
| Use core CSV/XML IO operations in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/spatial-io-core-operations |
| Implement custom WebGL layers in Azure Maps | https://learn.microsoft.com/en-us/azure/azure-maps/webgl-custom-layer |

© MicrosoftDocs · CC-BY-4.0 · MicrosoftDocs/Agent-Skills

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set144

The whole set →
azure-bot-service azure-bot-service — a skill for Azure AI Bot Service development. Provides expert guidance on channel setup, Direct Line 3.0, security, deployment, and debugging issues in the Bot Framework. CX Codex +1 180installs azure-content-safety azure-content-safety — a skill for Azure AI Content Safety development: text and image moderation, blocklist setup, groundedness checks, and prompt injection defense. CX Codex +1 180installs azure-firewall-manager Guides Azure Firewall Manager configuration, security policies, and architectural choices. Useful when setting up secured virtual hubs, DDoS plans, or WAF. CX Codex +1 180installs azure-traffic-manager Expert skill for Azure Traffic Manager: traffic routing, profile architecture, IaC with ARM/Bicep/Terraform. Covers endpoint configuration, routing methods, and troubleshooting degraded profiles. CX Codex +1 178installs azure-aks-edge-essentials azure-aks-edge-essentials — a skill for Claude Code helps troubleshoot and configure AKS Edge Essentials and AKS Arc clusters on Windows Server. Resolves cluster recovery issues, network routing, and Arc onboarding. CX Codex +1 177installs azure-database-migration This skill guides Azure Database Migration Service planning and troubleshooting. Use it to compare migration scenarios, check constraints, or investigate connection failures. CX Codex +1 177installs azure-virtual-network-manager Get guidance on Azure Virtual Network Manager configuration, security, and troubleshooting. Use it for network groups, IPAM pools, UDRs, and security admin rules. CX Codex +1 176installs azure-blueprints Skill for Azure Blueprints work: migrate after service retirement, debug deployment errors, automate via CLI and PowerShell. CX Codex +1 176installs

More in the catalog

Project sponsors

Companies that keep this analytics open