Places SDK for iOS 政策

使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

本文列出了通过 Places SDK for iOS 开发的所有应用(包括该 API 中的地点自动补全服务)的具体要求。如需了解面向 Google 地图开发者的更多一般信息,请参阅 Google Maps Platform 服务条款

提供使用条款和隐私政策

如果您开发的 Places SDK for iOS 应用,您必须随应用一起提供使用条款隐私权政策,并且应用要符合您与 Google 所签订协议中的相关准则:

  • 使用条款隐私权政策必须公开发布。
  • 您必须在应用的使用条款中明确声明,用户一旦使用您的应用,即会受到 Google 服务条款的约束。
  • 您必须在隐私权政策中告知用户您正在使用 Google Maps API,并以引用方式纳入 Google 隐私权政策

是否提供使用条款隐私权政策取决于您的应用平台。

移动应用

如果您开发的是移动应用,建议您在应用的下载页面(位于相关的应用商店中)和应用设置菜单中提供指向使用条款隐私权政策的链接。

Web 应用

如果您开发的是 Web 应用,建议您在自己网站的页脚中提供指向使用条款隐私权政策的链接。

预提取、缓存或存储内容

使用 Places SDK for iOS 的应用受您与 Google 所签协议条款的约束。根据协议条款的规定,除非条款中规定的有限条件,否则您不得预提取、存储、缓存任何内容,也不得将其编入索引。

显示 Places SDK for iOS 结果

您可以在 Google 地图上(或不使用地图)显示 Places SDK for iOS 结果。如果您想在地图上显示 Places SDK for iOS 结果,那么这些结果必须显示在 Google 地图上。禁止在非 Google 地图的地图上使用 Places SDK for iOS 数据。

如果您的应用在 Google 地图上显示数据,则 Google 徽标会包含在内,并且可能无法更改。在与 Google 地图相同的屏幕上显示 Google 数据的应用不需要向 Google 提供进一步的提供方说明。

如果您的应用在页面或视图上显示数据,但不显示 Google 地图,则必须在显示该数据的 Google 徽标中显示这些数据。例如,如果您的应用在一个标签页上显示 Google 数据,而包含该数据的 Google 地图位于另一个标签页,则第一个标签页必须显示 Google 徽标。如果您的应用使用或不使用自动补全功能,搜索字段必须内嵌显示徽标。

Google 徽标应放置在地图的左下角,归因信息应放在右下角,两者应全部显示在地图上,而不是地图下方或应用中的其他位置。以下地图示例在地图的左下角显示 Google 徽标,在右下方显示提供方说明。

以下 ZIP 文件包含不同尺寸的 Google 徽标,分别适用于桌面设备、Android 和 iOS 应用。您不得以任何方式修改这些徽标或调整其尺寸。

下载google_logo.zip

请勿修改提供方信息。请勿移除、隐藏或剪裁提供方信息。您不能内嵌使用 Google 徽标(例如,“这些地图来自 [Google_logo]”)。

确保注明归因来源。如果在直接嵌入图片之外使用 Google 图片的屏幕截图,请添加图片中显示的标准提供方说明。必要时,您可以自定义提供方标示文字的样式和位置,前提是这类文字与内容的距离非常接近,而且容易让普通观看者或读者辨识。 您不得离开内容(例如图书结尾、文件或节目的致谢信息,或网站的页脚)注明出处。

包括第三方数据提供商。我们地图产品中的部分数据和图片来自 Google 以外的其他提供商。如果使用此类图像,则提供方文字必须指明名称“Google”以及相关数据提供商,例如“地图数据:Google、Maxar Technologies”。图片中引用了第三方数据提供商,而只包括“Google”或 Google 徽标时,则不属于正确的提供方信息。

如果您在无法展示归因工具的设备上使用 Google Maps Platform,请与 Google 销售团队联系,讨论适合您用例的许可。

其他归因要求

第三方提供方的提供方说明包含的内容和链接必须按照提供时所采用的格式向用户显示。Google 建议您的应用在地点详情下方显示此信息。

API 返回的第三方提供方信息包含 Google 提供方信息。您必须自行添加此提供方说明,如显示 Google 徽标和提供方所述。

请按照以下说明检索单个地点或一组地点的第三方归因。

检索单个地点的提供方说明

当您按 ID 获取地点检索地点时,可以从 GMSPlace 上的 attributions 属性检索该地点的提供方说明。

attributionsNSAttributedString 对象的形式提供。

检索地点集的提供方说明

如果您的应用要显示通过请求设备的当前地点获取的信息,则该应用必须针对显示的地点详情显示第三方提供方说明。您可以从 GMSPlaceLikelihoodList 上的 attributions 属性中检索在请求中检索的所有地点的提供方信息。

attributionsNSAttributedString 对象的形式提供,您可以像在 attributions 上一样访问和显示该对象,如上文所述。

显示照片的提供方说明

如果您的应用显示照片,您必须显示包含这些照片的提供方说明。如需获取照片的提供方信息,请调用 GMSPlacePhotoMetadata.attributions。此属性为 NSAttributedStringnil(如果没有可显示的提供方说明)。

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 上设置委托,并设置 UITextViewDelegateshouldInteractWithURL 方法以返回 YES

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;
}
    

第三方提供方说明示例

第三方归因通常由带链接的文字组成。例如:

商家信息示例

在上面的示例中,NSLinkExample 属性涵盖示例公司文本范围。

请注意,用于唯一标识地点的地点 ID 不受缓存限制的约束。因此,您可以无限期地存储地点 ID 值。Places SDK for iOS 响应的 place_id 字段中会返回地点 ID。

Google 归因模型的样式指南

如果您无法使用可下载的 Google 徽标,以下是针对 CSS 和 HTML 中的 Google 归因工具的样式指南。

留白

锁定图标周围的留白高度/宽度应大于或等于 Google 中的“G”高度。

归因文案与 Google 徽标之间的间距应是“G”宽度的一半。

可辨度

署名应始终清晰可辨,并以适合给定背景的正确颜色变化形式出现。请务必为您选择的徽标变体提供足够的对比度。

颜色

在白色或浅色背景上使用 Google Material 灰色 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

字体

使用 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;