Introdução
A API Places permite 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 elas e migrar para a API Places (nova).
| API Places (legada) | API Places (nova) | Observações |
|---|---|---|
| Find Place (legada) | Text Search (nova) | Não há uma nova versão do Find Place (legada). Ela foi substituída pela Text Search (nova). |
| Nearby Search (legada) | Nearby Search (nova) | Todas as solicitações que usam a API legada e incluem uma consulta de texto precisam usar a Text Search (nova) porque a Nearby Search (nova) não aceita entrada de texto. |
| Text Search (legada) | Text Search (nova) | |
| Place Details (legada) | Place Details (nova) | |
| Place Photos (legada) | Place Photos (nova) | |
| Place Autocomplete (legada) | Autocomplete (nova) | |
| Query Autocomplete (legada) | Autocomplete (nova) | Recursos adicionados ao Autocomplete (nova). |
Migrar para as novas APIs
Para migrar para as novas APIs, consulte os seguintes guias de migração:
- Migrar para a Nearby Search (nova)
- Migrar para a Text Search (nova)
- Migrar para a Place Details (nova)
- Migrar para a Place Photos (nova)
- Migrar para a Autocomplete (nova)
Principais recursos adicionados à API Places (nova)
Esta seção aborda os principais recursos adicionados à API Places (nova).
Implementada na plataforma padrão do Google Cloud
A API Places (nova) é implementada na infraestrutura de serviço do Google Cloud. Essa implementação traz uma plataforma mais segura e confiável com opções de segurança aprimoradas, como OAuth. Esse design de API padrão oferece 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 vale a pena substituir apps que usam a API Places atual.
Preços simplificados
A API Places (nova) simplifica os preços para que você pague apenas pelos dados que usa. Os preços simplificados são implementados usando uma máscara de campo.
Com a Place Details (nova), a Nearby Search (nova) e a Text Search (nova), você usa a máscara de campo para controlar a lista de campos a serem retornados na resposta. Você só será cobrado 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 essas APIs retornem os mesmos dados para 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. É possível usar esses novos tipos e os atuais em uma pesquisa com a Nearby Search (nova) e a Text Search (nova). Os novos tipos estão todos incluídos em Tabela A.
Dados de lugares dinâmicos
A API Places (nova) oferece suporte a dados de resposta dinâmicos, como a disponibilidade de um eletroposto ou os preços mais recentes de combustível para um posto de gasolina. Use esses campos de resposta para criar experiências de usuário dinâmicas.