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 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 exemplo 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 que você insira a chave de API
no arquivo
SDKConstants.swift
para Swift ouSDKDemoAPIKey.h
para Objective-C. - Se você ainda não tem 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 console do Cloud, você pode
restringir a chave ao
identificador do pacote do app de exemplo para
garantir que apenas 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 seguinte linha, 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 demos 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 seu local, escolha Permitir.