Guía para programadores del API de Google Earth

Te damos la bienvenida a la documentación para programadores del API de Google Earth. El complemento de Google Earth y sus API te permiten incrustar toda la potencia de Google Earth y su capacidad de procesamiento 3D en tus páginas web. Puedes dibujar marcadores y líneas en la versión en 3D igual que en la versión en 2D de Google Maps.

El API es nuevo, por lo que puede presentar algunos problemas y la documentación no es perfecta. Sigue con nosotros mientras la terminamos de pulir y únete al foro de programadores del API de Google Earth para hacer comentarios o debatir sobre el API.

Índice de contenido

Destinatarios

Esta documentación está diseñada para usuarios familiarizados con la programación en JavaScript y los conceptos de la programación orientada a objetos. Las API de Google Earth se basan en muchos de los elementos KML, por lo que también deberías consultar la documentación sobre KML de Google Earth.

Ejemplos en el API del complemento de Google Earth

La mayoría de los ejemplos de esta documentación sólo muestran el código JavaScript relevante, no el archivo HTML completo. Puedes incorporar el código JavaScript a tu propio archivo HTML o buscar los numerosos ejemplos existentes online en http://www.google.es/earth/plugin/examples/samples/index.html.

La mayoría de los ejemplos de esta documentación sólo muestran el código JavaScript relevante, no el archivo HTML completo. Puedes incorporar el código JavaScript a tu propio archivo HTML o descargar el archivo HTML completo, haciendo clic en el enlace que encontrarás justo a continuación de cada ejemplo. También puedes empezar utilizando el archivo Sample.html incluido en el complemento de Google Earth.

Introducción al API del complemento de Google Earth

Puedes utilizar el API del complemento de Google Earth por sí sola o junto al API de Google Maps. Si ya tienes Google Maps incrustado en tu página web, puedes mejorarla ofreciendo a tus visitantes la opción de ver contenido tanto en Google Maps como en Google Earth. Puedes hacerlo en la misma página web. Por ejemplo, la página web de Google Maps presenta información en 2D. Al incorporar el complemento de Google Earth, los usuarios tienen la opción de mostrar la información en 3D y de ver el relieve, elementos geométricos y muchas otras funciones de Google Earth.

Instalación del complemento

Antes de instalar el API del complemento de Google Earth, lee las notas sobre programación que se muestran a continuación para asegurarte de que la aplicación funcione en la plataforma que pretendes utilizar.

Nota: esta versión del complemento de Google Earth SÓLO funciona en los sistemas operativos Microsoft Windows XP y Windows Vista. Está previsto que se admitan otros sistemas operativos en versiones futuras.

El complemento de Google Earth admite actualmente los siguientes navegadores web en sistemas operativos Windows:

• IE 6.0 o superior
• IE 7.0 o superior
• Firefox 2.x o 2.0x (compatibilidad con Firefox 3.0 próximamente)
• Netscape 7.1 o superior
• Mozilla 1.4 o superior
• Flock 1.0 o superior

Para instalar el complemento de Google Earth:

1. Inscríbete para conseguir una clave del API de Google Maps.
2. Descarga y ejecuta el programa de instalación del complemento de Google Earth.
3. De forma predeterminada, el complemento y todos sus archivos asociados se instalan en la carpeta C:\Archivos de programa\Google Earth Plugin.

Desinstalación del complemento de Google Earth

Para desinstalar el complemento de Google Earth, en el menú Inicio selecciona Complemento de Google Earth y haz clic en Desinstalar.

Uso de Samples.html

El archivo Samples.html de http://www.google.es/earth/plugins/examples/samples/index.html incluye muchos ejemplos útiles de código JavaScript. Puedes ver el código JavaScript y ejecutarlo desde la página web. También puedes ver los cambios de forma inmediata en el navegador de Google Earth de la página. Utiliza esta página para probar el código JavaScript que crees.

Incrustación de Google Earth en tu página web

En el complemento de Google Earth se incluyen varios archivos de ejemplo, así como una plantilla que puedes utilizar para empezar a trabajar. En el siguiente ejemplo se muestra el código HTML y JavaScript que se utiliza para incrustar el navegador de Google Earth en tu página web. Utilízalo como punto de partida para crear tu aplicación.

<html>
<head>
  <title>Google</title>
  <!-- *** Sustituye la siguiente clave por tu propia clave de API, que puedes conseguir en http://code.google.com/apis/maps/signup.html. *** -->
  <script type="text/javascript" src="http://maps.google.com/maps?file=api&v=2&key=abcdefg"></script>
  <script type="text/javascript">
google.load("earth", "1");
google.load("maps", "2.99");  // Para codificador geográfico JavaScript

var ge = null;
var geocoder;

function el(e) { return document.getElementById(e); }

function init() {
  geocoder = new GClientGeocoder();
  google.earth.createInstance("map3d", initCB, failureCB);
}

function initCB(object) {
  ge = object;
  ge.getWindow().setVisibility(true);
}

function failureCB(object) {
  alert('error de carga');
}

function submitLocation() {
  var address = el('address').value;
  geocoder.getLatLng(
    address, 
    function(point) {
      if (point && ge != null) {
        var la = ge.createLookAt('');     
        la.set(point.y, point.x, 100, ge.ALTITUDE_RELATIVE_TO_GROUND, 
               0, 0, 4000);
        ge.getView().setAbstractView(la);
      }
    }
  );
}

  </script>
</head>
<body onload='init()' id='body'>
  <div style='background:#ffe6e6; font-weight:bold; font-size: 16pt; font-family: arial;'>
    <center>Información confidencial de Google</center>

  </div>

  <div>
    <form name='searchform' id='searchform' action='javascript:submitLocation();void(0);'>
      <input type=text size=60 id='address'></input>
      <input type=submit value='Ir a ubicación'>
    </form>
  </div>

  <div id='map3d_container' style='border: 1px solid silver; height: 500px;'>

    <div id='map3d' style='height: 100%;'></div>
  </div>
</body>
</html>

Solución de problemas

Si el código no funciona, te ofrecemos algunos enfoques que pueden ayudarte a resolver los problemas:

• Asegúrate de que la clave del API sea válida.
• Busca errores tipográficos. Recuerda que JavaScript distingue entre mayúsculas y minúsculas.
• Utiliza un depurador de errores de JavaScript. En Firefox, puedes utilizar la consola de JavaScript, el depurador de errores Venkman o el complemento Firebug. En IE, puedes utilizar Microsoft Script Debugger. Esta serie de presentaciones muestra cómo utilizar las distintas herramientas de depuración de errores.
• Busca en el foro de programadores. Si no encuentras ninguna entrada que responda a tu pregunta, publícala en el grupo con un enlace a la página web que muestre el problema.
• Consulta la sección Recursos adicionales para acceder a otros recursos para programadores.

Recursos adicionales

Si necesitas más información sobre Google Earth, KML o Google Maps, consulta las siguientes páginas:

• http://code.google.com/apis/kml
• http://code.google.com/apis/maps
• http://earth.google.es