FreePublished on GitHub

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).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills

Works withAzure

See how to install

Files included (1)

SKILL.md18.4 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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

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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

More skills from this repository

azure-active-directory-b2c

Free

Expert knowledge for Azure Active Directory B2C development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building B2C user flows/custom policies, configuring IdPs/MFA, securing APIs, automating CI/CD, or monitoring with Sentinel, and other Azure Active Directory B2C related development tasks. Not for Azure Role-based access control (use azure-rbac), Azure Information Protection (use azure-information-protection), Azure Security (use azure-security), Azure Sentinel (use azure-sentinel).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-advisor

Free

Expert knowledge for Azure Advisor development including best practices, decision making, limits & quotas, security, configuration, and integrations & coding patterns. Use when managing Advisor alerts, digests, recommendation states, Resource Graph queries, or RBAC access, and other Azure Advisor related development tasks. Not for Cost Management (use azure-cost-management), Azure Monitor (use azure-monitor), Azure Policy (use azure-policy), Azure Security (use azure-security).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-ai-vision

Free

Expert knowledge for Azure AI Vision development including decision making, limits & quotas, configuration, integrations & coding patterns, and deployment. Use when using Image Analysis, Read OCR containers, smart-crop thumbnails, background removal, or video frame analysis, and other Azure AI Vision related development tasks. Not for Azure AI Custom Vision (use azure-custom-vision), Azure AI Video Indexer (use azure-video-indexer), Azure AI Document Intelligence (use azure-document-intelligence), Azure AI Immersive Reader (use azure-immersive-reader).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-aks-edge-essentials

Free

Expert knowledge for Azure Kubernetes Service Edge Essentials development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when deploying AKS Edge/Hybrid with Arc, Azure Local, GitOps, IoT/OPC/ONVIF, or Key Vault-integrated workloads, and other Azure Kubernetes Service Edge Essentials related development tasks. Not for Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure IoT Edge (use azure-iot-edge), Azure Stack Edge (use azure-stack-edge), Azure Container Apps (use azure-container-apps).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-analysis-services

Free

Expert knowledge for Azure Analysis Services development including troubleshooting. Use when resolving server connectivity, firewall/VNet, DNS, client connection, or network error issues, and other Azure Analysis Services related development tasks. Not for Azure Synapse Analytics (use azure-synapse-analytics), Azure SQL Database (use azure-sql-database), Azure SQL Managed Instance (use azure-sql-managed-instance), SQL Server on Azure Virtual Machines (use azure-sql-virtual-machines).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

azure-anyscale-on-azure

Free

Expert knowledge for Azure Anyscale On Azure development including limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when registering AKS as Anyscale clouds, wiring ACR images, enabling Private Link/RBAC, ARM-based deployments, or region checks, and other Azure Anyscale On Azure related development tasks. Not for Azure Databricks (use azure-databricks), Azure Kubernetes Service (AKS) (use azure-kubernetes-service), Azure Machine Learning (use azure-machine-learning), Azure HDInsight (use azure-hdinsight).

The English summary is being prepared. Showing the original description.

MicrosoftDocs/Agent-Skills786Updated Oct 19, 2026

See all skills by MicrosoftDocs

Report a problem with this skill

Install

Install with a command

npx skills add https://github.com/MicrosoftDocs/Agent-Skills --skill azure-maps

Paste it into your terminal and run it (requires Node.js). You can choose which agents to install it for, such as Claude Code or Codex.

Ask your agent

Please install the following Agent Skill.
https://github.com/MicrosoftDocs/Agent-Skills/tree/main/skills/azure-maps

First review SKILL.md and the bundled files and confirm there is nothing suspicious (such as sending data externally or reading credentials). Then place it in ~/.claude/skills/azure-maps/ for Claude Code, or ~/.agents/skills/azure-maps/ for Codex.

Send this text to Claude Code or Codex as is. It checks the contents before installing.

View source on GitHub

Repository: MicrosoftDocs/Agent-Skills
Stars: 786
Forks: 128
Category: DevOps
License: CC-BY-4.0
Original language: English
Last updated: Oct 19, 2026

A skill is a set of instructions and scripts for an agent. cccskills does not guarantee that skills are safe. Review the contents before you install.