Las regiones constituyen un potente recurso de KML que permite añadir conjuntos de datos de gran tamaño a Google Earth sin que el rendimiento se vea afectado negativamente. Los datos se cargan y se representan solo cuando el usuario puede verlos y ocupan una determinada parte de la pantalla. Con este recurso, puedes proporcionar distintos niveles de detalle para los datos, de forma que los detalles más sutiles se carguen solo cuando los datos ocupen una parte de la pantalla que sea lo suficientemente grande como para que sean visibles.
Conceptos clave
Todos los recursos pueden contener una región. Las regiones influyen en la visibilidad de los elementos geométricos de las marcas de posición o de las imágenes de las superposiciones. También determinan los procedimientos de selección y de nivel de detalle para los elementos geométricos o de superposición afectados. Además, las regiones se heredan a través de la jerarquía de KML e influyen en la visibilidad de los recursos definidos en niveles inferiores de la jerarquía.
En esta sección se describen los siguientes conceptos clave necesarios para comprender la noción de región:
- Herencia
- Cuadro de delimitación
- Nivel de detalle
- Altitud
- Grado de opacidad
- Cómo anidar regiones
- Enlaces de red basados en regiones
Herencia
En KML, algunas clases se derivan de una clase "básica". Las clases derivadas heredan todos los elementos de la clase básica y añaden algunos elementos específicos propios (esta es una técnica habitual de los sistemas orientados a objetos). Para comodidad, esta sección hace referencia a la clase básica en lugar de a toda la lista de clases derivadas. Por ejemplo:
- El término Feature (recurso) hace referencia a cualquier elemento KML que se derive de Feature: Document, Folder, GroundOverlay, NetworkLink, PhotoOverlay, Placemark y ScreenOverlay.
- Geometry (geometría) hace referencia a cualquier elemento geométrico de KML: Point, Polygon, LinearRing, LineString, Model y MultiGeometry.
- Overlay (superposición) hace referencia a los elementos derivados de Overlay: GroundOverlay, PhotoOverlay y Screen Overlay.
Consulta la sección Referencia de KML para obtener un diagrama que muestra la estructura de herencia de los elementos KML.
Cuadro delimitador
Cada región tiene un elemento de latitud, longitud y altitud (<LatLonAltBox>) que define el cuadro de delimitación de tus datos. Un cuadro de delimitación es un volumen que alberga un conjunto de puntos de datos u objetos. Al igual que el atributo de latitud y longitud (<LatLonBox>) de una superposición de suelo, el atributo de latitud, longitud y altitud (<LatLonAltBox>) de una región tiene límites al Norte, al Sur, al Este y al Oeste. Si los datos incluidos en la región están en 3D o en 2D con altitud, el atributo de latitud, longitud y altitud (<LatLonAltBox>) de la región también deberá incluir los atributos de altitud mínima (<minAltitude>) y de altitud máxima (<maxAltitude>).
![](https://developers-dot-devsite-v2-prod.appspot.com/static/kml/documentation/images/RegionParams.gif?authuser=19&hl=es)
Los objetos asociados a este cuadro delimitador se dibujan cuando 1) la región se hace visible y 2) el tamaño en pantalla proyectado del atributo <LatLonAltBox> está dentro del intervalo de píxeles especificado para dicha región, tal como se describe en el apartado Nivel de detalle. Cuando se cumplen estas dos condiciones, se considera que la región está "activa".
Nivel de detalle
El segundo concepto importante relacionado con las regiones es el de Nivel de detalle. Dado que las pantallas de los ordenadores tienen una cantidad de espacio limitada, es más eficaz crear configuraciones que carguen grandes cantidades de datos únicamente cuando haya píxeles suficientes para mostrar los datos de forma correcta. Cuando la región ocupa una parte relativamente pequeña de la pantalla (quizá porque el usuario esté viéndola desde mucha distancia o porque se trate de una zona plana que se esté viendo de forma oblicua), el mecanismo de nivel de detalle permite al autor del KML especificar un conjunto de datos con menor resolución para sustituir a los datos a resolución completa. Este conjunto de datos de menor resolución se carga más rápido y, dado que solo ocupa una pequeña parte de la pantalla, posiblemente el usuario no pueda percibir la diferencia.
En una región, los elementos <minLodPixels> y <maxLodPixels> permiten especificar un área de la pantalla (en píxeles cuadrados). Cuando los datos se proyecten en la pantalla, deberán ocupar un área de la pantalla que sea superior al valor de píxeles del nivel de detalle mínimo (<minLodPixels>) o inferior al valor de nivel de detalle máximo (<maxLodPixels>) para que se puedan ver. Cuando el tamaño proyectado de la región se encuentre fuera de dichos límites, dejará de ser visible y la región pasará a estar inactiva.
En el caso de que los datos deban estar activos hasta un tamaño infinito, tendrás que especificar el valor −1 (que es el predeterminado) para el elemento <maxLodPixels>.
Ejemplo 1: región para una superposición de suelo
En primer lugar, examinaremos un ejemplo sencillo que permite crear una región en una superposición en 2D al nivel del suelo. Este ejemplo utiliza una superposición de suelo que contiene datos históricos que muestran una parte de la ciudad de Mountain View (California) en 1991. A medida que el usuario acerca la imagen de la zona, la superposición se va haciendo visible. Así es como se muestra la superposición cuando se hace visible por primera vez (el archivo de ejemplo también incluye una cadena de líneas blanca para resaltar la superposición):
![](https://developers-dot-devsite-v2-prod.appspot.com/static/kml/documentation/images/MinLodPixels.jpg?authuser=19&hl=es)
En este ejemplo, el valor del elemento <minLodPixels> es 128, lo que implica que la superposición de suelo se muestra cuando ocupa 128 píxeles cuadrados en la pantalla (en este ejemplo se ha utilizado el valor predeterminado de -1 para el elemento <maxLodPixels>, por lo que permanecerá visible cuando el usuario acerque la imagen en este ángulo). La imagen utilizada para esta superposición ocupa un cuadro de 256 píxeles cuadrados.
Esto es lo que se ve cuando el usuario acerca la imagen:
![](https://developers-dot-devsite-v2-prod.appspot.com/static/kml/documentation/images/Closeup.jpg?authuser=19&hl=es)
Y esta es la imagen inclinada justo antes de que se vuelva invisible porque ocupa menos espacio del indicado por el valor de <minLodPixels>:
![](https://developers-dot-devsite-v2-prod.appspot.com/static/kml/documentation/images/AlmostGone.jpg?authuser=19&hl=es)
No es necesario que el valor de <LatLonAltBox> para estos datos incluya los elementos de altitud mínima (<minAltitude>) y de altitud máxima (<maxAltitude>), ya que los datos son planos y se encuentran al nivel del suelo. El cuadro de delimitación de los datos especificado en el elemento <LatLonAltBox> de la región es idéntico a los límites indicados por el valor de <LatLonBox> de la superposición de suelo, tal como se muestra a continuación en el archivo KML:
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>Flat Region</name>
<Region>
<LatLonAltBox>
<north>37.430419921875</north>
<south>37.41943359375</south>
<east>-122.080078125</east>
<west>-122.091064453125</west>
</LatLonAltBox>
<Lod>
<minLodPixels>128</minLodPixels>
</Lod>
</Region>
<GroundOverlay>
<name>Mountain View DOQQ</name>
<Icon>
<href>files/image.JPEG</href>
</Icon>
<LatLonBox>
<north>37.430419921875</north>
<south>37.41943359375</south>
<east>-122.080078125</east>
<west>-122.091064453125</west>
</LatLonBox>
</GroundOverlay> </Document> </kml>
Además, en el archivo KML se puede observar que la región es un duplicado de la imagen (o elemento geométrico) a cuya visibilidad afecta.
Ahora que has tenido tiempo de examinar el archivo KML, haz clic en el siguiente enlace para descargar la superposición en Google Earth. A continuación, prueba con distintos puntos de vista para ver cómo se muestra o se oculta la región, en función del área de pantalla que requiera. Ten en cuenta que si inclinas la vista lo suficiente o si alejas mucho la imagen, la superposición desaparecerá porque ocupa demasiado poco espacio en la pantalla como para cumplir el requisito de píxeles del elemento <minLodPixels>.
Ver ejemplo en Google Earth (historicOverlay.kmz)
Altitud
Ejemplo 2: región para un modelo 3D
En el siguiente ejemplo se muestra cómo crear una región que contenga objetos en 3D al nivel del suelo. Para esta región, el atributo <LatLonAltBox> contiene un elemento <maxAltitude> con un valor de 300 metros, que se corresponde con la altura del edificio. Probablemente reconocerás los edificios del ejemplo como el complejo de Naciones Unidas en Nueva York.
Es importante tener en cuenta que los límites especificados por el atributo <LatLonAltBox> de la región no tienen que coincidir exactamente con los límites de longitud y latitud del modelo. Las coordenadas del modelo hacen referencia a su propio origen local, que puede presentar alguna desviación con respecto a la posición real del modelo en la Tierra.
<?xml version='1.0' encoding='UTF-8'?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>3D Region on ground</name>
<Placemark>
<name>United Nations Headquarters</name>
<visibility>0</visibility>
<Region>
<Lod>
<minLodPixels>128</minLodPixels>
</Lod>
<LatLonAltBox>
<north>40.750683130314</north>
<south>40.748162385230</south>
<east>-73.966608428427</east>
<west>-73.969476624071</west>
<minAltitude>0</minAltitude>
<maxAltitude>300</maxAltitude>
<altitudeMode>absolute</altitudeMode>
</LatLonAltBox>
</Region>
<Model>
<altitudeMode>absolute</altitudeMode>
<Location>
<longitude>-73.967763927199</longitude>
<latitude>40.749458312255</latitude>
<altitude>0.406173708576</altitude>
</Location>
<Link>
<href>models/un.dae</href>
</Link>
</Model>
</Placemark>
</Document>
</kml>
Haz clic en el siguiente enlace para cargar el archivo en Google Earth. Prueba de nuevo con distintos puntos de vista para ver cuándo se muestran y cuándo se ocultan los edificios.
Ver ejemplo en Google Earth (unitedNations.kmz)
Ejemplo 3: región para una superposición en 2D con altitud
En este ejemplo se muestra cómo se puede añadir una superposición en 2D para que aparezca por encima de la superficie de la Tierra a una altitud especificada. Esta técnica es útil para datos que muestren frentes meteorológicos y patrones de tráfico aéreo. Este ejemplo muestra una nube pequeña a una altitud de 100.000 metros sobre el nivel del mar.
El atributo <LatLonAltBox> de la región especifica un valor de 100.000 metros para los elementos <minAltitude> y <maxAltitude> (el valor es idéntico para ambos elementos, porque la superposición está en 2D y no presenta grosor alguno). El atributo de modo de altitud (<altitudeMode>) es absoluto, lo que implica que su valor hace referencia al nivel del mar.
Ten en cuenta que el valor de altitud (<altitude>) del elemento de superposición de suelo (GroundOverlay) es también de 100.000 (es decir, coincide con el valor de altitud del cuadro delimitador de la región), mientras que el atributo del elemento <altitudeMode> del mismo elemento GroundOverlay coincide con el valor especificado para el atributo <altitudeMode> de la región.
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>Flat Region at altitude</name>
<GroundOverlay>
<name>Cloud overlay</name>
<Region>
<LatLonAltBox>
<north>33.75</north>
<south>22.5</south>
<east>-45</east>
<west>-56.25</west>
<minAltitude>100000</minAltitude>
<maxAltitude>100000</maxAltitude>
<altitudeMode>absolute</altitudeMode>
</LatLonAltBox>
<Lod>
<minLodPixels>128</minLodPixels>
</Lod>
</Region>
<Icon>
<href>files/image.PNG</href>
</Icon>
<altitude>100000</altitude>
<altitudeMode>absolute</altitudeMode>
<LatLonBox>
<north>33.75</north>
<south>22.5</south>
<east>-45</east>
<west>-56.25</west>
</LatLonBox>
</GroundOverlay>
</Document>
</kml>
Ver ejemplo en Google Earth (cloudRegion.kmz)
Grado de opacidad
También se puede especificar un grado de opacidad para una región, lo que permite que un objeto pase de transparente a opaco progresivamente y viceversa. Google Earth utiliza el grado de opacidad máximo (maxFadeExtent) para determinar la gradación desde la transparencia total hasta la opacidad total cuando la región se encuentra en su tamaño máximo visible. Por su parte, el grado de opacidad mínimo (minFadeExtent) se utiliza para determinar la gradación de opacidad cuando la región se encuentra en su tamaño mínimo visible. Los intervalos de gradación de opacidad son opcionales, pero impiden que se produzcan efectos de "salto" entre elementos de cadena de líneas (LineString) o de polígonos (Polygon) de distintas resoluciones. La gradación de opacidad repercute mucho en el rendimiento y no se debe utilizar con las imágenes.
Nota: la gradación de opacidad se aplica a todos los objetos, excepto a los iconos de marca de posición. Estos iconos se dibujan cuando la gradación de opacidad es superior a 0,5.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/kml/documentation/images/visibilityRange.gif?authuser=19&hl=es)
En el siguiente ejemplo se muestra cómo afecta el grado de opacidad a un elemento LineString.
<?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>Region in Placemark LineString</name>
<description>
The LineString corners mark the extent
of the Region LatLonAltBox.
The LineString minFadeExtent (at greatest range)
is 1/4 of the maxFadeExtent (at closest range)..
</description>
<Placemark>
<name>Region LineString</name>
<LineString>
<coordinates>
22,50,0
28,50,0
28,45,0
22,45,0
22,50,0
</coordinates>
</LineString>
<Region>
<LatLonAltBox>
<north>50</north>
<south>45</south>
<east>28</east>
<west>22</west>
</LatLonAltBox>
<Lod>
<minLodPixels>128</minLodPixels>
<maxLodPixels>1024</maxLodPixels>
<minFadeExtent>128</minFadeExtent>
<maxFadeExtent>512</maxFadeExtent>
</Lod>
</Region>
</Placemark>
</Document>
</kml>
Ver ejemplo en Google Earth (fadeLineString.kml)
Anidación de regiones
Las regiones se suelen anidar; las más grandes se asocian a resoluciones menos detalladas, mientras que las más pequeñas se colocan dentro de las regiones asociadas a niveles cada vez más detallados. En la siguiente figura, cada región tiene una serie de límites en cuanto a niveles de detalle que especifican qué tamaño de pantalla proyectado de la región en píxeles se requiere para que la región asociada se active. A medida que el usuario acerca la imagen, se activan las regiones con un mayor nivel de detalle, ya que la región ocupa más espacio en la pantalla. Las regiones con un mayor nivel de detalle sustituyen a las regiones cargadas anteriormente en las que el nivel de detalle es menor.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/kml/documentation/images/LodRange3.gif?authuser=19&hl=es)
Conforme se activan las distintas regiones anidadas sucesivas, estas pueden:
- acumular datos asociados a cada región (al igual que en el ejemplo de superposiciones que se describe más abajo),
- sustituir los datos de la región previamente cargada por datos nuevos (tal y como se muestra en la imagen anterior).
El atributo <LatLonAltBox> de una región secundaria debe estar incluido por completo en el atributo <LatLonAltBox> de la región principal. Las regiones se heredan a través de la jerarquía de elementos de carpetas y enlaces de red. Las regiones que se definen localmente tienen prioridad con respecto a las que están definidas en un lugar más alto de la jerarquía de carpetas. El siguiente ejemplo ilustra cómo el ámbito local de una región anula una región definida en un puesto superior de la jerarquía. En este ejemplo, la marca de posición de la región de Ucrania ("ukraineRegion") hereda la región de su documento principal. La carpeta de Rumanía ("romaniaFolder") especifica su propia región, utilizada por la marca de posición de "romaniaRegion". Consulta la sección Carga "inteligente" de enlaces de red basados en regiones que aparece a continuación para ver más ejemplos sobre la forma de usar las regiones dentro de los enlaces de red con objeto de conseguir la máxima eficacia.
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>Nested Regions</name> <Region> <LatLonAltBox> <north>56.25</north> <south>45</south> <east>33.75</east> <west>22.5</west> </LatLonAltBox> <Lod> <minLodPixels>128</minLodPixels> <maxLodPixels>1024</maxLodPixels> </Lod> </Region> <Placemark> <name>ukraineRegion</name> <LineString> <tessellate>1</tessellate> <coordinates> 22.5,45,0 33.75,45,0 33.75,56.25,0 22.5,56.25,0 22.5,45,0 </coordinates> </LineString> </Placemark> <Folder> <name>romaniaFolder</name> <Region> <LatLonAltBox> <north>50.625</north> <south>45</south> <east>28.125</east> <west>22.5</west> </LatLonAltBox> <Lod> <minLodPixels>128</minLodPixels> <maxLodPixels>1024</maxLodPixels> </Lod> </Region> <Placemark> <name>romaniaRegion</name> <LineString> <tessellate>1</tessellate> <coordinates> 22.5,45,0 28.125,45,0 28.125,50.625,0 22.5,50.625,0 22.5,45,0 </coordinates> </LineString> </Placemark> </Folder> </Document> </kml>
Carga "inteligente" de enlaces de red basados en regiones
Los enlaces de red basados en regiones que se muestran en el ejemplo anterior constituyen la forma más eficaz de publicar un conjunto de datos extenso en Google Earth. Mediante las regiones y los enlaces de red se puede crear una jerarquía de punteros en la que cada uno de ellos haga referencia a una región secundaria concreta. El elemento de modo de actualización de la vista (<viewRefreshMode>), tal y como se muestra en el siguiente archivo KML, tiene una opción relativa a la región (onRegion) que especifica que los datos de la región se deben cargar solo cuando la región esté activa. Si se proporcionan regiones anidadas con varios niveles de detalle, las cantidades más grandes de datos se cargarán solo cuando el punto de vista del usuario active la siguiente carga. En la siguiente sección sobre superposiciones, se proporciona un ejemplo detallado.
Parte 1: archivo principal
Para poder ejecutar este ejemplo, hay que guardar la primera parte del modo habitual. La segunda parte se debe guardar como romaniaRegion.kml para que el enlace de red pueda cargar la región cuando esta se active.
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>Nested Regions</name> <Region> <LatLonAltBox> <north>56.25</north> <south>45</south> <east>33.75</east> <west>22.5</west> </LatLonAltBox> <Lod> <minLodPixels>128</minLodPixels> <maxLodPixels>1024</maxLodPixels> </Lod> </Region> <Placemark> <name>ukraineRegion</name> <LineString> <tessellate>1</tessellate> <coordinates> 22.5,45,0 33.75,45,0 33.75,56.25,0 22.5,56.25,0 22.5,45,0 </coordinates> </LineString> </Placemark> <NetworkLink> <name>romania NetworkLink</name> <Region> <LatLonAltBox> <north>50.625</north> <south>45</south> <east>28.125</east> <west>22.5</west> </LatLonAltBox> <Lod> <minLodPixels>128</minLodPixels> <maxLodPixels>1024</maxLodPixels> </Lod> </Region> <Link> <href>romaniaRegion.kml</href> <viewRefreshMode>onRegion</viewRefreshMode> </Link> </NetworkLink> </Document> </kml>
Parte 2: archivo de enlace de red basado en regiones
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>romania Document</name>
<Region>
<LatLonAltBox> <north>50.625</north> <south>45</south> <east>28.125</east> <west>22.5</west> </LatLonAltBox>
<Lod> <minLodPixels>128</minLodPixels> <maxLodPixels>1024</maxLodPixels> </Lod>
</Region> <Placemark> <name>romaniaRegion</name> <LineString> <tessellate>1</tessellate> <coordinates> 22.5,45,0
28.125,45,0 28.125,50.625,0 22.5,50.625,0 22.5,45,0 </coordinates> </LineString> </Placemark>
</Document>
</kml>
Superposiciones
P: ¿Cómo puedo compartir una imagen de 47 MB con usuarios de todo el mundo?
R: Por partes.
P: ¿Qué pasa si todo el mundo intenta hacerlo?
R: Si usas enlaces de red basados en regiones y proporcionas varios niveles de detalle para las imágenes, tal y como se indica en este tutorial, no habrá problema alguno.
En esta sección se describe cómo se crea una "superposición", es decir, una jerarquía de regiones y enlaces de red que se pueden usar para mostrar eficazmente imágenes muy grandes. Los mosaicos de la resolución adecuada se cargan como fragmentos a medida que se muestra el área de la imagen. Las de mayor resolución se cargan en las áreas más cercanas al punto de vista. Mostrar una imagen de 7.008x6.720 píxeles en una pantalla de 1.024x768 requiere un esfuerzo que no merece la pena. Además, si el punto de vista del usuario está a muchos kilómetros de la superficie de la Tierra, todos estos datos se pueden amontonar en un puñado de píxeles y el rendimiento no será el óptimo. Las superposiciones, como muestra el ejemplo en formato DOQQ de la ciudad de Mountain View (California) de 1991, permiten aprovechar los enlaces de red y su capacidad para determinar si una región concreta está en el campo de visión y si el tamaño proyectado es adecuado para el punto de vista actual. Si la región está "activa" (si se cumplen ambas condiciones), el enlace de red carga los datos asociados a la región. Si la región está inactiva, no se carga ningún dato. Si la imagen original se divide en una jerarquía de imágenes con niveles de detalle que vayan en aumento, Google Earth puede cargar la imagen más adecuada para la vista actual.
Para ver cómo se usa esta jerarquía de imágenes, carga el archivo de ejemplo en Google Earth y prueba a acercar y alejar el área de interés: Mountain View en 1991, en formato DOQQ.
![]() | Ejemplo de uso de enlaces de red basados en regiones para cargar de forma eficaz un conjunto de datos muy extenso. La imagen original tiene 7.008x6.720 píxeles. La vista oblicua que se muestra aquí carga solo cinco mosaicos pequeños para representar la imagen (las líneas blancas se han añadido para resaltar los límites de cada mosaico). Esta aplicación muestra una imagen histórica de 1991 en formato DOQQ de la ciudad de Mountain View (California). |
Cómo preparar los datos para una superposición
En la superposición de ejemplo, la imagen original de Mountain View está dividida en cientos de pequeñas superposiciones de suelo GroundOverlays. Estas superposiciones (o mosaicos) están organizadas en una jerarquía de cinco niveles. Para el objetivo de este ejemplo, hablaremos aquí de una jerarquía sencilla de tres niveles y un conjunto de 21 superposiciones, pero los principios empleados son los mismos. Ten en cuenta que este es solo un enfoque para crear una jerarquía de enlaces de red basados en regiones y que existen otras formas de llevar a cabo este proceso.
Para crear una superposición, es necesario:
- Preparar la imagen dividiéndola en fragmentos manejables (se recomiendan 256x256 píxeles).
- Crear los archivos KML para configurar las regiones, los enlaces, los enlaces de red y, en este caso, los archivos que contienen las superposiciones de suelo.
Cómo preparar la imagen
Elige un tamaño estándar para los mosaicos (que son las imágenes divididas con distintas resoluciones) que Google Earth cargará a medida que se activen las regiones asociadas. Para este ejemplo, usaremos mosaicos de 256x256 píxeles, un tamaño lo suficientemente pequeño como para poder manejarlo con facilidad.
- Comienza con la imagen original a resolución completa. Divide la imagen en n mosaicos y vuelve a dividir cada uno de ellos en n mosaicos más.
Continúa dividiéndola hasta que consigas mosaicos del tamaño indicado (en este ejemplo, 256x256 píxeles).
Supongamos que la imagen original tiene 1.024x1.024 píxeles.
Al dividirla podríamos obtener la siguiente jerarquía. - Vuelve a unir cada mosaico de la jerarquía hasta lograr el tamaño estándar que hayas elegido (por ejemplo, 256x256 píxeles).
Los mosaicos obtenidos de esta forma tendrán menos detalles, pero estarán asociados a regiones que se activan cuando
el punto de vista está más alejado, por lo que la pérdida del detalle será imperceptible para el usuario.
![](https://developers-dot-devsite-v2-prod.appspot.com/static/kml/documentation/images/Tiling1.gif?authuser=19&hl=es)
![](https://developers-dot-devsite-v2-prod.appspot.com/static/kml/documentation/images/Tiling2.gif?authuser=19&hl=es)
El diagrama que aparece a continuación muestra cómo el punto de vista y la definición de las regiones anidadas determinan qué mosaicos son los que se cargan en realidad. Para este ejemplo de imagen con fragmentos grandes se han especificado tres niveles de detalle. Cuando el usuario observa la región desde una distancia grande, Google Earth muestra la vista en miniatura. Esta vista se expande por el espacio indicado por el elemento LatLonAltBox, pero como el tamaño proyectado es pequeño (256 píxeles cuadrados), en realidad no hay pérdida de información visual. Cuando el usuario acerca la escena, la región se divide en cuatro regiones. Cada uno de esos "mosaicos" tiene el mismo tamaño que la imagen en miniatura, pero proporciona imágenes con más detalle.
Si el usuario continúa acercando el área, comienzan a mostrarse partes de la imagen a resolución completa, en función de lo que se acerque la imagen. Las áreas lejanas conservan la cantidad inferior de detalles que se cargó al principio. En el ejemplo de la imagen DOQQ de la ciudad de Mountain View, activa los cuadros ("Boxes") y comprueba las marcas de posición A y B, que utilizan cadenas de líneas alrededor de las regiones y muestran varios niveles de la jerarquía al mismo tiempo.
Observa que el ejemplo utiliza los mismos valores para los elementos minLodPixels y maxLodPixels para todas las regiones (en todos los niveles de la jerarquía). Es el valor LatLonAltBox del cuadro el que determina qué nivel de la jerarquía y qué mosaicos de la región se deben cargar.
Cómo preparar los archivos KML
Para cada imagen, prepara un archivo KML que asocie la superposición de suelo a una región y un enlace de red. Cada archivo KML de este conjunto tiene los siguientes elementos:
- una región con los valores LatLonAltBox, minLodPixels y maxLodPixels para que Google Earth pueda determinar si la región está activa en un momento concreto,
- un conjunto de enlaces de red vinculados a los archivos secundarios (los mosaicos en el siguiente nivel de la jerarquía),
- la superposición de suelo para esta región.
Este ejemplo muestra el archivo KML de nivel superior para el ejemplo de la imagen en formato DOQQ de Mountain View. El valor maxLodPixels está establecido en -1, lo que tiene el significado especial "activo hasta un tamaño infinito". Sin esta especificación, es posible que la jerarquía completa no se active nunca.
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<NetworkLink>
<name>SuperOverlay: MV DOQQ</name>
<Region>
<LatLonAltBox>
<north>37.44140625</north>
<south>37.265625</south>
<east>-121.9921875</east>
<west>-122.16796875</west>
</LatLonAltBox>
<Lod>
<minLodPixels>128</minLodPixels>
<maxLodPixels>-1</maxLodPixels>
</Lod>
</Region>
<Link>
<href>http://mw1.google.com/mw-earth-vectordb/kml-samples/mv-070501/1.kml</href>
<viewRefreshMode>onRegion</viewRefreshMode>
</Link>
</NetworkLink>
</kml>
El siguiente archivo muestra una región del ejemplo en formato DOQQ de Mountain View (179.kml). Este archivo contiene cinco etiquetas href: cuatro de ellas se refieren a los cuatro archivos KML del siguiente nivel en la jerarquía de imágenes y una hace referencia al archivo de imagen utilizado para la superposición de suelo de este mosaico.
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<Region>
<Lod>
<minLodPixels>128</minLodPixels><maxLodPixels>-1</maxLodPixels>
</Lod>
<LatLonAltBox>
<north>37.430419921875</north><south>37.41943359375</south>
<east>-122.091064453125</east><west>-122.10205078125</west>
</LatLonAltBox>
</Region>
<NetworkLink>
<name>001120</name>
<Region>
<Lod>
<minLodPixels>128</minLodPixels><maxLodPixels>-1</maxLodPixels>
</Lod>
<LatLonAltBox>
<north>37.430419921875</north><south>37.4249267578125</south>
<east>-122.0965576171875</east><west>-122.10205078125</west>
</LatLonAltBox>
</Region>
<Link>
<href>180.kml</href>
<viewRefreshMode>onRegion</viewRefreshMode>
</Link>
</NetworkLink>
<NetworkLink>
<name>001121</name>
<Region>
<Lod>
<minLodPixels>128</minLodPixels><maxLodPixels>-1</maxLodPixels>
</Lod>
<LatLonAltBox>
<north>37.430419921875</north><south>37.4249267578125</south>
<east>-122.091064453125</east><west>-122.0965576171875</west>
</LatLonAltBox>
</Region>
<Link>
<href>185.kml</href>
<viewRefreshMode>onRegion</viewRefreshMode>
</Link>
</NetworkLink>
<NetworkLink>
<name>001122</name>
<Region>
<Lod>
<minLodPixels>128</minLodPixels><maxLodPixels>-1</maxLodPixels>
</Lod>
<LatLonAltBox>
<north>37.4249267578125</north><south>37.41943359375</south>
<east>-122.0965576171875</east><west>-122.10205078125</west>
</LatLonAltBox>
</Region>
<Link>
<href>190.kml</href>
<viewRefreshMode>onRegion</viewRefreshMode>
</Link>
</NetworkLink>
<NetworkLink>
<name>001123</name>
<Region>
<Lod>
<minLodPixels>128</minLodPixels><maxLodPixels>-1</maxLodPixels>
</Lod>
<LatLonAltBox>
<north>37.4249267578125</north><south>37.41943359375</south>
<east>-122.091064453125</east><west>-122.0965576171875</west>
</LatLonAltBox>
</Region>
<Link>
<href>195.kml</href>
<viewRefreshMode>onRegion</viewRefreshMode>
</Link>
</NetworkLink>
<GroundOverlay>
<drawOrder>5</drawOrder>
<Icon>
<href>179.JPEG</href>
</Icon>
<LatLonBox>
<north>37.430419921875</north><south>37.41943359375</south>
<east>-122.091064453125</east><west>-122.10205078125</west>
</LatLonBox>
</GroundOverlay>
</Document>
</kml>