Versión 3 del API de JavaScript de Google Maps

Conceptos

  1. Desarrollo para dispositivos móviles
  2. Localización
  3. Versiones
  4. Cómo solucionar problemas

Desarrollo para dispositivos móviles

La versión 3 del API de Google Maps está diseñada para cargarse rápidamente y funcionar correctamente en dispositivos móviles. En especial, nos hemos centrado en el desarrollo para dispositivos móviles avanzados (por ejemplo, los que utilizan los sistemas operativos iOS y Android). Los dispositivos móviles tienen tamaños de pantalla más pequeños que los de los típicos navegadores de escritorio. Por otra parte, también suelen tener comportamientos específicos de ese tipo de dispositivos como, por ejemplo, la ampliación o reducción de la imagen pellizcando la pantalla. Si quieres que tu aplicación funcione correctamente en dispositivos móviles, te recomendamos lo siguiente:

  • Define el elemento <div> que contiene tu mapa para disponer de atributos de anchura y altura del 100%. No obstante, ten en cuenta que algunos navegadores de escritorio más antiguos no muestran el contenido correctamente con estos valores.
  • Puedes detectar los dispositivos iPhone y Android inspeccionando la propiedad navigator.userAgent en el DOM:
    function detectBrowser() {
      var useragent = navigator.userAgent;
      var mapdiv = document.getElementById("map_canvas");
    
      if (useragent.indexOf('iPhone') != -1 || useragent.indexOf('Android') != -1 ) {
        mapdiv.style.width = '100%';
        mapdiv.style.height = '100%';
      } else {
        mapdiv.style.width = '600px';
        mapdiv.style.height = '800px';
      }
    }
    

    Esto permite cambiar el diseño para determinados dispositivos, al igual que hemos hecho aquí para modificar el estado real de la pantalla de los dispositivos.

  • Los dispositivos con iOS y Android respetan la siguiente etiqueta <meta>:

    <meta name="viewport" content="initial-scale=1.0, user-scalable=no" />
    

    Esta configuración especifica que el mapa se debe mostrar en modo de pantalla completa y que el usuario no debe poder modificar su tamaño. Ten en cuenta que el navegador Safari de iPhone requiere que se incluya la etiqueta <meta> en el elemento <head> de la página.

Para obtener más información sobre el desarrollo de aplicaciones para iPhone, consulta la documentación para desarrolladores de Apple. Para obtener más información sobre el desarrollo de dispositivos con Android, consulta la documentación de Android.

Localización

Puedes localizar tu aplicación del API de Google Maps mediante la modificación de la configuración de idioma y del código de región de la aplicación, que determina el comportamiento de la aplicación en función del país o territorio seleccionados.

Localización de idioma

El API de Google Maps utiliza la configuración de idioma preferida del navegador al mostrar información de texto como, por ejemplo, los nombres de los controles, las notificaciones de derechos de autor, las indicaciones para llegar en coche y las etiquetas de los mapas. En la mayoría de los casos, es preferible; normalmente no se quiere anular la configuración de idioma preferida del usuario. No obstante, si quieres cambiar el API de Google Maps para ignorar la configuración de idioma del navegador y obligarlo a mostrar la información en un idioma determinado, puedes añadir un parámetro language opcional a la etiqueta <script> al incluir el código del JavaScript del API de Google Maps, especificando el idioma que desees utilizar.

Por ejemplo, si quieres que la aplicación del API de Google Maps aparezca en japonés, añade &language=ja a la etiqueta <script> del siguiente modo:

<script type="text/javascript" src="http://maps.googleapis.com/maps/api/js?sensor=false&language=ja">

Nota: si se carga el API de la forma indicada anteriormente, se utilizará el idioma japonés para todos los usuarios independientemente de las preferencias del usuario. Asegúrate de que este sea el comportamiento que quieres antes de configurar esta opción.

Ver ejemplo (map-language.html)

El API de JavaScript de Google Maps también admite el texto bidireccional (Bidi) que contiene caracteres tanto en idiomas que se escriben de izquierda a derecha como en idiomas que se escriben de derecha a izquierda. Algunos ejemplos de idiomas que se escriben de derecha a izquierda son el árabe, el hebreo y el persa. Normalmente debes especificar las páginas de los idiomas que se escriben de derecha a izquierda para mostrarlas correctamente añadiendo dir='rtl' al elemento <html> de la página. En el siguiente ejemplo se representa un mapa de El Cairo (Egipto) con controles árabes:

Ver ejemplo (map-rtl.html)

Consulta también la lista de idiomas admitidos. Ten en cuenta que esta lista puede no ser exhaustiva, ya que actualizamos los idiomas admitidos con frecuencia.

Localización de región

El API de Google Maps ofrece mosaicos de mapa y modifica el comportamiento de la aplicación de forma predeterminada utilizando el país del dominio de alojamiento desde el que se carga el API. Si quieres alterar tu aplicación para ofrecer diferentes mosaicos de mapa o para modificar la aplicación (por ejemplo, los resultados de codificación geográfica de región), puedes anular este comportamiento predeterminado añadiendo un parámetro region a la etiqueta <script> al incluir el código JavaScript del API de Google Maps.

Como desarrollador de una aplicación del API de Google Maps, eres responsable de garantizar que tu aplicación cumpla las leyes locales. Para ello, asegúrate de que aplicas la localización de la región correcta para el país donde lanzarás la aplicación.

El parámetro region acepta los identificadores de subetiqueta de región de Unicode que, normalmente, tienen una asignación de uno a uno para los dominios de nivel principal de código de país. La mayoría de los identificadores de región de Unicode son idénticos a los códigos ISO 3166-1, con algunas excepciones importantes. Por ejemplo, el dominio de nivel principal de código de país de Gran Bretaña es "uk" (correspondiente al dominio .co.uk) mientras que su identificador de región es "GB".

Por ejemplo, para utilizar una aplicación del API de Google Maps localizada para el Reino Unido, añade &region=GB a la etiqueta <script> como se indica a continuación:

<script type="text/javascript" src="http://maps.googleapis.com/maps/api/js?sensor=false&region=GB">

En los siguientes ejemplos se muestran dos mapas, uno que codifica de forma geográfica "Toledo" en función de la región predeterminada (EE.UU.) para "Toledo, Ohio" y otro que modifica los resultados en función de una región (region) establecida para ES (España) para "Toledo, España".

Versiones

El equipo del API de Google Maps actualizará con regularidad esta API de JavaScript con nuevas funciones, correcciones de errores y mejoras de rendimiento. Todas las modificaciones del API serán compatibles con versiones anteriores para que las aplicaciones que lances con las interfaces documentadas actualmente puedan seguir funcionando sin modificaciones conforme se actualice el API (nota: las funciones en fase de prueba, documentadas en la referencia del API de prueba no se incluyen en esta garantía. Las funciones que estén en fase de prueba se etiquetarán claramente en la documentación del API).

Tipos de versiones

Puedes indicar la versión del API que desees cargar en tu aplicación especificándola con el parámetro v de la solicitud de inicialización del API de JavaScript de Google Maps. Actualmente se admiten dos opciones:

  • la versión de lanzamiento (especificada con v=3 u omitiendo el parámetro v),
  • la versión de prueba, especificada conv=3.exp (refleja la versión más reciente e incluye las correcciones de errores y las nuevas funciones que se introducen en el API a medida que se lanzan públicamente),
  • una versión numerada (indicada con v=3.number) que especifica un conjunto de funciones del API.

En la siguiente solicitud de inicialización se muestra cómo solicitar una versión específica del API de JavaScript de Google Maps:

http://maps.googleapis.com/maps/api/js?v=3.9&sensor=true_or_false

Cada trimestre, lanzaremos una nueva versión numerada (la "versión de lanzamiento") para todos los usuarios. Durante todo el trimestre seguiremos añadiendo correcciones de errores a esta versión de lanzamiento, que se indicarán en el registro de cambios del API de JavaScript de Google Maps, sin dejar de garantizar la estabilidad del conjunto de funciones.

Al lanzar una nueva versión numerada, se "congela" la versión de lanzamiento anterior y esa versión no se vuelve a actualizar con ningún cambio de código, incluidas las correcciones de errores, para garantizar su completa estabilidad. Cada vez que se introduce una nueva versión congelada mediante este sistema, se retira la versión congelada anterior de forma que nunca haya más de una versión congelada disponible. Las aplicaciones que solicitan versiones numeradas que se han retirado obtienen automáticamente la versión congelada más reciente.

Elección de una versión de API

A continuación se ofrecen varias indicaciones para elegir la versión de API más adecuada para cada aplicación desarrollada con la versión 3 del API de Google Maps.

  • Las aplicaciones de producción deben especificar la versión de lanzamiento (v=3) o la versión congelada. Si se especifica una versión retirada, por ejemplo, v=3.0, siempre se devolverá la versión congelada.
  • El Acuerdo de nivel de servicio del API de Google Maps for Business no se aplica a la versión de prueba actual. Las aplicaciones desarrolladas con el API de Google Maps for Business deben utilizar la versión de lanzamiento actual (la versión 3.9) o una versión anterior para poder acogerse al Acuerdo de nivel de servicio.
  • Al desarrollar una nueva aplicación con la versión 3 del API de Google Maps, se recomienda seleccionar la versión de prueba más reciente indicando su número (por ejemplo, la versión 3.10) y seguir utilizándola hasta que haga falta añadir nuevas funciones disponibles en una versión posterior. De esta forma, se puede utilizar en cada momento la versión más adecuada para cada aplicación conforme se va desarrollando, y cada versión se va convirtiendo en versión de lanzamiento y, por último, en versión congelada.
  • Las aplicaciones de producción que solicitan una versión igual o anterior a la versión congelada existente en el momento de la solicitud deben utilizar la versión de lanzamiento más reciente una vez por trimestre para poder identificar posibles problemas de incompatibilidad con versiones anteriores antes de que se convierta en versión congelada.

Documentación de versiones

La documentación siempre hace referencia a la versión de prueba. Sin embargo, existe un documento de referencia independiente disponible para cada versión.

Solución de problemas

Si el código no funciona correctamente, a continuación te ofrecemos varias sugerencias que te pueden ayudar a resolver estos problemas:

Autenticación obligatoria

Tienes que acceder a Google+ para realizar esta acción.

Acceder a...

Desarrolladores de Google necesita tu permiso para realizar esta acción.