Configuración

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

Cómo configurar 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 y una clave de API de Google Cloud para usarlos con el SDK de Maps 3D para iOS. Para ello, completa los siguientes pasos:

Paso 1

Consola

  1. En la consola de Google Cloud, en la página del selector de proyectos, haz clic 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

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 APIs o SDKs. 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:

Consola

  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 Environment:

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

Paso 3

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 de API, sigue estos pasos:

Consola

  1. Ve a la página Google Maps Platform > Credenciales.

    Ir a la página Credenciales

  2. En la página Credenciales, haz clic en Crear credenciales > Clave de API.
    El diálogo Se creó la clave de API mostrará la clave de API que acabas de crear.
  3. Haz clic en Cerrar.
    La nueva clave de API aparecerá en la página Credenciales debajo de Claves de API.
    (Recuerda restringir la clave de API antes de utilizarla en producción).

SDK de Cloud

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

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.

Cómo configurar 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:

  • Xcode versión 16.0 o posterior

Paso 2: Crea el proyecto de Xcode y, luego, 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 GoogleMaps3D se agregará a tu objetivo principal designado. Cuando termine, haz clic en Add Package.
  • Para verificar tu instalación, navega hasta el panel General de tu objetivo. 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 requiere detalles de privacidad de la app para las apps en 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 para inspeccionar su contenido, crea un archivo de tu app y genera un informe de privacidad a partir del 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 3D a tu app.