A API Places permite pesquisar e extrair informações de vários tipos de lugar usando uma string de texto ou por proximidade. A API Places é a versão legado 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 (nova) | Não há uma nova versão do Find Place. O Text Search (novo) substituiu esse recurso. |
| Pesquisa por proximidade (legado) | Pesquisa por proximidade (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 oferece suporte à entrada de texto. |
| Pesquisa de texto (legado) | Pesquisa de texto (nova) | |
| Detalhes do lugar (legado) | Detalhes do lugar (novo) | |
| Place Photo (legado) | Place Photo (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 estes guias de migração:
- Migrar para a Pesquisa por proximidades (novo)
- Migrar para a Pesquisa de texto (novo)
- Migrar para o Place Details (novo)
- Migrar para o Place Photo (novo)
- Migrar para o preenchimento automático (novo)
Principais recursos adicionados à API Places (novo)
Esta seção aborda os principais recursos adicionados à API Places (novo).
Implementado na plataforma padrão do Google Cloud
A API Places (nova) é implementada na infraestrutura de serviços no 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 traz um nível de consistência entre as APIs que melhoram a eficiência do desenvolvimento com a API Places (nova).
Desempenho aprimorado
A API Places (nova) oferece melhor performance, o que torna vantajoso substituir apps que usam a API Places atual.
Precificação simplificada
O preço é simplificado com a API Places (nova), para que você pague apenas pelos dados que usa. O preço simplificado é implementado 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. A cobrança é feita apenas pelos dados solicitados. O uso do 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.
Dados de resposta consistentes para um lugar
Com as APIs atuais, as APIs Place Details, Nearby Search e Text Search retornavam dados de resposta diferentes para um lugar. A API Places (nova) padroniza a resposta para que todas as APIs retornem os mesmos dados para 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 novos tipos. É possível usar esses novos tipos e os existentes em uma pesquisa com a Pesquisa por proximidade (nova) e a Pesquisa de texto (nova). Os novos tipos estão incluídos na tabela A.
Dados dinâmicos de lugares
A API Places (nova) oferece suporte a dados de resposta dinâmicos, como a disponibilidade de uma estação de recarga de VEs ou os preços de combustível mais recentes de um posto de gasolina. Use esses campos de resposta para criar experiências dinâmicas para os usuários.