Maps JavaScript API の URL パラメータ

このドキュメントでは、Maps JavaScript API を読み込む際にスクリプト読み込み URL のクエリ文字列で指定できるすべてのパラメータについて説明します。パラメータには、必須パラメータと省略可能なパラメータがあります。URL の標準規則と同様に、すべてのパラメータはアンパサンド（&）文字を使用して区切ります。

次のサンプル URL には、使用できるすべてのパラメータのプレースホルダが含まれています。

https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY
&callback=FUNCTION_NAME
&v=VERSION
&libraries="LIBRARIES"
&language="LANGUAGE"
&region="REGION"
&solution_channel="SOLUTION_IDENTIFIER"
&auth_referrer_policy="AUTH_REFERRER_POLICY"

次のサンプル script タグの URL は、Maps JavaScript API を読み込みます。

<script async
    src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
</script>

必須パラメータ

Maps JavaScript API を読み込む際、以下のパラメータが必要です。

  • key: 有効な API キー。有効な API キーが指定されない限り、Maps JavaScript API は読み込まれません。

  • callback: Maps JavaScript API が完全に読み込まれた後に呼び出されるグローバル関数の名前。

省略可能なパラメータ

これらのパラメータを使用すると、Maps JavaScript API の特定のバージョンのリクエスト、追加ライブラリの読み込み、地図のローカライズ、HTTP リファラー チェック ポリシーの指定を行えます。

  • v: 使用する Maps JavaScript API のバージョン。

  • libraries: 追加で読み込む Maps JavaScript API ライブラリのリスト（カンマ区切り）。

  • language: 使用する言語。このパラメータは、コントロールの名前、著作権に関する通知、運転ルート、コントロール ラベル、サービス リクエストに対するレスポンスに影響します。サポートされている言語の一覧をご覧ください。

  • region: 使用するリージョン コード。指定した国または地域に応じてマップの動作が変わります。

  • solution_channel: Google Maps Platform には、すぐに実行できる、さまざまな種類のサンプルコードが用意されています。 より複雑なコードサンプルの導入を追跡し、ソリューションの質を向上させるために、Google はサンプルコードの API 呼び出しに solution_channel クエリ パラメータを含めています。

  • auth_referrer_policy: Maps JS をご利用の場合、Cloud Console で HTTP リファラー制限を設定し、特定の API キーの使用を許可する URL を制限できます。デフォルトでは、特定のパスのみに API キーの使用を許可するように、これらの制限が構成されています。同じドメインの URL または元の URL で API キーを使用できる場合は、auth_referrer_policy=origin を設定して、Maps JavaScript API からのリクエストを承認する際に送信されるデータの量を制限できます。これはバージョン 3.46 以降で可能です。このパラメータが指定されていて、Cloud Console で HTTP リファラー制限が有効になっているなら、Maps JavaScript API は、現在のウェブサイトのドメインに一致する HTTP リファラー制限がある場合にのみ読み込むことができます。その際はパスを指定する必要ありません。