Visão geral

Selecionar plataforma: Android iOS JavaScript Web Service

Desenvolvedores do Espaço Econômico Europeu (EEE)

Se o endereço de faturamento estiver localizado no Espaço Econômico Europeu, a partir de 8 de julho de 2025 seu uso dos serviços estará sujeito aos Termos de Serviço da Plataforma Google Maps para o EEE. A funcionalidade varia de acordo com a região. Saiba mais.

Antes de começar: para usar o SDK do Places para iOS, você precisa de um projeto com uma conta de faturamento e a API Places ativada. Recomendamos ter vários proprietários de projetos e administradores de faturamento para que sempre haja alguém disponível com essas funções na sua equipe. Para saber mais, consulte Configurar no console do Cloud.

Introdução

O SDK do Places para iOS permite criar apps com reconhecimento de local que respondem contextualmente às empresas locais e outros lugares próximos ao dispositivo. Isso significa que você pode criar apps avançados com base em lugares que significam algo para o usuário.

Observação:a API Places (nova) é a versão atual do SDK do Places para iOS. A documentação legada e os guias de migração estão disponíveis na guia "Legado".

Conceitos

Um lugar é definido como um espaço físico que tem um nome. Outra maneira de pensar em um lugar é que ele é qualquer coisa que você pode encontrar em um mapa. Exemplos incluem empresas locais, pontos de interesse e locais geográficos. Na API, um lugar é representado pelo GMSPlace Class Reference. Ele inclui informações como o nome do lugar e o endereço, a localização geográfica, o ID do lugar, o número de telefone, o tipo de lugar, o URL do site e muito mais.

Observação: sempre que o app mostrar informações sobre lugares originados do SDK do Places para iOS, ele também precisará mostrar todas as atribuições relevantes retornadas pela API. Consulte a documentação sobre como mostrar atribuições.

Visão geral do SDK

Use o SDK do Places para iOS para ajudar seus clientes a explorar onde eles estão e o que está ao redor. O SDK do Places para iOS oferece as seguintes APIs:

SDK do Places para iOS (novo)	Descrição
Place Details (novo)	Retorna informações sobre lugares, incluindo o nome e o endereço do lugar, a localização geográfica, o tipo de lugar (como boate, loja de animais, museu) e muito mais.
Place Photo (novo)	Retorna imagens de alta qualidade de um lugar.
Text Search (novo)	Retorna informações sobre um conjunto de lugares com base em uma pesquisa de texto.
Nearby Search (novo)	Retorna informações sobre um conjunto de lugares especificando um local como uma área de pesquisa.
Autocomplete (novo)	Preenche automaticamente o nome e/ou endereço de um lugar à medida que os usuários digitam.

Outros destaques do SDK incluem:

• Detecção precisa de lugares com baixo consumo de energia com a verificação de Wi-Fi.
• Armazenamento em cache no dispositivo: a maioria das solicitações ao SDK do Places para iOS pode envolver uma viagem de ida e volta a um servidor do Google, mas também é possível armazenar dados localmente por 30 dias.

Políticas e termos

Todos os aplicativos que usam o SDK do Places para iOS precisam obedecer aos requisitos descritos nos Termos de Serviço da Plataforma Google Maps, e na seção Mostrar atribuições.