Haz clic aquí para ver las páginas que has visitado recientemente y las que visitas con más frecuencia.
Ocultar
Google Earth API

Capas y controles

  1. Introducción
  2. Capas
  3. Atmósfera y Sol
  4. Controles de navegación
  5. Superposiciones informativas

Introducción

Las capas contienen información adicional que se coloca sobre la capa base de imágenes de Google Earth. Los controles de navegación permiten al usuario realizar ampliaciones, inclinaciones y acercamientos mediante los controles de la ventana gráfica.

Capas

De forma predeterminada, la capa del relieve es la única capa que se muestra cuando el complemento de Google Earth se carga por primera vez. No todas las capas disponibles en el cliente de escritorio de Google Earth están disponibles con el complemento. A continuación se indican las capas disponibles:

  • LAYER_BORDERS: muestra las fronteras de países y de áreas y coloca etiquetas para ciudades, estados, países, océanos, etc.
  • LAYER_BUILDINGS: muestra edificios 3D.
  • LAYER_BUILDINGS_LOW_RESOLUTION: muestra edificios grises (sin realismo fotográfico). Ten en cuenta que estas capas no contienen copias de edificios con realismo fotográfico y, en su lugar, incluyen edificios que aún no existen en la capa de edificios con realismo fotográfico. A medida que se creen las versiones realistas de los edificios grises, estas se irán añadiendo a la capa LAYER_BUILDINGS y se irán eliminando de la capa LAYER_BUILDINGS_LOW_RESOLUTION.
  • LAYER_ROADS: muestra carreteras y nombres de carreteras.
  • LAYER_TERRAIN: muestra relieve en 3D.
  • LAYER_TREES: muestra modelos de árboles en 3D.

Si quieres habilitar una capa específica:

ge.getLayerRoot().enableLayerById(ge.LAYER_NAME, true);

Si quieres inhabilitar una capa:

ge.getLayerRoot().enableLayerById(ge.LAYER_NAME, false);

Atmósfera y Sol

El complemento de Google Earth puede mostrar el Sol y la atmósfera de la Tierra. El Sol produce sombras y aparece en el cielo en la ubicación correcta en función de la hora especificada (consulta el capítulo Tiempo de esta Guía para desarrolladores para obtener más información); la atmósfera se muestra de color azul gradual para imitar la difuminación de la luz a medida que atraviesa la atmósfera.

Si quieres alternar el Sol en el complemento:

ge.getSun().setVisibility(true);

Si quieres alternar la atmósfera en el complemento:

ge.getOptions().setAtmosphereVisibility(true);

Los controles de navegación permiten al usuario desplazarse en Google Earth e incluir controles de acercamiento, de ampliación, de inclinación, de desplazamiento y de rotación. Estos controles pueden estar siempre visibles, siempre ocultos o pueden permanecer ocultos hasta que el usuario desplace el cursor del ratón sobre el área de controles del complemento. Para especificar el comportamiento que quieres mostrar:

ge.getNavigationControl().setVisibility(ge.VISIBILITY_X);

Estos son los valores aceptables:

  • ge.VISIBILITY_SHOW
  • ge.VISIBILITY_HIDE
  • ge.VISIBILITY_AUTO

Cómo colocar los controles

Los controles de navegación se pueden colocar en cualquier esquina de la ventana del complemento de Google Earth. Para ello, modifica el valor de las unidades X e Y para que correspondan con la parte superior o inferior de la ventana, a la izquierda o a la derecha.

  • ge.UNITS_PIXELS: se interpreta como los píxeles desde la parte izquierda del borde inferior de la pantalla del complemento.
  • ge.UNITS_INSET_PIXELS: se interpreta como los píxeles desde la parte derecha del borde superior de la pantalla del complemento.

Por ejemplo, para desplazar los controles hacia la parte inferior derecha de la ventana:

ge.getNavigationControl().getScreenXY().setXUnits(ge.UNITS_INSET_PIXELS);
ge.getNavigationControl().getScreenXY().setYUnits(ge.UNITS_PIXELS);

Nota: Para su colocación, los controles de navegación no aceptan valores de píxeles específicos (por ejemplo, KmlVec2.setX()).

Para ver un ejemplo interactivo, consulta la sección API de Google Earth de la zona de ensayo de la API de AJAX: Mostrar/ocultar controles de navegación.

Superposiciones informativas

Google Earth también proporciona un conjunto de superposiciones informativas que se pueden añadir a la ventana del complemento. Estas superposiciones transmiten información sobre la ventana gráfica en uso: latitud, longitud, altitud, etc.

1. setScaleLegendVisibility() Muestra la escala actual del mapa.
2. setStatusBarVisibility() Muestra la barra de estado en la parte inferior de la ventana de Google Earth, que contiene las coordenadas geográficas y la altitud del relieve debajo de la posición del cursor actual, así como el punto desde el que el usuario está viendo la Tierra.
3. setOverviewMapVisibility() Muestra un mapa insertado de todo el mundo en la esquina inferior derecha. La ventana gráfica en uso se muestra en el mapa insertado en forma de rectángulo rojo.
4. setGridVisibility() Muestra las líneas de latitud y de longitud en el globo.
5. setAtmosphereVisibility() Muestra la luz difuminada en la atmósfera de la Tierra.