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) | Pesquisa de texto (novo) | Não há uma nova versão do Find Place (legado). A Pesquisa de texto (nova) substituiu essa opção. |
| Pesquisa nas proximidades (legado) | Nearby Search (novo) | Todas as solicitações que usam a API legada e incluem uma consulta de texto precisam usar a Pesquisa de texto (nova) porque a Pesquisa nas proximidades (nova) não aceita entrada de texto. |
| Pesquisa de texto (legado) | Pesquisa de texto (novo) | |
| Place Details (legado) | Place Details (novo) | |
| Place Photos (legado) | Place Photos (novo) | |
| Place Autocomplete (legado) | Preenchimento automático (novo) | |
| Query Autocomplete (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:
- Migrar para a Pesquisa nas proximidades (novo)
- Migrar para a pesquisa de texto (novo)
- Migrar para o Place Details (novo)
- Migrar para Place Photos (novo)
- Migrar para o preenchimento automático (novo)
Principais recursos adicionados à API Places (novo)
Esta seção aborda os principais recursos adicionados à API Places (New).
Implementado na plataforma padrão do Google Cloud
A API Places (nova) é implementada na infraestrutura de serviços do 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 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 vale a pena substituir apps que usam a API Places atual.
Precificação simplificada
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ó vai receber 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á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 (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, 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 Nearby Search (novo) e Text Search (novo). Os novos tipos estão incluídos na Tabela A.
Dados dinâmicos de lugares
A API Places (New) é compatível com dados de resposta dinâmica, como a disponibilidade de uma estação de recarga de VE ou os preços mais recentes de combustível de um posto de gasolina. Use esses campos de resposta para criar experiências dinâmicas para o usuário.