Introdução
Com a API Places, você pode pesquisar e recuperar informações de vários tipos de lugar 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 Text Search (nova) a substituiu. |
| Nearby Search (legado) | Nearby Search (novo) | Todas as solicitações que usam a API legada e incluem uma consulta de texto precisam usar o Text Search (novo), porque o Nearby Search (novo) não aceita entrada de texto. |
| Text Search (Legacy) | Text Search (novo) | |
| Place Details (legado) | Place Details (novo) | |
| Place Photos (legada) | Place Photos (novo) | |
| Place Autocomplete (legado) | Autocomplete (New) | |
| Query Autocomplete (legado) | Autocomplete (New) | Recursos adicionados ao Autocomplete (novo). |
Migrar para as novas APIs
Para migrar para as novas APIs, consulte os seguintes guias de migração:
- Migrar para o Nearby Search (novo)
- Migrar para a Text Search (New)
- Migrar para Place Details (New)
- Migrar para o Place Photos (novo)
- Migrar para o Autocomplete (novo)
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.