迁移到地点照片（新）

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

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

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

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

已放大照片大小

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

更改为照片引用

新的 Place Photo 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[] - 任何必需的提供方说明。此字段始终存在，但可能为空。