Configuração e demonstração

Selecione a 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 do Xcode

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

Usar o Swift Package Manager

  1. Se você ainda não tiver um projeto Xcode, crie um agora e salve-o no computador local. Se você não tem 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.
  2. Adicione o SDK do Maps para iOS como uma dependência. Consulte Como instalar o SDK para conferir as opções.
  3. No projeto do Xcode, navegue até 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 ponto, 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, selecione 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 no menu suspenso ao lado de Adicionar ao projeto, selecione seu projeto e clique em Adicionar pacote.

Usar o CocoaPods

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

target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
  use_frameworks!
  pod 'GoogleMaps', '9.0.0'
  pod 'Google-Maps-iOS-Utils', '6.1.0' # x-release-please-version
end
  4. Execute pod install.
  5. Feche o Xcode e clique duas vezes no arquivo .xcworkspace do projeto para iniciar o programa. Depois disso, é preciso usar o arquivo .xcworkspace para abrir o projeto.

Observação:o utilitário de agrupamento de marcadores depende do quadtree, mas você pode usar o quadtree sem o agrupamento de marcadores. Se você quiser usar apenas o utilitário quadtree, mude pod 'Google-Maps-iOS-Utils' para 'Google-Maps-iOS-Utils/QuadTree' no arquivo do pod.

Adicionar a chave de API ao seu app

Consulte Configurar um projeto do Xcode para instruções sobre como gerar uma chave de API e adicioná-la ao projeto do 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 seu app:

Instalar e executar o app de demonstração

A biblioteca de utilitários inclui um app de demonstração que pode ser instalado e testado.

Instale o app de demonstração:

Usar arquivos do GitHub

  1. Faça o download do arquivo de amostra 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 navegue até o diretório de exemplos adequado para o idioma 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 programa. Depois disso, é preciso usar o arquivo .xcworkspace para abrir o projeto.

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

Em Acessar uma chave de API, você gera uma chave de API para o 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 a 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 a 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á mostrado no app.
  • Se você estiver executando a versão Objective-C da demonstração, vai aparecer 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.