Exemplos de código do SDK do Places para iOS

Selecione a plataforma: Android iOS JavaScript

O app de demonstração do SDK do Places para iOS no GitHub fornecido com o SDK do Places para iOS demonstra vários recursos, incluindo o Place Autocomplete e o Place Photos. Além disso, cada página deste guia do desenvolvedor contém snippets de código. Importe e crie o app, adicione sua chave de API, veja a demonstração e use o exemplo de código fornecido como um ponto de partida para o app.

Ao ser executado, o app de exemplo mostra uma lista de exemplos disponíveis para o dispositivo. Selecione uma das opções.

Executar o app de exemplo completo localmente

O app de exemplo do SDK do Places para iOS está disponível como um arquivo de download no GitHub Siga estas etapas para instalar e testar o app de exemplo do SDK do Places para iOS.

  1. Faça o download do arquivo de exemplo de código no GitHub e descompacte-o. Como alternativa, clone o repositório em um diretório local:
    git clone https://github.com/googlemaps-samples/ios-places-sdk-samples.git
  2. Abra uma janela de terminal, navegue até o diretório em que você expandiu os arquivos de exemplo e acesse o diretório da versão que você quer usar:

    SwiftUI

    cd ios-places-sdk-samples/GooglePlacesDemos/
    open GooglePlacesDemos.xcodeproj

    Swift

    cd ios-places-sdk-samples/GooglePlaces-Swift/
    open GooglePlacesSwiftDemos.xcodeproj

    Objective-C

    cd ios-places-sdk-samples/Archive/GooglePlaces
    open GooglePlacesXCFrameworkDemos.xcodeproj
  3. No projeto do Xcode, acesse Arquivo > Adicionar dependências do pacote. Insira https://github.com/googlemaps/ios-places-sdk como o URL, pressione Enter para extrair o pacote e clique em Adicionar pacote.
  4. Ative o SDK do Places para iOS e o SDK do Maps para iOS no projeto do console do Google Cloud.
  5. Receba uma chave de API do seu projeto com a API Places e/ou a API Places (nova) ativada.
  6. Adicione sua chave de API ao app usando as instruções adequadas abaixo.

    SwiftUI

    Crie um arquivo de configuração local chamado GooglePlacesDemos.xcconfig para sua chave de API, no mesmo diretório do arquivo Info.plist do aplicativo de demonstração (GooglePlacesDemos/GooglePlacesDemos).

    Adicione duas linhas ao arquivo de configuração para definir suas chaves de API:

    PLACES_API_KEY = YOUR_PLACES_API_KEY e MAPS_API_KEY = YOUR_MAPS_API_KEY.

    Substitua YOUR_PLACES_API_KEY e YOUR_MAPS_API_KEY pelas chaves de API das etapas anteriores.

    Consulte o formato do arquivo de configurações (xcconfig) para receber ajuda na criação de um arquivo de configuração local.

    Swift

    Edite o arquivo SDKDemoAPIKey e cole sua chave de API na constante apropriada. Exemplo:

    let placesAPIKey = "YOUR_API_KEY"

    Se presente, remova a seguinte linha:

    #error (Register for API Key and insert here. Then delete this line.)

    Se o Xcode solicitar que você desbloqueie o arquivo SDKDemoAPIKey para edição, escolha Desbloquear.

    Objective-C

    Edite o arquivo SDKDemoAPIKey e cole sua chave de API na constante apropriada. Exemplo:

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    Se presente, remova a seguinte linha

    #error (Register for API Key and insert here. Then delete this line.)

    Se o Xcode solicitar que você desbloqueie o arquivo SDKDemoAPIKey para edição, escolha Desbloquear.

  7. Crie o app.
  8. Se a criação 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 nas instruções acima.
  9. Se você executar o app de exemplo, a janela do simulador do iOS vai mostrar uma lista de demonstrações de lugares.
  10. Se solicitado a permitir que o app de demonstração acesse sua localização, escolha Permitir.
  11. O exemplo que você escolheu agora está pronto.