Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar la Google Maps JavaScript API

Para que puedas comenzar, te proporcionaremos orientación en la Google Developers Console a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar la Google Maps JavaScript API y servicios relacionados
  3. Crear claves correspondientes
Continuar

Versiones

El equipo de la Google Maps JavaScript API actualiza la API con nuevas funciones, 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, ya sea en un entorno de prueba o de producción. Las versiones de la API tienen los siguientes nombres:

  • Experimental
  • Lanzamiento
  • Sin actualizar

También ofrecemos prácticas recomendadas para administrar tus procedimientos de versiones según el tipo de propósito de tu aplicación.

Sustitución y tipos de versiones

Todos los trimestres, lanzamos una versión nueva con número y la publicamos para usarse como versión experimental. Al mismo tiempo, la versión experimental previa se convierte en la versión de lanzamiento y la versión de lanzamiento previa se convierte en la versión sin actualizar. Este proceso se llama sustitución de versiones.

Durante los trimestres, continuamos agregando correcciones de errores a las versiones experimentales y de lanzamiento. Estas actualizaciones se observan en las notas de la versión de la Google Maps JavaScript API.

Puedes indicar la versión de la API que debe cargarse en tu aplicación especificándola en el parámetro v de la solicitud de arranque de la Google Maps JavaScript API. Se admiten las siguientes opciones:

  • La versión experimental, especificada con v=3.exp.
  • La versión de lanzamiento, especificada con v=3.
  • Un número de versión específico. Por ejemplo, v=3.25 o v=3.26.

Si no especificas de forma explícita una versión, recibirás la versión experimental de forma predeterminada en caso de que seas cliente del plan estándar (esto incluye clientes que no proporcionen una clave). Si eres cliente del plan premium y no especificas una versión, de forma predeterminada recibirás la versión de lanzamiento.

La versión experimental

La versión experimental (actualmente, la 3.27) contiene las funciones y correcciones de errores más recientes a medida que estén disponibles para el público. No se garantiza los cambios aplicados a la versión experimental tengan estabilidad en términos de funciones. Te recomendamos probar tus aplicaciones de manera regular con la versión experimental. Puedes hacerlo agregando v=3.27 al cargar la API. Si te gusta vivir al límite, puedes agregar v=3.exp para recibir siempre la versión experimental actual con todas las últimas funciones.

Puedes especificar la versión experimental con el siguiente arranque:

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

La versión de lanzamiento

En la versión de lanzamiento, aplicamos correcciones a errores de manera constante y, al mismo tiempo, nos aseguramos de que el conjunto de funciones permanezca estable. Las correcciones se mencionan en las notas de la versión.

La versión de lanzamiento actual es la 3.26. Puedes solicitarla con cualquiera de los siguientes arranques:

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

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

La versión sin actualizar

Cuando lanzamos una nueva versión con número, dejamos sin actualizar la versión de lanzamiento anterior. Esto significa que dejamos de actualizarla con correcciones de errores regulares. Sin embargo, es posible que de tanto en tanto realicemos cambios; por ejemplo, si hay motivos legales para hacerlo.

Cada vez que presentamos una versión sin actualizar, retiramos la versión sin actualizar previa. Cuando se especifique una versión retirada, como la v=3.0, siempre se devolverá la versión sin actualizar actual.

La versión sin actualizar actual es la 3.25. Puedes solicitarla con el siguiente arranque:

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

Prácticas recomendadas

El equipo Google Maps JavaScript API se esfuerza al máximo por mantener la compatibilidad entre las diferentes versiones de la API. Sin embargo, para continuar proporcionando un servicio moderno, y también por motivos operacionales, de tanto en tanto realizamos cambios que pueden interactuar con funciones existentes. En ocasiones como estas, en especial para aplicaciones más avanzadas, probablemente sea necesario realizar ajustes en el código mediante la Google Maps JavaScript API, a fin de que tu código continúe funcionando como se espera. A continuación, presentamos prácticas recomendadas para el uso de versiones en varias situaciones comunes.

Para aplicaciones de alta disponibilidad y alto tráfico

Con la voluntad de hacer un esfuerzo adicional para garantizar la estabilidad y la disponibilidad

Para garantizar que la sustitución de versiones no genere problemas, te recomendamos especificar de manera explícita el número de la versión de lanzamiento actual de la API del arranque. Por ejemplo, v=3.26. Para evitar terminar usando la versión sin actualizar de la API a medida que transcurra el tiempo, es importante suscribirse a las notificaciones de sustitución de versiones de Google en el grupo de notificaciones y anuncios de la Google Maps JavaScript API V3.

Una vez que tenga lugar la sustitución de una versión (cada trimestre), tu sistema de producción solicitará la versión sin actualizar de la API. En este momento, recomendamos configurar un entorno de organización y desarrollo para probar tu aplicación con la nueva versión de lanzamiento de la API. Si surge algún problema, puedes realizar los ajustes necesarios en tu código. Cuando tengas la certeza de que tu aplicación funciona bien con la nueva versión de lanzamiento de la API, podrás encargarte de las correcciones necesarias (si las hay) y actualizar simultáneamente tu aplicación par solicitar el número de versión correspondiente a la nueva versión de lanzamiento.

Para aplicaciones regulares

Te recomendamos especificar v=3 en tu solicitud de arranque. Esto significa que siempre obtienes la versión de lanzamiento actual de la Google Maps JavaScript API ya sometida a un gran volumen de tráfico y a las correcciones de errores necesarias. En la mayoría de los casos, la expectativa normal no debe incluir la necesidad de realizar acciones al sustituir una versión. Sin embargo, para asegurarte de que tu aplicación continúe funcionando bien, te recomendamos suscribirte a las notificaciones de sustitución de versiones de Google en el grupo de notificaciones y anuncios de la Google Maps JavaScript API V3.

Después de una sustitución, tu aplicación usará una nueva versión de la Google Maps JavaScript API. También puede resultarte conveniente inspeccionar las notas de la versión para conocer los cambios que pueden afectarte. Si observas que algo en tu aplicación no funciona correctamente, puedes regresar a la versión anterior especificando de manera explícita el número de la versión sin actualizar actual en tu solicitud de arranque, mientras realizas los ajustes necesarios en tu código.

Para aplicaciones de última generación

La búsqueda del acceso temprano a las funciones más recientes

Para las aplicaciones en las cuales la disponibilidad constante es un aspecto menos crítico, te recomendamos acceder a todas las funciones más recientes solicitando la versión experimental (v=3.exp) de la Google Maps JavaScript API. Google prueba por completo la versión experimental cada semana antes del lanzamiento. Generalmente, esta es bastante estable. Sin embargo, el ciclo de lanzamientos semanales implica que deben aplicarse controles adicionales para garantizar que tu aplicación continúe funcionando como se espera.

Comprobación de la versión

Para depurar, usa la propiedad google.maps.version para obtener la versión actual de la Google Maps JavaScript API en tu aplicación. Con el siguiente ejemplo de código se escribe la versión de API en la consola del navegador. (Si deseas más información sobre la consola del navegador, consulta la guía para comprobar 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?YOUR_API_KEY&callback=initMap"
    async defer></script>
  </body>
</html>

Documentación para las versiones de la API

En la guía del desarrollador siempre se describe la versión experimental.

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

Enviar comentarios sobre...

Google Maps JavaScript API
Google Maps JavaScript API
Si necesitas ayuda, visita nuestra página de asistencia.