Visão geral dos exemplos de código

Selecione a plataforma: Android iOS JavaScript

Os apps de demonstração do SDK fornecidos com o SDK do Places para iOS demonstram vários recursos, incluindo o preenchimento automático e as fotos de lugares. Além disso, você pode encontrar snippets de código em cada página 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 Cocoa em Swift e Objective-C.

O SDK do Places para iOS oferece um conjunto de apps de demonstração do SDK que você pode instalar e executar usando o comando pod try:

Siga estas etapas para instalar o CocoaPods e testar o SDK do Places para iOS:

  1. 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
  2. Acesse os arquivos de amostra usando um destes dois métodos:

    Usar arquivos do GitHub

    1. Faça o download do arquivo de exemplo de código do GitHub e descompacte o arquivo.
    2. Abra uma janela do terminal, navegue até o diretório em que você expandiu os arquivos de amostra e veja os detalhes no diretório do Google Places:

      Swift

      cd maps-sdk-for-ios-samples-master/GooglePlaces-Swift

      Objective-C

      cd maps-sdk-for-ios-samples-master/GooglePlaces
    3. Execute este comando:
      pod install
      open GooglePlacesDemos.xcworkspace

    Usar o CocoaPods v1.6.1

    1. Abra uma janela do terminal e instale a versão 1.6.1:
      sudo gem install cocoapods -v1.6.1
    2. Busque os arquivos do Google Places usando o CocoaPods:
      pod try GooglePlaces

      O CocoaPods atualiza seus repositórios de especificações e, em seguida, abre as demonstrações de SDK em um projeto temporário do Xcode, GooglePlacesDemos.xcworkspace.

  3. Ative o SDK do Places para iOS no seu projeto do Console do Google Cloud.
  4. Se você ainda não tiver uma chave de API, siga as instruções para configurar um projeto no Console do Cloud e receber uma chave de API. Ao configurar a chave no Console do Cloud, é possível especificar o identificador do pacote do app para garantir que somente seu app possa usá-la. O identificador de pacote padrão do app de exemplo do SDK é com.example.GooglePlacesDemos.
  5. 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";
  6. Se o Xcode solicitar o desbloqueio do arquivo SDKDemoAPIKey para edição, escolha Desbloquear.
  7. Remova a linha a seguir, se ela estiver presente, porque é usada para registrar o problema:

    Swift

    #error (Registre-se para a chave de API e insira aqui. Em seguida, exclua essa linha.")

    Objective-C

    #error Register your API key and insert here, then delete this line.
  8. Compile e execute o projeto novamente.
  9. Se a versão falhar ou o app falhar com um erro sobre sua chave de API ao executá-la pela primeira vez, verifique se você forneceu as chaves necessárias no arquivo SDKDemoAPIKey.
  10. Se você estiver executando as demonstrações do GooglePlaces, a janela do simulador de iOS mostrará uma lista de demonstrações do Places.
  11. Se você precisar permitir que GooglePlacesDemos acesse sua localização, escolha Permitir.
  12. O exemplo que você escolheu agora está pronto.

Usar snippets de código do guia do desenvolvedor

Cada página no Guia do desenvolvedor inclui snippets de código que ilustram um recurso específico da API. Por exemplo, consulte os guias sobre preenchimento automático, ver o lugar atual, fotos e outras páginas deste guia.