Guía de inicio rápido de la API de Maps Embed

Coloca un mapa interactivo o una panorámica de Street View en tu página web con una simple solicitud HTTP (no se requiere JavaScript).

Costos

Todas las solicitudes a la API de Maps Embed están disponibles sin cargo y con uso ilimitado. Sin embargo, todas las solicitudes siguen requiriendo una clave de API de Google Cloud válida. Para obtener más información, consulta Uso y facturación.

Antes de comenzar

Para crear un mapa incorporado en tu página web, haz clic en las siguientes pestañas para completar los pasos de configuración necesarios:

Paso 1

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 del 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. Google Maps Platform incluye un crédito mensual recurrente de USD 200. 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.

Console

Habilitar la API de Maps Embed

SDK de Cloud

gcloud services enable \
    --project "PROJECT" \
    "maps-embed-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:

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:

Console

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

Cómo generar un iframe

Haz clic en las siguientes opciones y agrega una ubicación y una clave de API a fin de generar un iframe para tu página web. Para ver parámetros y opciones adicionales, consulta Cómo incorporar un mapa.

Prueba tu iframe

Para ver el iframe en una ventana del navegador HTML:

  1. Abre el editor de texto predeterminado. Debes tener editores de texto como TextEdit o Microsoft Windows Notepad instalados en tu dispositivo de forma predeterminada.
  2. Crea un archivo HTML y asígnale el nombre index.html.
  3. Agrega el siguiente código con el iframe que generaste anteriormente:

    <html>
      <!-- Replace this code comment with your iframe. -->
    </html>
    
  4. Guarda tu archivo HTML index.html.

  5. Para cargar el archivo HTML en un navegador web, arrástralo del escritorio al navegador. Como alternativa, puedes hacer doble clic en el archivo en la mayoría de los sistemas operativos.

¡Felicitaciones! Acabas de configurar y crear un mapa con la API de Maps Embed.

Realice una limpieza

Puedes borrar tu proyecto de Google Cloud para detener la facturación de todos los recursos que se usaron en él.

  1. En la consola de Google Cloud, ve a la página Administrar recursos:

    Ir a la página Administración de recursos

  2. Si el proyecto que planeas borrar está vinculado a una organización, selecciona y expande la lista de organizaciones en la parte superior de la página.
  3. En la lista de proyectos, selecciona el proyecto que deseas borrar y haz clic en Borrar.
  4. En el diálogo, escribe el ID del proyecto y haz clic en Cerrar para borrarlo.

Próximos pasos