迁移到地点照片（新）

欧洲经济区 (EEA) 开发者

简介

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

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

下表列出了 Place Photos（旧版）中已重命名或修改为 Place Photos（新版）的参数，以及不再受支持的参数。

当前形参 新增参数 备注
maxheight maxHeightPx 您必须指定 maxHeightPx、maxWidthPx 或同时指定这两者。
maxwidth maxWidthPx 您必须指定 maxHeightPx、maxWidthPx 或同时指定这两者。

照片尺寸增大

Place Photos（旧版）支持的最大照片尺寸为 1600x1600 像素。Place Photos（新）支持的最大尺寸为 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[] - 任何必需的提供方信息。此字段始终存在，但可能为空。