Google Maps Platform プラグインユーザーの迅速なオンボーディング

WordPress、Shopify、Magento といったプラットフォーム用の Google Maps Platform プラグインを開発している方向けに、プラグインのユーザーを Google Maps Platform に素早くオンボーディングし、API キーを生成する方法を解説します。

プラグインは、Google Maps Platform へのリクエストを行うたびに API キーを送信する必要があります。API キーはユーザーの Google アカウントおよびお支払い情報と紐付けられており、プラグインを通して地図作成機能にアクセスするために必要です。

プラグインのユーザーが API キーを迅速に生成できるよう、クイックスタートウィジェットを起動するリンクまたはボタンを用意しましょう。クイックスタートウィジェットは、案内に従って簡単な手順を完了できる便利なポップアップウィンドウです。クイックスタートウィジェットのもうひとつの特長は、手順を行うためにユーザーを Google Cloud コンソールに移動させてウィンドウを切り替えながら作業してもらう必要がなく、プラットフォーム内で作業が完結することです。

クイックスタートウィジェットを起動する

クイックスタートウィジェットは、仕組みとしては単なるウェブページであり、ウィンドウサイズは JavaScript の window.open 呼び出しで制御することができます。たとえば以下のようになります。

<script>
  function openPopupWindow() {
    var winWidth=570;
    var winHeight=700;
    var left = (screen.width-winWidth)/2;
    var top = (screen.height-winHeight)/2;

    window.open('https://console.cloud.google.com/google/maps-hosted', 'Quick Start Widget',
    'resizable=yes,width='+winWidth+',height='+winHeight+',left='+left+',top='+top);
      return false;
  }
</script>

<!-- CTA to generate Google Maps API Key -->
<button type="button" onClick="openPopupWindow()" style="color: white; background-color: #1a73e8" href="#">
    Get an API Key
</button>

実際の動作はこちらで確認できます。

ユーザーがこのボタンをクリックすると、クイックスタートウィジェットがポップアップウィンドウを開き、ウィジェット内でのユーザーの操作に応じて以下を行います。

Google アカウントおよびプロジェクトを作成します（未作成だった場合）。
Google Maps Platform の各 API を有効化します。
API キーを生成し、ユーザーにプラグイン設定へコピー＆ペーストしてもらいます。

プラグインのユーザーが Google アカウントおよびプロジェクトをすでに持っている場合、Google Cloud コンソールの [認証情報] ページが表示され、ユーザーはそこで既存の API キーを取得するか、新しいキーを作成することができます。

プラグインのユーザー向けの詳細情報としては、クイックスタートウィジェットについてを案内してください。

よくある質問

クイックスタートウィジェットを使用するのに料金はかかりますか？

いいえ。クイックスタートウィジェットは無料で、Google Maps Platform のオンボーディングを簡素化するためにどなたでもご利用いただけます。

クイックスタートウィジェットを使用できるのは WordPress と Shopify だけですか？

クイックスタートウィジェットは、ウェブサイト作成ツールや e コマースサイトに限らず、あらゆるサードパーティウェブサイトでご利用いただけます。

ユーザーが入力したお支払い情報をサードパーティプラットフォーム側が参照することはできますか？

Google での認証後、お支払い情報やその他の情報を参照できるのはユーザー本人のみです。サードパーティのプラットフォームやプラグインのデベロッパーが情報を参照することはできません。

既存のプロジェクトと API キーを使用することはできますか？

すでに Google Maps Platform のアカウントをお持ちの場合、クイックスタートウィジェットを起動すると Google Cloud コンソールが表示され、そこで既存の API キーを取得するか、新しいキーを作成することができます。

プラグインユーザーは API キーのセキュリティ面でどういった点に注意すべきですか？

API キーのセキュリティ確保については、API の保護に関するベストプラクティスをご覧ください。また、クイックスタートウィジェットを使用したユーザーには、API キーのセキュリティ確保のための案内と Google Cloud コンソールへのリンクが記載されたメールが届きます。

Google Maps Platform プラグイン ユーザーの迅速なオンボーディング

クイック スタート ウィジェットを起動する

よくある質問

クイック スタート ウィジェットを使用するのに料金はかかりますか？

クイック スタート ウィジェットを使用できるのは WordPress と Shopify だけですか？

ユーザーが入力したお支払い情報をサードパーティ プラットフォーム側が参照することはできますか？