Antes de começar: antes de começar a usar a API Places, você precisa de um projeto com uma conta de faturamento, além de estar com a API API Places ativada. Recomendamos ter vários proprietários de projetos e administradores de faturamento, para que você sempre tenha alguém com esses papéis disponíveis na sua equipe. Para saber mais, consulte Configurar no Console do Cloud.
A API Places é um serviço que retorna informações sobre lugares usando solicitações HTTP. Os lugares são definidos nessa API como estabelecimentos, localizações geográficas ou pontos de interesse em destaque.
Apresentação da API
As seguintes solicitações de local estão disponíveis:
- O Place Search retorna uma lista de lugares com base no local ou na string de pesquisa do usuário.
- O Place Details retorna informações mais detalhadas sobre um lugar específico, incluindo avaliações de usuários.
- O Place Photos oferece acesso a milhões de fotos relacionadas a lugares armazenadas no banco de dados do Google Place.
- O Place Autocomplete preenche automaticamente o nome e/ou o endereço de um lugar conforme os usuários digitam.
- O Query Autocomplete fornece um serviço de previsão de consulta para pesquisas geográficas baseadas em texto, retornando consultas sugeridas conforme o tipo de usuário.
Cada um dos serviços é acessado como uma solicitação HTTP e retorna uma resposta JSON ou XML. Todas as solicitações para um serviço do Places precisam usar o protocolo https:// e incluir uma chave de API.
A API Places usa um ID de lugar para identificar um local de maneira exclusiva. Para ver detalhes sobre o formato e o uso desse identificador na API Places e em outras APIs, consulte a documentação de IDs de lugar.
Políticas e termos
Todos os aplicativos que usam a API Places ou o serviço Place Autocomplete precisam atender aos requisitos descritos nas políticas da API Places e nos Termos de Serviço da Plataforma Google Maps. A API Places e o Google Place Autocomplete compartilham a cota de uso conforme descrito na documentação Uso e faturamento da API Places.
Para informações sobre preços e cotas da API Places e do Place Autocomplete, consulte a documentação sobre o uso e faturamento da API Places.