Map Management API は、Cloud ベースのマップのスタイル設定リソースをプログラムで管理するために使用できる RESTful API です。この API を使用すると、地図の視覚的な外観を定義し、地図の ID を管理し、カスタム スタイルとデータセットを特定の地図バリアントに関連付けることができます。これらはすべて、Cloud コンソールを使用せずに実行できます。
Map Management API は、地図構成の大規模な管理を行うデベロッパーや、地図のスタイル設定を独自の自動化ワークフローや内部ツールに統合するデベロッパー向けに設計されています。
主なリソース
- StyleConfig: 地図のスタイルの JSON 表現が含まれます。これにより、地図の対象物の色、可視性、密度が定義されます。
- MapConfig: 一意のマップ ID（マップ ID）を表します。スタイル設定や、POI のブースト、建物の平坦化などの機能の設定のコンテナとして機能します。
- MapContextConfig:
StyleConfig（必要に応じて 1 つ以上の データセット）を特定のMapVariants内のMapConfigに関連付けます。
API バージョニング チャネル
Map Management API は、チャネルベースのバージョン管理を使用して、試験運用版の機能から安定した一般提供版への明確なパスを提供します。
- v2alpha（試験運用版）: 最新の試験運用版の機能が含まれています。 このチャネルの機能は予告なく変更される可能性があり、本番環境での使用はおすすめしません。
- v2beta（プレビュー）: 安定しており、一般提供に向けて準備中の機能が含まれています。このチャネルは、本番環境前の環境での早期導入とテストに適しています。
- v2（一般提供）: 完全にサポートされている、プロダクション レディな機能が含まれています。
ほとんどの v2 機能は、ロールアウト フェーズ中に v2alpha エンドポイントと v2beta エンドポイントの両方で使用できます。新規ユーザーの場合は、v2beta エンドポイントから始めることをおすすめします。
認証
Map Management API で認証するには、OAuth 2.0 のみ を使用できます。API キーはサポートされていません。詳細については、Use OAuthをご覧ください。
制限事項
- デベロッ 1}パー ロール: Map Management API を使用するには、Google Cloud プロジェクト内の Google Maps Platform リソースを管理するために必要な IAM 権限が必要です。
- リソース スコープ: この API は、クラウドベースの地図の スタイル設定リソースの管理に重点を置いています。他の Google Maps Platform 構成では、Cloud コンソールが必要になる場合があります。
料金
Map Management API の使用に料金はかかりません。API 呼び出しは Cloud コンソールの [お支払い] ページに表示されますが、料金は $0 になります。ただし、リクエストには次の制約があります。
- 3 QPS（秒間クエリ数）
- プロジェクトごとに 180 QPM（1 分あたりのクエリ数）、1 分ごとに更新
- プロジェクトごとに 100,000 QPD（1 日あたりのクエリ数）、毎日更新
使用量と課金をご覧ください。