Referência rápida da API Places (legada)

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

API Places (legada): erros comuns

  • Problema: se uma solicitação do Place Details (Legacy) omitir o parâmetro fields ou não especificar campos, a API vai retornar todos os campos e cobrar por todos eles. Correção: sempre defina o parâmetro fields ou 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 fields para 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_reference não pode ser armazenado em cache e pode expirar, então as referências armazenadas deixam de funcionar. Correção: receba um photo_reference novo 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_DENIED com 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: campo business_status. Consulte o guia de migração.
  • Campo de resposta reference: descontinuado desde 03/09/2019. Substituição: campo place_id. Consulte o guia de migração.
  • Parâmetro de solicitação do Nearby Search (legado) name: descontinuado. Substituição: parâmetro keyword. Consulte o guia de migração.