O repositório do SDK do Maps para iOS no GitHub contém exemplos que ilustram o uso do SDK do Maps para iOS no seu app iOS. O app de exemplo contém código para destaques de recursos do SDK e pode ser usado como ponto de partida para seu app.
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 conferir a lista completa de exemplos 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 no 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
aplicativo de exemplo 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, escolha Permitir.