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

Coloca un mapa interactivo o una imagen panorámica de Street View en tu página web con una solicitud HTTP simple, sin necesidad de usar 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 aún requieren 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, completa los pasos de configuración requeridos: haciendo clic en las siguientes pestañas:

Paso 1

Consola

  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:

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 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 para generar un iframe para tu página web. Para conocer parámetros y opciones adicionales, consulta el artículo Cómo incorporar un mapa.

Prueba el iframe

Para ver tu iframe en una ventana del navegador HTML:

  1. Abre tu editor de texto predeterminado. Deberías tener editores de texto, como TextEdit o el Bloc de notas de Microsoft Windows instalada 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 el archivo HTML index.html.

  5. Carga el archivo HTML en un navegador web arrastrándolo desde tu escritorio hasta tu navegador; De forma alternativa, hacer doble clic en el archivo funciona en la mayoría en los sistemas operativos.

¡Felicitaciones! Acabas de configurar y compilar 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 usan. dentro de ese proyecto.

  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 el de organizaciones en la parte superior de la página.
  3. En la lista de proyectos, selecciona el que quieres 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