迁移到地点照片（新）

此功能需要您启用新一代 Places API，即 Places API（新）。如需了解详情，请参阅启用 API。

Places SDK for Android 支持地点照片（旧版）。如果您熟悉“地图照片（旧版）”，地图照片（新版）会进行以下更改：

• 采用了新的定价模式。如需了解所有 API 的价格信息，请参阅 Places SDK for Android（新）。

• “地点照片（旧版）”会返回位图图片。 放置照片（新）会返回图片的 URI。

• 地点照片（旧版）支持的照片大小上限为 1600 x 1600 像素。地点照片（新）支持的尺寸上限为 4800 x 4800 像素。

• 如需发出请求，请调用新的 PlacesClient.fetchResolvedPhotoUri() 方法。

• 只有启用 Places API 后，您才能调用 PlacesClient.fetchPhoto() 方法。如果您仅启用 Places API（新版），则无法使用此方法。

  如需了解详情，请参阅使用 API 密钥。

• 将新 FetchResolvedPhotoUriRequest 类的对象传递给请求。

• 响应中的每张照片都由 PhotoMetadata 对象表示。对于 Places SDK for Android（新版），PhotoMetadata 对象包含一个新的 PhotoMetadata.getAuthorAttributions() 方法，该方法会返回类型为 AuthorAttributions 的对象。

  如果返回的 PhotoMetadata 对象包含任何提供方说明或作者提供方说明，无论您在哪里显示相应图片，都必须在应用中包含这些提供方说明。请参阅提供方说明文档。

• 如需在 PhotoMetadata 中访问新的作者归属信息，您必须通过调用 Places.initializeWithNewPlacesApiEnabled() 方法来初始化应用。如需详细了解如何选择 Places API 服务，请参阅设置 Google Cloud 项目。

示例请求

如需查看完整示例，请参阅放置照片（新）。