A API do Google Places (Legacy) está congelada: o que desenvolvedores da UE devem fazer antes de o cronômetro começar

O Google congelou a API Places Legacy em março de 2025. Ela ainda funciona, mas não receberá novos recursos, e a descontinuação está chegando. Para desenvolvedores da UE, a decisão de migração é mais complicada do que a documentação do Google sugere.

Em março de 2025, o Google reestruturou silenciosamente sua plataforma de mapas de formas que criaram urgência real para os desenvolvedores, mesmo que a comunicação tenha sido discreta. A API Places Legacy, a API Directions e a API Distance Matrix foram reclassificadas como "serviços Legacy". Ainda funcionam. Continuarão funcionando até que o Google anuncie uma data de descontinuação. Mas foram congeladas.

Sem novos recursos. Sem melhorias de arquitetura. Descontos por volume limitados ao nível de 100.000+, abaixo do que as aplicações maiores precisam. E em algum momento no futuro, um anúncio de descontinuação com 12 meses de aviso.

Para a maioria dos desenvolvedores, a questão não é se migrar. É quando e para onde.

Para desenvolvedores da UE especificamente, o cálculo é diferente. A decisão de migração envolve não apenas compatibilidade de API e preços, mas conformidade com o RGPD, residência de dados e o risco legal da infraestrutura dos EUA que a própria documentação do Google não aborda completamente.

Este guia cobre o que mudou, o que a migração envolve e quais perguntas as equipes da UE devem fazer antes de se comprometer com um caminho.

O que o Google mudou em março de 2025

A reestruturação de março de 2025 teve dois componentes distintos que muitos desenvolvedores confundiram.

Reestruturação de preços: O Google substituiu o crédito mensal fixo de US$ 200 por camadas gratuitas por SKU. Em vez de um único crédito que podia ser aplicado a qualquer combinação de API, cada tipo de API agora tem sua própria camada gratuita:

• API de Geocodificação: 10.000 eventos gratuitos por mês, depois US$ 2-7 por 1.000
• API Maps JavaScript: 10.000 eventos gratuitos por mês
• API Places (New): camada gratuita por tipo de solicitação
• API Routes: camada gratuita por tipo de rota

Para desenvolvedores que usavam intensamente uma única API sob o antigo crédito de US$ 200, o novo modelo pode significar pagar mais. Para desenvolvedores distribuídos em múltiplos tipos de API, as camadas gratuitas por SKU podem reduzir os custos. A única forma de saber é auditar seu uso atual com a nova estrutura de SKU.

Junto com a mudança de preços, o Google lançou planos de assinatura: Starter a US$ 100/mês (50.000 chamadas combinadas), Essentials a US$ 275/mês (100.000 chamadas combinadas) e Pro a US$ 1.200/mês (250.000 chamadas combinadas). Esses planos visam dar previsibilidade em escala, mas adicionam outra camada de complexidade à projeção de custos.

Designações de descontinuação de API: Separadamente, o Google designou três APIs como serviços Legacy:

• API Places (Legacy): substituída pela API Places (New)
• API Directions: substituída pela API Routes
• API Distance Matrix: substituída pela API Routes com computeRouteMatrix

A designação Legacy significa que essas APIs não recebem novos recursos e não são elegíveis para os novos níveis ampliados de desconto por volume. Estão em modo de manutenção.

O que a API Places (New) realmente muda

A API Places (New) não é uma substituição direta. Ela tem um formato de solicitação diferente, estrutura de resposta diferente e modelo de seleção de campos diferente.

A mudança mais significativa é o mascaramento de campos. A API Legacy retorna uma estrutura de resposta fixa. A nova API exige que você especifique quais campos precisa por meio de um cabeçalho de máscara de campo. Isso reduz a transferência desnecessária de dados e significa que você paga apenas pelos campos que solicita, mas também significa que cada chamada de API no seu código precisa ser atualizada com máscaras de campo explícitas.

Principais diferenças que os desenvolvedores encontram durante a migração:

Formato de solicitação: A nova API usa solicitações POST com um corpo JSON em vez de solicitações GET com parâmetros de consulta. Se sua integração constrói chamadas baseadas em URL, cada chamada precisa ser reestruturada.

Estrutura de resposta: Os nomes dos campos mudaram. formatted_address passa a ser formattedAddress (camelCase). place_id passa a ser id. O objeto geometry é reestruturado. O código de análise de resposta precisa ser auditado em todo o código.

Novos recursos exclusivos da API Places (New): Resumos gerados por IA, novos campos de dados para estações de carregamento de veículos elétricos, preços de combustível, detalhes de acessibilidade e sugestões de preenchimento automático aprimoradas. Se você precisa de algum desses recursos, precisa migrar.

Gerenciamento de fotos: O formato de referência de fotos mudou. As URLs de fotos geradas pela API Legacy vão parar de funcionar eventualmente, portanto qualquer referência de foto em cache precisa ser regenerada.

O Google fornece guias de migração, mas a experiência prática é que a migração é uma tarefa de engenharia significativa, não uma mudança de configuração. As equipes geralmente orçam de uma a quatro semanas dependendo da complexidade da integração.

A migração da API Routes (separada mas relacionada)

A API Directions e a API Distance Matrix seguem um padrão similar. O substituto é a API Routes, que usa um formato de solicitação/resposta diferente e oferece recursos que as APIs Legacy não têm: roteamento com informações de tráfego, modificadores de rota, suporte para veículos de duas rodas e otimização de eficiência de combustível.

A API Routes também tem preços diferentes. A API Directions Legacy cobrava por elemento (par origem-destino). A API Routes cobra por solicitação de rota e por elemento em solicitações de matriz. Para aplicações que fazem grandes volumes de solicitações de matriz, os custos podem mudar significativamente.

Se você está migrando a API Places, vale a pena planejar a migração da API Routes ao mesmo tempo, em vez de executar duas migrações separadas. O esforço paralelo é mais eficiente do que migrações sequenciais, cada uma com seus próprios ciclos de teste e implantação.

As considerações específicas da UE

É aqui que a decisão de migração se torna mais complexa para desenvolvedores europeus do que a documentação do Google sugere.

RGPD e transferências de dados transfronteiriças

O Google Maps Platform é infraestrutura dos EUA. Quando o navegador de um usuário faz uma solicitação à API Places ou carrega um mapa, essa solicitação passa pelos servidores do Google nos EUA. Sob o RGPD, isso é uma transferência de dados transfronteiriça.

A base legal atual para essas transferências é o Marco de Privacidade de Dados UE-EUA, que substituiu o acordo Privacy Shield invalidado pela decisão Schrems II em 2020. O MPD foi desafiado legalmente e sua estabilidade de longo prazo não está garantida. Para empresas em setores regulados (saúde, fintech, serviços jurídicos, aplicações governamentais), a dependência contínua da infraestrutura dos EUA é uma conversa de conformidade em andamento que requer monitoramento.

O uso das APIs do Google Maps também requer consentimento de cookies para a API JavaScript em algumas implementações, já que endereços IP de usuários e identificadores de dispositivos são enviados ao Google. Para aplicações que querem carregar mapas sem acionar um banner de consentimento, a infraestrutura hospedada nos EUA cria um problema estrutural.

O Google atualizou seus Termos de Serviço do Maps Platform para o EEE em 2025 para se aplicar especificamente a endereços de cobrança da UE. Os desenvolvedores devem revisar os termos atualizados em relação aos seus requisitos de DPA.

Simplificação da conformidade como gatilho de migração

Para muitas equipes da UE, as mudanças de março de 2025 forneceram um gatilho prático para reavaliar se permanecer no ecossistema do Google ou migrar para uma alternativa hospedada na UE.

O argumento de negócio para a reavaliação é direto: se você vai investir tempo de engenharia em uma migração de qualquer forma (da API Places Legacy para a API Places New), o esforço adicional marginal para migrar para um provedor diferente é frequentemente menor do que parece. As mudanças de endpoint de API, o trabalho de mapeamento de campos e os ciclos de teste são em grande parte os mesmos tanto se você está migrando para a nova API do Google quanto para uma alternativa de terceiros. A diferença está no que você obtém quando terminar.

Uma API de mapas hospedada na UE elimina completamente a preocupação com transferência transfronteiriça de dados do RGPD. Todas as solicitações ficam dentro da UE. Sem CCPs para negociar, sem dependência do MPD, sem necessidade de consentimento de cookies para carregar um mapa. Para empresas que concluíram recentemente auditorias de RGPD ou as antecipam, essa simplificação tem valor organizacional real.

Como avaliar se migrar dentro do Google ou trocar de provedor

O framework honesto para essa decisão tem quatro partes.

1. Audite seu uso atual de API

Antes de tomar qualquer decisão, mapeie cada chamada de API Places, API Directions e API Distance Matrix no seu código. Conte o volume por tipo de endpoint. Mapeie isso tanto para o modelo de preços da API Places (New) quanto para endpoints equivalentes em provedores alternativos candidatos.

A comparação de custos só faz sentido com dados de uso reais. Estimativas aproximadas baseadas no volume total de solicitações não são suficientes porque diferentes APIs dentro do mesmo provedor têm preços distintos.

2. Avalie sua exposição ao RGPD

Pergunte à sua equipe jurídica ou de conformidade quanto risco contínuo a dependência da infraestrutura dos EUA representa para seu contexto específico. Para um produto SaaS com clientes empresariais da UE que têm DPAs em vigor, o nível de risco é diferente do de uma aplicação de consumo que processa dados pessoais sensíveis.

Se a simplificação da conformidade tem valor, atribua um custo a ela. A sobrecarga jurídica interna de manter CCPs, monitorar a estabilidade do MPD e lidar com questionários de conformidade de clientes é trabalho real com custo real.

3. Avalie o esforço de migração para cada caminho

Migrar para a API Places (New) dentro do Google: estime com base na complexidade da sua integração. Mudanças de mascaramento de campos, reestruturação de solicitações, atualizações de análise de resposta. Normalmente de uma a quatro semanas de esforço de engenharia.

Migrar para uma alternativa de terceiros: escopo de engenharia similar. Mudanças de URL de endpoint, diferenças de parâmetros, diferenças de formato de resposta. Para equipes que já usam MapLibre GL JS como camada de renderização (o fork de código aberto do Mapbox GL JS), a camada de renderização permanece a mesma. Apenas as chamadas de geocodificação, busca e roteamento mudam.

4. Considere o que você obtém do outro lado

A API Places (New) dá acesso aos recursos mais recentes do Google: melhor preenchimento automático, resumos gerados por IA, dados de lugares expandidos. A cobertura de dados do Google é incomparável globalmente.

Alternativas hospedadas na UE como o MapAtlas oferecem conformidade com RGPD por design, residência de dados na UE e, em alguns casos, ferramentas de visibilidade em busca por IA que as APIs do Google não fornecem. Para aplicações em imóveis, hotelaria ou logística onde a capacidade de descoberta por IA das páginas de localização importa, a camada de visibilidade em IA é um diferencial significativo.

Nenhum caminho é universalmente correto. A resposta certa depende dos seus requisitos de conformidade, sensibilidade a preços e quais recursos são mais importantes para sua aplicação.

O que fazer agora

Independentemente do caminho de migração que você escolher, várias ações fazem sentido imediatamente:

Audite e documente sua superfície de API atual: Saiba exatamente quais endpoints Legacy você usa, com que frequência e de quais campos de dados depende. Essa informação é necessária para qualquer decisão de migração.

Execute a comparação de preços com números reais: Use seus dados de uso reais para comparar os preços Legacy, os preços da API Places (New) e os provedores alternativos. Faça isso no seu volume atual e no dobro do seu volume atual.

Verifique sua documentação de RGPD: Revise seu DPA atual com o Google, suas CCPs ou dependência do MPD, e sua implementação de consentimento de cookies. Entenda sua posição legal atual antes de alterá-la.

Não migre sob pressão de tempo: A API Legacy ainda funciona. Está congelada, não quebrada. Tome a decisão de migração com dados claros e margem de engenharia adequada, em vez de se apressar por urgência percebida. O anúncio de descontinuação dará 12 meses de aviso.

Defina um prazo de decisão: "Quando o Google anunciar a descontinuação" não é um plano. Defina um ponto de decisão interno sobre qual caminho de migração você vai tomar, idealmente dentro do próximo trimestre.

Se você quiser comparar como são realmente as APIs de mapas hospedadas na UE em termos de superfície de API, preços e esforço de migração, o MapAtlas cobre geocodificação, preenchimento automático de endereços, roteamento e tiles de mapa em um único modelo de preços com residência de dados na UE. A página de preços mostra a estrutura de níveis atual, e a camada gratuita (10.000 solicitações por mês para a maioria das APIs, 25.000 para geocodificação) permite testar a integração antes de se comprometer.

Perguntas frequentes

Quando o Google vai descontinuar a API Places Legacy?

O Google não definiu uma data final de descontinuação no início de 2026. A API Legacy foi congelada em março de 2025 e não recebe mais novos recursos. A política do Google é fornecer pelo menos 12 meses de aviso antes da descontinuação. Trate a migração como urgente, mas não como emergência.

A API Places (New) é mais cara do que a API Places Legacy?

Depende do seu padrão de uso. As novas camadas gratuitas por SKU beneficiam alguns perfis de uso e prejudicam outros. Mapeie suas chamadas de API atuais para a nova estrutura de SKU com seus dados de uso reais antes de tirar conclusões.

Também preciso migrar da API Directions?

Sim, se você quiser novos recursos e melhores descontos por volume. A API Directions e a API Distance Matrix foram ambas designadas como serviços Legacy em março de 2025. O substituto é a API Routes, que requer sua própria avaliação de migração separada.

Qual é o risco de RGPD de continuar com as APIs do Google Maps como desenvolvedor da UE?

O Google Maps Platform usa infraestrutura dos EUA, o que requer mecanismos de transferência de dados transfronteiriças sob o RGPD. A base atual é o Marco de Privacidade de Dados UE-EUA, que foi desafiado legalmente. Para setores regulados, isso é um risco de conformidade contínuo que requer monitoramento.

Quanto tempo leva a migração para um provedor alternativo?

O esforço de engenharia é similar à migração dentro do Google: de uma a quatro semanas dependendo da complexidade da integração, principalmente gasto em atualizações de endpoint, diferenças de parâmetros e testes de formato de resposta. Equipes que usam MapLibre GL JS para renderização têm o caminho de migração mais simples, já que a camada de renderização permanece a mesma.

Conclusão

As mudanças de março de 2025 colocaram um reloj no uso da API Places Legacy sem iniciar oficialmente a contagem regressiva. A API ainda funciona. A data de descontinuação não foi anunciada. Mas a direção está clara, e a migração será menos dolorosa com planejamento adequado do que com urgência.

Para desenvolvedores da UE, o momento da migração é também um momento de avaliação. O esforço de engenharia para alterar endpoints de API é em grande parte o mesmo tanto se você está ficando dentro do Google quanto migrando para uma alternativa hospedada na UE. A diferença significativa está no que você leva adiante: o conjunto de dados global abrangente do Google e os recursos mais recentes, ou conformidade com RGPD por design, preços mais simples e residência de dados na UE.

Essa é uma decisão que vale a pena tomar deliberadamente, com dados de uso reais e uma visão clara dos seus requisitos de conformidade, em vez de seguir o caminho de menor resistência imediata.

Leitura relacionada:

• Alternativas à API do Google Maps para desenvolvedores da UE
• Guia do desenvolvedor da UE para APIs de mapas compatíveis com RGPD
• Preços da API do Google Maps em 2026: o que você realmente paga
• Migrando da API do Google Maps: o que desenvolvedores da UE escolhem
• API de preenchimento automático de endereços: como melhora a conversão no checkout