迁移到地点照片（新）

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

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

下表列出了“地点照片（旧版）”中已重命名或修改为“地点照片（新版）”的参数，或不再受支持的参数。

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

增加了照片大小

地点照片（旧版）支持的照片大小上限为 1600 x 1600 像素。地点照片（新）支持的尺寸上限为 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 - 用于在执行 Google 相册请求时标识照片的字符串。
  • height - 图片的最大高度。
  • width - 图片的最大宽度。
  • html_attributions[] - 所有必需的提供方说明。此字段始终存在，但可能为空。