Por que migrar para a API Places (nova)?

A API Places (nova) oferece melhor desempenho e mais funcionalidades em comparação com a API Places (legada). Use este guia para entender as principais diferenças entre as duas versões da API Places e como lidar com as mudanças necessárias. Para mais detalhes sobre outros recursos da API Places (nova), consulte a visão geral do produto.

Principais recursos adicionados à API Places (nova)

Nesta seção, abordamos os principais recursos adicionados à API Places (nova).

Implementado na plataforma padrão do Google Cloud

A API Places (nova) é implementada na infraestrutura de serviço.

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

Desempenho aprimorado

A API Places (nova) oferece melhor desempenho, o que torna vantajoso substituir 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 usar. 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 que serão retornados na resposta. Assim, você só recebe cobranças pelos dados solicitados. O uso da máscara 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árias.

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 (nova) padroniza a resposta para que todas essas APIs retornem os mesmos dados de um lugar.

Tipos de lugar 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, 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 o Nearby Search (novo) e o Text Search (novo). Os novos tipos estão incluídos na Tabela A.

Dados dinâmicos de lugares

A API Places (nova) é compatível com dados de resposta dinâmicos, como a disponibilidade de um eletroposto ou os preços mais recentes de um posto de combustível. Use esses campos de resposta para criar experiências dinâmicas para os usuários.