Configuração e demonstração

Selecionar plataforma: Android iOS

Esta página descreve como configurar a biblioteca de utilitários do SDK do Maps para iOS.

Para testar esses utilitários, você pode:

Adicionar a biblioteca de utilitários do SDK do Maps para iOS a um projeto Xcode

Siga estas etapas para adicionar a biblioteca de utilitários ao espaço de trabalho do Xcode:

Usar o Gerenciador de pacotes do Swift

  1. Se você ainda não tiver um projeto Xcode, crie um agora e salve-o no computador local. Se você tem pouca experiência com desenvolvimento para iOS, crie um novo projeto e selecione o modelo de app iOS template. No Xcode 11.7 ou versões anteriores, crie um aplicativo de visualização única.
  2. Adicione o SDK do Maps para iOS como uma dependência. Consulte Instalar o SDK para conferir as opções.
  3. No projeto Xcode, acesse File -> Swift Packages -> Add Package Dependency.
  4. Na janela apresentada, insira o URL do repositório da biblioteca de utilitários do SDK do Maps para iOS https://github.com/googlemaps/google-maps-ios-utils e selecione Next.
    • Nesse momento, talvez seja necessário fazer a autenticação com sua conta do GitHub. Siga as instruções para criar um token de acesso pessoal do GitHub e continuar o processo.
  5. Na próxima janela, selecione a opção de rádio Version, escolha Up to Next Major Version na lista suspensa e insira a versão mais recente da biblioteca de utilitários do SDK do Maps para iOS (por exemplo, "6.0.0").
  6. Clique na lista suspensa ao lado de Add to Project, selecione seu projeto e escolha Add Package.

Adicionar a chave de API ao seu app

Consulte Configurar um projeto Xcode para instruções sobre como gerar uma chave de API e adicioná-la ao projeto Xcode.

Criar e executar o projeto

Depois de adicionar a chave de API, crie e execute o projeto.

Usar um utilitário no app

Consulte a documentação de cada utilitário para mais informações sobre como usá-lo no app:

Instalar e executar o app de demonstração

A biblioteca de utilitários inclui um app de demonstração que pode ser instalado para testar cada utilitário.

Instale o app de demonstração:

Usar arquivos do GitHub

  1. Faça o download do arquivo de exemplo de código no GitHub e descompacte o arquivo. Como alternativa, clone o repositório em um diretório local: 
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. Abra uma janela de terminal, navegue até o diretório em que você extraiu os arquivos de amostra e acesse o diretório de amostras adequado para o idioma que você quer usar:

    Swift

    cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeproj

    Objective-C

    cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj

Adicionar a chave de API ao app de demonstração

Em Acessar uma chave de API, você gera uma chave de API para seu app. Agora, adicione essa chave ao projeto Xcode do app de demonstração.

Swift

Inclua sua chave de API ao AppDelegate.swift da seguinte maneira:

  1. Adicione a seguinte declaração de importação: 
    import GoogleMaps
  2. Edite a linha a seguir para adicionar sua chave de API entre as aspas duplas: 
    // Change this key to a valid key registered with the demo app bundle id.
let mapsAPIKey = ""

Objective-C

Inclua sua chave de API ao AppDelegate.m da seguinte maneira:

  1. Adicione a seguinte declaração de importação: 
    @import GoogleMaps;
  2. Edite a linha a seguir para adicionar sua chave de API entre as aspas duplas: 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

Criar e executar o app de demonstração

Depois de adicionar a chave de API, crie e execute o projeto:

  • Se você estiver executando a versão Swift da demonstração, poderá selecionar qual utilitário será exibido no app.
  • Se você estiver executando a versão Objective-C da demonstração, verá a demonstração do utilitário de clustering de marcadores. Em seguida, edite a versão Objective-C da demonstração para testar cada utilitário. Consulte a seção Adicionar um utilitário ao app abaixo para mais informações.