azure-maps について
azure-maps は、Azure Maps を使う開発者向けのガイダンススキルです。ローカル資料とリモート取得するドキュメントを組み合わせ、地図、セキュリティ、構成、統合、移行などを扱います。
主な機能
- 01地図開発のベストプラクティス
- 02サービス選択と移行のガイダンス
- 03アーキテクチャと設計パターン
- 04セキュリティとアクセス構成
- 05Web SDK と API のガイダンス
活用シーン
- 01Bing Maps または Google Maps からの移行計画
- 02Azure Maps アプリの保護
- 03地図レイヤー、マーカー、ポップアップの構成
- 04地域カバレッジとサービス制限の確認
MCP 対応
`mcp_microsoftdocs:microsoft_docs_fetch` ツールで Microsoft のドキュメントを取得できます。代替手段として `fetch_webpage` も記載されています。
インストール
コマンドをコピーしてターミナルで実行します。
npx skills add https:/ / github.com/ microsoftdocs/ agent-skills --skill azure-mapsインストール後、Claude Code で/azure-mapsを入力して読み込まれたか確認します。
詳細
Azure Maps スキル
このスキルでは、Azure Maps に関する専門的なガイダンスを提供します。ベストプラクティス、意思決定、アーキテクチャと設計パターン、制限とクォータ、セキュリティ、構成、統合とコーディングパターンを扱います。ローカルのクイックリファレンスコンテンツと、リモートドキュメントの取得機能を組み合わせています。
このスキルの使用方法
IMPORTANT for Agent:関連するセクションを見つけるには、以下のカテゴリインデックスを使用してください。行範囲があるカテゴリ(例:
L35-L120)では、指定された行をread_fileで読み取ってください。ファイルへのリンクがあるカテゴリ(例:[security.md](security.md))では、リンク先の参照ファイルをread_fileで読み取ってください。
IMPORTANT for Agent:
metadata.generated_atが3か月以上前の場合は、ユーザーにリポジトリから最新バージョンを取得するよう提案してください。mcp_microsoftdocsツールが利用できない場合は、インストールを提案してください:インストールガイド
このスキルでは、ドキュメントコンテンツを取得するためにネットワークアクセスが必要です。
- 推奨:クエリ文字列
from=learn-agent-skillを指定してmcp_microsoftdocs:microsoft_docs_fetchを使用します。Markdown を返します。 - フォールバック:クエリ文字列
from=learn-agent-skill&accept=text/markdownを指定してfetch_webpageを使用します。Markdown を返します。
カテゴリインデックス
| カテゴリ | 行 | 説明 |
|---|---|---|
| ベストプラクティス | L35-L44 | Azure Maps の Web アプリを構築する際の、安全な認証、必須の帰属表示、ルーティングと検索の調整、アクセシビリティ、パフォーマンス最適化に関するガイダンス。 |
| 意思決定 | L45-L59 | Azure Maps の料金、コスト計画、カバレッジ、および Bing/Google Maps、Bing SDS、Power BI マップから Azure Maps サービスへの移行や置き換え方法に関するガイダンス。 |
| アーキテクチャと設計パターン | L60-L65 | Azure Maps、オープン DEM データ、NVIDIA cuOpt を使用した、高度データサービスや複数行程ルート最適化のための Azure アーキテクチャ設計。スケーラブルな地理空間ソリューションを実現します。 |
| 制限とクォータ | L66-L73 | Azure Maps サービス(ジオコーディング、レンダリング、ルーティング、交通情報、天気)のカバレッジ制限、データの可用性、QPS レート上限。地域ごとのサポートとタイル解像度も含みます。 |
| セキュリティ | L74-L88 | Azure Maps のセキュリティ保護:認証方式(キー、Entra ID、SAS)、SPA/Web/デーモン/デバイスのシナリオ、Power BI ビジュアルのアクセスとデータ所在地、Private Link によるプライベートネットワークアクセス。 |
| 構成 | L89-L116 | Azure Maps Web SDK の動作の構成:マップスタイル、レイヤー、マーカー、ポップアップ、ズーム/タイル、ローカライズ、ルーティングモデル、空間形式、ブラウザーサポート、API バージョンの移行。 |
| 統合とコーディングパターン | L117-L174 | Web/REST SDK を介した Azure Maps の統合、Bing/Google からの移行、データのレンダリングとスタイリング(レイヤー、描画、クラスター化、ヒートマップ)、Power BI/Spatial IO の使用に関するパターンとコードサンプル。 |
ベストプラクティス
| トピック | URL |
|---|---|
| Azure Maps で安全な認証のベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/azure-maps/authentication-best-practices |
| Azure Maps の必須の著作権帰属表示を正しく表示する | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-show-attribution |
| Azure Maps Route サービスでルーティングのベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-use-best-practices-for-routing |
| Azure Maps Search のベストプラクティスを適用する | https://learn.microsoft.com/en-us/azure/azure-maps/how-to-use-best-practices-for-search |
| Azure Maps アプリにアクセシビリティ機能を実装する | https://learn.microsoft.com/en-us/azure/azure-maps/map-accessibility |
| Azure Maps Web SDK のベストプラクティスでパフォーマンスを最適化する | https://learn.microsoft.com/en-us/azure/azure-maps/web-sdk-best-practices |
意思決定
アーキテクチャと設計パターン
| トピック | URL |
|---|---|
| オープン DEM データを使用して Azure 上に標高データサービスを構築する | https://learn.microsoft.com/en-us/azure/azure-maps/elevation-data-services |
| Azure Maps と NVIDIA cuOpt を使用して複数の旅程を最適化するサービスを設計する | https://learn.microsoft.com/en-us/azure/azure-maps/itinerary-optimization-service |
制限とクォータ
| トピック | URL |
|---|---|
| Azure Maps のサービスごとの QPS レート制限を適用する | https://learn.microsoft.com/en-us/azure/azure-maps/azure-maps-qps-rate-limits |
| 地域別の Azure Maps ジオコーディングのカバー範囲を確認する | https://learn.microsoft.com/en-us/azure/azure-maps/geocoding-coverage |
| Azure Maps のレンダリングのカバー範囲とタイル解像度を理解する | https://learn.microsoft.com/en-us/azure/azure-maps/render-coverage |
| Azure Maps の気象サービスの地域別カバー範囲を確認する | https://learn.microsoft.com/en-us/azure/azure-maps/weather-coverage |