O app de demonstração do SDK fornecido com o SDK do Maps para iOS inclui exemplos dos destaques dos recursos do SDK. Examine o código no app de demonstração para ver como cada exemplo é implementado.
Experimente as demonstrações do SDK
O aplicativo de demonstração do SDK do Maps para iOS está disponível como um arquivo de download no GitHub e como um pod de CocoaPods. O CocoaPods é um gerenciador de dependências de código aberto para projetos Swift e Objective-C da Cocoa.
Siga estas etapas para instalar e testar o app de demonstração do SDK do Maps para iOS.
- Acesse os arquivos de amostra usando um destes dois métodos:
Diretamente no GitHub
- Faça o download do arquivo de exemplo de código no GitHub e descompacte o arquivo.
- Abra uma janela do terminal, navegue até o diretório em que você expandiu os arquivos de exemplo e
detalhe o diretório do GoogleMaps:
Swift
cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
Objective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
- Execute os seguintes comandos:
Swift
pod install open GoogleMapsSwiftDemos.xcworkspace
Objective-C
pod install open GoogleMapsDemos.xcworkspace
Usar o CocoaPods v1.6.1
- Se você ainda não tiver a ferramenta CocoaPods, instale a versão 1.6.1 no macOS executando o seguinte comando no terminal. Para mais detalhes, consulte o Guia de primeiros passos do CocoaPods.
sudo gem install cocoapods -v1.6.1
- Busque os arquivos do Google Maps usando o Cocoapods:
pod try GoogleMaps
Quando solicitado, escolha Swift ou Objective-C. O CocoaPods atualiza seus repositórios de especificações e abre a demonstração em um projeto temporário do Xcode chamado
SwiftDemoApp.xcodeproj
ouObjCDemoApp.xcodeproj
.
- No Xcode, pressione o botão de compilação para criar e executar o esquema
atual. O build produz um erro, solicitando que você insira sua chave de API
no arquivo
SDKConstants.swift
para Swift ou arquivoSDKDemoAPIKey.h
para Objective-C. - Se você ainda não tem uma chave de API, siga as instructions para configurar um projeto no console do Google Cloud e gerar uma. Ao configurar a chave no console do Cloud, é possível especificar o identificador do pacote do seu app para garantir que somente ele possa usar a chave. O identificador de pacote padrão do
app de exemplos do SDK é
com.example.GoogleMapsDemos
. - Edite o arquivo
SDKConstants.swift
para Swift ouSDKDemoAPIKey.h
para Objective-C e cole sua chave de API na definição da constanteapiKey
oukAPIKey
. Exemplo:Swift
static let apiKey = "YOUR_API_KEY"
Objective-C
static NSString *const kAPIKey = @"YOUR_API_KEY";
- Remova a linha a seguir, já que ela é usada para registrar o problema definido pelo usuário:
Swift
#error (Register for API Key and insert here. Then delete this line.”)
Objective-C
#error Register for API Key and insert here.
- Compile e execute o projeto. A janela do simulador do iOS é exibida, mostrando uma lista de demonstrações do SDK do Maps.
- Escolha uma das opções exibidas para testar um recurso do SDK do Maps para iOS.
- Se você receber uma solicitação para permitir que o GoogleMapsDemos acesse sua localização, escolha Permitir.
Usar snippets de código do Guia para desenvolvedores
Todas as páginas do Guia do desenvolvedor contêm snippets de código que ilustram um recurso da API. Por exemplo, consulte os guias sobre objetos "map", marcadores, formas e outras páginas neste guia.