Configuração e demonstração

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, '16.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '10.0.0'
     pod 'Google-Maps-iOS-Utils', '6.1.3' # 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.

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.

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 = @"";