このドキュメントでは、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 との契約条件が適用されます。本契約の規定に従い、利用規約に記載されている限定的条件を除き、コンテンツのプリフェッチ、インデックス登録、保存、キャッシュ保存は行わないでください。
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 ロゴは地図の左下に配置し、帰属情報は右下に配置してください。いずれの情報も、地図全体に表示され、地図内やアプリ内の別の場所に配置しないでください。次の地図の例では、地図の左下に 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 と同じようにアクセスして表示できます。
写真の属性を表示する
アプリで写真を表示する場合は、写真を含む写真ごとに帰属を表示する必要があります。写真の属性を取得するには、
GMSPlacePhotoMetadata.attributions を呼び出します。このプロパティは、NSAttributedString、表示する属性がない場合は nil です。
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;
}
}
}];
サードパーティの属性を表示する
サードパーティ プロバイダへの帰属は、保持してユーザーに表示する必要があるコンテンツとリンクを含む 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 属性でカバーされています。
なお、プレイスを一意に識別するために使用されるプレイス ID は、キャッシング制限の適用対象外です。このため、プレイス ID 値は無期限に保存できます。プレイス ID は、Places SDK for iOS のレスポンスの place_id フィールドで返されます。
Google アトリビューションのスタイル ガイドライン
ダウンロード可能な Google ロゴを使用できない場合の、CSS および HTML での Google 帰属表示のスタイル ガイドラインは次のとおりです。
クリアスペース
ロックアップの周囲のクリアスペースは、Google の「G」の高さ以上にする必要があります。
帰属情報のコピーと Google ロゴの間隔は、「G」の幅の半分にする必要があります。
読みやすさ
バイラインは常に、はっきりと見やすく、背景色に適した色で表示する必要があります。選択したバリエーションのロゴに十分なコントラストを付けてください。
色
白または明るい色の背景で、0%～ 40% の黒濃淡を使用して Google Material Gray 700 テキストを使用します。
#5F6368 RGB 95 99 104 HSL 213 5 39 HSB 213 9 41
背景が暗く、写真やシンプルなパターンの上には、バイラインと帰属情報に白いテキストを使用します。
#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;