Notas de la versión de la API de Maps JavaScript

Suscríbete a estas notas de la versión. Suscribirse

El equipo de la API de Maps JavaScript actualiza la API con funciones nuevas, correcciones de errores y mejoras de rendimiento. Para indicar qué versión de la API deseas cargar en tu aplicación, especifícala en el parámetro v de la solicitud de arranque de la API de Maps JavaScript. Obtén más información sobre el control de versiones.

En este registro de cambios, se enumeran las versiones por fecha y número de versión, junto con los cambios asociados.

En esta página, se incluyen las notas de la versión de 2025 y 2026. Para conocer las versiones anteriores, consulta el archivo de notas de la versión de la API de Maps JavaScript.

Para recibir actualizaciones sobre las nuevas versiones de la API de Google Maps, suscríbete al grupo google-maps-js-api-v3-notify.

3.66.9d

14 de octubre de 2026

Cambios:

  • Se solucionó un problema por el que, cuando se completaba un arrastre en un AdvancedMarkerElement, se activaba por error un evento de clic en el mapa.
  • Se corrigió un problema por el que la ventana de información de un lugar de interés no se cerraba con la tecla Escape después de volver a abrir el mismo lugar de interés.
  • [canal alfa] AdvancedPlaceDetailsElement, AdvancedPlaceDetailsCompactElement y AdvancedPlaceItemElement ahora admiten ranuras de basic-section-top y basic-section-bottom en el canal alfa.
  • [canal alfa] PlacePinElementya está disponible en el canal alfa para mostrar información de lugares en un mapa
  • Se corrigió un problema por el que InfoWindow no se cerraba con la tecla Escape y el enfoque no volvía al elemento enfocado anteriormente cuando el mapa era un elemento gmp-map.

3.66.8b

8 de octubre de 2026

Cambios:

  • Se corrigió un error por el que la ventana de información de un lugar de interés no se cerraba con la tecla Escape después de volver a hacer clic en su ícono.
  • Se corrigió la navegación con las teclas de flecha del teclado que movía el enfoque a AdvancedMarkerElements fuera del área visible del mapa.
  • [Canal beta] Se agregaron MapMode.ROADMAP, el control de la IU del modo Mapa, Map3DElement.colorScheme (para el diseño de mapas claros y oscuros) y Label3DElement (<gmp-label-3d>) a los mapas en 3D (Map3DElement).

3.66.7

1 de octubre de 2026

Cambios:

  • [Canal alfa] Se corrigieron los íconos de vehículos de transporte público en la ventana emergente Route3DElement que desaparecían en el modo de colores forzados.
  • [Canal alfa] Route.createWaypointMarkers() ahora establece un title predeterminado localizado ("Origen" o "Destino") en los marcadores que crea.
  • [Canal alfa] Se corrigió el texto de la ventana emergente de Route3DElement que era invisible en los modos de mapa híbrido y satelital.
  • [canal alfa] Los marcadores 3D creados por Route.createWaypointMarkers() ahora mantienen un tamaño de pantalla constante (sizePreserved es true de forma predeterminada).
  • [Canal alfa] Ahora se puede acceder a los marcadores de origen y destino de Route3DElement con el teclado, y los lectores de pantalla los anuncian. Cuando colocas el cursor sobre un marcador, se muestra su título como información sobre la herramienta.
  • [Canal beta] Se agregaron las propiedades Map3DElement.maxMemoryMegabytes y Map3DElement.qualityMode, junto con la enumeración QualityMode, para ayudar a reducir el uso de memoria del mapa en 3D.
  • Se corrigió un problema por el que PopoverElement (<gmp-popover>) se desplazaba de su ancla cuando se cambiaba el zoom de la página en Safari.
  • Se agregó compatibilidad con eventos de puntero a través de gmp-pointerover, gmp-pointerout y gmp-pointermove para elementos interactivos en Maps3D.
  • Se corrigieron las definiciones de TypeScript para los elementos de dibujo de mapas en 3D (Marker3DElement, Model3DElement, Polygon3DElement, Polyline3DElement, FlattenerElement y CirclePathElement) y PopoverElement para que acepten google.maps.LatLng.

3.66.6c

22 de septiembre de 2026

Cambios:

  • Se corrigió un problema por el que PlaceAutocompleteElement no mostraba su botón para borrar cuando se completaba de manera programática a través de las opciones del constructor o la propiedad de valor.
  • [alpha channel] Se quitó colorScheme de google.maps.routes.RoutePolyline3DOptions. Route3DElement ahora hace un seguimiento del esquema de colores efectivo del Map3D superior.
  • [Canal beta] Se corrigió la fuga de memoria en el ciclo de vida de renderización de la panorámica de Street View.
  • [canal beta] Los íconos predeterminados de PlaceLinkElement se pueden ocultar con el atributo default-icon-hidden, lo que permite que los vínculos de lugares solo tengan texto.

3.66.4d

9 de septiembre de 2026

Cambios:

  • [Canal alfa] El rango mínimo de AutofitsCamera cambió de 2,000 metros a 80 metros.
  • Se dieron de baja AdvancedMarkerElement.addListener() y los eventos heredados (click, dragstart, drag, dragend). En su lugar, usa addEventListener() estándar con eventos con el prefijo gmp-.

3.66.3d

2 de septiembre de 2026

Cambios:

  • [canal alfa] Se agregó el campo trafficPolylinesDisabled a RoutePolyline3DOptions. Esto permite que los desarrolladores inhabiliten las polilíneas que tienen en cuenta el tráfico cuando crean polilíneas de rutas en 3D.
  • [Canal alfa] Se optimizó Route3DElement para evitar solicitudes innecesarias al backend cuando se activa o desactiva trafficPolylinesDisabled.

3.66.2d

26 de agosto de 2026

Cambios:

  • [Canal alfa] Se quitaron los íconos de Route 3D de la carga de fuentes y se movieron a recursos SVG incorporados para evitar complicaciones cuando se carga la fuente de Material Symbols más de una vez.
  • [canal beta] Se agregaron componentes avanzados del kit de IU de Places: AdvancedPlaceDetailsElement, AdvancedPlaceDetailsCompactElement, PlaceLinkElement, PlaceButtonElement, PlaceNameElement, AdvancedPlaceListElement y AdvancedPlaceSearchElement.
  • Se agregó un cuadro de información a los nombres de las líneas de transporte público para que se pueda ver el nombre completo, incluso cuando está truncado.
  • Se agregaron tipos de removeEventListener para componentes web personalizados.
  • Se corrigió un problema por el que VoiceOver mostraba un contorno de enfoque en los elementos del lector de pantalla ocultos visualmente para los marcadores de ruta.

3.66.1a

17 de agosto de 2026

Cambios:

  • Se corrigió el comportamiento de accesibilidad de las imágenes estáticas de las tarjetas de lugar agregando etiquetas de resguardo y quitando las detenciones redundantes del enfoque del teclado.

3.65.12f

6 de agosto de 2026

Cambios:

  • [canal alfa] Agrega <gmp-label-3d> (google.maps.maps3d.Label3DElement) al canal alfa de la API de Maps en 3D para JS. Ahora los desarrolladores pueden usar el nuevo elemento para declarar el texto de la etiqueta y configurar de forma independiente su comportamiento de colisión, por separado de sus elementos de marcador 3D vinculados (como <gmp-marker-3d> y <gmp-marker-3d-interactive>).
  • Proporciona nombres de accesibilidad únicos para los botones Más opciones en los widgets de Place Details.
  • [Canal alfa] Se mejoraron los mensajes de error del modo de viaje de Route 3D para cuando se usa TravelMode.TWO_WHEELER fuera de las versiones alfa y beta.
  • [Canal alfa] El componente Route3D ahora admite la propiedad trafficPolylinesDisabled. Esto permite que los desarrolladores inhabiliten las polilíneas con información del tráfico cuando usan las opciones de ruta TRAFFIC_AWARE o TRAFFIC_AWARE_OPTIMAL.
  • [Canal alfa] Se aumentó el padding de los límites norte de AutofitsCamera para evitar el recorte predeterminado del pin.
  • Se solucionó un problema por el que el hombrecito naranja de Street View no se podía arrastrar al mapa en dispositivos con pantalla táctil.

3.65.11b

27 de julio de 2026

Cambios:

  • [Canal alfa] Se mejoró el cuadro emergente de Route3D para mostrar íconos que no son de transporte público (en bicicleta, en automóvil, en vehículo de dos ruedas y a pie).
  • [canal alfa] Route.createWaypointMarkers crea marcadores para el origen y el destino, con un diseño predeterminado aplicado, a menos que se especifique una función customOverride. Por el momento, no se admiten puntos de referencia intermedios.

3.65.10a

22 de julio de 2026

Cambios:

  • Se corrigió un problema por el que la API de Maps JS cargaba la fuente Material Symbols Outlined de una manera que podía afectar a la misma fuente cargada en la página base.
  • Se solucionó un problema por el que PlaceAutocompleteElement enviaba un valor vacío en el POST del formulario cuando se inicializaba con options.value o se modificaba de forma programática a través de la propiedad value.
  • Se actualizaron los controles de la IU de inclinación y orientación del mapa en 3D para que se vuelvan a habilitar si se aumenta el rango de restricción de la cámara.

3.65.8c (revertida)

7 de julio de 2026

Cambios:

  • [canal alfa] Route3DElement renderiza datos adicionales de polilíneas y ventanas emergentes para las rutas de transporte público.
  • Se agregó compatibilidad con internalUsageAttributionIds a la API de Address Validation. Esta propiedad permite la atribución de llamadas a la API a paquetes o bibliotecas de OSS específicos.
  • Se actualizó la ventana de información predeterminada para los clics en lugares de interés en mapas en 2D para usar Place Widgets.
  • Se mejoró la confiabilidad de las panorámicas de Street View en condiciones de tráfico alto.

3.65.6a

25 de junio de 2026

Cambios:

  • [Canal beta] Se actualizó la ventana de información predeterminada para los clics en lugares de interés en mapas en 2D para usar Place Widgets.
  • Se corrigió un error por el que el mapa en 3D ocasionalmente arrojaba un error con valores de fov extremos.
  • Se actualizaron los marcadores de ruta predeterminados para que ya no usen la opción obsoleta glyph PinElement.

3.65.5e

17 de junio de 2026

Cambios:

  • Se corrigieron los tipos de OverlayView.getMap().
  • Se actualizaron los tipos de BasicPlaceAutocompleteElement y PlaceAutocompleteElement para indicar que el parámetro de opciones del constructor es opcional.

3.65.3b

4 de junio de 2026

Cambios:

  • La funcionalidad DrawingManager de la API de Maps JavaScript ya no está disponible. Para obtener más información, consulta https://developers.google.com/maps/deprecations.
  • Se mejoró el contraste de color del diálogo de derechos de autor del mapa en el modo oscuro.
  • Inhabilitar los controles de rotación del mapa en 3D cuando se alcanzan los límites de orientación
  • Se solucionó un problema por el que el campo de entrada para dispositivos móviles de Place Autocomplete se superponía con la barra de estado o el área segura del sistema iOS. Nota: La corrección funciona cuando se establece viewport-fit=cover en la metaetiqueta de la vista del puerto.
  • Se agregó compatibilidad con internalUsageAttributionIds a la API de Maps JavaScript en 3D. Esta propiedad permite que los desarrolladores atribuyan llamadas a la API a paquetes o bibliotecas de OSS específicos.
  • Se agregó compatibilidad con internalUsageAttributionIds a la API de Places (nueva). Esta propiedad permite que los desarrolladores atribuyan llamadas a la API a paquetes o bibliotecas de OSS específicos.
  • [Canal alfa] Se restringieron los tipos de métodos get de las propiedades de Route3DElement para que coincidan con la normalización de los métodos set.
  • [Canal alfa] Route3DElement expone las propiedades routes, fallbackInfo y geocodingResults.

3.65.2d

27 de mayo de 2026

Cambios:

  • Se corrigió un problema con el botón de zoom que se producía cuando se alejaba la imagen en un mapa con límites restringidos.
  • La biblioteca de Places introdujo transitStation en los lugares.
  • Se agregó compatibilidad con internalUsageAttributionIds en la biblioteca de Routes. Esta propiedad permite que los desarrolladores atribuyan llamadas a la API a paquetes o bibliotecas de OSS específicos.

3.65.1c

20 de mayo de 2026

Cambios:

  • Ahora, el logotipo de Google será de color gris oscuro sobre un fondo blanco para los tipos de mapa de ruta y de relieve en el modo claro, independientemente de si se proporciona un ID de mapa o un estilo personalizado.
  • [Canal alfa] Route3DElement envía eventos gmp-load y gmp-error después de llamadas a la API de Routes exitosas y con errores, respectivamente.
  • Se corrigió la documentación incorrecta que indicaba que las coincidencias se destacan en el texto secundario de las predicciones de autocompletar. Las coincidencias solo se destacan en el texto principal, lo que refleja el comportamiento de Autocomplete de la API de Places.
  • Se mejoró la herencia de colores para los elementos de predicción de autocompletar de Place Autocomplete, de modo que hereden correctamente el color establecido en el elemento superior.
  • Se agregaron los espacios "input-icon" y "clear-icon" a PlaceAutocompleteElement y BasicPlaceAutocompleteElement para personalizar los íconos.
  • Se expusieron las partes de sombra prediction-item-secondary-text y prediction-item-nonmatch para los elementos de predicción BasicPlaceAutocomplete y PlaceAutocomplete, lo que permite aplicar un estilo personalizado para el texto principal y el texto secundario que no coinciden.
  • Se agregaron el atributo no-clear-button y la propiedad noClearButton a PlaceAutocompleteElement y BasicPlaceAutocompleteElement para permitir ocultar el botón para borrar.
  • La funcionalidad de la capa de mapa de calor de la API de Maps JavaScript ya no está disponible.
  • Se mejoró el manejo de errores para la recuperación de la configuración del mapa.
  • Las imágenes de 45 grados ya no están disponibles para los mapas de trama.
  • Se agregaron las clases faltantes a la documentación de PlacesLibrary. También se documentó el método toString() en FormattableText.
  • Se mejoró la accesibilidad de los vínculos "Informar un error en el mapa".

3.64.12d

6 de mayo de 2026

Cambios:

  • El método equals() de LatLng ahora acepta objetos LatLngLiteral en lugar de arrojar un error. La documentación de LatLng y LatLngAltitude equals() ahora también refleja con precisión que el nivel de tolerancia existente es de 1e-9.
  • [Canal alfa] Map3DElement con elementos secundarios de ajuste automático ahora se renderiza inicialmente con el modo de altitud RELATIVE_TO_GROUND, que admite mostrar áreas de mayor elevación durante la carga en los casos en que las propiedades de la cámara están predefinidas en lugar de aplicarse con flyCameraTo. Además, en la carga inicial de Map3DElement, si el mapa tiene elementos secundarios que usan la API de AutofitsCamera y que aún están funcionando, la renderización inicial del mapa se aplaza hasta que todos terminen de funcionar, y la cámara se ajusta independientemente de la configuración de la animación de vuelo. Las actualizaciones posteriores de la cámara respetan la configuración de vuelo.
  • [canal alfa] Polygon3DElement agrega la propiedad autofitsCamera para admitir el ajuste automático de la cámara.

3.64.11d

29 de abril de 2026

Cambios:

  • [canal alfa] MarkerElement agrega la propiedad autofitsCamera para admitir el ajuste automático de la cámara del marcador.
  • Se corrigió un problema en PlaceAutocompleteElement por el que el ícono del elemento de predicción no se renderizaba en el navegador Safari.
  • La biblioteca de Places introdujo isPureServiceAreaBusiness en los lugares. Ahora es posible solicitar resultados para empresas de servicio en el área exclusivas configurando pureServiceAreaBusinessesIncluded en las solicitudes de Place Autocomplete (API de datos y widgets) y Text Search.
  • La biblioteca de Places introdujo addressDescriptor, containingPlaces y timeZone en los lugares.
  • La biblioteca de Places introdujo futureOpeningDate en los lugares. Ahora es posible solicitar resultados para empresas que aún no abrieron. Para ello, establece futureOpeningBusinessesIncluded en las solicitudes de Place Autocomplete (API de datos y widgets), Nearby Search y Text Search.
  • El logotipo de Google ahora será el mismo para el mapa de ruta claro con o sin un ID de mapa o un estilo personalizado. Anteriormente, mostrábamos el logotipo de Google en modo oscuro para todos los mapas de ruta que usaban un ID de mapa. Para mantener el logotipo de Google blanco, los usuarios deben cambiar al modo oscuro.
  • Se agregó focus-ring como CSS Shadow Part en PlaceAutocompleteElement y BasicPlaceAutocompleteElement.
  • Se agregaron los nuevos FuelType DIESEL_PLUS y E100. Se agregó un nuevo EVConnectorType NACS.
  • Se agregaron los atributos value, placeholder, disabled, readonly, no-input-icon y maxlength a PlaceAutocompleteElement y BasicPlaceAutocompleteElement.
  • Se agregó una propiedad "description" a PlaceAutocompleteElement y BasicPlaceAutocompleteElement para proporcionar contexto adicional a los usuarios de lectores de pantalla.
  • Se restringió el tipo declarado de LatLngAltitudeLiteral.altitude para no permitir valores nulos o indefinidos. Se corrigió el tipo de datos que se devuelve declarado de DirectionalLocation.toJSON().

3.64.9c

14 de abril de 2026

Cambios:

  • Las declaraciones de TypeScript ahora diferencian correctamente los tipos de métodos get y set de propiedades (incluidas las propiedades de solo lectura sin métodos set).

3.64.8b

8 de abril de 2026

Cambios:

  • [Canal alfa] Route3DElement, Marker3DElement y Polyline3DElement con autofitsCamera no provocarán actualizaciones de la cámara cuando se quiten del DOM. En el caso de Route3DElement, los errores o las respuestas vacías no tienen ningún efecto en la cámara. Además, cambiar autofitsCamera de verdadero a falso en un elemento determinado no actualizará la cámara para excluir ese elemento, sino que lo excluirá de futuras actualizaciones de la cámara.
  • Ahora, el zIndex de un AdvancedMarkerElement se determina por su valor establecido de forma explícita o, de forma predeterminada, por su posición vertical en píxeles. Los valores explícitos tienen prioridad sobre el valor predeterminado. Para evitar que los marcadores que se encuentran más abajo en la pantalla y no tienen un valor de zIndex se superpongan de forma inesperada con los que sí lo tienen, te recomendamos que apliques el valor de zIndex de manera coherente en todos los marcadores.
  • Las declaraciones de TypeScript ahora incluyen una interfaz que asigna nombres de etiquetas HTML a clases de JS (google.maps.HTMLElementTagNameMap y el HTMLElementTagNameMap global), una interfaz que asigna nombres de etiquetas HTML al EventMap de cada clase de JS (google.maps.HTMLElementEventMapTagNameMap), una interfaz de todas las propiedades de CSS personalizadas (google.maps.CSSProperties) y cada enum basado en cadenas tiene un tipo de unión de cadenas definido (como ${EnumName}String) y esa unión de cadenas se usa para ese enum en todas las declaraciones. addEventListener() también se sobrecarga en cada elemento personalizado con sus tipos de EventMap, y google.maps.importLibrary() se sobrecarga para escribir correctamente cada biblioteca que se devuelve para el nombre de la biblioteca que se pasa.

3.64.7d

1 de abril de 2026

Cambios:

  • Ahora, la propiedad mapId se puede actualizar de forma dinámica después de la inicialización de Map3DElement, lo que elimina la necesidad de volver a crear una instancia de Map3DElement.
  • [canal alfa] Se agregó un nuevo Route3DElement para renderizar rutas en mapas en 3D.
  • [Canal alfa] Se agregaron las nuevas APIs de Route.create3DPolylines() y Route.createPopover().
  • [Canal alfa] Se agregó una nueva API de spherical.traversePath().
  • [Canal alfa] Se agregó una nueva API de autofitsCamera a Marker3DElement, Polyline3DElement y Route3DElement, con una nueva API de autofitsCameraAnimation para Map3DElement.
  • [canal alfa] Se agregó un nuevo CirclePathElement para renderizar círculos con Polygon3DElement.
  • [canal alfa] Un nuevo modo Mapa ROADMAP ya está disponible en los mapas en 3D en el canal alpha.
  • Se corrigió un error por el que el muñeco naranja de Street View no funcionaba correctamente en dispositivos móviles cuando se encontraba en un mapa adjunto a un elemento del DOM creado en un contexto de marco diferente del código de la biblioteca de Maps JS.

3.64.6d

26 de marzo de 2026

Cambios:

  • Se corrigió un problema por el que, si no se destacaba ninguna predicción, presionar Intro no enviaba un formulario que contuviera elementos de Place Autocomplete.
  • Se corrigió una condición de carrera que causaba que FlattenerElement no se dibujara en los mapas en 3D.
  • Se corrigió un error por el que el control táctil en dispositivos móviles no funcionaba correctamente cuando se adjuntaba un mapa a un elemento del DOM que se creaba en un contexto de iframe diferente del código de la biblioteca de JS de Maps.

3.64.5d

18 de marzo de 2026

Cambios:

  • El canal weekly ahora incluye varias actualizaciones de mapas en 3D, como las nuevas funciones MarkerElement y FlattenerElement. Además, agregamos las propiedades cameraPosition y fov, y la compatibilidad con altitudeMode para los métodos flyCameraTo y flyCameraAround.
  • La biblioteca de Places introdujo currentOpeningHours, regularSecondaryOpeningHours y currentSecondaryOpeningHours para los lugares identificados. El currentOpeningHours proporciona el horario de atención de la próxima semana, incluidos los horarios excepcionales, como los días feriados. Los horarios secundarios son diferentes de los principales de un lugar y, además, indican los horarios de servicios como el de entrega desde el automóvil, retiro en la puerta o para llevar.
  • Se solucionó un problema en los mapas en 3D por el que, en ocasiones, el vínculo a Google Maps no se actualizaba correctamente después de mover el mapa.

3.64.4d

12 de marzo de 2026

Cambios:

  • Se sincronizó la propiedad de mapa InfoWindow en el cambio de posición para solucionar el problema que causaba advertencias innecesarias en la consola.
  • Se solucionó un problema por el que, en ocasiones, se descartaban las actualizaciones programáticas de fov en Map3DElement.
  • El método flyCameraAround en Map3DElement ahora acepta Number.Infinity para el parámetro repeatCount, lo que permite una animación sin fin.

3.64.3a

2 de marzo de 2026

Cambios:

  • La API de Maps Embed ahora usa el kit de IU de Places para mostrar los detalles de un lugar.
  • [Canal beta] La propiedad cameraPosition que se introdujo anteriormente en Map3DElement en la versión 3.64.2 ahora también se admite en el destino flyCameraTo. Consulta Mapas en 3D en Maps JavaScript para obtener más información.

3.64.2b

26 de febrero de 2026

Cambios:

  • google.maps.DirectionsService, google.maps.DirectionsRenderer y google.maps.DistanceMatrixService dejarán de estar disponibles a partir del 25 de febrero de 2026. Por el momento, no está previsto descontinuarlas y seguirán recibiendo correcciones de errores para cualquier regresión importante. Se enviará una notificación al menos 12 meses antes de descontinuar la asistencia técnica. Consulta heredado para obtener más detalles (incluidas las alternativas más recientes y recomendadas).
  • [Canal beta] Se introdujo un nuevo MarkerElement que te permite mostrar contenido HTML personalizado dentro de los marcadores en el mapa en 3D. Además, un nuevo FlattenerElement ahora puede aplanar mallas 3D en áreas específicas.
  • [canal beta] Se actualizó Map3DElement con las propiedades fov y cameraPosition, mientras que los métodos flyCameraTo y flyCameraAround ahora admiten altitudeMode. Consulta Mapas en 3D en Maps JavaScript para obtener más información.
  • Se corrigió un error que causaba que la creación de un PinElement con document.createElement('gmp-pin') arrojara un NotSupportedError.

3.64.1c

19 de febrero de 2026

Cambios:

  • Actualiza la colisión cuando se cambia el tamaño de AdvancedMarkerElement.

3.63.14d

5 de febrero de 2026

Cambios:

  • La biblioteca de Places introdujo nuevas opciones para identificar un lugar cuando se solicitan datos. Además de usar id, ahora puedes especificar un resourceName para inicializar un objeto Place.
  • La biblioteca de Places introdujo subDestinations para los lugares identificados. Estos subDestinations proporcionan destinos más específicos para los usuarios que realizan búsquedas dentro de un lugar grande o complejo, como un aeropuerto, un parque nacional, una universidad o un estadio.
  • Se corrigió un problema por el que Map3D requería que se especificara una altitud cuando se establecía la propiedad center en JS (ahora el valor predeterminado es 0).
  • El objeto Place de PlaceDetailsElement y PlaceDetailsCompactElement ahora incluye una propiedad googleMapsLinks, que proporciona URLs para la vinculación directa con Google Maps para una variedad de acciones. Esto incluye los URI para ver el lugar, obtener instrucciones sobre cómo llegar, ver fotos, leer opiniones existentes y escribir una opinión nueva.

3.63.13

29 de enero de 2026

Cambios:

  • La API de Maps Embed ya no muestra tarjetas emergentes cuando se coloca el cursor del mouse sobre los lugares de interés.
  • Se agregaron advertencias de la consola para los elementos del kit de IU de Places (Place Details y Place Search) que no están configurados correctamente.
  • PlaceDetailsElement ahora mostrará resúmenes de lugares generados por IA cuando estén disponibles.
  • Ya está disponible un resumen de opiniones generado por IA para PlaceDetailsElement.

3.63.10a

13 de enero de 2026

Cambios:

  • Se corrigió un problema que impedía los gestos de desplazamiento y clic dentro de los popovers.
  • Los campos resourceName y shortFormattedAddress ya están disponibles a través de la API de Places

3.63.9d

8 de enero de 2026

Cambios:

  • PlaceSearchElement muestra el contenido que no es de fotos un poco más rápido mientras se cargan las fotos. Se mejoraron las animaciones de aparición gradual de las fotos en todo el kit de IU de Places.
  • Se mejoró el rendimiento cuando se renderizan polilíneas en un mapa inclinado.
  • Se corrigió un error por el que la cámara del mapa en 3D no se actualizaba cuando se configuraba de manera programática en ciertas condiciones.
  • Se realizó una pequeña mejora en el rendimiento de la carga de fotos para PlaceDetailsElement y PlaceSearchElement.
  • Se aclaró el comportamiento de la propiedad draggable en MapOptions para explicar mejor las restricciones de interacción del usuario.
  • Aplica el acceso al canal beta para possibleNextAction en la biblioteca de Address Validation
  • Se agregó compatibilidad con la propiedad placeholder y el atributo HTML a PlaceAutocompleteElement.
  • PlaceAutocompleteElement ahora admite la personalización de más propiedades de fuentes CSS estándar, incluidas font, font-size, font-family, font-weight, line-height, font-style y color. El tamaño de fuente predeterminado ahora es de 16 px.
  • Se agregó compatibilidad con la propiedad value y el atributo HTML a PlaceAutocompleteElement.
  • Optimizar la carga de imágenes en el kit de IU de Places
  • Se agregó la parte de CSS input a PlaceAutocompleteElement

3.63.5d

11 de diciembre de 2025

Cambios:

  • Se lanza la API de Address Validation en la API de Maps JavaScript.
  • mapTypeId ahora se establece de forma predeterminada en MapTypeId.ROADMAP cuando se configura como nulo o indefinido, lo que corrige un problema que podía provocar que no se cargaran las tarjetas de mapa.
  • Oculta la sección de opiniones en PlaceDetailsElement si el lugar no se puede calificar.
  • Se mejoró el contraste de color del logotipo de Google que se muestra en google.maps.Map con un estilo personalizado.
  • Los mapas de vectores ahora usan las mismas imágenes satelitales que los mapas de trama, lo que permite una mayor fidelidad visual.

3.63.4a

4 de diciembre de 2025

Cambios:

  • --gmp-mat-spacing-medium ahora se aplica al padding del contenedor interno para la vista horizontal de PlaceDetailsCompactElement.
  • Se solucionó un problema por el que el mapa en 3D se desplazaba en Safari para macOS cuando se interactuaba con los controles de la IU.
  • Ahora, las propiedades language y region se pueden cambiar de forma dinámica en Map3DElement sin necesidad de volver a crear un mapa.

3.63.1b

20 de noviembre de 2025

Cambios:

  • Se solucionó un problema por el que la ventana de información se posicionaba de forma incorrecta cuando se adjuntaba a un AdvancedMarkerElement.
  • Se hizo que el botón para borrar de PlaceAutocompleteElement solo sea visible cuando la entrada tiene texto.
  • Se hizo que la coincidencia del atributo de orientación no distinga mayúsculas de minúsculas en los estilos de PlaceDetailsCompactElement.
  • Se agregó la capacidad de inhabilitar el desplazamiento lateral del mapa cuando PopoverElement está abierto en los mapas en 3D.
  • Se corrigió un error que impedía el uso de addEventListener() en PinElement.
  • Los diálogos modales (como el diálogo de combinaciones de teclas en el mapa y el diálogo de divulgaciones en el kit de IU de Places) ahora se cierran con un clic fuera del área de contenido.
  • Los datos de Place ahora incluyen resúmenes informativos generados por IA para las opiniones y las comodidades cercanas. Las propiedades nuevas son evChargeAmenitySummary, neighborhoodSummary, generativeSummary y reviewSummary.

3.62.13e

6 de noviembre de 2025

Cambios:

  • Se corrigió un problema de fuga de memoria que se producía cuando se agregaba y quitaba un PopoverElement de forma dinámica al DOM.
  • Se corrigió un problema de fuga de memoria que se producía cuando se agregaba y quitaba un Map3DElement de forma dinámica al DOM.
  • Se corrigió la alineación de las esquinas redondeadas de la imagen con las esquinas redondeadas del contenedor cuando se usa un borde grueso en PlaceDetailsCompactElement.

3.62.12c

30 de octubre de 2025

Cambios:

  • [canal alfa] Se quitó el elemento experimental ElevationElement.
  • Se agregaron variables de CSS para background-color, border-radius, box-shadow y padding a Map 3D PopoverElement.
  • Los lightboxes de fotos del kit de IU de Places ya no se cierran cuando se hace clic fuera de la foto.

3.62.11d

23 de octubre de 2025

Cambios:

  • [Canal alfa] Se hizo que el modo oscuro funcione para destacar los elementos de la lista contextual de lugares.
  • Se agregaron las propiedades anchorLeft y anchorTop a AdvancedMarkerElementOptions.
  • Ya está disponible el componente web de <gmp-pin>. Usa la nueva propiedad glyphSrc para proporcionar una URL de imagen para el glifo o la propiedad glyphText para mostrar texto. La propiedad glyph ahora está obsoleta en PinElement.
  • Se evita que la ventana de información se muestre de forma inesperada cuando se crea un AdvancedMarker asociado fuera del viewport.
  • Los mapas en 3D ya están disponibles en el canal semanal. Esta versión incluye un nuevo control de brújula y controles de la IU predeterminados simplificados, compatibilidad con el diseño de mapas basado en Cloud y control de gestos cooperativos, localización mejorada con nuevas propiedades language y region en Map3DElement, así como mejoras de accesibilidad para las etiquetas del mapa base. Consulta Mapas en 3D en Maps JavaScript para obtener más información.
  • Se mejoró la administración de la memoria para Map 3D para evitar problemas de memoria insuficiente en dispositivos iOS.
  • Se lanzó Routes JS. Permite que los desarrolladores realicen llamadas a la API de Routes y tracen rutas con la API de Maps JavaScript.

3.62.9c

9 de octubre de 2025

Cambios:

  • Se agregaron las propiedades anchorTop y anchorLeft a AdvancedMarkerElement. Esto permite cambiar el punto de anclaje de un marcador a una posición diferente de la predeterminada (abajo, en el medio).

3.62.8d

2 de octubre de 2025

Cambios:

  • Se habilitaron nuevos controles de cámara para la API de Maps Embed.
  • [canal beta] La propiedad defaultUIDisabled de la clase Map3DElement y la interfaz Map3DElementOptions se reemplazó por defaultUIHidden. defaultUIDisabled seguirá funcionando en el canal beta.
  • [canal beta] Se reemplazó la propiedad rounds de la interfaz FlyAroundAnimationOptions por repeatCount. rounds seguirá funcionando en el canal beta.
  • La propiedad mapMode ahora está obsoleta en PlaceContextualElement.

3.62.7e

25 de septiembre de 2025

Cambios:

  • Habilita los marcadores para destacar de PlaceContextualElement.

3.62.6d

18 de septiembre de 2025

Cambios:

  • [canal beta] Se aclararon los mensajes de error de Route.
  • [Canal beta] Se agregó compatibilidad con los nombres de recursos de Place en las solicitudes de Route.
  • [canal beta] Se permite crear polilíneas de Route a partir de rutas de RouteLeg.

3.62.5d

10 de septiembre de 2025

Cambios:

  • [Canal beta] La propiedad coordinates de Polyline3DElement se reemplazó por path, que ya está disponible como un atributo HTML. La propiedad outerCoordinates de Polygon3DElement se reemplazó por path, que ya está disponible como un atributo HTML. La propiedad innerCoordinates de Polygon3DElement se reemplazó por innerPaths. Todas las propiedades "coordinates" de estos dos elementos dejaron de estar disponibles, pero seguirán funcionando en el canal beta.

3.62.3c

3 de septiembre de 2025

No hay cambios públicos.

3.62.2c

28 de agosto de 2025

Cambios:

3.62.1

21 de agosto de 2025

Cambios:

  • [canal beta] Se agregaron sessionToken y placeAutocompleteElement como opciones opcionales para la API de Address Validation para la administración de sesiones en AddressValidation.fetchAddressValidation()
  • [Canal beta] Se lanzó Routes JS. Permite que los desarrolladores realicen llamadas a la API de Routes y tracen rutas con la API de Maps JavaScript.

3.61.14

7 de agosto de 2025

Cambios:

  • Se corrigió un problema por el que la lightbox de fotos no estaba disponible en el elemento Place Details Compact en el modo horizontal.

3.61.12c

31 de julio de 2025

Cambios:

  • Se agregó documentación para campos adicionales en PlaceAutocompleteElementOptions y BasicPlaceAutocompleteElementOptions.
  • Se resolvió un problema por el que los marcadores avanzados parpadeaban brevemente y, luego, desaparecían cuando se desplazaban fuera de la pantalla.
  • Se agregó googleMapsLinks a la clase Place.

3.61.11a

24 de julio de 2025

Cambios:

  • Se agregaron originalText y originalTextLanguageCode a la clase Place Review.
  • [alpha channel] Enable mapMode for PlaceContextual Maps Grounding Widget. Permite que los usuarios cambien entre ROADMAP, HYBRID y NONE.
  • [Canal beta] Ahora, Map3DElement activa un evento si el mapa no se inicializa, p.ej., por falta de compatibilidad con WebGL en el navegador del usuario.
  • Las imágenes a 45° en el mapa dejaron de estar disponibles. Consulta Bajas: Imágenes a 45° para obtener más información.

3.61.10d

17 de julio de 2025

Cambios:

  • El widget básico de Place Autocomplete ya está disponible en el canal semanal.
  • [Canal alfa] Se quitó el PlaceListElement experimental.
  • Agrega PlaceSearchElement y los elementos de configuración o solicitud asociados.
  • Se agregaron tokens de estilo adicionales para PlaceDetailsElement y PlaceDetailsCompactElement.

3.61.9a

10 de julio de 2025

Cambios:

  • Se actualizaron los marcadores para evitar que se repitan las instrucciones de navegación en cada elemento cuando se usa un lector de pantalla. Ahora, la instrucción se anuncia solo una vez cada vez que se ingresa al grupo.
  • Se corrigió un problema de contraste en el diálogo de combinaciones de teclas en el modo oscuro.
  • Se habilitó la compatibilidad con la personalización del borde, el radio del borde, el color de fondo del widget y el esquema de colores para el elemento Place Autocomplete. El elemento Place Autocomplete ahora respeta automáticamente el modo oscuro. Para inhabilitarlo, aplica color-scheme: light en CSS.
  • Se agregaron campos googleMapsURI a las clases Place Photo y Review.
  • [canal beta] Se agregó la enumeración PossibleNextAction a la API de Address Validation.

3.61.7a

1 de julio de 2025

Cambios:

  • La funcionalidad de la capa de mapa de calor en la API de Maps JavaScript ya no es compatible. Esta API dejó de estar disponible en mayo de 2025 y no estará disponible en una versión posterior de la API de Maps JavaScript, que se lanzará en mayo de 2026. Para obtener más información, consulta https://developers.google.com/maps/deprecations).
  • Se corrigió un problema en GA que impedía el procesamiento de los clics en los lugares de interés que se ocultaban con el estilo personalizado.
  • [Canal beta] Se agregó un control adicional para la pérdida de contexto de WebGL en mapas 3D. Los mapas en 3D ahora intentarán restablecerse cuando se restablezca el contexto de WebGL.

3.61.6d

26 de junio de 2025

Cambios:

  • Se agregó internalUsageAttributionIds a Map3DElement y Map3DElementOptions.

3.61.5a

17 de junio de 2025

Cambios:

  • Se habilitó la compatibilidad con la cadena "IP_BIAS" para LocationBias en Place Autocomplete.
  • Se corrigió un error de documentación de SearchNearbyRequest. El valor predeterminado de SearchNearbyRequest.RankPreference es POPULARITY, no DISTANCE.

3.61.4a

12 de junio de 2025

Cambios:

  • Se agregó la enumeración RPCStatus para describir los códigos de estado que devuelven ciertos servicios web.

3.61.3b

5 de junio de 2025

No hay cambios públicos.

3.61.2

29 de mayo de 2025

Cambios:

  • Se agregaron PlaceDetailsElement, PlaceDetailsCompactElement y los elementos de configuración asociados. Se quitó PlaceDetailsSize.
  • Se corrigió un problema con PlaceAutocompleteElement en el que, cuando se seleccionaba una entrada de IME, el elemento seleccionaba un elemento de predicción.

3.61.1

22 de mayo de 2025

Cambios:

  • [Canal beta] Se corrigió el problema de la ubicación o el viewport faltantes en el resultado de PlaceDetailsCompactElement.
  • Los detalles a nivel de la calle están disponibles en las ciudades cubiertas.

3.60.12

8 de mayo de 2025

Cambios:

  • [Canal beta] Se agregó compatibilidad con la API de Address Validation en la API de Maps JavaScript.
  • Se solucionó un problema con las llamadas de red desde contextos sin encabezados Origin.

3.60.11 (revertida)

1 de mayo de 2025

Cambios:

  • [canal beta] Se agregó PlaceDetailsCompactElement y los elementos de configuración asociados.
  • Se corrigió un error por el que StreetViewPanoramaOptions.zoomControl = false no funcionaba en los mapas de Street View.

3.60.10

24 de abril de 2025

Cambios:

  • [canal beta] Los mapas en 3D ya están disponibles en el canal beta. Esta versión incluye mejoras de accesibilidad, así como nuevos elementos interactivos para polilíneas, polígonos y modelos en 3D. Además, ahora hay un nuevo PopoverElement disponible para mostrar contenido HTML personalizado en mapas en 3D. Consulta Mapas en 3D en Maps JavaScript para obtener más información.

3.60.9

17 de abril de 2025

Cambios:

  • [canal alfa] Se lanzó PlaceContextualElement a la versión experimental sin restricciones.
  • [Canal alfa] Los modelos 3D ahora se renderizan con una iluminación basada en imágenes (IBL) de forma predeterminada en los mapas en 3D.

3.60.8

9 de abril de 2025

Cambios:

  • [Canal beta] Se quitó por completo la API de LocalContext. Si intentas crear una instancia de LocalContextMapView, ahora se arrojará un error. Consulta https://developers.google.com/maps/deprecations#localcontext-deprecation para obtener más información.
  • Se corrigió un error que causaba un comportamiento extraño cuando se arrastraban marcadores avanzados en dispositivos táctiles.
  • Se aumentó la opacidad de la superposición de la función de control cooperativo de gestos para que el texto cumpla con los requisitos de contraste en todas las áreas del mapa.
  • Se agregó compatibilidad con PostalAddress en la API de Places.
  • Garantiza que la superposición de mapas estáticos durante el inicio tenga el mismo colorScheme que el mapa subyacente.

3.60.7b

3 de abril de 2025

Cambios:

  • El widget de Place Autocomplete ya está disponible en el canal semanal.

3.60.6

27 de marzo de 2025

Cambios:

  • Se corrigió un problema en Safari en el que las páginas que usaban overscroll-behavior no se desplazaban correctamente.
  • Se corrigió el parpadeo que se producía cuando se agregaban muchos marcadores avanzados con el comportamiento de colisión habilitado.
  • Se agregó compatibilidad con PriceRange en Places.

3.60.5 (revertida)

20 de marzo de 2025

Cambios:

  • Se corrigió un error que impedía que se pudiera desplazar la página cuando se hacía clic o se tocaban los marcadores avanzados.
  • Se corrigió un error que causaba que el modo de pantalla completa no funcionara correctamente en <gmp-map>.
  • Se corrigió un error por el que la ventana de información de un marcador avanzado oculto seguía visible.
  • Los mapas con diseños personalizados en el mapa de ruta no perderán su diseño personalizado cuando se agregue la capa de rutas en bicicleta.

3.60.4

11 de marzo de 2025

Cambios:

  • Los estilos y colores de fondo personalizados se aplican al tipo de mapa y al esquema de colores específicos para los que se define el estilo (inicialmente, esto se limitará a Mapa de ruta y Mapa de ruta oscuro). La capa de transporte público mantendrá cualquier estilo personalizado para el tipo de mapa seleccionado.

3.60.3 (revertida)

5 de marzo de 2025

Cambios:

  • Se corrigió un error que causaba que no se mostrara el panel de instrucciones sobre cómo llegar.

3.60.2

27 de febrero de 2025

Cambios:

  • Places: Se agregó compatibilidad con el tipo de conector de VE NACS (SAE J3400).
  • Se lanzaron los elementos HTML gmp-map y gmp-advanced-marker para DG.

3.60.1

20 de febrero de 2025

Cambios:

  • [Canal alfa] altitudeMode en Polygon3DElement y Polyline3DElement ahora tiene el valor predeterminado CLAMP_TO_GROUND.
  • [Canal alfa] Ahora se debe configurar una nueva opción mode en Map3DElement para que se renderice el mapa en 3D (hay 2 valores nuevos disponibles: HYBRID y SATELLITE). Se quitó la opción defaultLabelsDisabled existente. Configura mode como HYBRID o SATELLITE.
  • [canal beta] El color de fondo volverá al valor predeterminado o al color establecido en MapOptions si no se estableció específicamente para un tipo de mapa en particular.
  • [canal beta] Los estilos personalizados de trama solo deben aplicarse al tipo de mapa al que se asignó el estilo.
  • Se solucionó un problema por el que los marcadores avanzados se desplazaban cuando se arrastraban en el modo de pantalla completa. También se solucionó un problema por el que el muñeco naranja de Street View se desplazaba cuando se arrastraba en el modo de pantalla completa.
  • Reemplaza el control de zoom predeterminado por el nuevo control de la cámara, que contiene los botones de desplazamiento lateral y zoom.
  • Actualiza los íconos de los botones de zoom para que se alineen con los nuevos íconos de los botones de desplazamiento.

3.59.8

6 de febrero de 2025

Cambios:

  • Ahora los clientes pueden acceder a los valores de TransitFare como texto.
  • [Canal alfa] Se lanzó el nuevo AirQualityMeterElement: <gmp-air-quality-meter>.
  • [canal alfa] El uso de PlaceAutocompleteElement ahora requerirá que la API de Places (nueva) esté habilitada en el proyecto de Google Cloud. .
  • [Canal alfa] PlaceAutocompleteElement: El evento gmp-placeselect se reemplaza por gmp-select y proporciona un objeto PlacePredictionSelectEvent en lugar de un objeto PlaceAutocompletePlaceSelect.
  • [Canal alfa] PlaceAutocompleteElement: El evento gmp-requesterror se reemplaza por gmp-error y proporciona un objeto Event en lugar de un objeto PlaceAutocompleteRequestErrorEvent.
  • [Canal alfa] PlaceAutocompleteElement: Se reemplazó componentRestrictions por includedRegionCodes.
  • [canal alfa] PlaceAutocompleteElement: types se reemplaza por includedPrimaryTypes.

3.59.7

30 de enero de 2025

Cambios:

  • [canal beta] Los colores de fondo de la hoja de ruta y de la hoja de ruta en modo oscuro que se establezcan para los estilos personalizados se deben renderizar detrás de las tarjetas y más allá de los márgenes del mapa.
  • [Canal Beta] Un mapa de ruta con diseño personalizado (o un mapa de ruta en modo oscuro) mantendrá su diseño personalizado cuando se agregue una capa de transporte público, en lugar de volver al diseño de mapa base predeterminado.
  • Los mapas que estén en modo oscuro permanecerán en ese modo cuando se agregue la capa de transporte público.

3.59.6

23 de enero de 2025

No hay cambios públicos.

3.59.5

16 de enero de 2025

Cambios:

  • Se corrigió un error que causaba que se generaran errores no detectados cuando se creaba una panorámica de Street View personalizada.

3.59.4a

9 de enero de 2025

Cambios:

  • Se corrigió un error que causaba que se generaran errores no detectados cuando se habilitaba la capa de tráfico.
  • [Canal beta] Se resolvió un problema por el que PlaceAutocompleteElement no enfocaba correctamente.
  • [canal beta] Los componentes atómicos del mapa se mostrarán en las ciudades admitidas con un nivel de zoom de 17 o superior.

Notas de versiones anteriores

Para consultar las notas de la versión de 2024 y años anteriores, consulta el archivo de notas de la versión de la API de Maps JavaScript.