Configuração e demonstração

Selecione a plataforma: Android iOS

Nesta página, descrevemos como configurar a biblioteca de utilitários do SDK do Maps para iOS.

Para testar esses utilitários, você pode:

Como opção, instale o CocoaPods

A biblioteca de utilitários está disponível como um pod do CocoaPods chamado Google-Maps-iOS-Utils. O CocoaPods é um gerenciador de dependências de código aberto para projetos Cocoa em Swift e Objective-C.

Se você ainda não tem a ferramenta CocoaPods, instale-a no macOS executando o seguinte comando no terminal:

sudo gem install cocoapods

Para mais detalhes, consulte o Guia de primeiros passos do CocoaPods (em inglês).

Instalar e executar o app de demonstração

A biblioteca de utilitários inclui um aplicativo de demonstração que você pode instalar e testar.

Instale o app de demonstração usando um destes dois métodos:

Usar arquivos do GitHub

  1. Faça o download do arquivo de exemplo de código no GitHub e descompacte o arquivo.
  2. Abra uma janela do terminal, navegue até o diretório em que você expandiu os arquivos de exemplo e detalhe o diretório de exemplos apropriado para a linguagem que você quer usar:
    • Para Swift, execute cd google-maps-ios-utils-master/samples/SwiftDemoApp
    • Para Objective-C, execute cd google-maps-ios-utils-master/samples/ObjCDemoApp.
  3. Execute este comando:
    pod install
  4. Feche o Xcode e clique duas vezes no arquivo .xcworkspace do projeto para iniciar o Xcode. A partir desse momento, use o arquivo .xcworkspace para abrir o projeto.

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 Maps usando o Cocoapods: 
    pod try Google-Maps-iOS-Utils

    Quando solicitado, escolha Swift ou Objective-C. O CocoaPods atualiza seus repositórios de especificações e, em seguida, abre a demonstração em um projeto temporário do Xcode chamado SwiftDemoApp.xcodeproj ou ObjCDemoApp.xcodeproj.

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

Em Gerar uma chave de API, gere 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 instrução de importação: 
    import GoogleMaps
  2. Edite a linha a seguir para adicionar sua chave de API entre 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 instrução de importação: 
    @import GoogleMaps;
  2. Edite a linha a seguir para adicionar sua chave de API entre 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 exibir no app.
  • Se você estiver executando a versão Objective-C da demonstração, será exibida a demonstração do utilitário de clustering de marcadores. Em seguida, edite a versão em Objective-C da demonstração para experimentar cada utilitário. Consulte a seção Adicionar um utilitário ao app abaixo para ver mais informações.

Instalar a biblioteca de utilitários como um projeto Xcode

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

Usar o CocoaPods

  1. Se você ainda não tiver um projeto Xcode, crie um agora e salve-o na sua máquina local. Se você não tem experiência com o desenvolvimento para iOS, crie um aplicativo de visualização única.
  2. Se você ainda não tiver um arquivo pod para o projeto, crie um arquivo chamado Podfile no diretório do projeto. Esse arquivo define as dependências do seu projeto.
  3. Edite o arquivo pod do projeto e adicione uma dependência ao pod Google-Maps-iOS-Utils. Este exemplo inclui as dependências necessárias para o SDK do Maps para iOS e a biblioteca de utilitários: 
    source 'https://github.com/CocoaPods/Specs.git'
platform :ios, '13.0'

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '7.4.0'
  pod 'Google-Maps-iOS-Utils', '4.2.2'
end
  4. Execute pod install.
  5. Feche o Xcode e clique duas vezes no arquivo .xcworkspace do projeto para iniciar o Xcode. A partir desse momento, use o arquivo .xcworkspace para abrir o projeto.

Observação:o utilitário de clustering de marcadores depende do quadtree, mas é possível usar o quadtree sem clustering de marcadores. Se você quiser apenas o utilitário quadtree, altere pod 'Google-Maps-iOS-Utils' para 'Google-Maps-iOS-Utils/QuadTree' no arquivo pod.

Usar o Cartago

  1. Instale o Carthage. Há vários métodos. Portanto, consulte o arquivo README do Carthage para ver as etapas exatas.
  2. 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. No Xcode 11.7 ou versões anteriores, crie um aplicativo de visualização única.
  3. Crie um arquivo chamado Cartfile no seu diretório do projeto Esse arquivo define as dependências do seu projeto.
  4. Edite o Cartfile e adicione a dependência da biblioteca de utilitários do SDK do Maps para iOS:
    github "googlemaps/google-maps-ios-utils"
  5. Salve o Cartfile.
  6. Em uma janela de terminal, acesse o diretório que contém Cartfile:
    cd <path-to-project>
  7. Execute o comando de atualização:
    carthage update --platform iOS

    Isso vai instalar as APIs especificadas no Cartfile e as respectivas dependências.
  8. No Finder, no diretório do seu projeto, acesse os arquivos de framework baixados em Carthage/Build/iOS.
  9. Para adicionar os frameworks do SDK do Maps para iOS ao seu projeto, arraste os pacotes a seguir. Quando solicitado, selecione Copiar itens se necessário, use a mesma versão acima.
    • GoogleMaps-x.x.x/Base/Frameworks/GoogleMapsBase.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMaps.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsCore.framework
    • GoogleMaps-x.x.x/Maps/Frameworks/GoogleMapsUtils.framework
  10. Clique com o botão direito do mouse em GoogleMaps.framework no projeto e selecione Show In Finder.
  11. Arraste Carthage/Build/iOS/GoogleMaps.framework/Resources/GoogleMaps.bundle da pasta Resources para seu projeto. Quando solicitado, verifique se Copy items into destination group's folder não está selecionado.
  12. Selecione o projeto no Project Navigator e escolha o local de destino do aplicativo.
  13. Abra a guia Fases de build do destino do aplicativo e, em Vincular binário com bibliotecas, adicione os seguintes frameworks:
    • Accelerate.framework
    • CoreData.framework
    • CoreGraphics.framework
    • CoreImage.framework
    • CoreLocation.framework
    • CoreTelephony.framework
    • CoreText.framework
    • GLKit.framework
    • ImageIO.framework
    • libc++.tbd
    • libz.tbd
    • OpenGLES.framework
    • QuartzCore.framework
    • SystemConfiguration.framework
    • UIKit.framework

  14. Escolha seu projeto, em vez de um destino específico, e abra a guia Build Settings. Na seção Other Linker Flags, adicione -ObjC. Se essas configurações não estiverem visíveis, altere o filtro na barra Build Settings de Basic para All.

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 o desenvolvimento para iOS, crie um novo projeto e selecione o Modelo de app iOS. No Xcode 11.7 ou anterior, crie um aplicativo de visualização única.
  2. Adicione o SDK do Maps para iOS como uma dependência. Consulte Como instalar o SDK para mais opções.
  3. No seu projeto do 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 Próxima.
    • Nesse momento, talvez seja necessário autenticar com sua conta do GitHub. Siga as instruções para criar um token de acesso pessoal do GitHub e continuar o processo.
  5. Na janela seguinte, escolha a opção Versão, escolha Exata na lista suspensa, insira a versão mais recente da biblioteca de utilitários do SDK do Maps para iOS (por exemplo, "3.4.0") e selecione Próxima.

Adicionar a chave de API ao seu app

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

Criar e executar o projeto

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

Adicionar um utilitário ao app

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