Google Places API(旧版)已冻结:欧盟开发者在弃用倒计时开始前应做什么
Google于2025年3月冻结了旧版Places API。它仍可使用,但不会获得新功能,弃用即将到来。对于欧盟开发者而言,迁移决策比Google文档所暗示的要复杂得多。
2025年3月,Google悄然重组了其地图平台,即使措辞温和,也给开发者带来了真实的紧迫性。旧版Places API、Directions API和Distance Matrix API全部被重新分类为"旧版服务"。它们仍然可以使用,在Google宣布弃用日期之前会持续工作。但它们已被冻结。
不再有新功能。不再有架构改进。批量折扣封顶在100,000+层级,低于大型应用所需的水平。在未来某个时刻,将会有一个附带12个月通知的弃用公告。
对大多数开发者而言,问题不是是否迁移,而是何时迁移、迁移到哪里。
对于欧盟开发者而言,这个计算更为复杂。迁移决策不仅涉及API兼容性和定价,还涉及GDPR合规性、数据驻留以及Google自身文档未能完全说明的美国基础设施法律风险。
本指南介绍了变化的内容、迁移涉及的内容,以及欧盟团队在确定方向之前应该提出的问题。
Google在2025年3月做了什么改变
2025年3月的重组有两个不同的组成部分,许多开发者将它们混为一谈。
定价重组:Google用每SKU免费额度取代了每月200美元的统一月度积分。不再是可以应用于任意API组合的单一积分,每种API类型现在都有自己的免费额度:
- 地理编码API:每月10,000次免费事件,之后每1,000次2至7美元
- Maps JavaScript API:每月10,000次免费事件
- Places API(新版):每种请求类型有免费额度
- Routes API:每种路线类型有免费额度
对于在旧版200美元积分下大量使用单一API的开发者,新模型可能意味着支付更多。对于分散在多种API类型上的开发者,每SKU免费额度实际上可能降低成本。唯一的确定方法是对照新SKU结构审计当前使用情况。
除定价变化外,Google还推出了订阅计划:入门版每月100美元(50,000次组合调用),基础版每月275美元(100,000次组合调用),专业版每月1,200美元(250,000次组合调用)。这些计划旨在提供规模化的可预测性,但也为成本预测增加了另一层复杂性。
API弃用指定:此外,Google将三个API指定为旧版服务:
- Places API(旧版):由Places API(新版)替代
- Directions API:由Routes API替代
- Distance Matrix API:由带computeRouteMatrix的Routes API替代
旧版指定意味着这些API不再获得新功能,也没有资格享受新的扩展批量折扣层级。它们处于维护模式。
Places API(新版)的实际变化
Places API(新版)不是直接替代品。它有不同的请求格式、不同的响应结构和不同的字段选择模型。
最重要的变化是字段掩码(field masking)。旧版API返回固定的响应结构。新版API要求你通过字段掩码标头指定所需字段。这减少了不必要的数据传输,意味着你只为请求的字段付费,但也意味着代码库中的每个API调用都需要用明确的字段掩码更新。
开发者在迁移过程中遇到的主要差异:
请求格式:新API使用带JSON主体的POST请求,而非带查询参数的GET请求。如果你的集成构建基于URL的调用,每个调用都需要重构。
响应结构:字段名称已更改。formatted_address变为formattedAddress(驼峰命名法)。place_id变为id。geometry对象已重构。响应解析代码需要全面审查。
仅在Places API(新版)中的新功能:生成式AI摘要、电动汽车充电站的新数据字段、燃油价格、无障碍详情以及改进的自动完成建议。如果你需要这些功能,就必须迁移。
照片处理:照片引用格式已更改。旧版API生成的照片URL最终将停止工作,因此任何缓存的照片引用都需要重新生成。
Google提供迁移指南,但实际经验表明迁移是一项有意义的工程任务,而非配置更改。团队通常预留一到四周时间,具体取决于集成复杂性。
Routes API迁移(独立但相关)
Directions API和Distance Matrix API遵循类似的模式。替代品是Routes API,它使用不同的请求/响应格式,提供旧版API没有的功能:感知交通的路线规划、路线修饰符、两轮车支持以及燃油效率优化。
Routes API的定价也不同。旧版Directions API按元素(起点-终点对)定价。Routes API按路线请求和矩阵请求中的元素计费。对于发出大量矩阵请求的应用,成本可能发生显著变化。
如果你正在迁移Places API,值得同时规划Routes API迁移,而非进行两次独立迁移。并行工作比顺序迁移更高效,每次迁移都需要自己的测试和部署周期。
欧盟特有的考虑因素
这是迁移决策对欧洲开发者比Google文档所暗示的更为复杂的地方。
GDPR与跨境数据传输
Google Maps Platform是美国基础设施。当用户的浏览器向Places API发出请求或加载地图时,该请求会路由经过Google的美国服务器。根据GDPR,这是跨境数据传输。
目前这些传输的法律依据是欧美数据隐私框架(DPF),它取代了2020年因Schrems II裁决而无效的隐私盾协议。DPF已受到法律挑战,其长期稳定性无法保证。对于受监管行业(医疗、金融科技、法律服务、政府相关应用)的公司而言,持续依赖美国基础设施是一个需要监控的持续合规对话。
在某些实施中使用Google Maps API还需要JavaScript API的Cookie同意,因为用户IP地址和设备标识符会被发送到Google。对于希望在不触发同意横幅的情况下加载地图的应用,美国托管基础设施造成了一个结构性问题。
Google于2025年更新了其Maps Platform EEA服务条款,专门适用于欧盟账单地址。开发者应根据其DPA要求审查更新后的条款。
合规简化作为迁移触发因素
对于许多欧盟团队而言,2025年3月的变化提供了一个实际触发点,重新评估是继续留在Google生态系统还是迁移到欧盟托管的替代方案。
重新评估的商业理由很直接:如果你无论如何都要投入工程时间进行迁移(旧版Places API到新版Places API),那么迁移到不同提供商的边际额外工作通常比看起来要小。API端点变更、字段映射工作和测试周期,无论是迁移到Google的新API还是第三方替代方案,在很大程度上是相同的。区别在于你完成后得到的是什么。
欧盟托管的地图API完全消除了GDPR跨境传输问题。所有请求都留在欧盟内。无需谈判SCC,无需依赖DPF,加载地图无需Cookie同意。对于最近完成GDPR审计或预计即将进行审计的公司,这种简化具有真实的组织价值。
评估是在Google内迁移还是切换提供商
这个决策的诚实框架包含四个部分。
1. 审计当前API使用情况
在做任何决定之前,映射代码库中的每个Places API调用、Directions API调用和Distance Matrix API调用。按端点类型统计数量。将其映射到Places API(新版)定价模型和候选替代提供商的等效端点。
成本比较只有在真实使用数据下才有意义。基于总请求量的粗略估计是不够的,因为同一提供商内的不同API定价不同。
2. 评估GDPR风险敞口
请你的法律或合规团队评估美国基础设施依赖对你特定情况的持续风险程度。对于与欧盟企业客户签有DPA的SaaS产品,风险级别与处理敏感个人数据的消费者应用不同。
如果合规简化有价值,为其分配成本。维护SCC、监控DPF稳定性和处理客户合规问卷的内部法律开销是真实的工作,有真实的成本。
3. 评估每条路径的迁移工作量
在Google内迁移到Places API(新版):根据集成复杂性估算。字段掩码变更、请求重构、响应解析更新。通常需要一到四周的工程工作。
迁移到第三方替代方案:工程范围类似。端点URL变更、参数差异、响应格式差异。对于已经使用MapLibre GL JS作为渲染层(Mapbox GL JS的开源分支)的团队,渲染层保持不变。只有地理编码、搜索和路线调用需要更改。
4. 考虑另一端获得什么
Places API(新版)让你能够获得Google的最新功能:更好的自动完成、生成式AI摘要、扩展的地点数据。Google的数据覆盖范围在全球无与伦比。
像MapAtlas这样的欧盟托管替代方案提供设计上符合GDPR的合规性、欧盟数据驻留,以及在某些情况下Google API不提供的AI搜索可见性工具。对于房地产、酒店业或物流等AI可发现性位置页面很重要的应用,AI可见性层是一个有意义的差异化因素。
没有普遍正确的路径。正确答案取决于你的合规要求、定价敏感性以及对你的应用最重要的功能。
现在应该做什么
无论选择哪条迁移路径,以下几个行动立即有意义:
审计并记录当前API接口:确切了解你使用哪些旧版端点、使用频率以及依赖哪些数据字段。任何迁移决策都需要这些信息。
用真实数字进行定价比较:使用实际使用数据比较旧版定价、Places API(新版)定价和替代提供商。在当前用量和2倍当前用量下执行此操作。
检查GDPR文档:审查你当前与Google的DPA、你的SCC或DPF依赖,以及你的Cookie同意实施。在更改之前了解你当前的法律立场。
不要在时间压力下迁移:旧版API仍然有效。它被冻结,但没有损坏。用清晰的数据和充足的工程时间做出迁移决策,而非因感知的紧迫性而仓促行事。弃用公告将给你12个月的通知。
设定决策截止日期:"等Google宣布弃用"不是一个计划。为你选择哪条迁移路径设定一个内部决策点,最好在下个季度内。
如果你想比较欧盟托管地图API在API接口、定价和迁移工作量方面的实际情况,MapAtlas在单一定价模型下提供地理编码、地址自动完成、路线规划和地图瓦片,并实现欧盟数据驻留。定价页面显示当前层级结构,免费层(大多数API每月10,000次请求,地理编码25,000次)让你在做出承诺前测试集成。
常见问题
Google何时会弃用旧版Places API?
截至2026年初,Google尚未设定最终弃用日期。旧版API于2025年3月被冻结,不再获得新功能。Google的政策是在弃用前至少提供12个月通知。将迁移视为紧迫但非紧急的任务。
Places API(新版)比旧版Places API更贵吗?
这取决于你的使用模式。新的每SKU免费额度对某些使用情况有利,对其他情况则不利。在得出结论之前,用实际使用数据将当前API调用映射到新SKU结构。
我也需要从Directions API迁移吗?
是的,如果你需要新功能和更好的批量折扣。Directions API和Distance Matrix API在2025年3月均被指定为旧版服务。替代品是Routes API,需要单独进行迁移评估。
作为欧盟开发者继续使用Google Maps API有何GDPR风险?
Google Maps Platform使用美国基础设施,根据GDPR需要跨境数据传输机制。目前的依据是欧美数据隐私框架,该框架已受到法律挑战。对于受监管行业,这是一个需要监控的持续合规风险。
迁移到替代提供商需要多长时间?
工程工作量与在Google内迁移类似:一到四周,取决于集成复杂性,主要花在端点更新、参数差异和响应格式测试上。使用MapLibre GL JS进行渲染的团队迁移路径最轻松,因为渲染层保持不变。
结语
2025年3月的变化在旧版Places API使用上设置了倒计时,但没有正式启动倒计时。API仍然有效。弃用日期尚未宣布。但方向是明确的,有充分准备的迁移会比在压力下进行的迁移更为顺畅。
对于欧盟开发者而言,迁移时刻也是一个评估时刻。更改API端点的工程工作,无论是留在Google内还是迁移到欧盟托管替代方案,基本上是相同的。有意义的区别在于你之后拥有的是什么:Google全面的全球数据集和最新功能,或者设计上符合GDPR的合规性、更简单的定价和欧盟数据驻留。
这个决策值得用真实使用数据和对合规要求的清晰认识来认真做出,而非默认选择阻力最小的路径。
相关阅读:
- 欧盟开发者的Google Maps API替代方案
- 欧盟开发者GDPR合规地图API指南
- Google Maps API 2026年定价:你实际支付的费用
- 从Google Maps API切换:欧盟开发者的选择
- 地址自动完成API:如何提升结账转化率
Frequently Asked Questions
Google何时会弃用旧版Places API?
截至2026年初,Google尚未为旧版Places API设定最终弃用日期。但Google的官方政策是在弃用前至少提供12个月的通知。旧版API于2025年3月被指定为"旧版服务",这意味着它不再获得新功能,批量折扣已封顶在100,000+层级。即使没有硬性截止日期,开发者也应将迁移视为紧迫任务。
Places API(新版)比旧版Places API更贵吗?
这取决于你的使用模式。Places API(新版)采用不同的定价模型,为每个SKU提供单独的免费额度,而非旧版的200美元月度积分。对于某些使用情况,费用相似或更低。对于其他情况,尤其是依赖统一积分涵盖多种API类型的开发者,新模型可能更贵。唯一确定的方法是在迁移前将当前API调用映射到新SKU结构并核算数字。
我也需要从Directions API迁移吗?
是的,如果你希望获得新功能和更好的批量折扣。Google在2025年3月与Places API同时将Directions API和Distance Matrix API指定为旧版服务。替代品分别是Routes API(用于导航)和带computeRouteMatrix的Routes API(用于距离矩阵)。迁移独立于Places API迁移,需要单独评估。
作为欧盟开发者继续使用Google Maps API有何GDPR风险?
Google Maps Platform在美国基础设施上处理数据,这意味着使用它涉及GDPR下的跨境数据传输。这需要标准合同条款或依赖欧美数据隐私框架。DPF此前已受到法律挑战,合规风险持续存在。对于医疗、金融科技、政府等受监管行业的开发者,或近期经历过GDPR审计的组织,这种法律风险是一个严峻的持续关切。
从Google Places API迁移到替代方案需要多长时间?
在Google生态系统内迁移到Places API(新版)通常需要一到四周,具体取决于集成的复杂性。迁移到第三方替代方案所需时间类似:主要花在更新端点URL、检查参数差异以及测试地理编码和搜索响应格式上。对于使用MapLibre GL JS作为渲染层的团队,渲染迁移通常是最快的部分。地理编码和搜索API测试是耗费大部分精力的地方。

