Places SDK for iOS のポリシー

このドキュメントでは、Places SDK for iOS を使用して開発されたすべてのアプリケーションに固有の要件について説明します。これには、この API の一部である Place Autocomplete サービスも含まれます。Google マップ デベロッパー向けの一般的な情報については、Google Maps Platform 利用規約をご覧ください。

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

Places SDK for iOS アプリケーションを開発する場合、アプリケーションについて、Google との契約に記載されているガイドラインに適合する利用規約とプライバシー ポリシーをアプリケーションに公開する必要があります。

  • 利用規約とプライバシー ポリシーは一般公開されていること。
  • アプリケーションの利用規約に、当該アプリケーションを使用するユーザーには Google の利用規約が適用される旨が明示的に記載されていること。
  • プライバシー ポリシーで、Google Maps API を使用していることをユーザーに伝え、参照として Google プライバシー ポリシーを組み込んでいること。

利用規約とプライバシー ポリシーをどこに組み込むべきかは、アプリケーションのプラットフォームによって異なります。

モバイルアプリ

モバイルアプリを作成している場合は、利用規約とプライバシー ポリシーのリンクを、関連するアプリストアのダウンロード ページとアプリの設定メニューに組み込むことをおすすめします。

ウェブ アプリケーション

ウェブ アプリケーションを作成している場合は、利用規約とプライバシー ポリシーへのリンクをウェブサイトのフッターに組み込むことをおすすめします。

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

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

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

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

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

アプリケーションで 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 セールスチームにお問い合わせのうえ、ユースケースに適したライセンスについてご相談ください。

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

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

API から返されるサードパーティ アトリビューションには、Google アトリビューションは含まれません。Google ロゴと帰属表示で説明されているように、この帰属情報は自分で含める必要があります。

1 つの場所または場所の集合についてサードパーティの属性を取得する手順は次のとおりです。

1 つの場所のアトリビューションを取得する

ID で場所を取得して場所を取得する場合は、GMSPlace の attributions プロパティからその場所の帰属情報を取得できます。

attributions は NSAttributedString オブジェクトとして提供されます。

場所のコレクションの属性を取得する

デバイスの現在地をリクエストして取得した情報を表示するアプリの場合、表示する場所の詳細について、サードパーティの属性を表示する必要があります。リクエストで取得したすべての場所の帰属情報は、 GMSPlaceLikelihoodList の attributions プロパティから取得できます。

attributions は NSAttributedString オブジェクトとして提供され、上記のように、1 か所の attributions と同じようにアクセスと表示ができます。

写真の帰属を表示する

アプリが写真を表示する場合は、その写真が含まれている写真ごとに attributions と authorAttributions を表示する必要があります。

  • アトリビューションにアクセスするには、GMSPlacePhotoMetadata.attributions を使用します。このプロパティは NSAttributedString です。表示するアトリビューションがない場合は nil です。
  • 著者の帰属情報にアクセスするには、GMSPlacePhotoMetadata.authorAttributions を使用します。このプロパティには GMSPlaceAuthorAttribution オブジェクトの配列が含まれます。

Swift

GMSPlacesClient.sharedClient().lookUpPhotosForPlaceID(placeID) { (photos, error) -> Void in
  if let error = error {
    // TODO: handle the error.
    print("Error: \(error.description)")
  } else {
    // Get attribution for the first photo in the list.
    if let photo = photos?.results.first {
      let attributions = photo.attributions
    }
  }
}

Objective-C

[[GMSPlacesClient sharedClient]
    lookUpPhotosForPlaceID:placeID
      callback:^(GMSPlacePhotoMetadataList *_Nullable photos,
                  NSError *_Nullable error) {
        if (error) {
          // TODO: handle the error.
          NSLog(@"Error: %@", [error description]);
        } else {
          // Get attribution for the first photo in the list.
          if (photos.results.count > 0) {
            GMSPlacePhotoMetadata *photo = photos.results.firstObject;
            NSAttributedString *attributions = photo.attributions;
          }
        }
      }];

クチコミを表示する

GMSPlace オブジェクトには最大 5 つのレビューを含めることができ、各レビューは GMSPlaceReview オブジェクトで表されます。必要に応じて、これらのレビューをアプリに表示できます。

Google ユーザーが投稿したレビューを表示する場合は、投稿者の名前をできるだけ近づける必要があります。GMSPlaceReview オブジェクトの作成者の帰属表示フィールドで利用可能な場合は、作成者の写真とプロフィールへのリンクも含めることをおすすめします。次の図は、公園のレビューの例を示しています。

投稿者の帰属表示

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

レビューにアクセスするには:

Swift

// Define a Place ID.
let placeID = "ChIJV4k8_9UodTERU5KXbkYpSYs"

// Specify the place data types to return.
let myProperties: [GMSPlaceProperty] = [.name, .website, .reviews]

// Create the GMSFetchPlaceRequest object.
let fetchPlaceRequest = GMSFetchPlaceRequest(placeID: placeID, placeProperties: myProperties)

client.fetchPlaceWithRequest(fetchPlaceRequest: fetchPlaceRequest, callback: {
  (place: GMSPlace?, error: Error?) in
  if let error = error {
    print("An error occurred: \(error.localizedDescription)")
    return
  }
  if let place = place {
    let firstReview: GMSPlaceReview = place.reviews![0]

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
})

Objective-C

// Define a Place ID.
NSString *placeID = @"ChIJV4k8_9UodTERU5KXbkYpSYs";

// Specify the place data types to return, including reviews.
NSArray<GMSPlaceProperty *> *myProperties = @[GMSPlacePropertyName, GMSPlacePropertyWebsite,GMSPlacePropertyReviews];

GMSFetchPlaceRequest *fetchPlaceRequest = [[GMSFetchPlaceRequest alloc] initWithPlaceID:placeID placeProperties: myProperties];

[placesClient fetchPlaceWithRequest: fetchPlaceRequest, callback: ^(GMSPlace *_Nullable place, NSError *_Nullable error) {
  if (error) {
    // TODO: handle the error.
    NSLog(@"Error: %@", [error description]);
  } else {
    // Get first review.
    GMSPlaceReview *firstReview = [place reviews][0];

    // Use firstReview to access review text, authorAttribution, and other fields.

  }
}];

第三者の帰属を表示する

サードパーティ プロバイダの属性は、保持してユーザーに表示する必要があるコンテンツとリンクを含む NSAttributedString オブジェクトとして提供されます。

帰属情報はリンクが機能する必要があるため、UITextView を使用して表示することをおすすめします。 リンクが機能するように、UITextView にデリゲートを設定し、YES を返すように UITextViewDelegate の shouldInteractWithURL メソッドを設定します。

Swift

...
  self.attributionTextView.delegate = self
...

// MARK: - UITextViewDelegate

func textView(textView: UITextView, shouldInteractWithURL URL: NSURL,
  inRange characterRange: NSRange) -> Bool {
  // Make links clickable.
  return true
}

Objective-C

...
  self.attributionTextView.delegate = self;
...

#pragma mark - UITextViewDelegate

- (BOOL)textView:(UITextView *)textView
    shouldInteractWithURL:(NSURL *)url
                  inRange:(NSRange)characterRange {
  // Make links clickable.
  return YES;
}

サードパーティ属性の例

サードパーティの帰属表示は通常、リンク付きのテキストで構成されます。次に例を示します。

サンプル企業のリスティング

上記の例では、Example Company のテキスト範囲は NSLink 属性でカバーされています。

Google 帰属のスタイル ガイドライン

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

クリアスペース

ロックアップ周りのクリアスペースは、Google の「G」の高さを最小サイズとして設定してください。

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

判読しやすさ

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

色

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

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

フォント

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;