Google Cloud Platform新版Text Search API缺失photos字段的技术问询

1. 为何photos字段缺失/返回空？ #

该API处于Beta测试阶段，photos字段属于未完全落地的功能。尽管文档中把places.photos列为可选字段，但Beta版本的功能通常是分阶段上线的，部分字段仅在文档中预先定义，实际未完成数据对接。

你验证过目标地点存在照片，且旧版API流程能正常获取，说明数据本身是完整的，问题出在新版Text Search API的Beta版本暂未整合照片字段的返回逻辑。

2. 如何查看API实现时间线和状态？ #

可以通过以下官方渠道获取信息：

• 查看该API的官方文档，Beta版本的文档通常会设有「更新日志」或「Beta状态」板块，记录功能迭代进度与上线计划。
• 订阅Google Maps Platform开发者邮件通知，会收到Beta版本的功能更新、状态变更等推送。
• 访问Google Maps Platform Issue Tracker，查看同类问题的开发者反馈及官方回复，了解该功能的开发进度。

3. X-Goog-FieldMask字段的未来支持性 #

Beta阶段的字段无法保证100%持续支持，Google可能会根据用户反馈或架构调整，对字段进行增删、重命名或逻辑修改。但像places.photos这类对应旧版成熟功能的字段，被移除的概率极低，大概率会在正式版中保留，可能仅调整字段结构或返回规则。

临时替代方案 #

目前若需在新版API流程中获取照片，可先通过Text Search API拿到Place ID，再调用新版Place Details API（注意该API同样处于Beta阶段，需确认字段支持情况）获取照片信息，这是适配新版体系的稳妥方案。

内容的提问来源于stack exchange，提问作者asding.fs