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.64, v=3.63, v=3.62 o v=3.61.
  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>
    (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.64. Esta versión se actualiza semanalmente con funciones nuevas, correcciones de errores y mejoras de rendimiento.

A mediados de mayo, el canal semanal se actualizará a la versión 3.65. 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.63. 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 mayo, el canal trimestral se actualizará a la versión 3.64. 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.

Te recomendamos que, a principios de mayo, pruebes tu aplicación con v=3.64.

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.63,
  });
  </script>

Actualmente, puedes especificar v=3.64, v=3.63, v=3.62 o v=3.61.

• La versión 3.64 recibe actualizaciones semanales con funciones nuevas, correcciones de errores y mejoras de rendimiento.
• La versión 3.63 no recibe actualizaciones semanales.
• La versión 3.62 no recibe actualizaciones semanales.
• La versión 3.61 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 versiones anteriores al crear una versión nueva.

Después de mediados de mayo, podrás especificar v=3.65, v=3.64, v=3.63 o v=3.62.

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

Si usas v=3.62 o v=3.61, te recomendamos que actualices a v=3.64 o v=3.63 antes de mediados de mayo. Cuando cambies de versión, recuerda que las versiones más recientes pueden quitar funciones obsoletas o generar incompatibilidades con versiones anteriores.

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

v=quarterly v=3.nn v=3.nn-1 Feb 2026 May 2026 Aug 2026 Nov 2026 v3.61 v3.62 v3.62 v3.63 v3.63 v3.63 v3.64 v3.64 v3.64 v3.64 v3.65 v3.65 v3.65 v3.66 v3.66 v3.67