迁移到地点照片(新)

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

  • 新的地点照片服务要求您 传递照片的资源名称,其中包括 请求网址,而不只是照片引用。如需了解详情,请参阅 更改为照片引用
  • 新的地点照片服务同时支持 API 密钥OAuth 作为身份验证机制。

下表列出了现有 已重命名或修改的地点照片 新的地点照片,或不再使用 支持。

当前参数 新增参数 备注
maxheight maxHeightPx 您必须指定 maxHeightPxmaxWidthPx,或同时设置两者。
maxwidth maxWidthPx 您必须指定 maxHeightPxmaxWidthPx,或同时设置两者。

已放大照片大小

现有地点照片最多支持 张照片 尺寸为 1600x1600 像素地点照片(新) 支持的尺寸最高可达 4800x4800 像素

更改为照片引用

新的 地点照片 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 时,您只需在 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[] - 任何必需的提供方说明。这个 字段始终存在,但可能为空。