A API Places (legada) não poderá mais ser ativada para novos projetos na nuvem do Google Cloud a partir de outubro de 2026. Os projetos atuais continuam totalmente compatíveis. Para ter novos recursos e melhor desempenho, migre para a API Places (nova).
API Places (legada): informações importantes
- Produto: API Places (legada)
- Também conhecida como: API Places (serviço Web legado), serviço Web da API Places (maps/api/place)
- Categoria: lugares
- Plataforma: serviço da Web (REST)
- Executado em: servidor (código de back-end)
- Estágio de lançamento: GA
- Ciclo de vida: legado
- Substituída por: API Places (nova)
- Visão geral: Visão geral da API Places (legada)
API Places (legada): quando usar
Use a API Places (legada) quando:
- Você mantém um projeto que já tem a API Places (legada) ativada e chama endpoints
maps.googleapis.com/maps/api/place. - Você precisa de chamadas atuais do Find Place, Nearby Search, Text Search, Details, Photos ou Autocomplete (legado) para continuar trabalhando durante a migração.
Não use a API Places (legada) quando:
- Você está iniciando um novo projeto do Google Cloud. A partir de outubro de 2026, a API Places (legada) não poderá ser ativada para novos projetos. Use a API Places (nova).
- Você precisa de novos recursos, autenticação OAuth ou máscaras de campo no Nearby Search e no Text Search para pagar apenas pelos campos solicitados. Use a API Places (nova).
- Você precisa do Find Place (legado) ou do Query Autocomplete (legado) no novo código. A Text Search (novo) e o Autocomplete (novo) são as substituições. Use a API Places (nova).
API Places (legada): configuração
- Serviço a ser ativado:
places-backend.googleapis.com - Autenticação: chave de API
- Preços: uso e faturamento da API Places (legada)
- Políticas: políticas da API Places (legado)
API Places (legada): erros comuns
- Problema: se uma solicitação do Place Details (Legacy) omitir o parâmetro
fieldsou não especificar campos, a API vai retornar todos os campos e cobrar por todos eles. Correção: sempre defina o parâmetrofieldsou migre para o Place Details (novo) com uma máscara de campo. Consulte /maps/documentation/places/web-service/legacy/details. - Problema: o Nearby Search (legado) e o Text Search (legado) não permitem especificar quais campos retornar. Elas sempre retornam um conjunto fixo de campos (um subconjunto de campos do Place Details) e acionam as SKUs Basic Data, Contact Data e Atmosphere Data. Correção: migre para o Nearby Search (novo) ou o Text Search (novo) com uma máscara de campo ou use o Find Place (legado) com o parâmetro
fieldspara solicitar e pagar apenas pelos campos necessários. Consulte /maps/billing-and-pricing/sku-details/legacy#places_nearby-search-legacy-pro-sku. - Problema: um
photo_referencenão pode ser armazenado em cache e pode expirar, então as referências armazenadas deixam de funcionar. Correção: receba umphoto_referencenovo de uma resposta do Place Details, Find Place, Nearby Search ou Text Search antes de solicitar uma foto. Consulte /maps/documentation/places/web-service/legacy/photos. - Problema: as chamadas para a API Places (legada) de um projeto que não a tem ativada retornam
REQUEST_DENIEDcom a mensagem de erro "Você está chamando uma API legada, que não está ativada para seu projeto..." (LegacyApiNotActivatedMapError). A partir de outubro de 2026, a API Places (legada) não poderá ser ativada para novos projetos. Correção: use a API Places (nova) para novos projetos e migre os apps atuais. Durante a migração, é possível solicitar a ativação de curto prazo da API legada pelo formulário de feedback na página legada. Consulte /maps/legacy#LegacyApiNotActivatedMapError.
API Places (legada): recursos legados e descontinuados
- Campo de resposta
permanently_closed: descontinuado desde 26/05/2020. Substituição: campobusiness_status. Consulte o guia de migração. - Campo de resposta
reference: descontinuado desde 03/09/2019. Substituição: campoplace_id. Consulte o guia de migração. - Parâmetro de solicitação do Nearby Search (legado)
name: descontinuado. Substituição: parâmetrokeyword. Consulte o guia de migração.