Os apps de demonstração do SDK fornecidos com o SDK do Places para iOS mostram uma série de recursos, incluindo o Place Autocomplete e de fotos de lugares. Além disso, você pode encontrar snippets de código em todas as páginas deste Guia para desenvolvedores.
Experimente as demonstrações do SDK usando o CocoaPods
O SDK do Places para iOS está disponível como um pod do CocoaPods. O CocoaPods é um gerenciador de dependências de código aberto para projetos Swift e Objective-C da Cocoa.
O SDK do Places para iOS disponibiliza um conjunto de apps de demonstração do SDK que você pode instalar e executar usando o comando pod try
:
- O GooglePlaces demonstra o preenchimento automático de lugares e as fotos de lugares.
Siga estas etapas para instalar o CocoaPods e testar o SDK do Places para iOS:
- Se você ainda não tem essa ferramenta, instale-a no macOS executando o seguinte comando no terminal. Para mais detalhes, consulte o Guia de primeiros passos do CocoaPods.
sudo gem install cocoapods
- Acesse os arquivos de amostra usando um destes dois métodos:
Usar arquivos do GitHub
- Faça o download do arquivo de exemplo de código no GitHub e descompacte o arquivo.
- Abra uma janela do terminal, navegue até o diretório em que você expandiu os arquivos de exemplo e
detalhe o diretório do GooglePlaces:
Swift
cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift
Objective-C
cd maps-sdk-for-ios-samples-master/GooglePlaces
- Execute este comando:
pod install
open GooglePlacesDemos.xcworkspace
Usar o CocoaPods v1.6.1
- Abra uma janela do terminal e instale a versão 1.6.1:
sudo gem install cocoapods -v1.6.1
- Busque os arquivos do Google Places usando o Cocoapods:
pod try GooglePlaces
O CocoaPods atualiza seus repositórios de especificações e abre as demonstrações do SDK em um projeto temporário do Xcode,
GooglePlacesDemos.xcworkspace
.
- Ative o SDK do Places para iOS para seu projeto do Console do Google Cloud.
- Se você ainda não tem uma chave de API, siga as instructions para configurar um projeto no console do Cloud e gerar uma. Ao configurar a chave no console do Cloud, é possível especificar o identificador do pacote do seu app para garantir que somente ele possa usar a chave. O identificador de pacote padrão do
app de exemplos do SDK é
com.example.GooglePlacesDemos
. - Edite o arquivo
SDKDemoAPIKey
e cole sua chave de API na constante apropriada. Exemplo:Swift
let placesAPIKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- Se o Xcode solicitar o desbloqueio do arquivo
SDKDemoAPIKey
para edição, escolha Unlock. - Se estiver presente, remova a linha a seguir, porque ela é usada para registrar o
problema:
Swift
#error (Registre-se para a chave de API e insira aqui. Em seguida, exclua esta linha".
Objective-C
#error Register your API key and insert here, then delete this line.
- Compile e execute o projeto novamente.
- Se o build falhar ou o app falhar com um erro sobre sua chave de API
na primeira execução, verifique se você forneceu as
chaves necessárias no arquivo
SDKDemoAPIKey
. - Se você estiver executando as demonstrações do GooglePlaces, a janela do simulador do iOS mostrará uma lista de demonstrações do Places.
- Se você receber uma solicitação para permitir que o GooglePlacesDemos acesse seu local, escolha Permitir.
- O exemplo que você escolheu agora está pronto.
Usar snippets de código do Guia para desenvolvedores
Todas as páginas do Guia do desenvolvedor contêm snippets de código que ilustram um recurso da API. Por exemplo, consulte os guias sobre preenchimento automático, acessar o lugar atual, fotos e outras páginas neste guia.