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 1º de março de 2025. 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$ 5 por 1.000, caindo para US$ 0,38 por 1.000 acima de 5 milhões
- 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.
Em novembro de 2025, o Google adicionou 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 cobra por solicitação e a API Distance Matrix Legacy por elemento (par origem-destino). A API Routes mantém a mesma divisão, cobrando solicitações de rota por solicitação e solicitações de matriz por elemento, mas com novos SKUs e preços. 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 é operado por um grupo com sede nos EUA, e o Google pode processar dados de solicitações em servidores fora da UE. Sob o RGPD, isso o torna uma possível transferência para um país terceiro.
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 contestado legalmente: o Tribunal Geral da UE o manteve em setembro de 2025, e essa decisão agora está em recurso no Tribunal de Justiça, então 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 introduziu Termos de Serviço do Google Maps Platform para o EEE próprios, em vigor desde 8 de julho de 2025, para clientes com endereço de cobrança no Espaço Econômico Europeu. 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 é operado por um grupo com sede nos 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
- API de preenchimento automático de endereços: como melhora a conversão no checkout
Perguntas frequentes
Quando o Google vai descontinuar a API Places Legacy?
O Google não definiu uma data final de descontinuação para a API Places Legacy no início de 2026. No entanto, a política do Google para serviços Legacy promete 12 meses de aviso antes que um serviço Legacy seja desativado. A API Legacy foi designada como 'serviço Legacy' em março de 2025, o que significa que não recebe mais novos recursos e os descontos por volume estão limitados ao nível de 100.000+. Os desenvolvedores devem tratar a migração como urgente mesmo sem um prazo definitivo.
A API Places (New) é mais cara do que a API Places Legacy?
Depende do seu padrão de uso. A API Places (New) usa um modelo de preços diferente, com camadas gratuitas por SKU em vez do antigo crédito mensal de US$ 200. Para alguns perfis de uso, os custos são similares ou menores. Para outros, especialmente desenvolvedores que dependiam do crédito fixo para cobrir múltiplos tipos de API, o novo modelo pode ser mais caro. A única forma de saber com certeza é mapear suas chamadas de API atuais para a nova estrutura de SKU e fazer os cálculos antes de migrar.
Também preciso migrar da API Directions?
Sim, se você quiser acesso a novos recursos e melhores descontos por volume. O Google designou a API Directions e a API Distance Matrix como serviços Legacy ao mesmo tempo que a API Places, em março de 2025. Os substitutos são a API Routes (para rotas) e a API Routes com computeRouteMatrix (para matriz de distâncias). A migração é separada da migração da API Places e requer sua própria avaliação.
Qual é o risco de conformidade com o RGPD de continuar usando as APIs do Google Maps como desenvolvedor da UE?
O Google Maps Platform é operado por um grupo com sede nos EUA que pode processar dados fora da UE, o que significa que seu uso envolve possíveis transferências de dados transfronteiriças sob o RGPD. Isso requer Cláusulas Contratuais Padrão ou dependência do Marco de Privacidade de Dados UE-EUA. O MPD foi desafiado legalmente antes e continua sendo um risco de conformidade. Para desenvolvedores em setores regulados (saúde, fintech, governo) ou organizações que passaram recentemente por auditorias de RGPD, essa exposição legal é uma preocupação séria e contínua.
Quanto tempo leva a migração da API do Google Places para uma alternativa?
Migrar para a API Places (New) dentro do ecossistema do Google normalmente leva de uma a quatro semanas dependendo da complexidade da sua integração. Migrar para uma alternativa de terceiros leva um tempo similar: principalmente gasto na atualização de URLs de endpoints, revisão de diferenças de parâmetros e teste de formatos de resposta de geocodificação e busca. Para equipes que usam MapLibre GL JS como camada de renderização, a migração da renderização costuma ser a parte mais rápida. Os testes das APIs de geocodificação e busca são onde se concentra a maior parte do esforço.
