Visão geral da API Places (legada)

Desenvolvedores do Espaço Econômico Europeu (EEE)

Introdução

Com a API Places, é possível pesquisar e recuperar informações de vários tipos de lugares usando uma string de texto ou por proximidade. A API Places (legada) é a versão legada da API Places (nova).

A tabela a seguir lista as versões correspondentes das duas APIs. Use este guia para entender as principais diferenças entre as duas e migrar para a API Places (nova).

API Places (legada) API Places (nova) Observações
Find Place (legado) Text Search (novo) Não há uma nova versão do Find Place (legado). A Pesquisa de texto (nova) substituiu essa opção.
Nearby Search (legado) Nearby Search (novo) Todas as solicitações que usam a API legada e incluem uma consulta de texto precisam usar a Text Search (New) porque a Nearby Search (New) não aceita entrada de texto.
Pesquisa de texto (legada) Text Search (novo)
Detalhes do lugar (legado) Detalhes do lugar (novo)
Place Photos (legado) Place Photos (novo)
Place Autocomplete (legado) Preenchimento automático (novo)
Preenchimento automático de consultas (legado) Preenchimento automático (novo) Recursos adicionados ao preenchimento automático (novo).

Migrar para as novas APIs

Para migrar para as novas APIs, consulte os seguintes guias de migração:

Principais recursos adicionados à API Places (nova)

Esta seção aborda os principais recursos adicionados à API Places (New).

Implementado na plataforma padrão do Google Cloud

A API Places (New) é implementada na infraestrutura de serviços do Google Cloud. Essa implementação traz um plataforma mais segura e confiável com opções de segurança aprimoradas, como OAuth. Esse design padrão de API traz um nível de consistência entre as APIs que melhora a eficiência do desenvolvimento com a API Places (New).

Desempenho aprimorado

A API Places (nova) oferece melhor performance, o que torna interessante substituir os apps que usam a API Places atual.

Preços simplificados

Os preços são simplificados com a API Places (nova) para que você pague apenas pelos dados que usa. Os preços simplificados são implementados usando uma máscara de campo.

Com o Place Details (novo), o Nearby Search (novo) e o Text Search (novo), você usa a máscara de campo para controlar a lista de campos a serem retornados na resposta. Assim, você só recebe cobranças pelos dados solicitados. Usar mascaramento de campo é uma boa prática de design para garantir que você não solicite dados desnecessários, o que ajuda a evitar tempo de processamento e cobranças desnecessários.

Dados de resposta consistentes para um lugar

Com as APIs legadas, as APIs Place Details (legada), Nearby Search (legada) e Text Search (legada) retornavam dados de resposta diferentes para um lugar. A API Places (New) padroniza a resposta para que todas as APIs retornem os mesmos dados de um lugar.

Tipos de lugares expandidos

A resposta da API agora pode conter o tipo principal de um lugar. Cada lugar pode ter um único valor de tipo especificado como o tipo principal do lugar, conforme listado na Tabela A.

A nova API também inclui vários tipos novos. Você pode usar esses novos tipos e os atuais em uma pesquisa com a Nearby Search (New) e a Text Search (New). Os novos tipos estão incluídos na Tabela A.

Dados dinâmicos de lugares

A nova API Places oferece suporte a dados de resposta dinâmica, como a disponibilidade de um eletroposto ou os preços mais recentes de combustíveis em um posto de gasolina. Use estes campos de resposta para criar experiências dinâmicas para os usuários.