迁移到地点照片（新）

欧洲经济区 (EEA) 开发者

简介

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