Configuración

En esta página, se describe lo que debes hacer para configurar el SDK de Maps en 3D para iOS y comenzar a compilar con él. El proceso de configuración implica configurar un proyecto de Google Cloud y una API para usarlos con el SDK y, luego, configurar un proyecto de Xcode. Completa estos pasos antes de agregar tu primer mapa en 3D a tu app.

Requisitos previos

Para usar el SDK de Maps 3D para iOS, tu proyecto y los dispositivos de destino deben cumplir con los siguientes requisitos:

  • Versión mínima de iOS: iOS 16.0 o una versión posterior.
  • Xcode: Versión 16.0 o posterior de Xcode

Configura un proyecto de Google Cloud y una clave de API

Antes de comenzar a compilar con el SDK de Maps 3D para iOS, debes configurar un proyecto de Google Cloud y una clave de API para usar con el SDK de Maps 3D para iOS. Para ello, completa los siguientes pasos:

Paso 1: Configura tu proyecto

Console

  1. En la consola de Google Cloud, en la página del selector de proyectos, haz clic en Crear proyecto para comenzar a crear un proyecto nuevo de Cloud.

    Ir a la página Selector de proyectos

  2. Asegúrate de que la facturación esté habilitada para tu proyecto de Cloud. Confirma que la facturación esté habilitada para tu proyecto.

    Google Cloud ofrece una prueba con un cargo de USD 0.00. La prueba vence al final de un plazo de 90 días, o bien después de que la cuenta acumule USD 300 en cargos, lo que ocurra primero. Puedes cancelar la prueba en cualquier momento. Para obtener más información, consulta Créditos de la cuenta de facturación y Facturación.

SDK de Cloud

gcloud projects create "PROJECT"

Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:

Paso 2: Habilita las APIs o los SDKs

Para usar Google Maps Platform, debes habilitar las APIs o los SDKs que planeas usar con tu proyecto.

Ten en cuenta que algunas integraciones requieren que habilites varias API o SDK. Si no sabes qué API o SDK habilitar, prueba usar el Explorador de capacidades o consulta la documentación de la API o el SDK que quieres usar.

Para habilitar una o más APIs o SDKs, sigue estos pasos:

Console

  1. En la página Biblioteca de la API de Google Maps en la consola de Cloud, consulta las APIs y los SDKs de Google Maps Platform que puedes habilitar:

    Ve a la página Biblioteca de la API de Google Maps

  2. Haz clic en la API o el SDK que deseas habilitar.
    • Si el botón dice HABILITAR, haz clic en él para habilitar la API o el SDK.
    • Si el botón dice ADMINISTRAR, la API o el SDK ya están habilitados y no necesitas hacer nada más.
    • Si haces clic en cualquiera de los botones, se mostrará el panel de la API o el SDK. (Haz clic en el botón INHABILITAR para quitar la API o el SDK de este proyecto).

SDK de Cloud

El siguiente comando habilita todas las APIs de Maps, Routes y Places:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:

Usa este comando para habilitar las APIs de entorno:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

Paso 3: Obtén una clave de API

En este paso, solo se realiza el proceso de creación de la clave de API. Si usas la clave de API en producción, te recomendamos que la restrinjas. Puedes encontrar más información en la página Usar claves de API específica del producto.

La clave de API es un identificador único que se utiliza para autenticar solicitudes asociadas a tu proyecto con fines de uso y facturación. Debes tener, al menos, una clave de API asociada a tu proyecto. Para crear una clave nueva o agregar una API o un SDK a una clave existente, sigue estas instrucciones.

Console

  1. Ve a la página Google Maps Platform > Claves y credenciales.

    Ir a la página Claves y credenciales

  2. Si se solicita, selecciona tu proyecto.

  3. Realiza una de las siguientes acciones:

    • Crea una clave nueva:

      1. Haz clic en Crear credenciales > Clave de API.
      2. En el panel Crear clave de API, abre la lista Elige las restricciones de API.
      3. Borra las APIs que no necesite esta clave y asegúrate de que las APIs que planeas usar permanezcan seleccionadas.
      4. Haz clic en Crear. En el panel, se mostrará tu nueva clave de API.

    • Usar una clave existente:

      1. Haz clic en el nombre de la clave.
      2. En la lista Seleccionar las restricciones de API, selecciona las APIs que planeas usar.
      3. Haz clic en Guardar.

    Seleccionar una API aquí no la habilita. Asegúrate de que cada API que selecciones esté habilitada en la Biblioteca de APIs.

  4. Para ver la cadena de clave más adelante, ve a la página Claves y credenciales y haz clic en Mostrar clave para la clave.

Si la consola se ve diferente de estos pasos, consulta Crea una clave de API y Agrega restricciones de API en la documentación de Google Cloud.

SDK de Cloud

Reemplaza PROJECT_ID por el ID del proyecto en los siguientes comandos.

  • Crea una clave nueva: Ejecuta el siguiente comando y reemplaza DISPLAY_NAME por un nombre para la clave. Reemplaza SERVICE_NAME por el nombre del servicio de una API que planeas usar, como places.googleapis.com. Para permitir más APIs, repite la marca --api-target.

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

    Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:

  • Usa una clave existente: Ejecuta el siguiente comando y reemplaza KEY_ID por el ID de la clave. Reemplaza SERVICE_NAME por el nombre del servicio de la API que deseas agregar. La marca --append conserva las APIs que la clave ya permite. Sin él, el comando las reemplaza.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=SERVICE_NAME

    Obtén más información sobre el SDK de Google Cloud, la instalación del SDK de Cloud y los siguientes comandos:

    El ID de clave no es la cadena de clave ni el nombre visible. Para encontrarlo, ejecuta gcloud services api-keys list --project="PROJECT_ID". El ID es la última parte del campo name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Para ver la cadena de la clave, ejecuta gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

Para habilitar el SDK, consulta la página del SDK de Maps 3D para iOS en la consola de Google Cloud. Para obtener más información sobre cómo completar estos pasos, consulta Cómo comenzar a utilizar Google Maps Platform.

Configura un proyecto de Xcode

En esta sección, se explica cómo crear y configurar un proyecto de Xcode para usarlo con el SDK de Maps 3D para iOS.

Una vez que habilites la facturación y crees una clave de API, podrás configurar el proyecto de Xcode que usarás para desarrollar tu app.

Paso 1: Instala el software requerido

Para compilar un proyecto con el SDK de Maps 3D para iOS, debes descargar e instalar lo siguiente:

  • Versión 16.0 o posterior de Xcode

Paso 2: Crea el proyecto de Xcode e instala el SDK de Maps 3D para iOS

Swift Package Manager

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

Para agregar el SDK a un proyecto nuevo o existente, sigue estos pasos:

  • Abre tu project o workspace de Xcode y, luego, ve a File > Add Package Dependencies.
  • Ingresa https://github.com/googlemaps/ios-maps-3d-sdk como la URL, presiona Intro para extraer el paquete y haz clic en "Add Package".
  • En la ventana Choose Package Products, verifica que se agregará GoogleMaps3D a tu destino principal designado. Cuando termines, haz clic en Add Package.
  • Para verificar la instalación, navega al panel General de tu destino. En Frameworks, Libraries, and Embedded Content, deberías ver los paquetes instalados. También puedes ver la sección Package Dependencies de Project Navigator para verificar el paquete y su versión.

Paso 3: Agrega la clave de API a tu app

Swift Package Manager

Agrega tu clave de API al punto de entrada principal de tu app (o en cualquier momento antes de que se cargue el mapa) de la siguiente manera.

  1. Agrega la siguiente sentencia de importación: 
    import GoogleMaps3D
  2. Agrega el siguiente método. Reemplaza YOUR_API_KEY por tu clave de API. 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

Paso 4 (opcional): Inspecciona el archivo de manifiesto de privacidad de Apple

Apple exige que se proporcionen detalles de privacidad de las apps en la App Store.

El archivo de manifiesto de privacidad de Apple se incluye en el paquete de recursos del SDK. Para verificar que se haya incluido el archivo de manifiesto de privacidad y, además, inspeccionar su contenido, crea un archivo de tu app y genera un informe de privacidad desde el archivo.

Próximos pasos

Ahora que tienes un proyecto de Google Cloud, una clave de API y un proyecto de Xcode configurados para usarlos con el SDK de Maps 3D para iOS, puedes agregar un mapa en 3D a tu app.