Places API 支持现有的地点照片。如果您熟悉现有的地点照片,不妨从新版地点照片进行以下更改:
- 新的地点照片服务要求您传递照片的资源名称,其中包括请求网址中的地点 ID,而不仅仅是照片引用。如需了解详情,请参阅对照片引用的更改。
- 新的地点照片服务支持使用 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[]
- 任何必需的提供方说明。此字段始终存在,但可能为空。