Configuração e demonstração

Usar o Gerenciador de pacotes do Swift

1. Se você ainda não tiver um projeto Xcode, crie um agora e salve-o em sua máquina local. Se você não tem experiência com desenvolvimento para iOS, crie um novo projeto e selecione a opção App iOS modelo. 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 ver opções.
3. No seu projeto do Xcode, navegue até File -> Pacotes Swift -> Adicione dependência do pacote.
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.
• Neste momento, pode ser necessário fazer a autenticação com sua conta do GitHub. Siga o instruções para criar GitHub token de acesso pessoal para continuar o processo.
5. Na próxima janela, selecione a opção Versão e selecione Até a próxima versão principal. 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 Add to Project, escolha o projeto e depois clique em Add Package.

Usar o CocoaPods

1. Se você ainda não tiver um projeto Xcode, crie um agora e salve-o em na máquina local. (Se você não tem experiência com desenvolvimento para iOS, crie uma Uma View Application.)
2. Se você ainda não tiver um arquivo pod para seu projeto, crie um arquivo chamado Podfile no diretório do projeto. Esse arquivo define seu dependências do projeto.
3. Edite o arquivo pod do seu projeto e adicione uma dependência no Google-Maps-iOS-Utils conjunto. Veja um que inclui as dependências necessárias para o 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.0.0' # x-release-please-version
   end

4. Execute pod install.
5. Feche o Xcode e clique duas vezes no arquivo .xcworkspace para iniciar o Xcode. A partir deste momento, você precisa usar 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 somente o utilitário quadtree, você pode mudar pod 'Google-Maps-iOS-Utils' a 'Google-Maps-iOS-Utils/QuadTree' no arquivo pod.

Usar arquivos do GitHub

1. Fazer o download o arquivo de exemplos de código da GitHub e descompactar o arquivo.
2. Abra uma janela do terminal, acesse o diretório em que você expandiu os arquivos de exemplo e acesse 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 para iniciar o Xcode. A partir deste momento, você precisa usar 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, em seguida, abre a demonstração em um projeto Xcode temporário chamado SwiftDemoApp.xcodeproj. ou ObjCDemoApp.xcodeproj.

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