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ê extraiu os arquivos de amostra e detalhe 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 Add Package.
  4. Ative o SDK do Places para iOS no projeto do console do Google Cloud.
  5. Receba uma chave de API do seu projeto com a API Places e/ou API Places (nova) ativada.
  6. Adicione a 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 uma linha ao arquivo de configuração para definir a chave de API:

    PLACES_API_KEY = YOUR_PLACES_API_KEY

    Substitua YOUR_PLACES_API_KEY pela chave de API das etapas anteriores.

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

    Swift

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

    let placesAPIKey = "YOUR_API_KEY"

    Se estiver presente, remova a seguinte linha:

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

    Se o Xcode pedir para desbloquear o arquivo SDKDemoAPIKey para edição, escolha Desbloquear.

    Objective-C

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

    static NSString *const kAPIKey = @"YOUR_API_KEY";

    Se estiver presente, remova a seguinte linha:

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

    Se o Xcode pedir para desbloquear o arquivo SDKDemoAPIKey para edição, escolha Desbloquear.

  7. Crie o app.
  8. Se o build falhar ou o app falhar com um erro sobre sua chave de API ao ser executado pela primeira vez, 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 do Places.
  10. Se for solicitado que você permita que o app de demonstração acesse sua localização, escolha Permitir.
  11. O exemplo que você escolheu agora está pronto.