O repositório do SDK do Maps para iOS no GitHub contém exemplos que ilustram o uso desse SDK no seu app iOS. O app de exemplo contém um código para os destaques dos recursos do SDK e pode ser usado como um ponto de partida.
Lista de amostras do SDK do Maps para iOS
As principais atividades de exemplo do app de demonstração estão listadas abaixo e reproduzidas nas páginas vinculadas para consulta rápida. Consulte a pasta de exemplos (link em inglês) do GitHub para ver uma lista completa das amostras disponíveis.
- Mostrar um mapa básico
- Mostrar uma janela de informações para um marcador
- Adicionar um marcador a um mapa
- Geocodificar um local de forma inversa
- Ativar e desativar gestos do mapa
- Gerenciar eventos de marcador
- Ativar o botão "Meu local"
- Desenhar polígonos em um mapa
- Desenhar polilinhas em um mapa
Executar o app de exemplo completo localmente
O app de exemplo do SDK do Maps para iOS está disponível como um arquivo de download no GitHub. Siga estas etapas para instalar e testar o app de exemplo do SDK do Maps para iOS.
- Execute
git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git
para clonar o repositório de amostras em um diretório local. Abra uma janela de terminal, navegue até o diretório em que você clonou os arquivos de amostra e navegue até o diretório GoogleMaps:
Swift
cd maps-sdk-for-ios-samples-main/GoogleMaps-Swift
pod install
open GoogleMapsSwiftDemos.xcworkspace
Objective-C
cd maps-sdk-for-ios-samples-main/GoogleMaps
pod install
open GoogleMapsDemos.xcworkspace
- No Xcode, pressione o botão de compilação para
criar o app
com o esquema atual. O build produz um erro, solicitando a inserção da chave de API
no arquivo
SDKConstants.swift
para Swift ouSDKDemoAPIKey.h
para Objective-C. - Se você ainda não tiver uma chave de API, siga as
instruções para configurar
um projeto no console do Google Cloud e receber uma chave de API. Ao configurar a
chave no Cloud Console, é possível
restringir a chave ao
identificador de pacote do app de exemplo para
garantir que somente seu app possa usá-la. O identificador de pacote padrão do app de amostras do SDK é
com.example.GoogleMapsDemos
. - Edite o arquivo
SDKConstants.swift
para Swift ouSDKDemoAPIKey.h
para Objective-C e cole a 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";
- No arquivo
SDKConstants.swift
(Swift) ouSDKDemoAPIKey.h
(Objective-C), remova a linha a seguir, porque 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 aparece, mostrando uma lista de demonstrações do SDK do Maps.
- Escolha uma das opções exibidas para experimentar um recurso do SDK do Maps para iOS.
- Se você receber uma solicitação para permitir que o GoogleMapsDemos acesse seu local, selecione Permitir.