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 之间达成的协议的条款。根据协议条款的规定,您不得预先提取、存储、缓存任何内容,除非在条款中规定的有限条件下。

请注意,用于唯一标识地点的地点 ID不受缓存限制的约束。地点 ID 会在 Places SDK for iOS 响应的“place_id”字段中返回。如需了解如何保存、刷新和管理地点 ID,请参阅地点 ID 指南

显示 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 属性中检索该地点的提供方说明。

attributions 作为 NSAttributedString 对象提供。

检索地点集合的提供方说明

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

attributions 作为 NSAttributedString 对象提供,您可以采用与 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;
}
    

第三方提供方说明示例

第三方提供方说明通常由带链接的文本组成。例如:

示例公司的商家信息

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

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;