Te damos la bienvenida a la documentación del desarrollador del API de Google Maps. El API de JavaScript de Google Maps te permite insertar Google Maps en tus páginas web. Si quieres utilizar el API, primero tendrás que registrarte para obtener una clave de API. Una vez que hayas recibido la clave de API, podrás crear una aplicación de mapa con las instrucciones de esta documentación.

Esta documentación está diseñada para personas familiarizadas con programación JavaScript y conceptos de programación relacionados con objetos. También debes estar familiarizado con Google Maps desde el punto de vista del usuario. Existen muchos tutoriales sobre JavaScript disponibles en Internet.
Esta documentación conceptual no es completa ni exhaustiva, ya que está diseñada para que puedas empezar a explorar y desarrollar rápidamente tus geniales aplicaciones con el API de Google Maps. También publicamos la Referencia del API de Google Maps, que es una guía relativamente completa.

Creación de mapplets de Google

El API de Google Maps admite ahora los mapplets (mapas + gadgets), que permiten insertar en Google Maps aplicaciones alojadas en ubicaciones externas. Estos mapplets se ejecutan en sus propios iFrames, lo que permite, por ejemplo, crear "mashups de mashups" y combinar código de un sitio con el de otro. Esto abre un panorama completamente nuevo para la programación en Google Maps. Crear mapplets es sencillo, aunque hay algunas cosas que no se hacen del mismo modo que con el API estándar de Google Maps. Para obtener más información, consulta la documentación sobre los mapplets y la guía de referencia.

Uso del cargador de API AJAX de Google

El API de Google Maps ahora está completamente integrado en las API AJAX de Google. Esta estructura permite cargar una clave de API para todas las API AJAX de Google admitidas (incluida la de Google Maps) y ofrece también un espacio de nombre común para cada API, lo que permite un funcionamiento conjunto de distintas API de Google. No te preocupes: si decides no utilizar el API AJAX de Google, podrás seguir utilizando el espacio de nombre existente.
El uso del API AJAX de Google es relativamente sencillo. Si quieres cambiar tu aplicación para utilizar esta estructura, debes seguir estos pasos:

• Carga el API específica que quieras utilizar con el método google.load. El método google.load utiliza un argumento con el API y el número de versión especifico que se va a cargar:

• Utiliza el espacio de nombre google.maps.* para todos los métodos, las clases y las propiedades que utilices actualmente en el API de Google Maps, sustituyendo el prefijo G por este espacio de nombre. Realiza cualquier inicialización en tus objetos con google.setOnLoadCallback(). Por ejemplo, el objeto GMap2 está asignado a google.maps.Map2 cuando se utiliza el cargador de API AJAX de Google:

Localización del API de Google Maps

El API de Google Maps utiliza la configuración de idioma preferido del navegador para mostrar información textual como, por ejemplo, nombres de controles, avisos de copyright e instrucciones de circulación. Si quieres cambiar la configuración de idioma del navegador en el que el API de Google Maps muestra la información y obligarlo a utilizar un idioma concreto, puedes añadir un parámetro hl opcional a la etiqueta <script> al incluir el código JavaScript del API de Google Maps especificando el idioma de dominio que desees utilizar.

Por ejemplo, si quieres que la información del API de Google Maps aparezca en alemán, añade &hl=de a la etiqueta <script> del siguiente modo:

Especificación del parámetro sensor

Si utilizas las API de Google Maps, ahora deberás indicar si tu aplicación utiliza un sensor (por ejemplo, un localizador GPS) para determinar la ubicación del usuario. Esto resulta de especial importancia para los dispositivos móviles. Las aplicaciones deben transmitir un parámetro sensor obligatorio a la etiqueta <script> cuando se incluya el código JavaScript del API de Google Maps, indicando si tu aplicación está utilizando un dispositivo sensor.

Las aplicaciones que determinan la ubicación del usuario a través de un sensor deben transmitir &sensor=true cuando se cargue el código JavaScript del API de Google Maps a través de http://maps.google.com/maps o con el cargador comú

XHTML y VML

Recomendamos el uso de XHTML conforme con los estándares en las páginas que contienen mapas. Cuando los navegadores ven el código XHTML DOCTYPE en la parte superior de la página, muestran la página en "modo conforme con los estándares", lo que hace que el diseño y los comportamientos en los navegadores sean mucho más predecibles. Las páginas que no incluyen esa definición pueden mostrarse en "modo chapucero", lo que puede ocasionar inconsistencias en el diseño.
Si quieres mostrar poli líneas en tu mapa (como las líneas que utiliza Google Maps para las instrucciones para llegar en coche), tendrás que incluir el espacio de nombre VML en tu documento XHTML para que todo funcione correctamente en Internet Explorer. El principio del documento XHTML debe ser como éste:

Actualizaciones del API

El parámetro v incluido en la URL http://maps.google.com/maps?file=api&v=2 hace referencia al número de versión del API de Google Maps que se va a utilizar. La mayoría de los usuarios del API probablemente prefieran utilizar la "versión 2" actual del API especificando el parámetro v=2 en esa URL. Si lo prefieres, puedes utilizar v=2.x para utilizar la última versión (con las funciones más recientes). No obstante, debes tener en cuenta que la última versión puede no ser tan fiable como la versión v=2. Actualizamos el API de Google Maps con frecuencia (a veces todas las semanas). Al hacerlo, las funciones incluidas en la versión v=2.x se trasladan a la versión v=2 a menos que se detecten problemas.

También puedes utilizar una versión "estable" del API con el parámetro v=2.s. Esta versión se actualiza con menos frecuencia (cada pocos meses). Dado que las versiones v=2 y v=2.x se actualizan aproximadamente cada dos semanas, algunos desarrolladores pueden preferir utilizar la versión estable v=2.s. Ten en cuenta que la versión estable puede ser varias versiones anterior a la actual y no incluir, por tanto, algunas de las últimas funciones.

Cada versión del API se etiqueta al actualizarla (por ejemplo, "versión 2.76"). Cuando se actualiza el API, en algunas ocasiones el código anterior basado en versiones previas puede no funcionar según lo previsto. Si necesitas vincular inevitablemente tu aplicación a una determinada versión del API, puedes hacerlo incluyendo esa versión de forma explícita en el parámetro v (por ejemplo, v=2.75). Sin embargo, esta opción no es recomendable. Siempre será mejor que bases tus productos en el código que se actualice.

Si realizamos una actualización significativa del API en el futuro, cambiaremos el número de versión principal y publicaremos un aviso en Google Code y en el foro de desarrolladores del API de Google Maps. Cuando esto suceda, pensamos mantener ambas versiones disponibles durante al menos un mes para que puedas migrar tu código.