Map Management API は、Cloud ベースのマップのスタイル設定リソースをプログラムで管理するために使用できる RESTful API です。この API を使用すると、Cloud コンソールを使用せずに、地図の外観を定義し、地図の ID を管理し、カスタム スタイルとデータセットを特定の地図バリアントに関連付けることができます。
Map Management API は、地図の構成の大規模な管理を行ったり、地図のスタイル設定を独自の自動化ワークフローや内部ツールに統合したりしたいデベロッパー向けに設計されています。
主なリソース
- StyleConfig: 地図のスタイルの JSON 表現が含まれます。地図対象物の色、可視性、密度を定義します。
- MapConfig: 一意のマップ ID を表します。スタイル設定や、スポットのブースト、建物のフラット化などの機能のコンテナとして機能します。
- MapContextConfig:
StyleConfig（必要に応じて 1 つ以上のデータセット）をMapConfig内の特定のMapVariantsに関連付けます。
API バージョニング チャネル
Map Management API は、チャネルベースのバージョニングを使用して、試験運用版の機能から安定版の一般提供への明確なパスを提供します。
- v2alpha（試験運用版）: 最新の試験運用版機能が含まれています。このチャンネルの機能は予告なく変更される可能性があり、本番環境での使用は推奨されません。
- v2beta（プレビュー）: 安定しており、一般提供に向けて準備中の機能が含まれています。このチャンネルは、本番前環境での早期導入とテストに適しています。
- v2（一般提供）: 完全にサポートされ、プロダクション レディな機能が含まれています。
ほとんどの v2 機能は、それぞれのロールアウト フェーズで v2alpha エンドポイントと v2beta エンドポイントの両方で使用できます。新規ユーザーには、v2beta エンドポイントから始めることをおすすめします。
認証
OAuth 2.0 は、API キーをサポートしていない Map Management API での認証にのみ使用できます。詳細については、OAuth を使用するをご覧ください。
制限事項
- デベロッパー ロール: 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 分ごとに更新されます。
- プロジェクトの QPD（1 日あたりのクエリ数）の上限は 100,000 件で、毎日更新されます。
使用量と請求額をご覧ください。