Agrega un mapa con un marcador

En este instructivo, se muestra cómo agregar un mapa simple de Google Maps con un marcador a tu app para iOS. Está destinado a personas con conocimientos básicos o intermedios de Swift o Objective-C, además de conocimientos generales de Xcode. Si deseas obtener una guía avanzada para crear mapas, consulta la guía para desarrolladores.

Con este instructivo, crearás el siguiente mapa. El marcador se encuentra en Sídney, Australia.

Captura de pantalla que muestra un mapa con un marcador sobre Sídney

Obtén el código

Clona o descarga el repositorio de muestras de Google Maps para iOS en GitHub.

También puedes hacer clic en el siguiente botón para descargar el código fuente:

Obtener el 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

Comenzar

Swift Package Manager

El SDK de Maps para iOS se puede instalar con Swift Package Manager.

  1. Asegúrate de haber quitado todas las dependencias existentes del SDK de Maps para iOS.
  2. Abre una ventana de terminal y navega al directorio tutorials/map-with-marker.
  3. Asegúrate de que el lugar de trabajo de Xcode esté cerrado y ejecuta los siguientes comandos: 
    sudo gem install cocoapods-deintegrate cocoapods-clean
pod deintegrate
pod cache clean --all
rm Podfile
rm map-with-marker.xcworkspace
  4. Abre tu proyecto de Xcode y borra el Podfile.
  5. Ve a File > Add Package Dependencies.
  6. Ingresa https://github.com/googlemaps/ios-maps-sdk como la URL, presiona Intro para extraer el paquete y haz clic en Add Package.
  7. Es posible que debas restablecer la caché de paquetes con File > Packages > Reset Package Cache.

Usar CocoaPods

  1. Descarga e instala Xcode versión 15.0 o una posterior.
  2. Si todavía no tienes CocoaPods, instálala en macOS ejecutando el siguiente comando desde la terminal: 
    sudo gem install cocoapods
  3. Navega al directorio tutorials/map-with-marker.
  4. Ejecuta el comando pod install. Con esto, se instalará el SDK de Maps especificado en Podfile, junto con las dependencias.
  5. Ejecuta pod outdated para comparar la versión del pod instalada con las actualizaciones nuevas. Si se detecta una versión nueva, ejecuta pod update para actualizar Podfile e instalar el SDK más reciente. Para obtener más detalles, consulta la Guía de CocoaPods.
  6. Abre (haz doble clic) el archivo map-with-marker.xcworkspace del proyecto para abrirlo en Xcode. Debes usar el archivo .xcworkspace para abrir el proyecto.

Obtén una clave de API y habilita las API necesarias

Para completar este instructivo, necesitas una clave de API de Google autorizada para usar el SDK de Maps para iOS. Haz clic en el siguiente botón para obtener una clave y activar la API.

Comienza ahora

Para obtener más detalles, consulta Cómo obtener una clave de API.

Agrega la clave de API a tu aplicación

Agrega tu clave de API a AppDelegate.swift de la siguiente manera:

  1. Ten en cuenta que se agregó la siguiente sentencia de importación al archivo: 
    import GoogleMaps
  2. Edita la siguiente línea en tu método application(_:didFinishLaunchingWithOptions:). Para ello, reemplaza YOUR_API_KEY por tu clave de API: 
    GMSServices.provideAPIKey("YOUR_API_KEY")

Compila y ejecuta tu app

  1. Conecta un dispositivo iOS a tu computadora o selecciona un simulador en el menú de esquemas de Xcode.
  2. Si usas un dispositivo, asegúrate de que los servicios de ubicación estén habilitados. Si usas un simulador, selecciona una ubicación en el menú Features.
  3. En Xcode, haz clic en la opción de menú Product/Run (o en el ícono del botón de reproducción).
    • Xcode compila la app y, luego, la ejecuta en el dispositivo o en el simulador.
    • Deberías ver un mapa con un marcador centrado en Sídney, en la costa este de Australia, similar al de la imagen que se muestra en esta página.

Solución de problemas:

  • Si no ves un mapa, verifica que hayas obtenido una clave de API y la hayas agregado a la app, como se describió anteriormente. Revisa la consola de depuración de Xcode y busca mensajes de error sobre la clave de API.
  • Si restringiste la clave de API por el identificador de paquete de iOS, edita la clave para agregar el identificador de paquete de la app: com.google.examples.map-with-marker.
  • Asegúrate de tener una buena conexión de Wi-Fi o GPS.
  • Usa las herramientas de depuración de Xcode para ver los registros y depurar la app.

Comprende el código

  1. Crea un mapa y establécelo como vista en 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. Agrega un marcador al mapa en 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;

De forma predeterminada, el SDK de Maps para iOS muestra el contenido de la ventana de información cuando el usuario presiona un marcador. Si deseas utilizar el comportamiento predeterminado, no es necesario agregar un objeto de escucha de clics para el marcador.

¡Felicitaciones! Compilaste una app para iOS que muestra un mapa de Google Maps con un marcador para indicar una ubicación determinada. También aprendiste a usar el SDK de Maps para iOS.

Próximos pasos

Obtén más información sobre el objeto de mapa y lo que puedes hacer con los marcadores.