迁移到地点照片（新）

简介

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

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

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

当前形参	新增参数	备注
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[] - 任何必需的署名信息。此字段始终存在，但可能为空。