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