Referencia rápida de la API de Maps Embed

La API de Maps Embed coloca un mapa interactivo o una panorámica de Street View en una página web a través de una solicitud HTTP establecida como una URL de iframe src, sin necesidad de usar JavaScript. Admite los modos de mapa place, view, directions, streetview y search.

API de Maps Embed: Datos clave

  • Producto: API de Maps Embed
  • También conocida como: API de Google Maps Embed, Maps Embed
  • Categoría: Maps
  • Plataforma: JavaScript (navegador)
  • Se ejecuta en: El cliente (código de la app o del navegador)
  • Etapa de lanzamiento: GA
  • Ciclo de vida: Activo
  • Descripción general: Descripción general de la API de Maps Embed
  • Disponibilidad regional: Global. El modo Street View depende de la cobertura de Street View; el parámetro region acepta las regiones que se indican en la página de detalles de cobertura de Maps Platform. (detalles de la cobertura)

API de Maps Embed: Cuándo usarla

Usa la API de Maps Embed en los siguientes casos:

  • Necesitas un mapa interactivo o una panorámica de Street View en una página web que use solo un iframe HTML, sin JavaScript.
  • Necesitas mostrar un pin de lugar, una vista de mapa, instrucciones sobre cómo llegar entre puntos o resultados de la búsqueda de un área en un mapa incorporado.
  • Necesitas un mapa incorporado sin cargo por solicitud y sin límites de QPS ni de solicitudes diarias (se requiere una clave de API).

No uses la API de Maps Embed en los siguientes casos:

  • Necesitas personalizar un mapa web con tus propias imágenes y contenido. En su lugar, usa la API de Maps JavaScript.
  • Necesitas extender un mapa incorporado con funciones programáticas más allá de los parámetros de URL del iframe. En su lugar, usa la API de Maps JavaScript.

API de Maps Embed: Configuración

API de Maps Embed: Errores comunes

  • Problema: Si la página de host establece una metaetiqueta referrer en no-referrer o same-origin, el navegador no envía el encabezado Referer, y una clave de API con restricción de referencia HTTP puede rechazar las solicitudes de incorporación. Solución: Agrega referrerpolicy="strict-origin-when-cross-origin" al iframe para que el dominio del sitio se envíe a Google. Consulta /maps/documentation/embed/embedding-map.
  • Problema: No se admiten mapas incorporados de menos de 200 px en ninguna de las dimensiones. Solución: Configura el width y el height del iframe en, al menos, 200 px. Consulta /maps/documentation/embed/embedding-map.
  • Problema: Aunque el uso no tiene costo, aparece un mapa oscurecido con la marca de agua "Solo para fines de desarrollo" si la facturación no está habilitada, la forma de facturación no es válida, se supera un límite diario autoimpuesto o la solicitud no tiene un HTTP referer mientras se usa una clave restringida por referer. Solución: Habilita la facturación con una forma de pago válida en el proyecto, aumenta o quita cualquier límite de cuota diaria autoimpuesto y asegúrate de que se envíe la URL de referencia para las claves restringidas por URL de referencia (por ejemplo, con referrerpolicy="strict-origin-when-cross-origin" en el iframe). Consulta /maps/documentation/embed/error-messages.
  • Problema: En el caso de las solicitudes no válidas (parámetros incorrectos o faltantes, y errores de clave de API y de cuota, como una clave faltante o no válida, la API de Maps Embed no habilitada o un incumplimiento de restricción de clave), solo se informa el código de estado HTTP 4xx en la consola del navegador, no un mensaje descriptivo. El texto del error aparece dentro del iframe en lugar del mapa. Solución: Lee el texto del error en el iframe y el código de estado de la consola (400 para errores de parámetros, 401 para una clave faltante, 403 para una clave no válida) y, luego, confirma que los parámetros y la clave sean válidos, que la API de Maps Embed esté habilitada y que las restricciones de la clave permitan la solicitud. Consulta /maps/documentation/embed/error-messages.

Qué puedes hacer con la API de Maps Embed

Consulta las guías vinculadas a continuación para cada tarea o compara los productos en el Explorador de capacidades.

API de Maps Embed: Instrucciones sobre cómo llegar y enrutamiento

API de Maps Embed: Maps

API de Maps Embed: Places

API de Maps Embed: Street View