Adicionar um mapa com um marcador

Este tutorial mostra como adicionar um mapa do Google com um marcador ao seu app iOS. Ele é adequado para pessoas com conhecimento básico ou intermediário de Swift ou Objective-C, além de conhecimento geral do Xcode. Se quiser consultar um guia avançado sobre a criação de mapas, leia o guia para desenvolvedores.

Ao longo deste tutorial, você vai criar o mapa abaixo. O marcador está posicionado em Sydney, Austrália.

Acessar o código

Clone ou baixe o repositório de exemplos do Google Maps para iOS no GitHub.

Se preferir, clique no botão a seguir para fazer o download do código-fonte:

Informar o código

Swift

import UIKit
import GoogleMaps

class ViewController: UIViewController {

    override func viewDidLoad() {
        super.viewDidLoad()
        // Do any additional setup after loading the view.
        // Create a GMSCameraPosition that tells the map to display the
        // coordinate -33.86,151.20 at zoom level 6.
        let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
        let mapView = GMSMapView.map(withFrame: self.view.frame, camera: camera)
        self.view.addSubview(mapView)

        // Creates a marker in the center of the map.
        let marker = GMSMarker()
        marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
        marker.title = "Sydney"
        marker.snippet = "Australia"
        marker.map = mapView
  }
}
      

Objective-C

#import "ViewController.h"
#import <GoogleMaps/GoogleMaps.h>

@interface ViewController ()

@end

@implementation ViewController

- (void)viewDidLoad {
    [super viewDidLoad];
  // Do any additional setup after loading the view.
  // Create a GMSCameraPosition that tells the map to display the
  // coordinate -33.86,151.20 at zoom level 6.
  GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                          longitude:151.20
                                                               zoom:6];
  GMSMapView *mapView = [GMSMapView mapWithFrame:self.view.frame camera:camera];
  mapView.myLocationEnabled = YES;
  [self.view addSubview:mapView];

  // Creates a marker in the center of the map.
  GMSMarker *marker = [[GMSMarker alloc] init];
  marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
  marker.title = @"Sydney";
  marker.snippet = @"Australia";
  marker.map = mapView;
}

@end
      

Primeiros passos

Gerenciador de pacotes do Swift

O SDK do Maps para iOS pode ser instalado usando o Gerenciador de pacotes do Swift.

1. Remova todas as dependências atuais do SDK do Maps para iOS.
2. Abra uma janela de terminal e navegue até o diretório tutorials/map-with-marker.
3. Feche o espaço de trabalho do Xcode e execute os seguintes comandos:

   sudo gem install cocoapods-deintegrate cocoapods-clean
   pod deintegrate
   pod cache clean --all
   rm Podfile
   rm map-with-marker.xcworkspace

4. Abra seu projeto do Xcode e exclua o podfile.
5. Acesse Arquivo > Adicionar dependências de pacote.
6. Insira https://github.com/googlemaps/ios-maps-sdk como o URL, pressione Enter para extrair o pacote e clique em Adicionar pacote.
7. Talvez seja necessário redefinir o cache de pacotes usando Arquivo > Pacotes > Redefinir cache de pacotes.

Usar o CocoaPods

1. Baixe e instale o Xcode versão 16.0 ou mais recente.
2. Se você ainda não tiver o CocoaPods, instale-o no macOS executando o seguinte comando no terminal:

   sudo gem install cocoapods

3. Navegue até o diretório tutorials/map-with-marker.
4. Execute o comando pod install. Isso vai instalar o SDK do Maps especificado no Podfile, além de todas as dependências.
5. Execute pod outdated para comparar a versão do pod instalada com novas atualizações. Se uma nova versão for detectada, execute pod update para atualizar o Podfile e instalar o SDK mais recente. Para mais detalhes, consulte o guia do CocoaPods (em inglês).
6. Clique duas vezes no arquivo map-with-marker.xcworkspace do projeto para abri-lo no Xcode. É preciso usar o arquivo .xcworkspace para abrir o projeto.

Gerar uma chave de API e ativar as APIs necessárias

Para concluir este tutorial, você precisa de uma chave de API do Google que possa usar o SDK do Maps para iOS. Clique no botão abaixo para receber uma chave e ativar a API.

Começar

Para mais detalhes, consulte Acessar uma chave de API.

Adicionar a chave de API a seu aplicativo

Inclua sua chave de API ao AppDelegate.swift da seguinte maneira:

1. Verifique se a seguinte instrução de importação foi adicionada ao arquivo:

   import GoogleMaps

2. Edite a seguinte linha no método application(_:didFinishLaunchingWithOptions:), substituindo YOUR_API_KEY pela chave de API:

   GMSServices.provideAPIKey("YOUR_API_KEY")

Observação:o exemplo de código do tutorial concluído está configurado para ser executado como um projeto Swift Xcode, mas inclui exemplos de Swift e Objective-C.

Criar e executar o app

1. Conecte um dispositivo iOS ao computador ou selecione um simulador no menu de esquema do Xcode.
2. Se você estiver usando um dispositivo, verifique se os Serviços de localização estão ativados. Se você estiver usando um simulador, selecione um local no menu Recursos.
3. No Xcode, clique na opção de menu Produto/Executar ou no ícone do botão de reprodução.
• O Xcode cria o app e o executa no dispositivo ou no simulador.
• Será mostrado um mapa com um marcador centralizado em Sydney, na costa leste da Austrália, semelhante à imagem desta página.

Solução de problemas:

• Se o mapa não aparecer, confirme se você recebeu uma chave de API e a incluiu no app, como descrito anteriormente. Verifique se há mensagens de erro sobre a chave de API no console de depuração do Xcode.
• Se você restringiu a chave de API pelo identificador do pacote iOS, edite a chave para adicionar o identificador do pacote no app: com.google.examples.map-with-marker.
• Verifique se você tem uma boa conexão Wi-Fi ou GPS.
• Use as ferramentas de depuração do Xcode para conferir os registros e depurar o app.

Entender o código

1. Crie um mapa e defina esse elemento como a visualização em viewDidLoad().

   Swift

   // Create a GMSCameraPosition that tells the map to display the
   // coordinate -33.86,151.20 at zoom level 6.
   let camera = GMSCameraPosition.camera(withLatitude: -33.86, longitude: 151.20, zoom: 6.0)
   let mapView = GMSMapView.map(withFrame: CGRect.zero, camera: camera)
   view = mapView
         

   Objective-C

   // Create a GMSCameraPosition that tells the map to display the
   // coordinate -33.86,151.20 at zoom level 6.
   GMSCameraPosition *camera = [GMSCameraPosition cameraWithLatitude:-33.86
                                                           longitude:151.20
                                                                zoom:6.0];
   GMSMapView *mapView = [[GMSMapView alloc] initWithFrame: CGRectZero camera:camera];
   self.view = mapView;
         

2. Adicione um marcador ao mapa em viewDidLoad().

   Swift

   // Creates a marker in the center of the map.
   let marker = GMSMarker()
   marker.position = CLLocationCoordinate2D(latitude: -33.86, longitude: 151.20)
   marker.title = "Sydney"
   marker.snippet = "Australia"
   marker.map = mapView
         

   Objective-C

   // Creates a marker in the center of the map.
   GMSMarker *marker = [[GMSMarker alloc] init];
   marker.position = CLLocationCoordinate2DMake(-33.86, 151.20);
   marker.title = @"Sydney";
   marker.snippet = @"Australia";
   marker.map = mapView;
         

Por padrão, o SDK do Maps para iOS mostra o conteúdo da janela de informações quando o usuário toca em um marcador. Não é preciso adicionar um listener de clique para o marcador se o comportamento padrão atende às suas expectativas.

Parabéns! Você criou um app iOS que mostra um mapa do Google com um marcador indicando um local específico. Além disso, você aprendeu a usar o SDK do Maps para iOS.

Próximas etapas

Saiba mais sobre o objeto "map" e o que você pode fazer com os marcadores.