Control de versiones

El equipo de la API de Maps JavaScript actualiza la API con funciones nuevas, correcciones de errores y mejoras de rendimiento. En esta página, se describen las versiones de la API que se encuentran disponibles para usarse en tus aplicaciones.

Canales y números de versiones

En tu aplicación, puedes especificar los canales o números de versiones:

  • El canal semanal se especifica con v=weekly.
    Este canal se actualiza una vez por semana y es el más actual.
  • El canal trimestral se especifica con v=quarterly.
    Este canal se actualiza una vez por trimestre y es el más predecible.
  • El canal beta se especifica con v=beta.
    Este canal se basa en el canal weekly y se actualiza una vez por semana. Incluye cambios adicionales que se usarán para realizar pruebas anticipadas y recibir comentarios.
  • El canal alfa se especifica con v=alpha.
    Este canal se basa en el canal beta y se actualiza una vez por semana. Incluye experimentos para que los clientes brinden comentarios sobre los prototipos. Además, debe usarse únicamente con fines de desarrollo y no en producción.
  • El número de versión se especifica con v=n.nn.
    Puedes elegir v=3.58, v=3.57, v=3.56 o v=3.55.
    Los números de versión se actualizan una vez por trimestre (consulta la sección Actualizaciones trimestrales).

Si no especificas de forma explícita un canal o una versión, recibirás el canal semanal de forma predeterminada. Si migraste desde el plan Premium y no especificaste de forma explícita un canal o una versión, recibirás el canal trimestral de forma predeterminada. Si especificas una versión no válida, recibirás el canal predeterminado.

Cómo elegir el canal semanal

Para la mayoría de las aplicaciones, recomendamos usar el canal semanal. Es la versión más reciente y actualizada y contiene las últimas correcciones de errores y mejoras de rendimiento. Para especificar el canal semanal, carga la API de Maps JavaScript con la siguiente etiqueta de la secuencia de comandos:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=weekly
        &key=YOUR_API_KEY&callback=initMap">
</script>

Actualmente, el canal semanal es la versión 3.58. Esta versión se actualiza semanalmente con funciones nuevas, correcciones de errores y mejoras de rendimiento.

A mediados de noviembre, el canal semanal se actualizará a versión 3.59. En ese momento, es posible que la versión nueva quite funciones obsoletas o genere incompatibilidades con versiones anteriores.

Cómo elegir el canal trimestral

En algunas aplicaciones, es conveniente utilizar actualizaciones menos frecuentes pero más grandes, porque brindan una mayor previsibilidad. Estas aplicaciones deben usar el canal trimestral. Usa este enfoque si deseas que las correcciones de errores y las mejoras de rendimiento se realicen en el momento esperado (consulta la sección Actualizaciones trimestrales). Para especificar el canal trimestral, carga la API de Maps JavaScript con la siguiente etiqueta de la secuencia de comandos:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=quarterly
        &key=YOUR_API_KEY&callback=initMap">
</script>

Actualmente, el canal trimestral es la versión 3.57. Durante el trimestre, esta versión no recibe funciones nuevas, correcciones de errores ni mejoras de rendimiento. Es posible que, ocasionalmente, realicemos correcciones de errores de seguridad en esta versión.

A mediados de noviembre, el canal trimestral se actualizará a la versión 3.58. En ese momento, es posible que esa versión incluya funciones nuevas, quite las funciones obsoletas o genere incompatibilidades con versiones anteriores de los tres meses previos.

Cómo elegir el canal beta

Usa el canal beta para probar nuevas funciones y cambios. Las funciones beta son funciones completas, pero pueden tener algunos problemas pendientes (usa la Herramienta de seguimiento de errores para informar problemas y enviar comentarios). El canal beta no posee ningún ANS ni una política de baja, y es posible que algunos cambios no sean retrocompatibles con versiones anteriores.

Este canal se basa en el canal weekly y se actualiza una vez por semana.

Para especificar el canal beta, carga la API de Maps JavaScript con la siguiente etiqueta de la secuencia de comandos:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=beta
        &key=YOUR_API_KEY&callback=initMap">
</script>

Cómo elegir el canal alfa

Usa el canal alfa para probar nuevas funciones y cambios experimentales. Usa la Herramienta de seguimiento de errores para informar problemas y enviar comentarios. El canal alfa no posee ningún ANS ni una política de baja, y es posible que algunos cambios no sean retrocompatibles con versiones anteriores. Además, debe usarse únicamente con fines de desarrollo y no en producción.

Este canal se basa en el canal beta y se actualiza una vez por semana.

Para especificar el canal alfa, carga la API de Maps JavaScript con la siguiente etiqueta de la secuencia de comandos:

  <script async
      src="https://maps.googleapis.com/maps/api/js?v=alpha
          &key=YOUR_API_KEY&callback=initMap">
  </script>
  

Cómo elegir un número de versión

Especifica una versión por su número solo si pruebas y actualizas tu aplicación con regularidad. Esto se debe a que, con el tiempo, las versiones numeradas se borran a medida que se crean versiones nuevas cada trimestre. Para especificar el número de versión, carga la API de Maps JavaScript con la siguiente etiqueta de la secuencia de comandos:

<script async
    src="https://maps.googleapis.com/maps/api/js?v=3.57
        &key=YOUR_API_KEY&callback=initMap">
</script>

Actualmente, puedes especificar v=3.58, v=3.57, v=3.56 o v=3.55.

  • La versión 3.58 recibe actualizaciones semanales con funciones nuevas, correcciones de errores y mejoras en el rendimiento.
  • La versión 3.57 no recibe actualizaciones semanales.
  • La versión 3.56 no recibe actualizaciones semanales.
  • La versión 3.55 no recibe actualizaciones semanales.
  • Es posible que, ocasionalmente, realicemos correcciones de errores de seguridad en alguna de estas versiones.
  • Es posible que implementemos cambios incompatibles con las versiones anteriores al crear una versión nueva.

Después de mediados de noviembre, podrás especificar v=3.59, v=3.58, v=3.57 o v=3.56.

  • La versión 3.59 recibirá actualizaciones semanales con funciones nuevas, correcciones de errores y mejoras en el rendimiento.
  • La versión 3.58 ya no recibirá actualizaciones semanales.
  • La versión 3.57 ya no recibirá actualizaciones semanales.
  • La versión 3.56 ya no recibirá actualizaciones semanales.
  • Es posible que, ocasionalmente, realicemos correcciones de errores de seguridad en alguna de estas versiones.
  • La versión 3.55 ya no estará disponible. Se ignorará cualquier intento de cargar esta versión y, en su lugar, recibirás tu canal predeterminado.

En el siguiente diagrama, se muestra qué versiones estarán disponibles en cada canal durante el próximo año.

. v=weekly v=trimestral v=3.nn v=3.nn-1 Ago de 2024 Noviembre de 2024 Febrero de 2025 Mayo de 2025 v3.55 v3.56 v3.56 v3.57 v3.57 v3.57 v3.58 v3.58 v3.58 v3.58 v3.59 v3.59 v3.59 v3.60 v3.60 v3.61

Una actualización afectó mi aplicación

Las actualizaciones de los canales de versiones pueden afectar tu aplicación. Esto puede ocurrir porque tu aplicación depende de funciones obsoletas o sin documentar, o debido a un error o una corrección de errores que implementamos.

Como solución temporal, puedes reconfigurar tu aplicación para que use una versión anterior.

  1. Abre la consola en las herramientas para desarrolladores de tu navegador y observa el valor de google.maps.version.
  2. Actualiza la etiqueta de la secuencia de comandos que carga la API y solicita un número de versión anterior.
    Por ejemplo, si google.maps.version es "3.58.2", usa v=3.57 en la etiqueta de la secuencia de comandos.
    Esta solución temporal solo funcionará por un tiempo limitado.

Una vez que se implemente la solución temporal, tendrás tiempo (en general, de 3 a 6 meses) para actualizar la aplicación de modo que ya no use las funciones obsoletas o sin documentar y considere los errores o las correcciones de errores.

Luego, debes volver a usar la etiqueta original de la secuencia de comandos para cargar la API.

También puedes crear un caso de asistencia o informar un problema.

Actualizaciones trimestrales

Una vez por trimestre, el equipo de la API de Maps JavaScript lanza una versión nueva. Esto sucede a mediados de febrero, a mediados de mayo, a mediados de agosto y a mediados de noviembre. La próxima actualización será a mediados de noviembre. El nuevo canal semanal proporcionará la versión 3.59, y, en ese momento, se actualizarán los demás.

Actualización del canal semanal

Actualmente, el canal semanal usa la versión 3.58.

A mediados de noviembre, el canal semanal se actualizará de la versión 3.58 a la versión 3.59. En ese momento, esta versión puede incluir funciones nuevas, quitar aquellas obsoletas o generar incompatibilidades con versiones anteriores. Es posible que debas probar estos cambios cuando se actualice el canal.

En el transcurso del trimestre, la nueva versión se actualizará semanalmente con funciones nuevas, correcciones de errores y mejoras de rendimiento. No se quitarán las funciones obsoletas ni se generarán incompatibilidades con versiones anteriores.

Actualización del canal trimestral

Actualmente, el canal trimestral usa la versión 3.57.

A mediados de noviembre, el canal trimestral se actualizará desde la versión 3.57 a la versión 3.58. Después de la actualización, esta versión puede incluir funciones nuevas, quitar aquellas obsoletas o generar incompatibilidades con versiones anteriores de los tres meses previos. Es posible que debas probar estos cambios cuando se actualice el canal.

En el transcurso del trimestre, esta versión no incluirá funciones nuevas, correcciones de errores ni mejoras de rendimiento. No se quitarán las funciones obsoletas ni se generarán incompatibilidades con versiones anteriores.

Actualizaciones de versiones

A mediados de noviembre, los números de la versión se desplazarán para adaptarse al lanzamiento de una versión nueva.

Versión 3.59

A mediados de noviembre, se lanzará la nueva versión 3.59. Después del lanzamiento, esta versión incluirá funciones nuevas, quitará las funciones obsoletas, o generar incompatibilidades con versiones anteriores en comparación con la versión 3.58. Debes probar tu aplicación cuando cambies de número de versión.

Durante el trimestre, la nueva versión se actualizará semanalmente con nuevas funciones, correcciones de errores y mejoras de rendimiento. No se quitarán las funciones obsoletas ni se generarán incompatibilidades con versiones anteriores.

Versión 3.58

Esta versión incluye funciones nuevas, quita las funciones obsoletas o presenta incompatibilidades con versiones anteriores en comparación con la versión 3.57. Debes probar tu aplicación cuando cambies de número de versión.

Después de mediados de noviembre, esta versión ya no se actualizará con funciones nuevas, correcciones de errores ni mejoras de rendimiento. No se quitarán las funciones obsoletas ni se generarán incompatibilidades con versiones anteriores.

Versión 3.57

Esta versión incluye funciones nuevas, quita las funciones obsoletas o presenta incompatibilidades con versiones anteriores en comparación con la versión 3.56. Debes probar tu aplicación cuando cambies de número de versión.

Esta versión ya no se actualizará con funciones nuevas, correcciones de errores ni mejoras de rendimiento. No se quitarán las funciones que dejaron de estar disponibles después de esta versión ni se generarán nuevas incompatibilidades con versiones anteriores.

Versión 3.56

Esta versión incluye funciones nuevas, quita las funciones obsoletas o presenta incompatibilidades con versiones anteriores en comparación con la versión 3.55. Debes probar tu aplicación cuando cambies de número de versión.

Esta versión ya no se actualizará con funciones nuevas, correcciones de errores ni mejoras de rendimiento. No se quitarán las funciones que dejaron de estar disponibles después de esta versión ni se generarán nuevas incompatibilidades con versiones anteriores.

Versión 3.55

Después de mediados de noviembre, se eliminará esta versión y ya no se podrá usar. Se ignorará cualquier intento de cargar esta versión y, en su lugar, recibirás tu canal predeterminado.

Versiones compatibles

En cada trimestre, hay cuatro versiones disponibles. Las cuatro versiones son compatibles.

Verificaciones de la versión

Para realizar una depuración, usa la propiedad google.maps.version a fin de obtener la versión actual de la API de Maps JavaScript en tu aplicación. En la siguiente muestra de código, se escribe la versión de API en la consola del navegador. (Para obtener más información sobre la consola del navegador, consulta la guía para verificar errores en tu navegador).

<!DOCTYPE html>
<html>
  <head>
    <title>Display Google Maps API Version</title>
  </head>
  <body>
    <script>
      function initMap() {
        // Add your map here.
        console.log('Google Maps API version: ' + google.maps.version);
      }
    </script>
    <script src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap"
    defer></script>
  </body>
</html>

Documentación para las versiones de la API

En la guía para desarrolladores, siempre se describe la versión semanal.

A su vez, se conserva una referencia por separado para cada versión: