Control de versiones

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>
    (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
      key: "YOUR_API_KEY",
      v: "weekly",
    });
  </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 la 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>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "quarterly",
  });
  </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>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "beta",
  });
  </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>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: "alpha",
  });
  </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>
  (g=>{var h,a,k,p="The Google Maps JavaScript API",c="google",l="importLibrary",q="__ib__",m=document,b=window;b=b[c]||(b[c]={});var d=b.maps||(b.maps={}),r=new Set,e=new URLSearchParams,u=()=>h||(h=new Promise(async(f,n)=>{await (a=m.createElement("script"));e.set("libraries",[...r]+"");for(k in g)e.set(k.replace(/[A-Z]/g,t=>"_"+t[0].toLowerCase()),g[k]);e.set("callback",c+".maps."+q);a.src=`https://maps.${c}apis.com/maps/api/js?`+e;d[q]=f;a.onerror=()=>h=n(Error(p+" could not load."));a.nonce=m.querySelector("script[nonce]")?.nonce||"";m.head.append(a)}));d[l]?console.warn(p+" only loads once. Ignoring:",g):d[l]=(f,...n)=>r.add(f)&&u().then(()=>d[l](f,...n))})({
    key: "YOUR_API_KEY",
    v: 3.57,
  });
  </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 de 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 de 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.

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 otros canales.