迁移到地点照片（新）

Places API 支持现有的地点照片。如果您熟悉现有的地点照片， 新版地点照片 进行以下更改：

  • 新的地点照片服务要求您 传递照片的资源名称，其中包括 请求网址，而不只是照片引用。如需了解详情，请参阅 更改为照片引用。
  • 新的地点照片服务支持使用 API 密钥和 OAuth 令牌作为身份验证机制。

下表列出了现有 已重命名或修改的地点照片 新的地点照片，或不再使用 支持。

当前参数 新增参数 备注
maxheight maxHeightPx 您必须指定 maxHeightPx 和/或 maxWidthPx。
maxwidth maxWidthPx 您必须指定 maxHeightPx 和/或 maxWidthPx。

已放大照片大小

现有地点照片最多支持 张照片 尺寸为 1600x1600 像素地点照片（新）支持的尺寸上限为 4800 x 4800 像素。

更改为照片引用

新的 地点照片 API 要求您传递所请求照片的资源名称， 包含地点 ID 和照片参考，格式如下：

https://places.googleapis.com/v1/places/PLACE_ID/photos/PHOTO_REFERENCE/media?maxWidthPx=400&key=API_KEY

新版“附近搜索”“文本搜索”和“地点详情”均会在响应中返回支持此格式的 photos[] 数组。新响应中的每个 photos[] 元素都包含以下字段：

  • name - 包含 照片。此字符串的格式如下：

    places/PLACE_ID/photos/PHOTO_REFERENCE
  • heightPx - 图片的最大高度（以像素为单位）。
  • widthPx - 图片的最大宽度（以像素为单位）。
  • authorAttributions[] - 任何必需的提供方说明。这个 字段始终存在，但可能为空。

使用现有 API 时，您只需传递照片引用，格式如下：

https://maps.googleapis.com/maps/api/place/photo?photo_reference=PHOTO_REFERENCEmaxwidth=400&key=API_KEY

现有的“查找地点”“附近搜索”“文本搜索”和“地点详情”均会在响应中返回支持此格式的 photos[] 数组。现有列中的每个 photo 元素 响应包含以下字段：

  • photo_reference - 一个字符串，用于识别照片， 执行照片请求
  • height - 图像的最大高度。
  • width - 图片的最大宽度。
  • html_attributions[] - 任何必需的提供方说明。这个 字段始终存在，但可能为空。