迁移到地点照片（新）

简介

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

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

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

当前参数	新参数	备注
maxheight	maxHeightPx	您必须指定 maxHeightPx, maxWidthPx, 或两者。
maxwidth	maxWidthPx	您必须指定 maxHeightPx, maxWidthPx, 或两者。

照片大小增加

Place Photos（旧版）支持的最大照片大小为 1600 x 1600 像素。Place Photos（新）支持的最大照片大小为 4800 x 4800 像素。

对照片引用的更改

Place Photos（新） 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[]：任何必需的署名。此字段始终存在，但可能为空。