Bienvenido al desarrollo de la documentación del revelador para el Google Maps API. Javascript API de Google Maps le deja encajar los mapas de Google en sus Web pages. Para utilizar el API, usted necesita primero registrarse para una Key API. Una vez que usted haya recibido una Key del API, usted puede desarrollar un uso del mapa después de las instrucciones en esta documentación.

Audiencias

Esta documentación esta diseñada para las personas familiarizadas con la programación en Javascript y conceptos de programación orientados a objeto. Usted debe también estar familiarizado con los mapas de Google desde el punto de vista de un usuario. Hay muchas clases particulares de Javascript disponibles en el Web.

Esta documentación conceptual no es completa y exhaustiva; esta diseñada para comenzar rápidamente a explorar y a desarrollar los usos de los mapas API de Google. También publicamos la referencia del API de los mapas de Google que debe ser relativamente completa

Hemos reorganizado recientemente la documentación para agregar una información más conceptual y para explotar las discusiones en las áreas dominantes siguientes:

• Basic Map Objects
• Map Events
• Map Controls
• Map Overlays
• Map Services

Esperamos que este hallazgo le reajuste más fácil a seguir, especialmente para los desarrolladores que son nuevos en los mapas API. La regeneración en la documentación es agradable también. Cerciórese de ensamblar el foro del desarrollador de API de los mapas a la regeneración de la elasticidad y discutir el API.

Crear Google Mapplets
Los mapas API de Google ahora agregan las ayudas para Mapplets (mapas + Gadgets), que permiten que usted encaje usos externamente recibidos dentro de los mapas de Google. Estos mapplets funcionan dentro de sus propios iFrames, permitiendo que usted cree "mashups de mashups" y que mezcle código a partir de un sitio con otro por ejemplo. ¡Esto abre un mundo nuevo entero de la codificación dentro de los mapas de Google! La escritura Mapplets es fácil, aunque algunas cosas se hacen diferentemente que en los mapas estándares API de Google. Compruebe fuera de la documentación y de la referencia de Mapplets de los mapas de Google para saber si hay más información.

Usar el cargador de Google AJAX API
Los mapas API de Google ahora se integran completamente con el Google AJAX APIs. Este marco permite a usted cargar una Key del API para todo el Google apoyado en AJAX APIs (mapas incluyendo los de Google) y también proporciona un namespace común para cada API, permitiendo que diversos Google APIs funcionen juntos. No se preocupe: si usted decide no utilizar el marco de Google AJAX API, usted puede continuar utilizando el namespace existente.

Usar el marco de Google AJAX API es relativamente simple. Cambiar su uso para utilizar el marco implica los pasos siguientes:

En vez de cargar el API de http://maps.google.com/apis, usted carga el cargador común de http://www.google.com/jsapi. Usted puede pasar su Key existente del API de los mapas de Google a este URL:

<script type="text/javascript" src="http://www.google.com/jsapi?key=ABCDEFG"></script>

Cargue el API específico que usted desea con el método de google.load. El método de google.load lleva un argumento para el API específico y número de versión load:

<script type="text/javascript">
  google.load("maps", "2");
</script>

Utilice el google.maps. * namespace para todas las clases, métodos y características que usted utiliza actualmente en los mapas API de Google, substituyendo el prefijo de G por este namespace. Realice cualquier inicialización a sus objetos usando google.setOnLoadCallback(). Por ejemplo, el objeto GMap2 Maps a google.maps.Map2 al usar el cargador de Google AJAX API:

<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 usar el cargador de Google AJAX API está disponible en http://code.google.com/apis/ajax/documentation/.

La localización del Google Maps API

El Google Maps usa las aplicaciones del API inglesas por defecto al exhibir la información textual tal como los nombres para los controles, los avisos de copyright, y las direcciones que conducen. Si usted desea cambiar los mapas API correctamente a la información de exhibición en una lengua particular, usted puede agregar un HL opcional al parámetro de la etiqueta al incluir el código del Javascript API en los mapas, especificando la lengua del dominio de uso.

Por ejemplo, para exhibir un uso del API en los mapas en alemán, agregue el &hl=de a <script> según lo demostrado abajo

<script type="text/javascript" src="http://maps.google.com/maps?file=api&v=2&key=abcdefg&hl=de"

Vea también la lista apoyada de los idiomas del dominio. Observe que ponemos al día a menudo idiomas apoyadas así que esta lista puede no ser exhaustiva.

Notas De Programación

Antes de que usted comience a cavar en los mapas API, usted debe tomar de Google la nota de las preocupaciones siguientes para asegurar sus trabajos del uso suavemente a través de sus plataformas previstas.

Compatibilidad Del Browser
Los mapas API de Google apoyan los mismos browsers que el Google Maps Web site. La escritura http://maps.google.com/maps?file=api&v=2 se puede analizar en casi cada browser sin errores, así que usted puede incluir con seguridad esa escritura antes de comprobar para saber si hay compatibilidad.

Diversos usos requieren a veces diversos comportamientos para los usuarios de los browsers incompatibles. Los mapas API proporcionan un método global (GBrowserIsCompatible()) a la compatibilidad del check, pero no tiene ningún comportamiento automático cuando detecta un browser incompatible. La mayoría de los ejemplos en este documento no comprueban para saber si hay compatibilidad del browser, ni exhiben un mensaje de error para más antiguos browsers. Los usos claramente verdaderos deben hacer algo más amistoso con los browsers incompatibles, pero hemos omitido tales checks para hacer los ejemplos más legibles.

Los usos no triviales encontrarán inevitable inconsistencias entre los browsers y las plataformas. No hay solución simple a estos problemas, pero el Google Maps foro del revelador del API y quirksmode.org son ambos buenos recursos para encontrar workarounds.

XHTML y VML

Recomendamos a usted utilizar XHTML estándar-obediente en las páginas que contienen mapas. Cuando los browsers consideran el XHTML DOCTYPE en la tapa de la página, rinden a la página en " standards compliance mode" que hace la disposición y los comportamientos mucho más fiables a través de los browsers. Las páginas sin esa definición pueden rendir en el "quirks mode " que puede conducir a la disposición contraria.

Si usted desea mostrar polylines en su mapa (como las líneas usadas por Google Maps para demostrar direcciones que conducen), usted necesita incluir el namespace de VML en su documento de XHTML para hacer todo el trabajo correctamente en Internet Explorer. El principio de su documento de XHTML debe parecer esto:

<!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">

API Updates

El parámetro de V dentro del URL http://maps.google.com/maps?file=api&v=2 refiere al número de versión de los mapas API de Google a utilizar. La mayoría de los usuarios del API desearán utilizar la "versión actual 2" API pasando el parámetro v=2 dentro de ese URL. Usted puede en lugar de otro obtener el lanzamiento más último (últimas características) pasando v=2.x en lugar de otro. Sin embargo, esté enterado que el lanzamiento más último puede no ser tan confiable como el lanzamiento v=2. Ponemos al día los mapas API de Google a menudo (a veces cada semana), en los cuales las características del punto dentro del lanzamiento de v=2.x se emigran en el lanzamiento v=2 a menos que se descubran los problemas.

Además, usted puede utilizar una versión "estable" del API pasando el parámetro de v=2.s. Esta versión se pone al día menos a menudo, cada pocos meses. Desde el v=2 y el v=2.x los lanzamientos se ponen al día cada dos semanas, algunos reveladores preferirán utilizar el v=2.s. estable. Observe por favor que la versión estable puede ser varias versiones detrás de la versión actual y por lo tanto puede no incluir algunas de las características más últimas.

Cada versión del API se etiqueta mientras que lo ponemos al día (por ejemplo, "versión 2.76"). Pues ponemos al día el API, un viejo código basado en versiones anteriores puede no trabajar de vez en cuando según lo anunciado. Si usted necesita absolutamente enclavijar su uso a un lanzamiento particular del API, usted puede hacerlo explícitamente incluyendo esa versión dentro del parámetro de v (e.g. v=2.75). Sin embargo, esto no se recomienda. Es siempre mejor basar sus productos en el código pues consigue actualizado.

Cuando hacemos una actualización significativa al API en el futuro, cambiaremos encima del número de versión principal y fijaremos un aviso en el código de Google y el foro del revelador del API de los mapas. Cuando sucede eso esperamos apoyar ambas versiones por lo menos un mes para permitir que usted emigre su código.

Fuente: http://code.google.com/intl/en/apis/maps/documentation/