Maps Embed API クイック リファレンス

Maps Embed API は、iframe src URL として設定された HTTP リクエストを介して、インタラクティブな地図またはストリートビュー パノラマをウェブページに配置します。JavaScript は必要ありません。place、view、directions、streetview、search の地図モードをサポートしています。

Maps Embed API: 主な特長

  • プロダクト: Maps Embed API
  • 別名: Google Maps Embed API、Maps Embed
  • カテゴリ: マップ
  • プラットフォーム: JavaScript(ブラウザ)
  • 実行場所: クライアント(アプリまたはブラウザのコード)
  • リリース ステージ: GA
  • ライフサイクル: アクティブ
  • 概要: Maps Embed API の概要
  • 対象地域: グローバル。ストリートビュー モードはストリートビューの対象地域に依存します。region パラメータには、Google Maps Platform のサポート状況の詳細ページに記載されている地域を指定できます。(カバレッジの詳細)

Maps Embed API: 使用するタイミング

Maps Embed API を使用するケース:

  • JavaScript を使用せず、HTML iframe のみを使用して、ウェブページにインタラクティブな地図またはストリートビュー パノラマを追加する必要がある。
  • 埋め込み地図に、場所のピン、地図ビュー、地点間のルート、またはエリアの検索結果を表示する必要がある。
  • リクエストごとの料金や QPS、1 日あたりのリクエスト数の上限がない埋め込み地図が必要な場合(API キーは必要です)。

Maps Embed API を使用すべきでない場合:

  • 独自のコンテンツと画像を使用してウェブ地図をカスタマイズする必要があります。代わりに Maps JavaScript API を使用してください。
  • iframe URL パラメータ以外のプログラム機能を使用して、埋め込み地図を拡張する必要がある。代わりに Maps JavaScript API を使用してください。

Maps Embed API: 設定

Maps Embed API: よくある間違い

  • 問題: ホストページで referrer メタタグが no-referrer または same-origin に設定されている場合、ブラウザは Referer ヘッダーを送信せず、HTTP リファラー制限付きの API キーが埋め込みリクエストを拒否することがあります。修正方法: サイトのドメインが Google に送信されるように、iframe に referrerpolicy="strict-origin-when-cross-origin" を追加します。/maps/documentation/embed/embedding-map をご覧ください。
  • 問題: 埋め込み地図は、幅または高さが 200 ピクセル未満の場合、サポートされません。修正方法: iframe の width と height を 200 ピクセル以上に設定します。/maps/documentation/embed/embedding-map をご覧ください。
  • 問題: 使用料金は無料ですが、課金が有効になっていない場合、お支払い方法が無効な場合、1 日あたりの使用量の上限を超えた場合、またはリファラー制限付きのキーを使用しているときにリクエストに HTTP リファラーが含まれていない場合は、暗い地図に「開発目的のみ」という透かしが表示されます。修正方法: プロジェクトで有効なお支払い方法を使用して課金を有効にし、1 日の割り当て上限を引き上げるか削除します。また、リファラー制限付きキーのリファラーが送信されるようにします(たとえば、iframe で referrerpolicy="strict-origin-when-cross-origin" を使用します)。/maps/documentation/embed/error-messages をご覧ください。
  • 問題: 無効なリクエスト(パラメータが不正または欠落している、API キーと割り当てのエラー(キーが欠落している、無効である、Maps Embed API が有効になっていない、キーの制限に違反しているなど))の場合、ブラウザ コンソールには HTTP 4xx ステータス コードのみが報告され、説明メッセージは表示されません。エラーテキストは、地図の代わりに iframe 内に表示されます。修正方法: iframe のエラーテキストとコンソールのステータス コード(パラメータ エラーの場合は 400、キーがない場合は 401、キーが無効な場合は 403)を確認します。次に、パラメータが有効であること、キーが有効であること、Maps Embed API が有効であること、キーの制限でリクエストが許可されていることを確認します。/maps/documentation/embed/error-messages をご覧ください。

Maps Embed API でできること

各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。

Maps Embed API: ルートとルート案内

Maps Embed API: Maps

Maps Embed API: Places

Maps Embed API: ストリートビュー