Places SDK for Android のポリシー

このトピックでは、Places SDK for Android で開発されるすべてのアプリ(その API の一部である Place Autocomplete サービスを含む)の帰属表示の要件について説明します。Google Maps Platform のその他の用語については、Google Maps Platform 利用規約をご覧ください。

利用規約とプライバシー ポリシーを明示する

Places SDK for Android アプリを開発する場合は、Google との契約に定められているガイドラインに準拠した利用規約プライバシー ポリシーをアプリとともに公開する必要があります。

  • 利用規約プライバシー ポリシーは一般公開されている必要があります。
  • アプリケーションの利用規約に、そのアプリケーションを使用するユーザーには Google の利用規約が適用されることを明記する必要があります。
  • プライバシー ポリシーで、Google Maps API を使用していることをユーザーに通知し、参照として Google プライバシー ポリシーを組み込む必要があります。

利用規約プライバシー ポリシーを開示する場所は、アプリケーションのプラットフォームによって異なります。

モバイルアプリ

モバイルアプリを開発する場合は、該当するアプリケーション ストアのダウンロード ページとアプリの設定メニューに、利用規約プライバシー ポリシーへのリンクを記載することをおすすめします。

ウェブ アプリケーション

ウェブ アプリケーションを開発する場合は、利用規約プライバシー ポリシーへのリンクをウェブサイトのフッターに記載することをおすすめします。

コンテンツのプリフェッチ、キャッシュ保存、保存

Places SDK for Android を使用するアプリケーションには、Google との契約条件が適用されます。本契約の条項に従い、規約に記載されている限定的条件を除き、コンテンツのプリフェッチ、インデックス登録、保存、キャッシュ保存は認められません。

なお、プレイスを一意に識別するために使用されるプレイス ID は、キャッシュ制限適用対象外です。プレイス ID は、Places SDK for Android のレスポンスの「place_id」フィールドで返されます。プレイス ID を保存、更新、管理する方法については、場所 ID のガイドをご覧ください。

Places SDK for Android の結果を表示する

Places SDK for Android の結果は、Google マップまたは地図なしで表示できます。Places SDK for Android の結果を地図に表示する場合は、結果を Google マップに表示する必要があります。Google マップ以外の地図で Places SDK for Android のデータを使用することは禁止されています。

アプリケーションで Google マップにデータを表示する場合は、Google ロゴが表示されますが、それは変更できません。Google データを Google マップと同じ画面に表示するアプリケーションは、Google への帰属表示を追加する必要はありません。

アプリケーションのデータを、Google マップには表示せずにページまたはビューに表示する場合は、データとともに Google ロゴを表示する必要があります。たとえば、あるタブに Google データを表示し、別のタブにそのデータを含む Google マップを表示する場合、最初のタブに Google ロゴを表示する必要があります。アプリケーションで、オートコンプリートの有無にかかわらず検索フィールドを使用する場合、ロゴをインラインで表示する必要があります。

Google のロゴは地図の左下に配置し、権利帰属情報は右下に配置してください。どちらも地図上またはアプリ内の別の場所の下ではなく、地図全体に表示されるようにしてください。次の地図の例では、地図の左下に Google のロゴ、右下に帰属情報が表示されています。

ポリシー アトリビューション プレースメント

次の ZIP ファイルには、パソコン、Android、iOS の各アプリケーションに適したサイズの Google ロゴが含まれています。いかなる場合でも、これらのロゴのサイズ変更や変更はできません。

ダウンロード: google_logo.zip

帰属表示は変更しないでください。属性情報を削除したり、隠したり、切り抜いたりしないでください。Google ロゴをインラインで使用することはできません(例: 「これらの地図は [Google_logo] のものです」)。

アトリビューションはなるべく近くで行いましょう。直接埋め込み以外で Google 画像のスクリーンショットを使用する場合は、画像に表示される標準の帰属情報を含めます。帰属情報テキストは、必要に応じてスタイルと配置をカスタマイズできます。ただし、テキストはコンテンツと近く、平均的な閲覧者や読者が判読できる必要があります。権利帰属表示をコンテンツから離れることはできません(書籍の巻末、ファイルや番組のクレジット、ウェブサイトのフッターなど)。

第三者データ プロバイダを含める。Google のマッピング サービスのデータと画像の一部は、Google 以外のプロバイダから提供されています。このような画像を使用する場合、帰属情報のテキストには「Google」の名称と関連するデータ プロバイダ(「地図データ: Google, Maxar Technologies」など)を記載する必要があります。第三者データ プロバイダが画像で引用されている場合、「Google」または Google ロゴのみを使用しても、帰属は適切ではありません。

帰属表示が現実的でないデバイスで Google Maps Platform を使用している場合は、 Google セールスチームにお問い合わせのうえ、ユースケースに適したライセンスについてご相談ください。

帰属表示に関するその他の要件

サードパーティの属性を取得し、アプリに属性を表示する手順は次のとおりです。

プレイスから属性を取得する

get place by ID を呼び出して取得した情報を表示する場合、アプリは取得した Place Details のサードパーティ属性も表示する必要があります。

API は Place オブジェクトを返します。Place オブジェクトから属性を取得するには、Place.getAttributions() を呼び出します。このメソッドは、String オブジェクトの List を返します。表示する属性がない場合は null を返します。

String placeId = "INSERT_PLACE_ID_HERE";
List<Place.Field> placeFields = Arrays.asList(Place.Field.ID, Place.Field.NAME);
FetchPlaceRequest request = FetchPlaceRequest.newInstance(placeId, placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
  Place place = response.getPlace();
  textView.append("Place found: " + place.getName());
  List<String> attributions = place.getAttributions();
  if (attributions != null) {
    StringBuilder stringBuilder = new StringBuilder("Attributions: ");
    for (String attribution : attributions) {
      stringBuilder.append(attribution).append("\n");
    }
    textView.append(stringBuilder.toString());
  }}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
      // Handle the error.
    }
  }
);

写真の帰属情報を表示する

アプリに写真を表示する場合は、その写真が含まれる各写真の属性を表示する必要があります。PhotoMetadata には、次の 2 種類のアトリビューションのいずれかを含めることができます。

写真の文字列属性を取得するには、PhotoMetadata.getAttributions() を呼び出します。このメソッドは、HTML 文字列を返すか、表示する属性がない場合は空の文字列を返します。

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the attribution text.
String attributions = photoMetadata.getAttributions();

写真の作成者属性を取得するには、PhotoMetadata.getAuthorAttributions() を呼び出します。このメソッドは AuthorAttributions オブジェクトを返します。このオブジェクトには、AuthorAttribution オブジェクトの List(作成者ごとに 1 つ)が含まれます。

// Get the photo metadata from the Place object.
PhotoMetadata photoMetadata = place.getPhotoMetadatas().get(0);

// Get the author attributions object.
AuthorAttributions authorAttributions = photoMetadata.getAuthorAttributions();
List<AuthorAttribution> authorAttributionList = authorAttributions.asList();

レビューを表示する

Place オブジェクトには最大 5 つのレビューを含めることができ、各レビューは Review オブジェクトで表されます。これらのレビューをアプリに表示することもできます。

Google ユーザーが投稿したレビューを表示する場合は、投稿者の名前を近くに置く必要があります。Review オブジェクトの作成者情報フィールドから取得できる場合は、作成者の写真とプロフィールへのリンクを含めることをおすすめします。次の図は、公園のレビューの例を示しています。

著者帰属の表示

レビューの並べ替え方法をエンドユーザーに表示することもおすすめします。

レビューにアクセスするには、Place.getReviews() を呼び出します。

// Specify the fields to return.
final List<Place.Field> placeFields = Arrays.asList(Place.Field.REVIEWS);

// Construct a request object, passing the place ID and fields array.
final FetchPlaceRequest request = FetchPlaceRequest.newInstance("INSERT_PLACE_ID_HERE", placeFields);

placesClient.fetchPlace(request).addOnSuccessListener((response) -> {
    Place place = response.getPlace();
    List<Review> reviews = place.getReviews();
    // For loop for iterating over the List
    for (int i = 0; i < reviews.size(); i++) {
      // For each review, get the Review object.
        Review placeReview = reviews.get(i);

      // Get any attribution and author attribution.
        String reviewAttribution = placeReview.getAttribution();
        AuthorAttribution authorAttribution = placeReview.getAuthorAttribution();

        // Display the review contents and attributions as necessary.
    }
}).addOnFailureListener((exception) -> {
    if (exception instanceof ApiException) {
        // Handle the error.
    }
});

サードパーティの属性を表示する

サードパーティ プロバイダの属性には、HTML 形式のコンテンツとリンクが含まれます。これらは、提供された形式で保持し、ユーザーに表示する必要があります。この情報は場所の詳細の下に表示することをおすすめします。

API は、アプリが使用するすべての場所の属性を生成します。属性は場所ごとではなく、API 呼び出しごとに提供されます。

属性を表示する方法の一つは、TextView を使用することです。次に例を示します。

TextView attributionsText = (TextView) findViewById(R.id.attributions);
String thirdPartyAttributions = place.getAttributions();
attributionsText.setText(thirdPartyAttributions);

サードパーティ属性の例

Listings by <a href="https://www.example.com/">Example Company</a>

Google アトリビューションのスタイル ガイドライン

以下は、ダウンロード可能な Google ロゴを使用できない場合の、CSS と HTML の Google 帰属表示のスタイル ガイドラインです。

クリアスペース

ロックアップの周囲のクリアスペースは、Google の「G」の高さ以上である必要があります。

帰属情報のコピーと Google ロゴの間のスペースは、「G」の幅の半分にします。

読みやすさ

バイラインは常にはっきりと見やすく、背景色に適した色で表示する必要があります。選択したバリエーションのロゴに十分なコントラストを付けてください。

白または明るい色の背景で Google Material Gray 700 テキストを使用し、黒の色合い(最大 0%~ 40%)を使用します。

Google
#5F6368
RGB 95 99 104
HSL 213 5 39
HSB 213 9 41

背景が暗く、写真や目立たないパターンの上には、バイラインとアトリビューションに白いテキストを使用します。

Google
#FFFFFF
RGB 255 255 255
HSL 0 0 100
HSB 0 0 100

Font

Roboto フォントを使用します。

CSS の例

次の CSS を「Google」のテキストに適用すると、白または明るい背景に「Google」が適切なフォント、色、間隔でレンダリングされます。

font-family: Roboto;
font-style: normal;
font-weight: 500;
font-size: 16px;
line-height: 16px;
padding: 16px;
letter-spacing: 0.0575em; /* 0.69px */
color: #5F6368;