このドキュメントでは、Places API(新版)を使って開発されるすべてのアプリケーション (その API の一部である Autocomplete(新版) サービスを含む)に固有の要件について説明します。Google マップ デベロッパー向けの一般的な情報については、 Google Maps Platform の利用規約をご覧ください。
ポリシー
このセクションでは、Places API に関連するポリシーについて説明します。ポリシーは、サービスを正しく使用し、Google Maps Platform の期待に沿って使用するための実践的な 実装ガイドラインと要件を提供します。
キャッシュ保存の制限の例外
ただし、プレイスを一意に識別するために使用されるプレイス ID は、キャッシング制限の適用対象外 のため、プレイス ID の値を無期限で保存できます。プレイス ID は、place_id フィールドで
API レスポンスで返されます。プレイス ID を保存、更新、管理する方法については、プレイス ID のガイドをご覧ください。
欧州経済領域の国と地域
請求先住所が 欧州経済領域(EEA)にあるお客様の場合、このプロダクトの利用規約が異なり、機能も異なる場合があります。 Google Maps Platform を使用して構築する前に、EEA 固有の次の 規約と情報をご確認ください。
- Google Maps Platform EEA の利用規約
- Google Maps Platform EEA サービス固有の規約
- EEA に関するよくある質問(FAQ)
- Google Maps Platform の道路安全要件
請求先住所が EEA にない場合は、次の利用規約が適用されます。
Google マップの帰属表示の要件
このセクションでは、アプリケーションを通じて Google マップとコンテンツを表示するための帰属表示の要件とガイドラインについて説明します。
Google マップの帰属表示を表示する
アプリやウェブサイトで Google Maps Platform API のコンテンツを表示する場合は、Google マップの帰属表示の要件に準拠する必要があります。帰属表示がすでに表示されている Google マップにコンテンツを表示する場合は、追加の帰属表示は必要ありません。
Google マップの帰属表示を含める
Google Maps Platform によってユーザー インターフェース(Places UI キットなど)にすでに提供されている Google マップの帰属表示の場合:
- 表示場所に関係なく、含まれている帰属表示を削除しないでください。帰属表示を変更したり、隠したり、 不明瞭にしたりしないでください。背景に対してはっきりと見えるようにしてください。
- 境界線、背景色、シャドウ、十分な空白などの UI キューを使用して、Google Maps Platform のコンテンツを他のコンテンツと視覚的に区別してください。
- 視覚的な変更を行う場合は、Google マップの帰属表示の要件をすべて遵守する必要があります。
Google マップのロゴとテキストの帰属表示
可能な限り、帰属表示には Google マップのロゴを使用してください。スペースが限られている場合は、「Google マップ 」というテキストを使用できます。 エンドユーザーは、どのコンテンツが Google マップによって提供されているかを常に明確に把握できるようにする必要があります。
ロゴの帰属表示
アプリやウェブサイトで Google マップのロゴを使用する場合は、次の要件に沿ってください。
Google マップのロゴをダウンロードする
Google マップの公式ロゴファイルを使用してください。以下のロゴをダウンロードし、このセクションのガイドラインに沿ってください。
Google マップの帰属表示アセットをダウンロードするGoogle マップのロゴを使用する場合は、次のガイドラインに沿ってください。
- ロゴを変更しないでください。
- 歪みを防ぐため、ロゴのアスペクト比を維持してください。
- マップや画像など、背景が複雑な場合は、アウトライン表示のロゴを使用してください。
- 単色や微妙なグラデーションなど、背景がシンプルな場合は、アウトライン表示でないロゴを使用してください。
ロゴのサイズ仕様
Google マップのロゴのサイズ仕様は次のとおりです。- ロゴの最小高さ: 16 dp
- ロゴの最大高さ: 19 dp
- ロゴの最小クリアスペース: 左、右、上は 10 dp、下は 5 dp
dp について詳しくは、マテリアル デザインのウェブサイトのピクセル密度をご覧ください。
ロゴのユーザー補助機能
Google マップのロゴのユーザー補助機能に関する要件は次のとおりです。- ロゴと背景のコントラストをアクセシビリティの高い状態に保ってください。
- 「Google マップ 」というテキストを含むユーザー補助ラベルを含めてください。
テキストの帰属表示
インターフェースのサイズが Google マップのロゴの使用に対応していない場合は、「Google マップ 」というテキストを使用できます。次のガイドラインに沿ってください。
- 「Google マップ 」というテキストは一切変更しないでください。
- Google マップ の文字の大小は変更しないでください。
- Google マップ を複数行に折り返さないでください。
- Google マップ を他の言語にローカライズしないでください。
- HTML 属性
translate="no"を使用して、ブラウザが Google マップ を翻訳しないようにします。
次の表の説明に従って、Google マップのテキストのスタイルを設定します。
Google マップのテキストのスタイル設定の要件 プロパティ スタイル フォント ファミリー Roboto。フォントの読み込みは任意です。 代替フォント ファミリー プロダクトですでに使用されている Sans Serif の本文フォント、またはデフォルトのシステム フォントを呼び出すための Sans-Serif フォント スタイル 標準 フォントの太さ 400 フォントの色 白、黒(#1F1F1F)、グレー(#5E5E5E)。背景に対してアクセシビリティの高い(4.5:1)コントラストを維持します。 フォントサイズ 最小フォントサイズ: 12sp
最大フォントサイズ: 16sp
sp について詳しくは、マテリアル デザインのウェブサイトでフォントサイズの単位をご覧ください。文字間隔 標準
CSS の例
次の CSS は、白または明るい背景に適切なタイポグラフィ スタイルと色で Google マップをレンダリングします。
@import url('https://fonts.googleapis.com/css2?family=Roboto&display=swap'); .GMP-attribution { font-family: Roboto, Sans-Serif; font-style: normal; font-weight: 400; font-size: 1rem; letter-spacing: normal; white-space: nowrap; color: #5e5e5e; }
ビジュアルの要件
Google マップの帰属表示のビジュアル処理については、次の要件に沿ってください。帰属表示は、コンテンツの上部または下部の近くに、同じビジュアル コンテナ内に配置します。コンテンツが 1 行の場合は、右または左に配置できます。
境界線、背景色、シャドウ、十分な空白などの UI キューを使用して、Google Maps Platform のコンテンツを他のコンテンツと視覚的に区別してください。
- Google Maps Platform 以外のコンテンツを帰属表示として使用して、Google マップを誤って表現しないでください。
- 帰属表示が常に表示され、読みやすいことを確認してください。削除、非表示、不明瞭化、変更は行わないでください。
次の図に、これらのビジュアル要件の例を示します。
第三者データ プロバイダ
Google のマッピング サービスのデータと画像の中には、Google 以外のプロバイダから提供されているものがあります。 Map Tiles API などの一部のプロダクトでは、第三者データ プロバイダに必要な帰属表示 を提供することがあります。その場合、帰属情報の文言には 「Google マップ」の名称と関連する データ プロバイダ名(「地図データ: Google, Maxar Technologies」など)を記載する必要があります。Google が第三者の帰属表示を提供する場合、「Google マップ」または Google ロゴのみを表示しただけでは帰属表示として適切ではありません。
その他の帰属表示要件
次の帰属表示の要件は、Places API に固有のものです。
エンドユーザーの住所の予測入力
エンドユーザーが顧客アプリケーション内で Autocomplete 機能を使用して番地を入力し、その番地が Autocomplete なしでエンドユーザーによって完全かつ正確に提供された場合、エンドユーザーが選択した住所には、Google Maps Platform 契約の Google マップのコンテンツの制限は適用されません。この例外は、エンドユーザーが選択した番地と、そのエンドユーザーの特定の取引にのみ適用されます。Autocomplete 機能によって提供される住所の候補リストや、その他の Google マップのコンテンツには適用されません。この例外は、他の Google Maps Platform サービスによって提供される POI または住所検索機能には適用されません。
上の画像では、左側の住所リストには Google マップのコンテンツの制限が適用されます。エンドユーザーが選択した住所は、そのエンドユーザーの該当する取引の目的でのみ、Google マップのコンテンツの制限の対象外となります。
サードパーティの帰属表示
サードパーティの帰属表示を取得し、アプリに帰属表示を配置する手順は次のとおりです。
プレイスから帰属表示を取得する
アプリでプレイス ID を使用して Place Detailsを呼び出して取得した情報を表示する場合は、 取得したプレイスの詳細に関するサードパーティ帰属もアプリに表示する必要があります。
レスポンスの
Place
オブジェクトの帰属表示は、
Attribution
オブジェクトで表されます。レスポンスに Attribution を追加するには、
places.attributions(Nearby Search とテキスト検索)または attributions
(Place Details)をリクエストの
フィールド マスクに含めます。
Attribution オブジェクトのフィールドは、帰属の provider
と providerUri を含む文字列です。表示する帰属がない場合は
空の文字列となります。
写真の帰属を表示する
アプリに写真を表示する場合は、各写真の所有者の帰属を表示する必要があります。
レスポンスの
Place
オブジェクトの写真に関する詳細は、photos 配列に含まれています。レスポンスに photos
配列を追加するには、リクエストの
フィールド マスクに places.photos(Nearby Search とテキスト検索)または
photos(Place Details)を含めます。
photos 配列の各要素は
Photo のインスタンスであり、
AuthorAttribution 型の authorAttributions 配列が含まれています。
AuthorAttribution オブジェクトのフィールドは、帰属の displayName、uri、photoUri を含む文字列です。表示する帰属がない場合は空の文字列となります。
クチコミを表示する
レスポンスの Place
オブジェクトには、最大 5 つのクチコミを含めることができます。アプリでのクチコミ表示は省略可です。
Google ユーザーが投稿したクチコミを表示する場合は、投稿者の名前を近くに配置する必要があります。Review オブジェクトの投稿者帰属フィールドから取得できる場合は、投稿者の写真とプロフィールへのリンクも含めることをおすすめします。次の図は、公園のクチコミの例を示しています。
また、Google では、クチコミの並べ替え方法をエンドユーザーに表示することをおすすめしています。
レスポンスの
Place
オブジェクトの各クチコミは、
Review
オブジェクトで表されます。レスポンスに Review オブジェクトを追加するには、リクエストの
フィールド マスクに places.reviews
(Nearby Search とテキスト検索) または reviews (Place Details) を含めます。
Review オブジェクトのフィールドには帰属表示が含まれます。表示する帰属表示がない場合は空になります。
検索結果の属性
欧州において Google 独自のランキング システムを使用する場合は、検索サービスに説明テキストを表示して、検索結果のランキングを決める主な要素とそれらの重み付けが、直接または 1 クリックで表示されるようにする必要があります。説明テキスト:
見出し: 検索結果について
本文: Google マップで指定した場所の付近の店舗などを検索すると、ローカル検索の結果が表示されます。検索結果の精度を高めるため、ローカル検索の結果は複数の要素(主に関連性、距離、知名度)に基づいて生成されます。
ボタン 1: 詳細 __
[詳細] テキストは、ヘルプセンターの記事にリンクさせます。
ボタン 2: OK
AI を活用した要約
プレイス、地域、クチコミの要約など、AI を活用した要約をアプリに表示する場合は、次のことを行う必要があります。
- 以下で定義されている必要な帰属表示、報告リンク、参照リンクを表示します。
- エンドユーザーは、Google マップで提供されている要約テキストの全文を読めるようにする必要があります。
AI を活用した要約の開示テキストを表示する
AI を活用した要約を表示する場合は、必ず、ローカライズされた開示テキスト(レスポンス本文の disclosureText フィールドに記載)を要約の直下に含めてください。API によって提供される開示テキストを変更したり、追加したりしないでください。
プレイスと地域の要約に関する追加要件
プレイスと地域の 要約は、 アプリに表示される場合、次のテキストと必要なリンクを伴う必要があります。
| テキスト | 要件 |
|---|---|
| この要約について | 「Google がローカル リスティング情報を入手する方法と、それらの用途」へのリンク(https://support.google.com/local-listings/answer/9851099)を使用します。 |
| 要約を報告 |
レスポンスの 注: Places API(新版)を通じて提供される AI を活用した要約には、世界中どの地域でも Google のコンテンツとサービスのポリシーが適用されます。適用される法律に基づき、Google のサービスからの削除を希望するコンテンツを報告する場合は、提供されたフラグ コンテンツの URL( |
クチコミの要約に関する要件
アプリに表示される クチコミの要約には、「クチコミの 要約」というテキストを含む見出しを含める必要があります。また、次のテキストと必要なリンクを使用する必要があります。
| テキスト | 要件 |
|---|---|
| この要約について | 「Google がローカル リスティング情報を入手する方法と、それらの用途」へのリンク(https://support.google.com/local-listings/answer/9851099)を使用します。 |
| 要約を報告 |
レスポンスの 注: Places API(新版)を通じて提供される AI を活用した要約には、世界中どの地域でも Google のコンテンツとサービスのポリシーが適用されます。適用される法律に基づき、Google のサービスからの削除を希望するコンテンツを報告する場合は、提供されたフラグ コンテンツの URL( |
| クチコミを見る | レスポンスの reviewSummary.reviewsUri フィールドに含まれるリンクを使用します。 |
自動車ユースケースの表示に関するガイダンス
運転者の安全のため、自動車エクスペリエンスでは、AI を活用した要約を駐車モードでレンダリングすることをおすすめします。運転モードで要約をレンダリングする場合は、運転者の注意がすぐに道路に戻るように、画面上の情報をシンプルでわかりやすく簡潔にする必要があります。
- 3 行以内
- 120 文字または 24 語以内
- 最小フォントサイズ 24 dp
特に自動車のコンテキストでは、AI を活用した要約を安全で、すべての現地の法律や規制に準拠した方法でレンダリングする責任はデベロッパーにあります。