Los mismos mapas de excelente calidad, además de un acuerdo de servicio, asistencia y control sobre los anuncios.
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.
¡Nuevo! Asistencia para la codificación geográfica inversa en el API de Google Maps
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.
Hemos organizado la documentación recientemente para añadir más información conceptual y tratar las siguientes áreas básicas:
Esperamos que el nuevo diseño te resulte más sencillo, especialmente si es la primera vez que vas a programar con el API de Google Maps. También agradeceremos cualquier comentario que nos envíes sobre la documentación. Asegúrate de incorporarte al foro de desarrolladores del API de Google Maps para hacer comentarios e intercambiar opiniones sobre el API.
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.
El API de Google Maps ahora está completamente integrada 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:
http://maps.google.com/apis, carga el cargador común desde http://www.google.com/jsapi. Puedes incluir tu clave de API de Google Maps en la siguiente URL:
<script type="text/javascript" src="http://www.google.com/jsapi?key=ABCDEFG"></script>
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:
<script type="text/javascript">
google.load("maps", "2");
</script>
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:
<script type="text/javascript" src="http://www.google.com/jsapi?key=ABCDEFG"></script>
<script type="text/javascript">
google.load("maps", "2.x");
// Call this function when the page has been loaded
function initialize() {
var map = new google.maps.Map2(document.getElementById("map"));
map.setCenter(new google.maps.LatLng(37.4419, -122.1419), 13);
}
google.setOnLoadCallback(initialize);
</script>
La documentación completa para utilizar el cargador de API AJAX de Google está disponible en http://code.google.com/intl/es/apis/ajax/documentation/.
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:
<script type="text/javascript" src="http://maps.google.com/maps?file=api&v=2&key=abcdefg&hl=de"
Consulta también la lista de idiomas de dominio admitidos. Ten en cuenta que esta lista puede no ser exhaustiva, ya que actualizamos los idiomas admitidos con frecuencia.
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ún.
#
# Example using sensor when loading the Maps JavaScript API
#
<script type="text/javascript" src="http://maps.google.com/maps?file=api&v=2&key=abcdefg&sensor=true">
#
# Example using sensor when loading the Maps API via the common loader
#
<script type="text/javascript" src="http://www.google.com/jsapi?key=abcdef"></script>
<script type="text/javascript">
google.load("maps", "2",{"other_params":"sensor=true"});
function initialize() {
var map = new google.maps.Map2(document.getElementById("map"));
map.setCenter(new google.maps.LatLng(37.4419, -122.1419), 13);
}
google.setOnLoadCallback(initialize);
</script>
Ten en cuenta que aunque tu dispositivo no utilice un dispositivo de detección, deberás seguir transmitiendo este parámetro, estableciendo su valor en false.
Antes de empezar a explorar el API de Google Maps, debes tener en cuenta las siguientes cuestiones para asegurarte de que tu aplicación funcione sin problemas en las plataformas en las que se vaya a utilizar:
El API de Google Maps admite los mismos navegadores que el sitio web de Google Maps. La secuencia de comandos http://maps.google.com/maps?file=api&v=2 se puede analizar sin errores en casi todos los navegadores, así que puedes incluir con seguridad esa secuencia de comandos antes de comprobar la compatibilidad.
En algunas ocasiones, las diferentes aplicaciones requieren distintos comportamientos cuando los usuarios utilizan navegadores incompatibles. El API de Google Maps ofrece un método global (GBrowserIsCompatible()) de comprobación de la compatibilidad, pero no dispone de ningún comportamiento automático para los casos en los que detecta un navegador incompatible. En la mayor parte de los ejemplos de este documento no se comprueba la compatibilidad del navegador ni se muestra un mensaje de error cuando se utilizan navegadores de versiones anteriores. Obviamente, las aplicaciones reales deben desarrollar un comportamiento más adecuado con los navegadores incompatibles, pero hemos omitido esas comprobaciones para que los ejemplos sean más legibles.
Las aplicaciones no triviales inevitablemente detectarán inconsistencias entre los navegadores y las plataformas. No existe una solución fácil a estos problemas, pero el foro de desarrolladores del API de Google Maps y quirksmode.org son buenos recursos para la búsqueda de soluciones.
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 polilí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:
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN"
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xmlns:v="urn:schemas-microsoft-com:vml">
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.
El equipo de Google Maps también actualiza de forma invisible el API con las mejoras de rendimiento y las correcciones de errores más recientes. Estas correcciones sólo deberían mejorar el rendimiento y solucionar errores, pero es posible que rompamos de forma inadvertida algunos clientes del API. Infórmanos de estos problemas en el foro de desarrolladores del API de Google Maps.
Esta documentación hace referencia a la versión 2 del API de Google Maps, lanzada el 3 de abril de 2006. Si tu API utiliza la versión 1 del API de Google Maps (es decir, si la fecha de creación de tu sitio es anterior al 3 de abril de 2006), debes intentar actualizar tu sitio web. Para obtener más información, consulta la guía de actualización a la versión 2.
Ten en cuenta que, en la mayoría de los ejemplos de esta documentación, sólo se muestra el código JavaScript relevante, no todo el archivo HTML. Puedes conectar el código JavaScript a tu propio archivo HTML base o puedes hacer clic en el enlace que aparece después de cada ejemplo para descargar el archivo HTML completo.
El API de Google Maps recomienda el uso de cierres de función y el sistema de gestión de eventos del API GEvent vincula eventos a nodos DOM de un modo que provoca pérdidas de memoria prácticamente inevitables en algunos navegadores, concretamente en Internet Explorer. La versión 2 del API de Google Maps incluye un nuevo método, GUnload(), que eliminará la mayor parte de las referencias circulares que causan estas pérdidas. Tendrás que ejecutar GUnload() en el evento onunload de tu página para reducir las posibilidades de pérdida de memoria en tu aplicación:
<body onunload="GUnload()">
Aunque el uso de esta función ha eliminado prácticamente por completo las pérdidas de memoria de Internet Explorer en Google Maps, debes realizar una comprobación de pérdida de memoria en tu propio sitio con herramientas como Drip si detectas problemas de consumo de memoria.
A continuación te mostramos algunos recursos adicionales. Ten en cuenta que estos sitios no son propiedad ni responsabilidad de Google.
A continuación te ofrecemos varias sugerencias que te pueden ayudar a resolver problemas de funcionamiento de tu código: