Informações gerais

Selecione a plataforma: Android iOS JavaScript Serviço da Web

Antes de começar : antes de começar a usar o SDK do Places para iOS, você precisa ter um projeto com uma conta de faturamento e ativar a API Places . 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

Com o SDK do Places para iOS, você pode criar apps com reconhecimento de local que respondem contextualmente às empresas locais e a 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.

conceitos

Um lugar é definido como um espaço físico que tem um nome. Outra maneira de pensar em um lugar é como tudo o que pode ser encontrado em um mapa. Por exemplo, empresas locais, pontos de interesse e localizações geográficas. Na API, um local é representado por GMSPlace Class Reference. Ele inclui informações como o nome e endereço do local, a localização geográfica, o ID do lugar, o número de telefone, o tipo do lugar, o URL do site e muito mais.

Observação:sempre que seu app exibe informações sobre locais provenientes do SDK do Places para iOS, ele também precisa mostrar todas as atribuições relevantes retornadas pela API. Consulte a documentação sobre exibição de atribuições.

Escolha sua versão do SDK

A versão 8.5.0 do SDK do Places é compatível com duas versões: o SDK do Places para iOS e o SDK do Places para iOS (novo), a próxima geração.

Sua primeira tarefa é decidir qual SDK usar. Isso é válido se você é um cliente novo ou atual que já usa o SDK. Para saber quais são as principais diferenças entre as duas versões do SDK, consulte Escolher a versão do SDK.

Preços de cada versão do SDK

A versão escolhida do SDK controla os preços do Text Search. O SDK do Places para iOS (novo) é compatível com um modelo simplificado de preços. Assim, você paga apenas pelos dados que usar. Para informações detalhadas sobre preços de ambos os SDKs, consulte Uso e faturamento.

Observação : os preços do Place Details, Place Autocomplete, Photos e Current Place são os mesmos para os dois SDKs.

Visão geral da API

Ajude seus clientes a explorar onde eles estão e o que há ao redor:

• Place Details retorna informações sobre lugares, incluindo o nome e o endereço do local, a localização geográfica especificada como coordenadas de latitude e longitude, o tipo de lugar (como boate, pet shop, museu) e muito mais.
• Current Place retorna uma lista de locais em que o dispositivo do usuário foi localizado pela última vez, além de uma indicação da probabilidade relativa de cada lugar.
• O Place Autocomplete preenche automaticamente o nome e/ou endereço de um lugar conforme as pessoas digitam.
• Place Photos retorna imagens de alta qualidade de um lugar.
• IDs de lugar armazenam o ID exclusivo de um ou mais locais para recuperação de informações sob demanda.
• Text Search (Pesquisa por texto) para retornar informações sobre um conjunto de lugares com base em uma pesquisa de texto.

Outros destaques da API:

• Detecção precisa do local com baixa potência com busca por Wi-Fi.
• Armazenamento em cache no dispositivo: a maioria das solicitações ao SDK do Places para iOS pode envolver um envio de ida e volta a um servidor do Google, mas você também pode armazenar os dados em cache localmente por 30 dias.

Políticas e termos

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