Referencia KML

Esta sección contiene una referencia alfabética para todos los elementos KML definidos en la versión 2.2 de KML, así como elementos en el espacio de nombres de extensiones de Google. A continuación, se muestra el árbol de clases para los elementos KML. En este diagrama, los elementos a la derecha en una rama en particular del árbol son extensiones de los elementos a la izquierda. Por ejemplo, el marcador es un tipo especial de función. Contiene todos los elementos que pertenecen a Feature y agrega algunos elementos que son específicos del elemento del marcador.

KML es un estándar abierto oficialmente llamado OpenGIS® KML Encoding Standard (OGC KML). La mantiene el Open Geospatial Consortium, Inc. (OGC). La especificación completa de KML de OGC se puede encontrar en http://www.opengeospatial.org/standards/kml/.

El esquema XML completo para KML se encuentra en http://schemas.opengis.net/kml/.

Nota: Haz clic en el nombre de un elemento en este diagrama para saltar a su entrada en la sección de referencia.

diagrama de árbol de clase Elemento del objeto (superior) gx:Elemento de la gira; elemento secundario de Feature Elemento de NetworkLink; elemento secundario de Feature Elemento de marca de posición; elemento secundario de la función Elemento superpuesto; elemento secundario de Feature Elemento contenedor; elemento secundario de Feature Elemento destacado Elemento de geometría; elemento secundario del objeto Elemento PhotoOverlay; elemento secundario de Overlay ScreenOverlay; elemento secundario de Overlay Elemento GroundOverlay; elemento secundario de Overlay Elemento de la carpeta; elemento secundario del contenedor Elemento del documento; elemento secundario del contenedor Elemento de punto; elemento secundario de geometría Elemento LineString; elemento secundario de geometría Elemento LinearRing; elemento secundario de Geometría Elemento de vínculo: elemento secundario del objeto Elemento del ícono: elemento secundario del vínculo Elemento de orientación: elemento secundario del objeto Elemento de ubicación; elemento secundario del objeto Elemento de escala; elemento secundario del objeto Elemento poligonal; elemento secundario de geometría Elemento de MultiGeometry, elemento secundario de Geometry Elemento del modelo; elemento secundario de MultiGeometry gx:Elemento de seguimiento; elemento secundario de geometría Elemento de estilo; elemento secundario de StyleSelector gx:Elemento de varias pistas; elemento secundario de Geometría StyleSelector, elemento secundario del objeto Elemento StyleMap; elemento secundario del selector de estilo Elemento TimePrimitive; elemento secundario del objeto Elemento TimeSpan; elemento secundario de TimePrimitive gx:Marca de tiempo Elemento AbstractView; elemento secundario del objeto Elemento de la cámara; elemento secundario de AbstractView Elemento LookAt; elemento secundario de AbstractView Elemento de región; elemento secundario del objeto Elemento de objeto secundario; elemento secundario del objeto elemento LatLonBox; elemento secundario del objeto elemento LatLonAltBox; elemento secundario del objeto gx:LatLonQuad; chip de objeto Elemento de estilo secundario; bloque de objeto Elemento BalloonStyle; elemento secundario de SubStyle Elemento de colorStyle; elemento secundario de SubStyle Elemento ListStyle; elemento secundario de SubStyle gx:Elemento TimeSpan; secundario de TimeSpan Elemento de TimeStamp; elemento secundario de TimePrimitive Elemento de LineStyle; elemento secundario de ColorStyle Elemento PolyStyle; elemento secundario de ColorStyle IconStyle; elemento secundario de ColorStyle Elemento de LabelStyle; elemento secundario de ColorStyle gx:Elemento TourPrimitive; elemento secundario del objeto gx:Actualización animada gx:Elemento FlyTo; hijo de TourPrimitive gx:SoundCue, elemento secundario de TourPrimitive gx:TourControl, elemento secundario de gx:TourPrimitive gx:Elemento de espera; elemento secundario de gx:TourPrimitive gx:Elemento PlayList; elemento secundario del objeto

Ten en cuenta que, en realidad, los elementos abstractos (que se muestran en los cuadros del diagrama) no se usan en los archivos KML. Son una manera útil de que un solo elemento sirva como base programática de varios elementos derivados similares (pero diferentes). Comprender esta jerarquía orientada a objetos también es una buena manera de aprender KML, ya que puedes ver fácilmente grupos de elementos relacionados.

Todos los elementos derivados de Object pueden tener asignado un id. El mecanismo de actualización de los archivos KML usa este id (consulta <Update>) para los archivos cargados con un NetworkLink. Los estilos compartidos también lo usan (consulta <Style>). El id es un ID XML estándar.

Como los archivos KML son una gramática XML y un formato de archivo, los nombres de las etiquetas distinguen entre mayúsculas y minúsculas, y deben aparecer exactamente como se muestra aquí. Si conoces XML, también te interesará el Esquema KML 2.2. Cuando estás editando archivos KML de texto, puedes cargar este esquema en cualquier editor XML y validar tu código KML con él.

Sugerencia: ver KML para las funciones de Google Earth

Ésta es una función útil de Google Earth que te permite ver fácilmente el archivo KML de cualquier función. En Google Earth, puedes hacer clic con el botón derecho en un elemento del panel "Lugares" y copiarlo. Para ver el archivo KML correspondiente al objeto copiado, abre tu editor de texto favorito y pega la selección en él.

Compatibilidad

Las versiones KML tienen un sistema de numeración doble: majorVersion.minorVersion. Todas las versiones con el mismo majorVersion son compatibles. Por esta razón, si cambias el espacio de nombres a "2.2" (es decir, xmlns="http://www.opengis.net/kml/2.2"), todos los archivos KML 2.1 se validarán en el esquema de KML 2.2.

Acerca de esta referencia

Cada entrada de referencia incluye una sección de sintaxis que enumera los elementos contenidos en el elemento principal. Esta sección de sintaxis es una lista informal y usa una forma abreviada para resumir los elementos. Esta sección también contiene lo siguiente:

  • valores predeterminados para cada elemento (o los puntos suspensivos si se trata de un elemento complejo o si no hay un valor predeterminado)
  • el type del valor (consulta Campos KML)

La sección "Sintaxis" se puede copiar y usar como plantilla para cualquier elemento no abstracto en un archivo KML.

Espacio de nombres de extensión KML y el prefijo gx

El estándar KML de OGC proporciona un mecanismo para las extensiones (elementos adicionales que contienen información más allá de lo que está disponible en el estándar) (obtén más información sobre los espacios de nombres XML en w3.org). Con el lanzamiento de Google Earth 5.0, Google ha proporcionado extensiones a KML para admitir varias funciones nuevas. Estas extensiones usan el prefijo gx y el siguiente URI de espacio de nombres:

 xmlns:gx="http://www.google.com/kml/ext/2.2"

Este URI de espacio de nombres debe agregarse al elemento <kml> en cualquier archivo KML mediante elementos con el prefijo gx-:

<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

Es posible que las extensiones a KML no sean compatibles con todos los navegadores geográficos. Si el navegador no admite extensiones determinadas, los datos de dichas extensiones deben ignorarse en silencio y el resto del archivo KML debe cargarse sin errores.

Los elementos que actualmente usan el prefijo gx son los siguientes:

El esquema XML completo de los elementos en este espacio de nombres de extensión se encuentra en http://developers.google.com/kml/schema/kml22gx.xsd.

Campos KML

KML usa tipos XML comunes, como boolean, string, double,float y int. Además, define una serie de tipos de elementos de campo. En la tabla siguiente se enumeran algunos de los tipos más utilizados, definidos en KML, y vínculos a elementos de muestra que los utilizan:

Tipo de campo Valor Ejemplo de uso
altitudeModeEnum clampToGround, relativeToGround, absoluto Consulta <LookAt> y <Region>
ángulo90 un valor ≥−90 y ≤90 Consulta <latitude> en <Model>
anglepos90. un valor ≥ 0 y ≤ 90 Mira <tilt> en <LookAt>
ángulo180 un valor ≥−180 y ≤180 Consulta <longitude> en <Modelo>
angle360; un valor ≥−360 y ≤360 Consulta <heading> en <Orientation>
color Valor hexadecimal: aabbggrr Consulta cualquier elemento que extienda <ColorStyle>
colorModeEnum normal, aleatorio Consulta cualquier elemento que extienda <ColorStyle>
fecha y hora dateTime, date, gYearMonth, gYear Ver <TimeSpan> y <TimeStamp>
displayModeEnum. default, hide Ver <BalloonStyle>
gridOrigin. lowerLeft, topLeft Ver <PhotoOverlay>
refreshModeEnum onChange, onInterval y onExpire Consulta <Vínculo>
shapeEnum rectángulo, cilindro, esfera Ver <PhotoOverlay>
styleStateEnum normal, destacar Consulta <StyleMap>
unidaddeunidad fracción, píxeles, píxeles integrados Consulta <hotSpot> en <IconStyle>, <ScreenOverlay>
Vec2 x=double xunits=kml:unitsEnum
==double yunits=kml:unitsEnum
Consulta <hotSpot> en <IconStyle>,
y <ScreenOverlay>
viewRefreshEnum nunca, onRequest, onStop, onRegion Consulta <Vínculo>

 

<AbstractView>

Sintaxis

<!-- abstract element; do not create -->
<!-- AbstractView -->                       <!-- Camera, LookAt -->
  <!-- extends Object -->
  <TimePrimitive>...</TimePrimitive>        <!-- gx:TimeSpan or gx:TimeStamp -->
  <gx:ViewerOptions>
    <gx:option name="" enabled=boolean />   <!-- name="streetview",
                                                      "historicalimagery",
                                                   or "sunlight" -->
  </gx:ViewerOptions>
<-- /AbstractView -->

Descripción

Este es un elemento abstracto y no se puede utilizar directamente en un archivo KML. Los elementos <Camera> y <LookAt> extienden este elemento.

Extiende

Elementos específicos de AbstractView

<gx:ViewerOptions>
Este elemento habilita los modos de visualización especiales en Google Earth 6.0 y versiones posteriores. Tiene uno o más elementos secundarios <gx:option>. El elemento <gx:option> tiene un atributo name y un atributo enabled. El elemento name especifica una de las siguientes opciones: imágenes de Street View ("streetview"), imágenes históricas ("imagen histórica") y efectos de luz solar para una hora determinada del día ("luz solar"). El atributo enabled se usa para activar o desactivar un modo de visualización determinado.
<gx:horizFov>
Define el campo visual horizontal de AbstractView durante un viaje. Este elemento no tiene efecto en AbstractViews fuera de una visita guiada. El cliente de Google Earth (versiones 6.1 y posteriores) inserta automáticamente <gx:horizFov>. A las vistas regulares de AbstractView se les asigna un valor de 60; a las vistas dentro de Street View, se les asigna un valor de 85 que coincide con el campo de visión estándar de Street View en Google Earth. Una vez establecido, el valor se aplicará a las vistas posteriores, hasta que se especifique un valor nuevo.

Extendido por

<gx:altitudeMode>

Este elemento es una extensión del estándar KML 2.2 de OGC y es compatible con Google Earth 5.0 y versiones posteriores. Más información

Sintaxis

<gx:altitudeMode>clampToGround</gx:altitudeMode>
  <!-- gx:altitudeModeEnum: relativeToSeaFloor, clampToSeaFloor, relativeToGround, clampToGround, absolute -->

Descripción

Se puede utilizar en lugar del elemento <altitudeMode> estándar de KML de OGC y acepta los siguientes valores además de los valores altitudeMode estándar:

  • relativeToSeaFloor: Interpreta la altitud como un valor en metros sobre el lecho marino. Si el elemento KML está sobre el suelo en lugar del mar, la altitud se interpretará como si estuviera sobre el suelo.
  • clampToSeaFloor: Se ignora la especificación de altitud y el elemento KML se posiciona en el lecho marino. Si el elemento KML está en tierra en lugar de en el mar, clampToSeaFloor se fijará en el suelo.

Al igual que con <altitudeMode>, <gx:altitudeMode> afecta lo siguiente:

  • las coordenadas de altitud del elemento <coordinates>
  • <minAltitude> y <maxAltitude> en <LatLonAltBox>
  • <altitude> en <Location>, <GroundOverlay> y AbstractView (<LookAt> y <Camera>).

Puedes encontrar más información sobre los modos de altitud en el capítulo Modos de altitud de la guía para programadores de KML.

Ejemplo

altitudemode_reference.kml.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">   <!-- required when using gx-prefixed elements -->

<Placemark>
  <name>gx:altitudeMode Example</name>
  <LookAt>
    <longitude>146.806</longitude>
    <latitude>12.219</latitude>
    <heading>-60</heading>
    <tilt>70</tilt>
    <range>6300</range>
    <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
  </LookAt>
  <LineString>
    <extrude>1</extrude>
    <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
    <coordinates>
      146.825,12.233,400
      146.820,12.222,400
      146.812,12.212,400
      146.796,12.209,400
      146.788,12.205,400
    </coordinates>
  </LineString>
</Placemark>

</kml>

 

<gx:AnimatedUpdate>

Este elemento es una extensión del estándar KML 2.2 de OGC y es compatible con Google Earth 5.0 y versiones posteriores. Más información

Sintaxis

<gx:AnimatedUpdate id="ID">
  <gx:duration>0.0</gx:duration>     <!-- double, specifies time in seconds -->
  <Update>
    <targetHref>...</targetHref>     <!-- required; can contain a URL or be left blank -->
                                      <!-- (to target elements within the same file) -->
    <Change>...</Change>
    <Create>...</Create>
    <Delete>...</Delete>
  </Update>
  <gx:delayedStart>0</gx:delayedStart>  <!-- double, specifies time in seconds -->
</gx:AnimatedUpdate>

Descripción

<gx:AnimatedUpdate> controla los cambios durante un viaje a los elementos KML mediante <Update>. Los cambios en los elementos KML no modificarán el DOM; es decir, los cambios se revertirán cuando finalice el viaje y no se guardarán en el KML en ningún momento.

<gx:AnimatedUpdate> también debe contener un valor <gx:duration> para especificar la cantidad de tiempo en segundos durante la cual se realiza la actualización. Los campos de números enteros, de punto flotante y de color están animados de forma fluida desde el valor original hasta el valor nuevo en toda la duración. Los valores booleanos, de string y otros que no se prestan a la interpolación se actualizan al final de este período.

Consulta los cronogramas de viajes en el capítulo Viajes de la Guía para desarrolladores de KML a fin de obtener información sobre <gx:AnimatedUpdate> y el cronograma de giras.

<gx:duration>
Especifica la duración, en segundos, de la actualización.
<gx:delayedInicio>
Especifica la cantidad de segundos que hay que esperar (después de la posición de inicio intercalado) antes de iniciar la actualización.

Ejemplo

En el siguiente ejemplo, se muestra un cambio en el tamaño del ícono. Este cambio tendrá una duración de 5 segundos.

ejemplo_animado_de_actualización.kml

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

<Document>
  <name>gx:AnimatedUpdate example</name>

  <Style id="pushpin">
    <IconStyle id="mystyle">
<Icon>
<href>http://maps.google.com/mapfiles/kml/pushpin/ylw-pushpin.png</href> <scale>1.0</scale>
</Icon>
</IconStyle>
</Style> <Placemark id="mountainpin1"> <name>Pin on a mountaintop</name> <styleUrl>#pushpin</styleUrl>
<Point>
<coordinates>170.1435558771009,-43.60505741890396,0</coordinates>
</Point> </Placemark> <gx:Tour> <name>Play me!</name> <gx:Playlist> <gx:FlyTo>
<gx:flyToMode>bounce</gx:flyToMode>
<gx:duration>3</gx:duration>
<Camera>
<longitude>170.157</longitude>
<latitude>-43.671</latitude>
<altitude>9700</altitude>
<heading>-6.333</heading>
<tilt>33.5</tilt>
</Camera>
</gx:FlyTo> <gx:AnimatedUpdate> <gx:duration>5</gx:duration> <Update> <targetHref></targetHref> <Change> <IconStyle targetId="mystyle"> <scale>10.0</scale> </IconStyle> </Change> </Update> </gx:AnimatedUpdate> <gx:Wait> <gx:duration>5</gx:duration> </gx:Wait> </gx:Playlist> </gx:Tour> </Document> </kml>

Extiende

Contenido

<Estilo de la pista>

Sintaxis

<BalloonStyle id="ID">
  <!-- specific to BalloonStyle -->
  <bgColor>ffffffff</bgColor>            <!-- kml:color -->
  <textColor>ff000000</textColor>        <!-- kml:color -->
  <text>...</text>                       <!-- string -->
  <displayMode>default</displayMode>     <!-- kml:displayModeEnum -->
</BalloonStyle>

Descripción

Especifica cómo se dibuja el globo de descripción de los marcadores. Si se especifica, el <bgColor> se usará como el color de fondo del globo. Consulta <Función> para ver un diagrama que ilustra cómo aparece el globo de descripción predeterminado en Google Earth.

Elementos específicos de BalloonStyle

<bgColor>
Color de fondo del globo (opcional). Los valores de color y opacidad (Alfa) se expresan en notación hexadecimal. El rango de valores para cualquier color es de 0 a 255 (de 00 a ff). El orden de expresión es aabbggrr; en el que aa=alpha (00 a ff); bb=blue (00 a ff); gg=green (00 a ff); rr=red (00 a ff). Para la versión alfa, 00 es completamente transparente y ff es completamente opaco. Por ejemplo, si deseas aplicar un color azul con un 50% de opacidad a una superposición, debes especificar lo siguiente: <bgColor>7fff0000</bgColor>, donde alpha=0x7f, blue=0xff, green=0x00 y red=0x00. El color predeterminado es el blanco opaco (ffffffff).

Nota: El uso del elemento <color> en <BalloonStyle> dejó de estar disponible. En su lugar, usa <bgColor>.

<textColor>
Color de primer plano para el texto. El color predeterminado es el negro (ff000000).
<text>
Texto que se muestra en el globo Si no se especifica texto, Google Earth dibuja el globo predeterminado (con el elemento <nombre> en negrita, el elemento <description>, los vínculos para obtener instrucciones sobre cómo llegar, un fondo blanco y una cola adjunta a las coordenadas de los puntos del elemento, si se especifica).
Puedes agregar entidades a la etiqueta <text> con el siguiente formato para hacer referencia a un elemento secundario de Función: $[name], $[description], $[address], $[id] y $[Snippet]. En la función actual, Google Earth busca la entidad de cadena correspondiente y sustituye esa información del globo. Para incluir Hasta aquí, desde la siguiente ruta en auto en el globo, usa la etiqueta $[geDirections]. Para evitar que los vínculos de instrucciones sobre cómo llegar aparezcan en un globo, incluye el elemento <text> con contenido o con $[description] para sustituir la función básica <description>.
Por ejemplo, en el siguiente extracto de KML, los campos $[name] y $[description] se reemplazarán por los campos <name> y <description> que se encuentran en los elementos de la función que usan BalloonStyle:
<displayMode>
Si <displayMode> es default, Google Earth utiliza la información que se indica en <text> para crear un globo . Si <displayMode> es hide, Google Earth no mostrará el globo. En Google Earth, al hacer clic en el ícono de la vista de lista para una marca de posición cuyo <displayMode> de globo esté ocultar, Google Earth volará a la marca de posición.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document> <name>BalloonStyle.kml</name>
<open>1</open>
<Style id="exampleBalloonStyle">
<BalloonStyle>
<!-- a background color for the balloon -->
<bgColor>ffffffbb</bgColor>
<!-- styling of the balloon text -->
<text><![CDATA[
<b><font color="#CC0000" size="+3">$[name]</font></b>
<br/><br/>
<font face="Courier">$[description]</font>
<br/><br/>
Extra text that will appear in the description balloon
<br/><br/>
<!-- insert the to/from hyperlinks -->
$[geDirections]
]]></text>
</BalloonStyle>
</Style>
<Placemark>
<name>BalloonStyle</name>
<description>An example of BalloonStyle</description>
<styleUrl>#exampleBalloonStyle</styleUrl>
<Point>
<coordinates>-122.370533,37.823842,0</coordinates>
</Point>
</Placemark>
</Document>
</kml>

Extiende

Contenida por

Volver al principio

<gx:balloonVisibility>

Este elemento es una extensión del estándar KML 2.2 de OGC y es compatible con Google Earth 5.0 y versiones posteriores. Más información

Sintaxis

<gx:balloonVisibility>0</gx:balloonVisibility>    <!-- 0 (not visible) or 1 (visible) -->

Descripción

Alterna la visibilidad del globo de descripción. Para que se pueda actualizar el globo, se debe identificar el ID XML del objeto (por ejemplo, <Placemark targetId="xxx">).

Ejemplos

El primer ejemplo muestra <gx:balloonVisibility> con una marca de posición. Cuando se carga la marca de posición, se abre el globo de descripción.
balloonvisibility_example.kml

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

  <Placemark>
    <name>Eiffel Tower</name>
    <description>
        Located in Paris, France. 

This description balloon opens
when the Placemark is loaded. </description> <gx:balloonVisibility>1</gx:balloonVisibility> <Point> <coordinates>2.294785,48.858093,0</coordinates> </Point> </Placemark> </kml>

El segundo ejemplo muestra cómo usar <gx:balloonVisibility> en una visita guiada. Durante la visita, se abren y cierran algunos globos que proporcionan información al espectador.
balloonvisibility_tourexample.kml.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

  <Document>
    <name>balloonVisibility Example</name>
    <open>1</open>

    <gx:Tour>
      <name>Play me</name>
      <gx:Playlist>

        <gx:FlyTo>
          <gx:duration>8.0</gx:duration>
          <gx:flyToMode>bounce</gx:flyToMode>
          <LookAt>
            <longitude>-119.748584</longitude>
            <latitude>33.736266</latitude>
            <altitude>0</altitude>
            <heading>-9.295926</heading>
            <tilt>84.0957450</tilt>
            <range>4469.850414</range>
            <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater1">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater1">
                <gx:balloonVisibility>0</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>3</gx:duration>
          <gx:flyToMode>smooth</gx:flyToMode>
          <LookAt>
            <longitude>-119.782630</longitude>
            <latitude>33.862855</latitude>
            <altitude>0</altitude>
            <heading>-9.314858</heading>
            <tilt>84.117317</tilt>
            <range>6792.665540</range>
            <gx:altitudeMode>relativeToSeaFloor</gx:altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater2">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="underwater2">
                <gx:balloonVisibility>0</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>3</gx:duration>
          <gx:flyToMode>smooth</gx:flyToMode>
          <LookAt>
            <longitude>-119.849578</longitude>
            <latitude>33.968515</latitude>
            <altitude>0</altitude>
            <heading>-173.948935</heading>
            <tilt>23.063392</tilt>
            <range>3733.666023</range>
            <altitudeMode>relativeToGround</altitudeMode>
          </LookAt>
        </gx:FlyTo>

        <gx:AnimatedUpdate>
          <gx:duration>0.0</gx:duration>
          <Update>
            <targetHref/>
            <Change>
              <Placemark targetId="onland">
                <gx:balloonVisibility>1</gx:balloonVisibility>
              </Placemark>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:Wait>
          <gx:duration>4.0</gx:duration>
        </gx:Wait>

      </gx:Playlist>
    </gx:Tour>

    <Placemark id="underwater1">
      <name>Underwater off the California Coast</name>
      <description>
        The tour begins near the Santa Cruz Canyon,
        off the coast of California, USA.
      </description>
      <Point>
        <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode>
        <coordinates>-119.749531,33.715059,0</coordinates>
      </Point>
    </Placemark>

    <Placemark id="underwater2">
      <name>Still swimming...</name>
      <description>We're about to leave the ocean, and visit the coast...</description>
      <Point>
        <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode>
        <coordinates>-119.779550,33.829268,0</coordinates>
      </Point>
    </Placemark>

    <Placemark id="onland">
      <name>The end</name>
      <description>
        <![CDATA[The end of our simple tour.
        Use <gx:balloonVisibility>1</gx:balloonVisibility>
        to show description balloons.]]>
      </description>
      <Point>
        <coordinates>-119.849578,33.968515,0</coordinates>
      </Point>
    </Placemark>


  </Document>
</kml>

Extiende

<Cámara>

Sintaxis

<Camera id="ID">
  <!-- inherited from AbstractView element -->
  <TimePrimitive>...</TimePrimitive>  <!-- gx:TimeSpan or gx:TimeStamp -->
  <gx:ViewerOptions>
    <option> name=" " type="boolean">     <!-- name="streetview", "historicalimagery", "sunlight", or "groundnavigation" -->
    </option>
  </gx:ViewerOptions>

  <!-- specific to Camera -->
  <longitude>0</longitude>            <!-- kml:angle180 -->
  <latitude>0</latitude>              <!-- kml:angle90 -->
  <altitude>0</altitude>              <!-- double -->
  <heading>0</heading>                <!-- kml:angle360 -->
  <tilt>0</tilt>                      <!-- kml:anglepos180 -->
  <roll>0</roll>                      <!-- kml:angle180 -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: relativeToGround, clampToGround, or absolute -->
        <!-- or, gx:altitudeMode can be substituted: clampToSeaFloor, relativeToSeaFloor -->
</Camera> 

Descripción

Define la cámara virtual que mira la escena. Este elemento define la posición de la cámara en relación con la superficie de la Tierra y la dirección de visualización de la cámara. La posición de la cámara se define por <longitud>, <latitud>, <altitude> y <altitudeMode> o <gx:altitudeMode>. La dirección de visualización de la cámara se define por <heading>, <tilt> y <roll>. <Camera> puede ser un elemento secundario de cualquier elemento o <NetworkLinkControl>. Un elemento superior no puede contener ambos elementos.

<Camera> proporciona un control total de seis grados de libertad sobre la vista para que puedas colocar la cámara en el espacio y luego girarla alrededor de los ejes X, Y y Z. Y, lo más importante, puedes inclinar la vista de la cámara para observar en el cielo hacia el cielo.

<Camera> también puede contener un parámetro TimePrimitive (<gx:TimeSpan> o <gx:TimeStamp>). Los valores de tiempo en la cámara afectan las imágenes históricas, la luz solar y la visualización de los atributos con marca de tiempo. Para obtener más información, lee Tiempo con AbstractViews en el capítulo Tiempo y animación de la Guía para desarrolladores.

Cómo definir una vista

Dentro de una función o de <NetworkLinkControl>, usa un objeto <Camera> o <LookAt> (pero no ambos en el mismo objeto). El objeto <Camera> define el punto de vista en términos de la posición y orientación del espectador. El objeto <Camera> te permite especificar una vista que no se encuentra en la superficie de la Tierra. El objeto <LookAt> define el punto de vista en términos de lo que se ve. El alcance del objeto <LookAt> es más limitado que <Camera> y generalmente requiere que la dirección de la vista cruce la superficie de la Tierra.

En el siguiente diagrama, se muestran los ejes X, Y y Z, que están conectados a la cámara virtual.

  • El eje X apunta hacia la derecha de la cámara y se llama el vector derecho.
  • El eje Y define la dirección “hacia arriba” en relación con la pantalla y se llama vector vectorial hacia arriba.
  • El eje Z apunta desde el centro de la pantalla hacia el punto de los ojos. La cámara mira hacia abajo en el eje −Z, que se llama vector de vista.

Orden de transformaciones

El orden de rotación es importante. De forma predeterminada, la cámara apunta directamente hacia abajo, hacia el eje −Z, en dirección a la Tierra. Antes de realizar las rotaciones, la cámara se traduce a lo largo del eje Z a <altitude>. El orden de las transformaciones es el siguiente:

  1. <altitude>: Traduce a lo largo del eje Z a <altitude>
  2. <heading>: Rota el eje Z.
  3. <tilt>: Rota el eje X.
  4. <roll>: Gira alrededor del eje Z (otra vez).

Ten en cuenta que, cada vez que se aplica una rotación, dos de los ejes de la cámara cambian de orientación.

Elementos específicos de la cámara

<longitude>
Longitud de la cámara virtual (punto de vista). Distancia angular en grados, en relación con el primer meridiano. Valores al oeste del rango de Meridian desde −180 a 0 grados. Los valores al este del meridiano van de 0 a 180 grados.
<latitude>
Latitud de la cámara virtual. Grados del norte o sur del ecuador (0 grados). Los valores varían entre −90 grados y 90 grados.
<altitude>
La distancia de la cámara a la superficie de la Tierra en metros. Interpretado según la <altitudeMode> o la <gx:altitudeMode> de la Cámara.
<heading>
Dirección (acimut) de la cámara, en grados. Predeterminado=0 (verdadero norte). (Consulta el diagrama). Los valores varían de 0 a 360 grados.
<tilt>
Rotación, en grados, de la cámara alrededor del eje X. Un valor de 0 indica que la vista apunta directamente hacia la Tierra (el caso más común). Un valor de 90 para <tilt> indica que la vista está orientada hacia el horizonte. Los valores superiores a 90 indican que la vista apunta hacia arriba. Los valores de <tilt> se fijan en +180 grados.
<roll>
Rotación, en grados, de la cámara alrededor del eje Z. Los valores varían entre −180 y +180 grados.
<altitudeMode>
Especifica cómo se interpreta la <altitude> que se especificó para la cámara. Los valores posibles son los siguientes:
  • relativeToGround (predeterminado) interpreta la <altitude> como un valor en metros sobre el suelo. Si el punto está sobre el agua, la <altitude> se interpretará como un valor en metros sobre el nivel del mar. Consulta <gx:altitudeMode> a continuación para especificar los puntos relacionados con el lecho marino.
  • clampToGround: En el caso de una cámara, esta configuración también coloca la cámara relativeToGround, ya que, si se coloca la cámara exactamente a la altura del terreno, el ojo se intersecaría con el terreno (y la vista se bloquearía).
  • absolute: Interpreta el valor de <altitude> como un valor en metros sobre el nivel del mar.
<gx:altitudeMode>
Es una extensión KML en el espacio de nombres de extensiones de Google, que permite altitudes relativas al lecho marino. Los valores son los siguientes:
  • relativeToSeaFloor: Interpreta la <altitude> como un valor en metros sobre el lecho marino. Si el punto se encuentra sobre el suelo en lugar de en el mar, se interpretará que la <altitude> está sobre el suelo.
  • clampToSeaFloor: Se ignora la especificación de <altitude>, y la cámara se posicionará en el lecho marino. Si el punto está en tierra en vez de en el mar, la cámara estará colocada en el suelo.

Extiende

Contenida por

Volver al principio

<ColorStyle>

Sintaxis

<!-- abstract element; do not create -->
<!-- ColorStyle id="ID" -->          <!-- IconStyle,LabelStyle,LineStyle,PolyStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->
<!-- /ColorStyle -->

Descripción

Este es un elemento abstracto y no se puede utilizar directamente en un archivo KML. Proporciona elementos para especificar el color y el modo de color de los tipos de estilo extendido.

Elementos específicos de ColorStyle

<color>
Los valores de color y opacidad (Alfa) se expresan en notación hexadecimal. El rango de valores de cualquier color es de 0 a 255 (de 00 a ff). En el caso del alfa, 00 es completamente transparente y ff es completamente opaco. El orden de expresión es aabbggrr, donde aa=alpha (00 a ff); bb=blue (00 a ff); gg=green (00 a ff); rr=red (00 a ff). Por ejemplo, si deseas aplicar un color azul con un 50% de opacidad a una superposición, debes especificar lo siguiente: <color>7fff0000</color>, donde alpha=0x7f, blue=0xff, green=0x00 y red=0x00.
<colorMode>
Los valores de <colorMode> son normales (sin efectos) y random. Un valor de random aplica una escala lineal aleatoria a la <color> base de la siguiente manera.
  • Para lograr una selección de colores verdaderamente aleatoria, especifica un <color> de color blanco (ffffffff).
  • Si especificas un solo componente de color (por ejemplo, un valor de ff0000ff para red), se seleccionarán los valores de color aleatorios para ese componente (rojo). En este caso, los valores pueden variar desde 00 (black) hasta ff (full red).
  • Si especificas valores en dos o en los tres componentes de color, se aplica una escala lineal aleatoria a cada componente de color, y los resultados van del negro al valor máximo especificado para cada componente.
  • La opacidad de un color proviene del componente alfa de <color> y nunca es aleatorio.

Extiende

Extendido por

Volver al principio

<Contenedor>

Sintaxis

<!-- abstract element; do not create -->
<!-- Container id="ID" -->              <!-- Document,Folder -->
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <address>...</address>                <!-- string -->
  <AddressDetails xmlns="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0">...
</AddressDetails> <!-- string --> <phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- LookAt or Camera --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <atom:author>...<atom:author> <!-- xmlns:atom="http://www.w3.org/2005/Atom" --> <atom:link href=" "/> <!-- specific to Container -->
<!-- 0 or more Features --> <!-- /Container -->

Descripción

Este es un elemento abstracto y no se puede utilizar directamente en un archivo KML. Un elemento contenedor contiene una o más funciones y permite la creación de jerarquías anidadas.

Extiende

Extendido por

Volver al principio

<Document>

Sintaxis

<Document id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                 <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 --> <!-- specific to Document --> <!-- 0 or more Schema elements --> <!-- 0 or more Feature elements --> </Document>

Descripción

Un documento es un contenedor de características y estilos. Este elemento es obligatorio si tu archivo KML utiliza estilos compartidos. Se recomienda usar estilos compartidos, lo que requiere los siguientes pasos:

  1. Definir todos los estilos en un documento. Asigna un ID único a cada estilo.
  2. Dentro de un elemento o StyleMap determinado, haz referencia al ID del estilo mediante un elemento <styleUrl>.

Tenga en cuenta que las funciones del documento no heredan los estilos compartidos.

Cada elemento debe hacer referencia explícitamente a los estilos que utiliza en un elemento <styleUrl>. En el caso de un estilo que se aplica a un documento (como ListStyle), el documento debe hacer referencia explícitamente a <styleUrl>. Por ejemplo:

<Document>
  <Style id="myPrettyDocument">
   <ListStyle> ... </ListStyle>

  </Style>
  <styleUrl#myPrettyDocument">
  ...
</Document> 

No coloques estilos compartidos en una carpeta.

En el siguiente ejemplo, se ilustra el uso de un estilo compartido.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>Document.kml</name>
<open>1</open> <Style id="exampleStyleDocument">
<LabelStyle>
<color>ff0000cc</color>
</LabelStyle>
</Style>
<Placemark>
<name>Document Feature 1</name>
<styleUrl>#exampleStyleDocument</styleUrl>
<Point>
<coordinates>-122.371,37.816,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>Document Feature 2</name>
<styleUrl>#exampleStyleDocument</styleUrl>
<Point>
<coordinates>-122.370,37.817,0</coordinates>
</Point>
</Placemark>
</Document>
</kml>

Extiende

Contenido

Volver al principio

<gx:duration>

Este elemento es una extensión del estándar KML 2.2 de OGC y es compatible con Google Earth 5.0 y versiones posteriores. Más información

Sintaxis

<gx:duration>0.0</gx:duration>            <!-- double -->

Descripción

<gx:duration> extiende gx:TourPrimitive mediante la especificación de un intervalo de eventos. La hora se escribe como segundos con el tipo de datos double en XML.

Duración y <gx:FlyTo>

Cuando se incluye una duración dentro de un elemento <gx:FlyTo>, se especifica el tiempo que tarda el navegador en volar desde el punto anterior hasta el punto especificado.

<gx:FlyTo>
  <gx:flyToMode>bounce</gx:flyToMode>
  <gx:duration>10.2</gx:duration>

  <!-- AbstractView -->
    ...
  <!-- /AbstractView -->
</gx:FlyTo>

Duration y <gx:AnimatedUpdate>

Especifica el período durante el cual se realiza la actualización. Los campos de números enteros, de punto flotante y de color están animados de forma fluida desde el valor original hasta el valor nuevo en toda la duración. Los valores booleanos, de string y otros que no se prestan a la interpolación se actualizan al final de este período.

<gx:AnimatedUpdate>
  <gx:duration>5.0</gx:duration>
  <Update>

    ....

  </Update>
</gx:AnimatedUpdate>

 

<ExtendedData>

Sintaxis

<ExtendedData>                       
<Data name="string">
  <displayName>...</displayName>    <!-- string -->
   <value>...</value>                <!-- string -->
</Data> <SchemaData schemaUrl="anyURI">
<SimpleData name=""> ... </SimpleData>   <!-- string -->
</SchemaData> <namespace_prefix:other>...</namespace_prefix:other> </ExtendedData>

Descripción

El elemento ExtendedData ofrece tres técnicas para agregar datos personalizados a un elemento KML (NetworkLink, Placemark, GroundOverlay, PhotoOverlay, ScreenOverlay, Document, Folder). Estas técnicas son

  • Cómo agregar pares de valor/datos sin tipo con el elemento <Data> (básico)
  • Declarar nuevos campos escritos mediante el elemento <Schema> y, luego, establecerlos con el elemento <SchemaData> (avanzado)
  • Hace referencia a los elementos XML definidos en otros espacios de nombres haciendo referencia al espacio de nombres externo dentro del archivo KML (básico).

Estas técnicas se pueden combinar en un solo archivo KML o una función para diferentes datos.

Para obtener más información, consulta Agregar datos personalizados en la sección "Temas en KML".

Elementos específicos de ExtendedData

<Nombre de datos ="string">
Crea un par nombre/valor sin tipo. El nombre puede tener dos versiones: name y displayName. El atributo name se usa para identificar el par de datos dentro del archivo KML. El elemento displayName se utiliza cuando se muestra un nombre con formato adecuado, con espacios y formato HTML, en Google Earth. En el elemento <text> de <BalloonStyle>, la notación $[name/displayName] se reemplaza por <displayName>. Si sustituyes el valor del atributo name del elemento <Data> en este formato (por ejemplo, $[holeYardage]), el valor del atributo se reemplaza por <value>. De forma predeterminada, el globo del marcador muestra los pares de nombre y valor asociados a él.
<displayName>
Es una versión opcional de name con formato que se usará con fines de visualización.
<value>
Valor del par de datos.
<Placemark>
  <name>Club house</name>
  <ExtendedData>
    <Data name="holeNumber">
      <value>1</value>
    </Data>
    <Data name="holeYardage">
      <value>234</value>
    </Data>
    <Data name="holePar">
      <value>4</value>
    </Data>
  </ExtendedData>
</Placemark>
<SchemaData schemaUrl="cualquierURI">
Este elemento se usa junto con <Esquema> para agregar datos personalizados escritos a un elemento KML. El elemento Esquema (identificado por el atributo schemaUrl) declara el tipo de datos personalizado. Los objetos de datos reales (“instancias” de los datos personalizados) se definen usando el elemento SchemaData.
La <schemaURL> puede ser una URL completa, una referencia a un ID de esquema definido en un archivo KML externo o una referencia a un ID de esquema definido en el mismo archivo KML. Se aceptan las siguientes especificaciones:
schemaUrl="http://host.com/PlacesIHaveLived.kml#my-schema-id"
schemaUrl="AnotherFile.kml#my-schema-id"
schemaUrl="#schema-id"   <!-- same file -->
El elemento Schema siempre es un elemento secundario de Document. El elemento ExtendedData es un elemento secundario de la función que contiene los datos personalizados.
<SimpleData name="string">
Este elemento asigna un valor al campo de datos personalizados identificado con el atributo name. El tipo y el nombre de este campo de datos personalizados se declaran en el elemento <Schema>.
Este es un ejemplo de cómo definir dos elementos de datos personalizados:
<Placemark>
  <name>Easy trail</name>
  <ExtendedData>
    <SchemaData schemaUrl="#TrailHeadTypeId">
      <SimpleData name="TrailHeadName">Pi in the sky</SimpleData>
      <SimpleData name="TrailLength">3.14159</SimpleData>
      <SimpleData name="ElevationGain">10</SimpleData>
    </SchemaData>
    </ExtendedData>
    <Point>
      <coordinates>-122.000,37.002</coordinates>
    </Point>
</Placemark>
<Placemark>
  <name>Difficult trail</name>
  <ExtendedData>
    <SchemaData schemaUrl="#TrailHeadTypeId">
      <SimpleData name="TrailHeadName">Mount Everest</SimpleData>
      <SimpleData name="TrailLength">347.45</SimpleData>
      <SimpleData name="ElevationGain">10000</SimpleData>
    </SchemaData>
  </ExtendedData>
  <Point>
    <coordinates>-122.000,37.002</coordinates>
  </Point>
</Placemark>
<namespace_prefix:other>
Este elemento te permite agregar datos personalizados sin tipo. Asegúrese de hacer referencia al prefijo del espacio de nombres en el elemento <kml> de su archivo o como atributo del elemento <ExtendedData> y agregar el prefijo del nombre de cada elemento de datos. Los datos personalizados que se agregan de esta manera se conservan en el archivo KML, pero Google Earth no los usa de ninguna manera. Siempre se guarda junto con el archivo.
En el siguiente ejemplo, se muestra cómo usar el prefijo del espacio de nombres "camp":
<ExtendedData xmlns:prefix="camp">
<camp:number>14</camp:number>
<camp:parkingSpaces>2</camp:parkingSpaces>
<camp:tentSites>4</camp:tentSites>
</ExtendedData>

Contenida por

Consulta también

<Función>

Sintaxis

<!-- abstract element; do not create -->
<!-- Feature id="ID" -->                <!-- Document,Folder,
                                             NetworkLink,Placemark,
                                             GroundOverlay,PhotoOverlay,ScreenOverlay -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <!-- TimeStamp or TimeSpan --> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 -->
<-- /Feature -->

Descripción

Este es un elemento abstracto y no se puede utilizar directamente en un archivo KML. En el siguiente diagrama se muestra cómo aparecen algunos de los elementos de un elemento en Google Earth.

Elementos específicos de la función

<name>
Texto definido por el usuario que se muestra en el Visor 3D como la etiqueta del objeto (por ejemplo, para una marca de posición, carpeta o vínculo de red).
<visibility>
Valor booleano. Especifica si la función se dibuja en el visor 3D cuando se carga inicialmente. Para que un elemento sea visible, la etiqueta <visibility> de todos sus elementos principales también debe establecerse en 1. En la Vista de lista de Google Earth, cada Función tiene una casilla de verificación que permite al usuario controlar la visibilidad de la Función.
<open>
Valor booleano. Especifica si un documento o una carpeta aparece cerrado o abierto cuando se carga por primera vez en el panel Lugares. 0=contraída (la opción predeterminada), 1=expandido. Consulta también <ListStyle>. Este elemento se aplica solo a Documentos, Carpetas y NetworkLinks.
<atom:author>

KML 2.2 admite nuevos elementos para incluir datos sobre el autor y el sitio web relacionado en tu archivo KML. Esta información se muestra en los resultados de búsquedas geográficas, tanto en navegadores de Google Earth como Google Earth, y en otras aplicaciones como Google Maps. Los elementos de descripción que se usan en KML son los siguientes:

  • atom:author elemento - elemento principal para atom:name
  • Elemento atom:name: el nombre del autor
  • Elemento atom:link: contiene el atributo href
  • Atributo href: la URL de la página web que contiene el archivo KML o KMZ

Estos elementos se definen en el formato de distribución de Atom. La especificación completa se encuentra en http://atompub.org. (consulta el ejemplo a continuación).

El elemento <atom:author> es el elemento principal de <atom:name>, el cual especifica el autor de la función KML.

<atom:link href="..." >
Especifica la URL del sitio web que contiene este archivo KML o KMZ. Asegúrate de incluir el espacio de nombres para este elemento en cualquier archivo KML que lo utilice: xmlns:atom="http://www.w3.org/2005/Atom" (consulta la muestra que aparece a continuación).
<address>
Es un valor de string que representa una dirección no estructurada escrita como una calle estándar, una ciudad, un estado o un código postal. Puedes usar la etiqueta <address> para especificar la ubicación de un punto en lugar de usar coordenadas de latitud y longitud. (Sin embargo, si se proporciona un <Point>, este tiene prioridad sobre la <address>). Para saber qué parámetros de configuración son compatibles con esta etiqueta en Google Earth, ve a la Ayuda de Google Maps.
<xal:AddressDetails>
Una dirección estructurada, con formato xAL, o lenguaje de dirección extensible, un estándar internacional para el formato de direcciones. KML usa solo <xal:AddressDetails> para la codificación geográfica en Google Maps. Para obtener información detallada, consulta la documentación de la API de Google Maps. Por el momento, Google Earth no utiliza este elemento. En su lugar, usa <address>. Asegúrate de incluir el espacio de nombres para este elemento en cualquier archivo KML que lo use: xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"
<phoneNumber>
Es un valor de string que representa un número de teléfono. Google Maps para dispositivos móviles solamente usa este elemento. El estándar de la industria para teléfonos celulares habilitados para Java es RFC2806.
Para obtener más información, consulta http://www.ietf.org/rfc /rfc2806.txt
<Snippet maxLines="2" >
Una descripción breve de la función. En Google Earth, esta descripción se muestra en el panel Lugares bajo el nombre de la característica. Si no se indica un fragmento, se utilizan las dos primeras líneas de <description>. En Google Earth, si una marca de posición contiene una descripción y un fragmento, el <Snippet> aparece debajo de la marca de posición en el panel Lugares, y la <description> aparece en la viñeta de descripción de la marca de posición. Esta etiqueta no admite el lenguaje de marcado HTML. <Snippet> tiene un atributo maxLines, un número entero que especifica la cantidad máxima de líneas que se muestran.
<description>

Contenido proporcionado por el usuario que aparece en la viñeta de descripción

El contenido admitido para el elemento <description> cambió de Google Earth 4.3 a 5.0. A continuación, se proporciona información específica de cada versión, seguida de información común para ambas.

Google Earth 5.0

Google Earth 5.0 (y las versiones posteriores) admite contenido de texto sin formato, al igual que HTML y JavaScript completos, en los globos descriptivos. El contenido del código de la etiqueta se dibuja mediante el motor de navegador web de código abierto de WebKit y se muestra como lo haría en cualquier navegador basado en WebKit.

Restricciones generales

Por lo general, no se permiten los vínculos a archivos locales. Esto evita que el código malicioso dañe tu sistema o acceda a tus datos. Si deseas permitir el acceso a tu sistema de archivos local, selecciona Preferencias > Permitir el acceso a archivos locales y datos personales. Se permiten siempre vínculos a archivos de imagen en el sistema de archivos local, si se encuentran dentro de una etiqueta <img>.

Se puede acceder al contenido que se comprimió en un archivo KMZ, incluso en el sistema de archivos local.

Las cookies están habilitadas, pero para los fines de la política del mismo origen, el contenido local no comparte el dominio con ningún otro contenido (incluido otro contenido local).

HTML

En su mayoría, HTML se procesa como lo haría en cualquier navegador WebKit.

Los destinos se ignoran cuando se incluyen en HTML escritos directamente en el KML; todos los vínculos de este tipo se abren como si el objetivo estuviera establecido en _blank. Se ignoran los objetivos especificados.

Sin embargo, el código HTML que se encuentre en un iframe, o que se genere dinámicamente con JavaScript o DHTML, usará target="_self" como opción predeterminada. Se pueden especificar otras orientaciones y se admiten.

El contenido de los archivos KMZ, los vínculos de anclaje local y los métodos ;flyto no se pueden orientar desde el código HTML dentro de un iFrame.

Si el usuario especifica width="100%" para el ancho de un iFrame, el ancho del iFrame dependerá del resto del contenido del globo. Básicamente, debe ignorarse al calcular el tamaño del diseño. Esta regla también se aplica a cualquier otro elemento de bloques dentro del globo.

JavaScript

Se admite la mayor parte de JavaScript. No se pueden crear cuadros de diálogo; no se mostrarán funciones como alert() y prompts(). Sin embargo, se escribirán en la consola del sistema, al igual que otros errores y excepciones.

CSS

Se admite CSS. Al igual que con los CSS en un navegador web normal, CSS se puede usar para darle estilo al texto y a los elementos de las páginas, y para controlar el tamaño y la apariencia del globo de descripción.

Google Earth 4.3

El elemento <description> admite texto sin formato, así como un subconjunto de elementos de formato HTML, incluidas las tablas (consulte el ejemplo de KML a continuación). No es compatible con otras tecnologías basadas en la Web, como el lenguaje de marcado de páginas dinámicas (PHP, JSP, ASP), los lenguajes de programación (VBScript, JavaScript) y los lenguajes de aplicación (Java, Python). En Google Earth versión 4.2, el video es compatible. (Consulta el ejemplo más abajo).

Información común

Si tu descripción no contiene lenguaje de marcado HTML, Google Earth intentará aplicarle formato, reemplaza las líneas nuevas por <br> y une las URL con etiquetas de anclaje. Una string de URL válida para Internet se convierte automáticamente en un hipervínculo a esa URL (p.ej., http://www.google.com). Por lo tanto, no es necesario encerrar una URL entre etiquetas <a href="http://.."></a> para obtener un vínculo simple.

Al usar HTML para crear un hipervínculo en torno a una palabra específica, o al incluir imágenes en el HTML, debes usar referencias de entidades HTML o el elemento CDATA para el escape de paréntesis angulares, apóstrofos y otros caracteres especiales. El elemento CDATA le indica al analizador de XML que ignore los caracteres especiales usados entre corchetes. Este elemento tiene la forma siguiente:

<![CDATA[
  special characters here
]]> 

Si prefieres no usar el elemento CDATA, puedes usar referencias de entidad para reemplazar todos los caracteres especiales.

<description>
  <![CDATA[
This is an image
<img src="icon.jpg">
  ]]>
</description>

Otro comportamiento especificado mediante el uso del elemento <a>

KML admite el uso de dos atributos dentro del elemento <a>: href y type.

El elemento fijo <a> contiene un atributo href que especifica una URL.

Si el archivo href es un archivo KML y tiene una extensión de archivo .kml o .kmz, Google Earth lo cargará directamente cuando el usuario haga clic en él. Si la URL termina con una extensión que Google Earth no conoce (por ejemplo, .html), se enviará al navegador.

La href puede ser una URL de fragmento (es decir, una URL con un signo # seguido de un identificador KML). Cuando el usuario hace clic en un vínculo que incluye la URL de un fragmento, el navegador vuela de manera predeterminada a la función cuyo ID coincide con el fragmento. Si el elemento tiene un elemento LookAt o Camera, este se verá desde el punto de vista especificado.

Para especificar aún más el comportamiento, agrega una de las siguientes tres strings a la URL del fragmento:

  • ;flyto (predeterminado): volar a la función
  • ;balloon: abrir el globo de la función, pero no volar a ella.
  • ;balloonFlyto: abrir el globo de la función y volar a ella

Por ejemplo, el siguiente código indica que se debe abrir el archivo CraftsFairs.kml, volar a la marca de posición cuyo ID sea "Albuquerque" y abrir el globo:

<description>
  <![CDATA[ 
<a href="http://myServer.com/CraftsFairs.kml#Albuquerque;balloonFlyto">
One of the Best Art Shows in the West</a> ]]> </description>

El atributo type se utiliza en el elemento <a> cuando href no termina en .kml o .kmz, pero la referencia debe interpretarse en el contexto de KML. Especifique lo siguiente:

type="application/vnd.google-earth.kml+xml" 

Por ejemplo, la siguiente URL utiliza el atributo type para notificar a Google Earth que debe intentar cargar el archivo, aunque la extensión de archivo sea .php:

<a href="myserver.com/cgi-bin/generate-kml.php#placemark123"
   type="application/vnd.google-earth.kml+xml">
<AbstractView>
Define un punto de vista asociado con cualquier elemento derivado de Feature. Consulta <Cámara> y <LookAt>.
<TimePrimitive>
Asocia esta función con un período (<TimeSpan>) o un momento determinado (<TimeStamp>).
<styleUrl>
URL de un <Style> o <StyleMap> definido en un Documento. Si el estilo está en el mismo archivo, usa una referencia #. Si el estilo está definido en un archivo externo, usa una URL completa junto con # referencia. Algunos ejemplos son
<styleUrl>#myIconStyleID</styleUrl>
<styleUrl>http://someserver.com/somestylefile.xml#restaurant</styleUrl>
<styleUrl>eateries.kml#my-lunch-spot</styleUrl>
<StyleSelector>
Se pueden definir uno o más estilos y estilos para personalizar la apariencia de cualquier elemento derivado de la función o de la geometría de una marca de posición. (Consulta <BalloonStyle>, <ListStyle>, <StyleSelector>, y los estilos derivados de <ColorStyle>). Un estilo definido en un elemento se denomina "estilo intercalado" y solo se aplica al elemento que lo contiene. Un estilo definido como secundario de un <Document> se denomina "estilo compartido". Un estilo compartido debe tener definido un id. Uno o más elementos hacen referencia a este id. en el elemento <Document>. En los casos en los que un elemento de estilo se define en un estilo compartido y en un estilo intercalado para un elemento (es decir, una carpeta, GroundOverlay, NetworkLink, Placemark o ScreenOverlay), el valor del estilo intercalado del elemento tiene prioridad sobre el valor del estilo compartido.
<Region>
Las características y la geometría asociadas con una región solo se dibujan cuando esta está activa. Consulta <Región>.
<Metadata>
<ExtendedData>
Te permite agregar datos personalizados a un archivo KML. Estos datos pueden ser (1) datos que hacen referencia a un esquema XML externo, (2) pares de datos o valores sin tipo o (3) datos escritos. Un elemento KML determinado puede contener una combinación de estos tipos de datos personalizados.

Ejemplo de uso de elementos HTML dentro de una descripción

En este ejemplo, se ilustra el conjunto completo de elementos HTML admitidos por el elemento <description> en Google Earth 4.3. Google Earth 5.0 y las versiones posteriores admiten HTML completo y JavaScript.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Placemark>
<name>Feature.kml</name> <Snippet maxLines="4">
The snippet is a way of
providing an alternative
description that will be
shown in the List view.
</Snippet>
<description>
<![CDATA[
Styles: <i>Italics</i>, <b>Bold</b>, <u>Underlined</u>,
<s>Strike Out</s>, subscript<sub>subscript</sub>,
superscript<sup>superscript</sup>,
<big>Big</big>, <small>Small</small>, <tt>Typewriter</tt>,
<em>Emphasized</em>, <strong>Strong</strong>, <code>Code</code>
<hr />
Fonts:
<font color="red">red by name</font>,
<font color="#408010">leaf green by hexadecimal RGB</font>,
<font size=1>size 1</font>, <font size=2>size 2</font>,
<font size=3>size 3</font>, <font size=4>size 4</font>,
<font size=5>size 5</font>, <font size=6>size 6</font>,
<font size=7>size 7</font>,
<font face=times>Times</font>,
<font face=verdana>Verdana</font>,
<font face=arial>Arial</font>
<br/>
<hr />
Links:
<a href="http://doc.trolltech.com/3.3/qstylesheet.html">
QT Rich Text Rendering
</a>
<br />
<hr />
Alignment:
<br />
<p align=left>left</p><p align=center>center</p>
<p align=right>right</p>
<hr />
Ordered Lists:
<br />
<ol><li>First</li><li>Second</li><li>Third</li></ol>
<ol type="a"><li>First</li><li>Second</li><li>Third</li></ol>
<ol type="A"><li>First</li><li>Second</li><li>Third</li></ol>
<hr />
Unordered Lists:
<br />
<ul><li>A</li><li>B</li><li>C</li></ul>
<ul type="circle"><li>A</li><li>B</li><li>C</li></ul>
<ul type="square"><li>A</li><li>B</li><li>C</li></ul>
<hr />
Definitions:
<br />
<dl>
<dt>Scrumpy</dt>
<dd>Hard English cider from the west country</dd>
<dt>Pentanque</dt>
<dd>A form of boules where the goal is to throw metal ball as
close as possible to a jack</dd>
</dl>
<hr />
Block Quote:
<br />
<blockquote>
We shall not cease from exploration<br />
And the end of all our exploring<br />
Will be to arrive where we started<br />
And know the place for the first time
</blockquote>
<br />
<hr />
Centered:
<br />
<center>See, I have a Rhyme assisting<br />
my feeble brain,<br />
its tasks oft-times resisting!</center>
<hr />
Headings:
<br />
<h1>Header 1</h1>
<h2>Header 2</h2>
<h3>Header 3</h3>
<h3>Header 4</h4>
<h3>Header 5</h5>
<hr />
Images:
<br />
<img src="icon.jpg">
and we have a link http://www.google.com.]]> </description> <Point>
<coordinates>-122.378927,37.826793,0</coordinates>
</Point>
</Placemark>
</kml>

Ejemplo de uso de los elementos de inscripción

En este ejemplo, se muestra el uso de los elementos <atom:author>, <atom:name> y <atom:link> del espacio de nombres Atom. Ten en cuenta que debes hacer referencia a este espacio de nombres en el elemento <kml>.

<kml xmlns="http://www.opengis.net/kml/2.2"
     xmlns:atom="http://www.w3.org/2005/Atom"> 
  <Document>
    <atom:author>
      <atom:name>J. K. Rowling</atom:name>
    </atom:author>
    <atom:link href="http://www.harrypotter.com" />
    <Placemark>
      <name>Hogwarts</name>
      <Point>
        <coordinates>1,1</coordinates>
      </Point>
    </Placemark>
    <Placemark>
      <name>Little Hangleton</name>
      <Point>
        <coordinates>1,2</coordinates>
      </Point>
    </Placemark>
  </Document>
</kml>

Video de muestra

En este ejemplo, se muestra cómo incorporar un video Flash en el globo.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document> <name>Video Example</name>
<Style id="sn_blue-dot_copy3">
<IconStyle>
<Icon>
<href>http://www.google.com/intl/en_us/mapfiles/ms/icons/blue-dot.png</href>
</Icon>
</IconStyle>
</Style>
<Placemark>
<name>Placemark</name>
<description>
<![CDATA[<div style="font-size:larger">
<div>
<div style="width: 212px; font-size: 12px;">
<b>The Spaghetti Film</b>
</div>
<div style="font-size: 11px;">
<a target="_blank" href="http://www.youtube.com/?v=FICUvrVlyXc">
http://www.youtube.com/?v=FICUvrVlyXc</a><br>
</div><br>
<div style="margin-left: auto; margin-right:auto;">
<object height="175" width="212">
<param value="http://www.youtube.com/v/FICUvrVlyXc" name="movie">
<param value="transparent" name="wmode">
<embed wmode="transparent" type="application/x-shockwave-flash"
src="http://www.youtube.com/v/FICUvrVlyXc" height="175"
width="212">

</object>
</div>
</div>
</div>
<div style="font-size: smaller; margin-top: 1em;">Saved from
<a href="http://maps.google.com/ig/add?synd=mpl&pid=mpl&moduleurl=
http:%2F%2Fwww.google.com%2Fig%2Fmodules%2Fmapplets-youtube.xml&hl=en&gl=us">
YouTubeVideos</a>
</div>
]]>
</description>
<styleUrl>#sn_blue-dot_copy3</styleUrl>
<Point>
<coordinates>-93.47875999999999,45.083248,0</coordinates>
</Point>
</Placemark>
</Document> </kml>

Extiende

Extendido por

<gx:FlyTo>

Este elemento es una extensión del estándar KML 2.2 de OGC y es compatible con Google Earth 5.0 y versiones posteriores. Más información

Sintaxis

<gx:FlyTo id="ID">
  <gx:duration>0.0</gx:duration>         <!-- double -->
  <gx:flyToMode>bounce</gx:flyToMode>    <!-- smooth or bounce -->
  <!-- AbstractView -->                        <!-- Camera or LookAt -->
    ...
  <!-- /AbstractView -->
</gx:FlyTo>

Descripción

<gx:FlyTo> especifica un punto en el espacio al que volará el navegador durante un viaje. Debe contener un AbstractView y debe contener los elementos <gx:duration> y <gx:flyToMode>, que especifican el tiempo que lleva volar hasta el punto definido desde el punto actual y el método de vuelo, respectivamente.

<gx:flyToMode>

Hay dos valores permitidos para <gx:flyToMode>: smooth y bounce.

  • FlyTos Smooth permite un vuelo ininterrumpido de un punto a otro. Una serie de FlyTos fluidas que no se han interrumpido comenzará y terminará a una velocidad cero y no disminuirá su velocidad en cada punto. Una serie de FlyTos se rompe por cualquiera de los siguientes elementos:
    • <gx:flyToMode>bounce</gx:flyToMode>
    • <gx:Wait>
    Esto significa que la velocidad será cero en FlyTo inmediatamente antes de cualquiera de los elementos anteriores. Una serie de FlyTos fluidas no se rompe con los elementos <gx:AnimatedUpdate>.

  • Bounce: Los FlyTo comienzan y terminan a una velocidad cero.

Ejemplo

<gx:FlyTo>
<gx:duration>2.55</gx:duration>
<gx:flyToMode>smooth</gx:flyToMode>
<Camera>
<longitude>-113.084448</longitude>
<latitude>36.567081</latitude>
<altitude>41277.571403</altitude>
<heading>116.150227</heading>
<altitudeMode>absolute</altitudeMode>
</Camera>
</gx:FlyTo>

Extiende

Contenido

<Folder>

Sintaxis

<Folder id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- specific to Folder --> <!-- 0 or more Feature elements --> </Folder>

Descripción

Una carpeta se usa para organizar otras funciones de manera jerárquica (carpetas, marcas de posición, NetworkLinks o superposiciones). Un elemento es visible solo si este y todos sus elementos principales son visibles.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Folder>
<name>Folder.kml</name> <open>1</open>
<description>
A folder is a container that can hold multiple other objects
</description>
<Placemark>
<name>Folder object 1 (Placemark)</name>
<Point>
<coordinates>-122.377588,37.830266,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>Folder object 2 (Polygon)</name>
<Polygon>
<outerBoundaryIs>
<LinearRing>
<coordinates>
-122.377830,37.830445,0
-122.377576,37.830631,0
-122.377840,37.830642,0
-122.377830,37.830445,0
</coordinates>
</LinearRing>
</outerBoundaryIs>
</Polygon>
</Placemark>
<Placemark>
<name>Folder object 3 (Path)</name>
<LineString>
<tessellate>1</tessellate>
<coordinates>
-122.378009,37.830128,0 -122.377885,37.830379,0
</coordinates>
</LineString>
</Placemark>
</Folder>
</kml>

Extiende

Contenido

<Geometría>

Sintaxis

<!-- abstract element; do not create -->
<!-- Geometry id="ID" -->
                                              <!-- Point,LineString,LinearRing,
                                               Polygon,MultiGeometry,Model,
                                               gx:Track -->
<!-- /Geometry -->

Descripción

Este es un elemento abstracto y no se puede utilizar directamente en un archivo KML. Proporciona un objeto de marcador de posición para todos los objetos de geometría derivados.

Extiende

Extendido por

<GroundOverlay>

Sintaxis

<GroundOverlay id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 --> <!-- inherited from Overlay element --> <color>ffffffff</color> <!-- kml:color --> <drawOrder>0</drawOrder> <!-- int --> <Icon>...</Icon> <!-- specific to GroundOverlay --> <altitude>0</altitude> <!-- double --> <altitudeMode>clampToGround</altitudeMode> <!-- kml:altitudeModeEnum: clampToGround or absolute --> <!-- or, substitute gx:altitudeMode: clampToSeaFloor or relativeToSeaFloor --> <LatLonBox> <north>...</north> <! kml:angle90 --> <south>...</south> <! kml:angle90 --> <east>...</east> <! kml:angle180 --> <west>...</west> <! kml:angle180 --> <rotation>0</rotation> <! kml:angle180 --> </LatLonBox> <gx:LatLonQuad> <coordinates>...</coordinates> <!-- four lon,lat tuples --> </gx:LatLonQuad> </GroundOverlay>

Descripción

Este elemento dibuja una superposición de imágenes dibujada en el terreno. El elemento secundario <href> de <Icon> especifica la imagen que se utilizará como superposición. Este archivo puede estar en un sistema de archivos local o en un servidor web. Si se omite este elemento o no contiene <href>, se dibujará un rectángulo con el color y los límites LatLonBox definidos por la superposición de suelo.

Elementos específicos de GroundOverlay

<altitude>
: Especifica la distancia en metros sobre la superficie de la Tierra y se interpreta de acuerdo con el modo de altitud.
<altitudeMode>
: Especifica cómo se interpreta la <altitude>. Los valores posibles son los siguientes:
  • clampToGround: (valor predeterminado) Indica que se debe ignorar la especificación de altitud y agregar la superposición sobre el terreno.
  • absolute: Establece la altitud de la superposición respecto del nivel del mar, independientemente de la elevación real del relieve bajo el elemento. Por ejemplo, si estableces la altitud de una superposición en 10 metros con el modo de altitud absoluta, la superposición aparecerá a nivel del suelo si el relieve inferior también se encuentra a 10 metros sobre el nivel del mar. Si el relieve se encuentra a 3 metros sobre el nivel del mar, la superposición se mostrará en una altura de 7 metros.
<gx:altitudeMode>
Es una extensión KML en el espacio de nombres de extensiones de Google, que permite altitudes relativas al lecho marino. Los valores son los siguientes:
  • relativeToSeaFloor: Interpreta la <altitude> como un valor en metros sobre el lecho marino. Si el punto se encuentra sobre el suelo en lugar de en el mar, se interpretará que la <altitude> está sobre el suelo.
  • clampToSeaFloor: Se ignora la especificación <altitude> y la superposición se arrastra sobre el lecho marino. Si el punto está en tierra en vez de en el mar, la superposición se posicionará en el suelo.
<LatLonBox>
Especifica dónde están alineados los lados superior, inferior, derecho e izquierdo de un cuadro de límite para la superposición de suelo.
  • <north> Especifica la latitud del borde norte del cuadro de límite, en grados decimales, de 0 a ±90.
  • <south> : Especifica la latitud del borde sur del cuadro de límite, en grados decimales, de 0 a ±90.
  • <east> Especifica la longitud del borde este del cuadro de límite, en grados decimales, de 0 a ±180. (Para las superposiciones que se superponen con el meridiano de 180°, los valores pueden extenderse más allá de ese rango).
  • <west> Especifica la longitud del borde oeste del cuadro de límite, en grados decimales, de 0 a ±180. (Para las superposiciones que se superponen con el meridiano de 180°, los valores pueden extenderse más allá de ese rango).
  • <rotation>: especifica una rotación en grados de la superposición sobre su centro. Los valores pueden ser de ±180. El valor predeterminado es 0 (norte). Las rotaciones se especifican en la dirección en sentido antihorario.
<LatLonBox>
   <north>48.25475939255556</north>
   <south>48.25207367852141</south>
   <east>-90.86591508839973</east>
   <west>-90.8714285289695</west>
   <rotation>39.37878630116985</rotation>
</LatLonBox> 
<gx:LatLonQuad>
Se usa para superposiciones de suelo cuadrilátero no rectangular.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<GroundOverlay>
<name>GroundOverlay.kml</name>
<color>7fffffff</color>
<drawOrder>1</drawOrder>
<Icon>
<href>http://www.google.com/intl/en/images/logo.gif</href>
<refreshMode>onInterval</refreshMode>
<refreshInterval>86400</refreshInterval>
<viewBoundScale>0.75</viewBoundScale>
</Icon>
<LatLonBox>
<north>37.83234</north>
<south>37.832122</south>
<east>-122.373033</east>
<west>-122.373724</west>
<rotation>45</rotation>
</LatLonBox>
</GroundOverlay>
</kml>

Extiende

Contenida por

<Icon>

Sintaxis

<Icon id="ID">
  <!-- specific to Icon -->
  <href>...</href>                         <!-- anyURI -->
  <gx:x>0<gx:x/>                           <!-- int -->
  <gx:y>0<gx:y/>                           <!-- int -->
  <gx:w>-1<gx:w/>                          <!-- int -->
  <gx:h>-1<gx:h/>                          <!-- int -->
  <refreshMode>onChange</refreshMode>
    <!-- kml:refreshModeEnum: onChange, onInterval, or onExpire -->
  <refreshInterval>4</refreshInterval>     <!-- float -->
  <viewRefreshMode>never</viewRefreshMode>
    <!-- kml:viewRefreshModeEnum: never, onStop, onRequest, onRegion -->
  <viewRefreshTime>4</viewRefreshTime>     <!-- float -->
  <viewBoundScale>1</viewBoundScale>       <!-- float -->
  <viewFormat>...</viewFormat>             <!-- string -->
  <httpQuery>...</httpQuery>               <!-- string -->
</Icon>

Descripción

Define una imagen asociada con un estilo de ícono o una superposición. El elemento secundario <href> requerido define la ubicación de la imagen que se usará como superposición o como ícono del marcador. Esta ubicación puede estar en un sistema de archivos local o en un servidor web remoto. Los elementos <gx:x>, <gx:y>, <gx:w> y <gx:h> se usan para seleccionar un ícono de una imagen que contenga varios íconos (a menudo llamados paleta de íconos).

<Icon>
  <href>Sunset.jpg</href>   <!-- Here, the image contains only one icon -->
</Icon>
<Icon>
  <href>/home/mydir/myiconpalette.jpg</href>
  <gx:w>138</gx:w>
  <gx:h>138</gx:h>
    <!-- Since x and y values are omitted, these measurements are made starting at
    the lower-left corner of the icon palette image -->
</Icon>

Elementos específicos del ícono

<href>
Una dirección HTTP o una especificación de archivo local que se usa para cargar un ícono.
<gx:x>
y
<gx:y>
Si el elemento <href> especifica una paleta de íconos, estos elementos identifican los desplazamientos (en píxeles) desde la esquina inferior izquierda de la paleta de íconos.Si no se especifican valores para x e y, se supone que la esquina inferior izquierda de la paleta de íconos es la esquina inferior izquierda del ícono.
<gx:a>
y
<gx:h>
Si el elemento <href> especifica una paleta de íconos, estos elementos especifican el ancho (<gx:w>) y la altura (<gx:h>), en píxeles, del ícono que se usará.
<refreshMode>
Para obtener una descripción de <refreshMode> y los demás elementos que se indican a continuación, consulta <Link>.
<refreshInterval>
<viewRefreshMode>
<viewRefreshTime>
<viewBoundScale>
<viewFormat>
<httpQuery>

Contenida por

<IconStyle>

Sintaxis

<IconStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum:normal or random -->

  <!-- specific to IconStyle -->
  <scale>1</scale>                   <!-- float -->
  <heading>0</heading>               <!-- float -->
  <Icon>
    <href>...</href>
  </Icon>
  <hotSpot x="0.5"  y="0.5"
    xunits="fraction" yunits="fraction"/>    <!-- kml:vec2 -->
</IconStyle>

Descripción

Especifica cómo se dibujan los iconos de los marcadores de puntos, tanto en el panel Lugares como en el visor 3D de Google Earth. El elemento <Icon> especifica la imagen del ícono. El elemento <scale> especifica el ajuste x, y del ícono. El color especificado en el elemento <color> de <IconStyle> se combina con el color de <Icon>.

Elementos específicos de IconStyle

<scale>
Cambia el tamaño del ícono.

Nota: La etiqueta <geomScale> dejó de estar disponible. En su lugar, use <scale>.

<heading>
Dirección (es decir, el norte, sur, este, oeste), en grados. Predeterminado=0 (Norte). (Consulta el diagrama). Los valores varían de 0 a 360 grados.
<Icon>
Un ícono personalizado. En <IconStyle>, el único elemento secundario de <Icon> es <href>:
  • <href>: una dirección HTTP o una especificación de archivo local que se usa para cargar un ícono.
<hotSpot x="0,5" y="0,5" xunits="fraction" yunits="fraction">
Especifica la posición en el ícono que está "anclada" en el <Punto> especificado en el marcador. Los valores x e y se pueden especificar de tres formas diferentes: como píxeles ("pixels"), como fracciones del ícono ("fraction") o como píxeles incorporados ("insetPixels"), que es un desplazamiento en píxeles desde la esquina superior derecha del ícono. Las posiciones x e y pueden especificarse de distintas maneras; por ejemplo, x puede estar en píxeles y y puede ser una fracción. El origen del sistema de coordenadas se encuentra en la esquina inferior izquierda del ícono.
  • x: La cantidad de píxeles, un componente fraccionario del ícono o una inserción de píxeles que indica el componente x de un punto en el ícono.
  • y: La cantidad de píxeles, un componente fraccionario del ícono o una inserción de píxeles que indica el componente y de un punto en el ícono.
  • xunits: Unidades en las que se especifica el valor x. Un valor de fracción indica que el valor x es una fracción del ícono. Un valor de pixels indica el valor x en píxeles. Un valor de insetPixels indica la sangría desde el borde derecho del ícono.
  • yunidades: Unidades en las que se especifica el valor y. Un valor de fracción indica que el valor y es una fracción del ícono. Un valor de pixels indica el valor y en píxeles. Un valor de insetPixels indica la sangría desde el borde superior del ícono.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<Style id="randomColorIcon">
<IconStyle>
<color>ff00ff00</color>
<colorMode>random</colorMode>
<scale>1.1</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/pal3/icon21.png</href>
</Icon>
</IconStyle>
</Style>
<Placemark>
<name>IconStyle.kml</name>
<styleUrl>#randomColorIcon</styleUrl>
<Point>
<coordinates>-122.36868,37.831145,0</coordinates>
</Point>
</Placemark>
</Document>
</kml>

Extiende

Contenida por

Contenido

<kml>

Sintaxis

<kml xmlns="http://www.opengis.net/kml/2.2" hint="target=sky"> ... </kml>

Descripción

Es el elemento raíz de un archivo KML. Se requiere este elemento. Sigue la declaración de XML al comienzo del archivo. El atributo hint se utiliza como señal para que Google Earth muestre el archivo como datos celestes.

El elemento <kml> también puede incluir el espacio de nombres de cualquier esquema XML externo al que se haga referencia dentro del archivo.

Un elemento <kml> básico contiene 0 o 1 Feature y 0 o 1 NetworkLinkControl:

<kml xmlns="http://www.opengis.net/kml/2.2">
  <NetworkLinkControl> ... </NetworkLinkControl>
  <!-- 0 or 1 Feature elements -->
</kml>

<LabelStyle>

Sintaxis

<LabelStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->

  <!-- specific to LabelStyle -->
  <scale>1</scale>                   <!-- float -->
</LabelStyle>

Descripción

Especifica cómo se dibuja el <name> de un elemento en el visor 3D. Se pueden especificar un color personalizado, un modo de color y una escala para la etiqueta (nombre).

Nota: La etiqueta <labelColor> dejó de estar disponible. En su lugar, use <LabelStyle>.

Específico para <LabelStyle>

<scale>
Cambia el tamaño de la etiqueta.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<Style id="randomLabelColor">
<LabelStyle>
<color>ff0000cc</color>
<colorMode>random</colorMode>
<scale>1.5</scale>
</LabelStyle>
</Style>
<Placemark>
<name>LabelStyle.kml</name>
<styleUrl>#randomLabelColor</styleUrl>
<Point>
<coordinates>-122.367375,37.829192,0</coordinates>
</Point>
</Placemark>
</Document>
</kml>

Extiende

Contenida por

<gx:LatLonQuad>

Este elemento es una extensión del estándar KML 2.2 de OGC y es compatible con Google Earth 5.0 y versiones posteriores. Más información

Sintaxis

<GroundOverlay id="ID">
  ...
  <Icon>...</Icon>
  <altitude>0</altitude>
  <altitudeMode>clampToGround</altitudeMode>                   <!-- or absolute -->
         <!-- can substitute <gx:altitudeMode>clampToSeaFloor</gx:altitudeMode> -->

  <gx:LatLonQuad>
    <coordinates>...</coordinates>              <!-- four lon,lat tuples -->
  </gx:LatLonQuad>
</GroundOverlay>

Descripción

Permite superposiciones de suelo cuadrilátero no rectangular.

Especifica las coordenadas de los cuatro puntos de las esquinas de un cuadrilátero que definen el área superpuesta. Se deben proporcionar exactamente cuatro tuplas de coordenadas, cada una de las cuales consta de valores de punto flotante para la longitud y la latitud. Inserta un espacio entre las tuplas. No incluyas espacios dentro de una tupla. Las coordenadas deben especificarse en sentido antihorario con la primera coordenada correspondiente a la esquina inferior izquierda de la imagen superpuesta. La forma descrita en estas esquinas debe ser convexa.

Si se inserta un tercer valor en una tupla (que representa la altitud), se ignorará. La altitud se establece mediante <altitude> y <altitudeMode> (o <gx:altitudeMode>) que extienden <GroundOverlay>. Los modos de altitud permitidos son absolute, clampToGround y clampToSeaFloor.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2" xmlns:gx="http://www.google.com/kml/ext/2.2"> <GroundOverlay> <name>gx:LatLonQuad Example</name> <Icon> <href>http://developers.google.com/kml/documentation/images/rectangle.gif</href> <viewBoundScale>0.75</viewBoundScale> </Icon> <gx:LatLonQuad> <coordinates> 81.601884,44.160723 83.529902,43.665148 82.947737,44.248831 81.509322,44.321015 </coordinates> </gx:LatLonQuad> </GroundOverlay> </kml>

Extiende

Contenida por

<LinearRing>

Sintaxis

<LinearRing id="ID">
  <!-- specific to LinearRing -->
  <gx:altitudeOffset>0</gx:altitudeOffset>   <!-- double -->
  <extrude>0</extrude>                       <!-- boolean -->
  <tessellate>0</tessellate>                 <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
    <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
    <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <coordinates>...</coordinates>             <!-- lon,lat[,alt] tuples -->
</LinearRing>

Descripción

Define una string de línea cerrada, generalmente el límite exterior de un polígono. Opcionalmente, también se puede usar un objeto LinearRing como límite interno de un polígono para crear agujeros en el polígono. Un polígono puede contener varios elementos <LinearRing> que se usan como límites internos.

Nota: En Google Earth, un polígono con un <altitudeMode> de clampToGround sigue líneas de rumbo constante. Sin embargo, un LinearRing (por sí solo) con un <altitudeMode> de clampToGround sigue excelentes líneas de círculo.

Elementos específicos de LinearRing

<gx:altitudeOffset>
Es una extensión KML, en el espacio de nombres de extensiones de Google, que modifica cómo se representan los valores de altitud. Este desplazamiento le permite mover un LinearRing completo hacia arriba o hacia abajo como una unidad sin modificar todos los valores de coordenadas individuales que conforman el LinearRing. (Aunque el LinearRing se muestra con el valor de desplazamiento de altitud, los valores de altitud originales se conservan en el archivo KML). Las unidades están en metros.
<extrude>
Valor booleano. Especifica si se debe conectar el LinearRing al suelo. Para extruir esta geometría, el modo de altitud debe ser relativeToGround, relativeToSeaFloor o absoluta. Solo se sobresalen los vértices del LinearRing, no el centro de la geometría. Los vértices se extruyen hacia el centro de la esfera de la Tierra.
<tessellate>
Valor booleano. Especifica si se debe permitir que el LinearRing siga el relieve. Para habilitar la teselación, el valor de <altitudeMode> debe ser clampToGround o clampToSeaFloor. Los LinearRings muy grandes deberían habilitar la teselación para que sigan la curvatura de la Tierra (de lo contrario, podrían quedar ocultas y estar ocultas).
<altitudeMode>
Especifica cómo se interpretan los componentes de altitudes en el elemento <coordinates>. Los valores posibles son los siguientes:
  • clampToGround - (predeterminado) indica que debe ignorar una especificación de altitud (por ejemplo, en la etiqueta <coordinates>).
  • relativeToGround: Establece la altitud del elemento en relación con la elevación real del suelo de una ubicación específica. Por ejemplo, si la elevación del piso de una ubicación es exactamente a nivel del mar y la altitud de un punto se establece en 9 metros, la elevación para el ícono de la elevación de la marca de un punto será de 9 metros con este modo. Sin embargo, si la misma coordenada se establece en una ubicación en la que la elevación del suelo es de 10 metros sobre el nivel del mar, la elevación es de 19 metros. Un uso típico de este modo es colocar postes telefónicos o una telesilla.
  • absolute: Establece la altitud de la coordenada en relación con el nivel del mar, independientemente de la elevación real del terreno debajo del elemento. Por ejemplo, si defines una altitud de 10 metros con un modo de altitud absoluta, el ícono de marcador de posición aparecerá al nivel del suelo si el relieve inferior también se encuentra a 10 metros sobre el nivel del mar. Si el relieve se encuentra a 3 metros sobre el nivel del mar, el marcador aparecerá elevado por encima de 7 metros sobre el relieve. Un modo de uso típico de este modo es la ubicación de aviones.
<gx:altitudeMode>
Es una extensión KML en el espacio de nombres de extensiones de Google, que permite altitudes relativas al lecho marino. Los valores son los siguientes:
  • relativeToSeaFloor: Interpreta la <altitude> como un valor en metros sobre el lecho marino. Si el punto se encuentra sobre el suelo en lugar de en el mar, se interpretará que la <altitude> está sobre el suelo.
  • clampToSeaFloor: Se ignora la especificación <altitude> y el punto se posicionará en el lecho marino. Si el punto está en tierra en lugar de en el mar, el punto se posicionará en el suelo.
<coordinates>(obligatorio)
Cuatro o más tuplas, cada una de las cuales consta de valores de punto flotante para longitud, latitud y altitud. El componente altitude es opcional. No incluyas espacios dentro de una tupla. La última coordenada debe ser la misma que la primera. Las coordenadas se expresan solo en grados decimales.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Placemark>
<name>LinearRing.kml</name>
<Polygon>
<outerBoundaryIs>
<LinearRing>
<coordinates> -122.365662,37.826988,0 -122.365202,37.826302,0 -122.364581,37.82655,0 -122.365038,37.827237,0 -122.365662,37.826988,0 </coordinates>
</LinearRing>
</outerBoundaryIs>
</Polygon>
</Placemark>
</kml>

Extiende

Contenida por

<LineString>

Sintaxis

<LineString id="ID">
  <!-- specific to LineString -->
  <gx:altitudeOffset>0</gx:altitudeOffset>  <!-- double -->
  <extrude>0</extrude>                      <!-- boolean -->
  <tessellate>0</tessellate>                <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
      <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
      <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <gx:drawOrder>0</gx:drawOrder>            <!-- integer -->
  <coordinates>...</coordinates>            <!-- lon,lat[,alt] -->
</LineString>

Descripción

Define un conjunto conectado de segmentos de líneas. Usa <LineStyle> para especificar el color, el modo de color y el ancho de la línea. Cuando se extruye una LineString, la línea se extiende al suelo y forma un polígono que se parece a una pared o una cerca. Para LineStrings extruidos, la línea en sí utiliza el LineStyle actual, y la extrusión utiliza el PolyStyle actual. Consulta el instructivo en formato KML para ver ejemplos de LineStrings (o paths).

Elementos específicos de LineString

<gx:altitudeOffset>
Es una extensión KML, en el espacio de nombres de extensiones de Google, que modifica cómo se representan los valores de altitud. Este desplazamiento te permite mover una LineString completa hacia arriba o hacia abajo como una unidad sin modificar todos los valores de coordenadas individuales que conforman LineString. (Aunque LineString se muestra con el valor de desplazamiento de altitud, los valores de altitud originales se conservan en el archivo KML). Las unidades están en metros.
<extrude>
Valor booleano. Especifica si se debe conectar la LineString al suelo. Para extruir una LineString, el modo de altitud debe ser relativeToGround, relativeToSeaFloor o absoluta. Los vértices del LineString se alzan hacia el centro de la esfera de la Tierra.
<tessellate>
Valor booleano. Especifica si se debe permitir que LineString siga el relieve. Para habilitar la teselación, el modo de altitud debe ser clampToGround o clampToSeaFloor. LineStrings muy grandes debe permitir la teselación para que sigan la curvatura de la tierra (de lo contrario, pueden quedar ocultas y ocultas).
<altitudeMode>
Especifica cómo se interpretan los componentes de altitudes en el elemento <coordinates>. Los valores posibles son los siguientes:
  • clampToGround (predeterminado) indica que debe ignorar una especificación de altitud (por ejemplo, en la etiqueta <coordinates>).
  • relativeToGround: Establece la altitud del elemento en relación con la elevación real del suelo de una ubicación específica. Por ejemplo, si la elevación del piso de una ubicación es exactamente a nivel del mar y la altitud de un punto se establece en 9 metros, la elevación para el ícono de la elevación de la marca de un punto será de 9 metros con este modo. Sin embargo, si la misma coordenada se establece en una ubicación en la que la elevación del suelo es de 10 metros sobre el nivel del mar, la elevación es de 19 metros. Un uso típico de este modo es colocar postes telefónicos o una telesilla.
  • absolute: Establece la altitud de la coordenada en relación con el nivel del mar, independientemente de la elevación real del terreno debajo del elemento. Por ejemplo, si defines una altitud de 10 metros con un modo de altitud absoluta, el ícono de marcador de posición aparecerá al nivel del suelo si el relieve inferior también se encuentra a 10 metros sobre el nivel del mar. Si el relieve se encuentra a 3 metros sobre el nivel del mar, el marcador aparecerá elevado por encima de 7 metros sobre el relieve. Un modo de uso típico de este modo es la ubicación de aviones.
<gx:altitudeMode>
Es una extensión KML, en el espacio de nombres de extensiones de Google, que permite altitudes relativas al lecho marino. Los valores son los siguientes:
  • relativeToSeaFloor: Interpreta la <altitude> como un valor en metros sobre el lecho marino. Si el punto se encuentra sobre el suelo en lugar de en el mar, se interpretará que la <altitude> está sobre el suelo.
  • clampToSeaFloor: Se ignora la especificación <altitude> y el punto se posicionará en el lecho marino. Si el punto está en tierra en lugar de en el mar, el punto se posicionará en el suelo.
<gx:drawOrder>
Es un valor entero que especifica el orden en el que se dibujan varias strings de línea. LineStrings puede ocultar primero o parcialmente las LineStrings dibujadas primero con un orden de dibujo posterior. Es posible que se requiera este elemento junto con los elementos <gx:outerColor> y <gx:outerWidth> en <LineStyle> cuando se cruzan líneas de dos colores entre sí.
<coordinates>(obligatorio)
Dos o más coordenadas de coordenadas, cada una de las cuales consta de valores de punto flotante para longitud, latitud y altitud. El componente altitude es opcional. Inserta un espacio entre las tuplas. No incluyas espacios dentro de una tupla.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>LineString.kml</name>
<open>1</open>
<LookAt>
<longitude>-122.36415</longitude>
<latitude>37.824553</latitude>
<altitude>0</altitude>
<range>150</range>
<tilt>50</tilt>
<heading>0</heading>
</LookAt>
<Placemark>
<name>unextruded</name>
<LineString>
<extrude>1</extrude>
<tessellate>1</tessellate>
<coordinates>
-122.364383,37.824664,0 -122.364152,37.824322,0 </coordinates>
</LineString>
</Placemark>
<Placemark>
<name>extruded</name>
<LineString>
<extrude>1</extrude>
<tessellate>1</tessellate>
<altitudeMode>relativeToGround</altitudeMode>
<coordinates>
-122.364167,37.824787,50 -122.363917,37.824423,50 </coordinates>
</LineString>
</Placemark>
</Document>
</kml>

Extiende

Contenida por

<LineStyle>

Sintaxis

<LineStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- colorModeEnum: normal or random -->

  <!-- specific to LineStyle -->
  <width>1</width>                            <!-- float -->
  <gx:outerColor>ffffffff</gx:outerColor>     <!-- kml:color -->
  <gx:outerWidth>0.0</gx:outerWidth>          <!-- float -->
  <gx:physicalWidth>0.0</gx:physicalWidth>    <!-- float -->
  <gx:labelVisibility>0</gx:labelVisibility>  <!-- boolean -->
</LineStyle>

Descripción

Especifica el estilo de dibujo (color, modo de color y ancho de línea) para toda la geometría de la línea. La geometría de líneas incluye los contornos de los polígonos delineados y la "fijación" extruida de íconos de marcador (si la extrusión está habilitada).

Elementos específicos de LineStyle

<width>
Ancho de la línea, en píxeles.
<gx:outerColor>
El color de la parte de la línea que define <gx:outerWidth>. Ten en cuenta que los elementos <gx:outerColor> y <gx:outerWidth> se ignoran cuando se aplica <LineStyle> a <Polygon> y <LinearRing>.
<gx:outerWidth>
Un valor entre 0.0 y 1.0 que especifica la proporción de la línea que usa <gx:outerColor>. Solo se aplica al ancho de la configuración de líneas con <gx:physicalWidth>; no se aplica a las líneas que usan <width>. Consulta también <gx:drawOrder> en <LineString>. Es posible que sea necesario un valor de orden de dibujo si las líneas de dos colores se cruzan entre sí; por ejemplo, para mostrar intercambios de autopistas.
<gx:physicalWidth>
Ancho físico de la línea, en metros.
<gx:labelVisibility>
Valor booleano que define si se muestra o no una etiqueta de texto en un LineString. La etiqueta de LineString está incluida en el elemento <name>, que es secundario de <LineString> (es decir, dentro del mismo elemento <Placemark>).

Google Earth 6.1 y las versiones posteriores no muestran las etiquetas de forma predeterminada; deben habilitarse para cada LineString si estableces <gx:labelVisibility> en 1.

Problema conocido de Google Earth 6.1: las LineString sin un elemento <gx:physicalWidth> solo mostrarán la etiqueta si la longitud de la línea es mayor a 100 m * la cantidad de caracteres en la etiqueta. Por ejemplo, una etiqueta con siete caracteres (“ejemplo”) solo se mostrará si la línea supera los 700 m. Esto no afecta a LineStrings con un valor <gx:physicalWidth>.

Ejemplo

En el siguiente ejemplo, se muestra una línea roja opaca al 50% con un ancho de 4 píxeles.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
  <name>LineStyle.kml</name>
  <open>1</open>
  <Style id="linestyleExample">
    <LineStyle>
      <color>7f0000ff</color>
      <width>4</width>
      <gx:labelVisibility>1</gx:labelVisibility>
    </LineStyle>
  </Style>
  <Placemark>
    <name>LineStyle Example</name>
    <styleUrl>#linestyleExample</styleUrl>
    <LineString>
      <extrude>1</extrude>
      <tessellate>1</tessellate>
      <coordinates>
        -122.364383,37.824664,0 -122.364152,37.824322,0
      </coordinates>
    </LineString>
  </Placemark>
</Document>
</kml>

Extiende

Contenida por

Sintaxis

<Link id="ID">
  <!-- specific to Link -->
  <href>...</href>                      <!-- string -->
  <refreshMode>onChange</refreshMode>
    <!-- refreshModeEnum: onChange, onInterval, or onExpire -->
  <refreshInterval>4</refreshInterval>  <!-- float -->
  <viewRefreshMode>never</viewRefreshMode>
    <!-- viewRefreshModeEnum: never, onStop, onRequest, onRegion -->
  <viewRefreshTime>4</viewRefreshTime>  <!-- float -->
  <viewBoundScale>1</viewBoundScale>    <!-- float -->
  <viewFormat>BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth]</viewFormat>
                                        <!-- string -->
  <httpQuery>...</httpQuery>            <!-- string -->
</Link>

Descripción

<Link> especifica la ubicación de cualquiera de los siguientes elementos:

  • Archivos KML recuperados por vínculos de red
  • Archivos de imagen que se usan en cualquier superposición (el elemento <Icon> especifica la imagen en una superposición; <Icon> tiene los mismos campos que <Link>).
  • Archivos del modelo que se usan en el elemento <Model>

El archivo se carga y actualiza condicionalmente, según los parámetros de actualización que se proporcionan aquí. Se pueden especificar dos conjuntos diferentes de parámetros de actualización: uno basado en time (<refreshMode> y <refreshInterval>) y otro se basa en la view actual de "cámara" (<viewRefreshMode> y <viewRefreshTime>). Además, Link especifica si se deben escalar los parámetros del cuadro de límite que se envían al servidor (<viewBoundScale>) y proporciona un conjunto de parámetros opcionales de visualización que pueden enviarse a la servidor.

Cuando se recupera un archivo, la URL que se envía al servidor consta de tres datos:

  • La href (referencia de hipertexto) que especifica el archivo que se cargará.
  • una string de formato arbitraria que se crea a partir de (a) parámetros que se especifican en el elemento <viewFormat> o (b) parámetros del cuadro de límite (este es el valor predeterminado y se utiliza si no se incluye un elemento <viewFormat> en el archivo).
  • una segunda string de formato especificada en el elemento <httpQuery>.

Si el archivo especificado en <href> es un archivo local, no se utilizan los elementos <viewFormat> y <httpQuery>.

El elemento <Link> reemplaza el elemento <Url> de <NetworkLink> que se incluía en las versiones anteriores de KML y agrega funcionalidad al elemento <Region> (presentado en KML 2.1). En Google Earth 3.0 y versiones anteriores, se ignora el elemento <Link>.

<href>
Una URL (ya sea una dirección HTTP o una especificación de archivo local). Cuando el elemento principal de <Link> es un NetworkLink, <href> es un archivo KML. Cuando el elemento superior de <Link> es un modelo, <href> es un archivo COLLADA. Cuando el elemento superior de <Icon> (los mismos campos que <Link>) es una superposición, <href> es una imagen. Las URL relativas se pueden usar en esta etiqueta y se evalúan según el archivo KML que las contiene. Consulta Archivos KMZ para obtener más información sobre cómo crear referencias relativas en los archivos KML y KMZ.
<refreshMode>
Especifica un modo de actualización basado en el tiempo, que puede ser uno de los siguientes:
  • onChange: Se actualiza cuando se carga el archivo y cada vez que cambian los parámetros del vínculo (predeterminado).
  • onInterval: Se actualiza cada n segundos (especificado en <refreshInterval>).
  • onExpire: Actualiza el archivo cuando se cumpla el plazo de vencimiento. Si un archivo recuperado tiene un NetworkLinkControl, el tiempo de <expires> tiene prioridad sobre los plazos de vencimiento especificados en los encabezados HTTP. Si no se especifica la hora <expires>, se usa el encabezado HTTP max-age (si está presente). Si max-age no está presente, se usa el encabezado HTTP Expires (si está presente). (Consulta la sección RFC261b del Protocolo de transferencia de hipertexto: HTTP 1.1 para obtener detalles sobre los campos de encabezado HTTP).
<refreshInterval>
Indica que se debe actualizar el archivo cada n segundos.
<viewRefreshMode>
Especifica cómo se actualiza el vínculo cuando cambia la "cámara".
Puede ser uno de los siguientes:
  • never (predeterminado): ignora los cambios en la vista. También ignora los parámetros <viewFormat>, si hubiera alguno.
  • onStop: Actualiza el archivo n segundos después de que se detenga el movimiento, donde n se especifica en <viewRefreshTime>.
  • onRequest: Actualiza el archivo solo cuando el usuario lo solicita explícitamente. (Por ejemplo, en Google Earth, el usuario hace clic con el botón derecho del mouse y selecciona Actualizar en el menú contextual).
  • onRegion: Actualiza el archivo cuando la región se activa. Consulta <Región>.
<viewRefreshTime>
Después de que se detiene el movimiento de la cámara, especifica la cantidad de segundos que hay que esperar antes de actualizar la vista. (Consulta <viewRefreshMode> y onStop más arriba).
<viewBoundScale>
Ajusta los parámetros de BBOX antes de enviarlos al servidor. Un valor inferior a 1 especifica que se usará menos que la vista completa (pantalla). Un valor superior a 1 especifica que se debe recuperar un área que se extiende más allá de los bordes de la vista actual.
<viewFormat>
Especifica el formato de la cadena de consulta que se agrega al archivo <href> del vínculo antes de que se obtenga el archivo (si <href> especifica un archivo local, este elemento se ignora).
Si especificas un elemento <viewRefreshMode> de onStop y no incluyes la etiqueta <viewFormat> en el archivo, la siguiente información se agrega automáticamente a la string de consulta:

BBOX=[bboxWest],[bboxSouth],[bboxEast] y [bboxNorth]

Esta información coincide con la especificación del cuadro de límite del servicio de mapas web (WMS).
Si especifica una etiqueta <viewFormat> vacía, no se agregará información a la string de consulta.
También puedes especificar un conjunto personalizado de parámetros de visualización para agregar a la string de consulta. Si proporcionas una string de formato, se usa en lugar de la información de BBOX. Si también quieres la información de BBOX, debes agregar esos parámetros junto con los parámetros personalizados.
Puedes utilizar cualquiera de los siguientes parámetros en tu string de formato (y Google Earth sustituirá el valor actual apropiado en el momento en que crea la string de consulta):
  • [lookatLon], [lookatLat] : La longitud y la latitud del punto que <LookAt> está viendo.
  • [lookatRange], [lookatTilt], [lookatHeading]: valores utilizados por el elemento <LookAt> (consulta las descripciones de <range>, <tilt> y <heading> en <LookAt>)
  • [lookatTerrainLon], [lookatTerrainLat], [lookatTerrainAlt]: Indica el terreno en grados o metros que <LookAt> está viendo.
  • [cameraLon], [cameraLat] y [cameraAlt]: grados/metros del punto de vista de la cámara
  • [horizFov], [vertFov] : campo visual horizontal de la cámara.
  • [horizPixels], [vertPixels]: tamaño en píxeles del visor 3D
  • [terrainEnabled]: indica si el visor 3D está mostrando el relieve.
<httpQuery>
Anexa información a la string de consulta, según los parámetros especificados. (Google Earth sustituye el valor actual apropiado en el momento en que crea la cadena de consulta). Se admiten los siguientes parámetros:
  • [clientVersion]
  • [kmlVersion]
  • [nombredelcliente]
  • [idioma]

Ejemplo

<NetworkLink>
  <name>NE US Radar</name>
  <flyToView>1</flyToView>
  <Link>
    <href>http://www.example.com/geotiff/NE/MergedReflectivityQComposite.kml</href>
    <refreshMode>onInterval</refreshMode>
    <refreshInterval>30</refreshInterval>
    <viewRefreshMode>onStop</viewRefreshMode>
    <viewRefreshTime>7</viewRefreshTime>
    <viewFormat>BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxNorth];CAMERA=\
      [lookatLon],[lookatLat],[lookatRange],[lookatTilt],[lookatHeading];VIEW=\
      [horizFov],[vertFov],[horizPixels],[vertPixels],[terrainEnabled]</viewFormat>
  </Link>
</NetworkLink> 

Extiende

Contenida por

Consulta también

<ListStyle>

Sintaxis

<ListStyle id="ID">
  <!-- specific to ListStyle -->
  <listItemType>check</listItemType> <!-- kml:listItemTypeEnum:check,
                                          checkOffOnly,checkHideChildren,
                                         radioFolder -->
  <bgColor>ffffffff</bgColor>        <!-- kml:color -->
  <ItemIcon>                         <!-- 0 or more ItemIcon elements -->
    <state>open</state>
      <!-- kml:itemIconModeEnum:open, closed, error, fetching0, fetching1, or fetching2 -->
    <href>...</href>                 <!-- anyURI -->
  </ItemIcon>
</ListStyle>

Descripción

Especifica cómo se muestra un elemento en la vista de lista. La vista de lista es una jerarquía de contenedores y elementos secundarios. En Google Earth, es el panel Lugares.

Elementos específicos de ListStyle

<listItemType>
Especifica cómo se muestra un elemento en la vista de lista. Los valores posibles son los siguientes:
  • check (predeterminado): la visibilidad del elemento está vinculada a la casilla de verificación del elemento.
  • radioFolder: cuando se especifica para un contenedor, solo uno de los elementos del contenedor es visible a la vez.
  • checkOffOnly: Cuando se especifica para un contenedor o un vínculo de red, evita que todos los elementos sean visibles a la vez, es decir, el usuario puede desactivar todo al mismo tiempo, pero no puede activar todo al mismo tiempo. Esta configuración es útil para los contenedores o vínculos de red que contienen grandes cantidades de datos.
  • checkHideChildren: Usa una casilla de verificación normal para la visibilidad, pero no muestre los elementos secundarios del contenedor o el vínculo de red en la vista de lista. Una casilla de verificación le permite al usuario activar o desactivar la visibilidad de los objetos secundarios en el visor.
<bgColor>
Color de fondo del fragmento Los valores de color y opacidad se expresan en notación hexadecimal. El rango de valores de cualquier color es de 0 a 255 (de 00 a ff). En el caso del alfa, 00 es completamente transparente y ff es completamente opaco. El orden de expresión es aabbggrr, donde aa=alpha (00 a ff); bb=blue (00 a ff); gg=green (00 a ff); rr=red (00 a ff). Por ejemplo, si deseas aplicar un color azul con un 50% de opacidad a una superposición, debes especificar lo siguiente: <color>7fff0000</color>, donde alpha=0x7f, blue=0xff, green=0x00 y red=0x00.
<ItemIcon>
Ícono que se usa en la vista de lista y que refleja el estado de la recuperación de una carpeta o un vínculo. Los íconos asociados con los modos open y closed se usan para las carpetas y los vínculos de red. Los íconos asociados con los modos error y fetching0, fetching1 y fetching2 se usan para los vínculos de red. En la siguiente captura de pantalla, se ilustran los íconos de Google Earth para estos estados:
<estado>
Especifica el estado actual de la NetworkLink o la carpeta. Los valores posibles son open, closed, error, fetching0, fetching1 y fetching2. Estos valores se pueden combinar si insertas un espacio entre dos valores (sin comas).
<href>
Especifica el URI de la imagen que se usa en la vista de lista para el elemento.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>ListStyle.kml</name>
<open>1</open>
<Style id="bgColorExample">
<ListStyle>
<bgColor>ff336699</bgColor>
</ListStyle>
</Style>
<Style id="checkHideChildrenExample">
<ListStyle>
<listItemType>checkHideChildren</listItemType>
</ListStyle>
</Style>
<Style id="radioFolderExample">
<ListStyle>
<listItemType>radioFolder</listItemType>
</ListStyle>
</Style>
<Folder>
<name>ListStyle Examples</name>
<open>1</open>
<Folder>
<name>bgColor example</name>
<open>1</open>
<Placemark>
<name>pl1</name>
<Point>
<coordinates>-122.362815,37.822931,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>pl2</name>
<Point>
<coordinates>-122.362825,37.822931,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>pl3</name>
<Point>
<coordinates>-122.362835,37.822931,0</coordinates>
</Point>
</Placemark>
<styleUrl>#bgColorExample</styleUrl>
</Folder>
<Folder>
<name>checkHideChildren example</name>
<open>1</open>
<Placemark>
<name>pl4</name>
<Point>
<coordinates>-122.362845,37.822941,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>pl5</name>
<Point>
<coordinates>-122.362855,37.822941,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>pl6</name>
<Point>
<coordinates>-122.362865,37.822941,0</coordinates>
</Point>
</Placemark>
<styleUrl>#checkHideChildrenExample</styleUrl>
</Folder>
<Folder>
<name>radioFolder example</name>
<open>1</open>
<Placemark>
<name>pl7</name>
<Point>
<coordinates>-122.362875,37.822951,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>pl8</name>
<Point>
<coordinates>-122.362885,37.822951,0</coordinates>
</Point>
</Placemark>
<Placemark>
<name>pl9</name>
<Point>
<coordinates>-122.362895,37.822951,0</coordinates>
</Point>
</Placemark>
<styleUrl>#radioFolderExample</styleUrl>
</Folder>
</Folder>
</Document>
</kml>

Extiende

Contenida por

<LookAt>

Sintaxis

<LookAt id="ID">
  <!-- inherited from AbstractView element -->
  <TimePrimitive>...</TimePrimitive>  <!-- gx:TimeSpan or gx:TimeStamp -->
    <gx:ViewerOptions>
    <option> name=" " type="boolean">     <!-- name="streetview", "historicalimagery", "sunlight", or "groundnavigation" -->
    </option>
  </gx:ViewerOptions>

  <!-- specific to LookAt -->
  <longitude>0</longitude>            <!-- kml:angle180 -->
  <latitude>0</latitude>              <!-- kml:angle90 -->
  <altitude>0</altitude>              <!-- double -->
  <heading>0</heading>                <!-- kml:angle360 -->
  <tilt>0</tilt>                      <!-- kml:anglepos90 -->
  <range></range>                     <!-- double -->
  <altitudeMode>clampToGround</altitudeMode>
          <!--kml:altitudeModeEnum:clampToGround, relativeToGround, absolute -->
          <!-- or, gx:altitudeMode can be substituted: clampToSeaFloor, relativeToSeaFloor -->

</LookAt>

Descripción

Define una cámara virtual asociada con cualquier elemento derivado de Feature. El elemento LookAt coloca la "cámara" en relación con el objeto que se ve. En Google Earth, la vista "vuela a" este punto de vista de LookAt cuando el usuario hace doble clic en un elemento del panel Lugares o hace doble clic en un ícono del visor 3D.

Elementos específicos de LookAt

<longitude>
La longitud del punto que mira la cámara. Distancia angular en grados, en relación con el primer meridiano. Valores al oeste del rango de Meridian desde −180 a 0 grados. Los valores al este del meridiano van de 0 a 180 grados.
<latitude>
Latitud del punto que mira la cámara. Grados del norte o sur del ecuador (0 grados). Los valores varían entre −90 grados y 90 grados.
<altitude>
La distancia de la superficie de la Tierra en metros. Interpretado de acuerdo con el modo de altitud de LookAt.
<heading>
Dirección (es decir, el norte, sur, este, oeste), en grados. Predeterminado=0 (Norte). (Consulta el siguiente diagrama). Los valores varían de 0 a 360 grados.
<tilt>
Realiza un ángulo entre la dirección de la posición de LookTo y la normal respecto de la superficie de la Tierra. (Consulta el siguiente diagrama). Los valores varían entre 0 y 90 grados. Los valores de <tilt> no pueden ser negativos. Un valor <tilt> de 0 grados indica la visualización directamente desde arriba. Un valor de <inclinación> de 90 grados indica la visualización del horizonte.
<range>(obligatorio)
Distancia en metros desde el punto especificado por <longitud>, <latitud> y <altitude> hasta la posición de LookAt. (Consulta el siguiente diagrama).
<altitudeMode>
Especifica cómo se interpreta la <altitude> especificada para el punto LookAt. Los valores posibles son los siguientes:
  • clampToGround (predeterminado): Indica que se debe ignorar la especificación <altitude> y colocar la posición LookAt en el suelo.
  • relativeToGround: Interpreta la <altitude> como un valor en metros sobre el suelo.
  • absolute: Interpreta el valor de <altitude> como un valor en metros sobre el nivel del mar.
<gx:altitudeMode>
Es una extensión KML en el espacio de nombres de extensiones de Google, que permite altitudes relativas al lecho marino. Los valores son los siguientes:
  • relativeToSeaFloor: Interpreta la <altitude> como un valor en metros sobre el lecho marino. Si el punto se encuentra sobre el suelo en lugar de en el mar, se interpretará que la <altitude> está sobre el suelo.
  • clampToSeaFloor: Se ignora la especificación <altitude> y el LookAt se posicionará en el lecho marino. Si el punto está en tierra en vez de en el mar, el LookAt aparecerá en el suelo.

En este diagrama, se ilustran los elementos <range>, <tilt> y <altitude>:

 

En este diagrama, se ilustra el elemento <heading>:

 

Este=90, Sur=180, Oeste=270
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
xmlns:gx="http://www.google.com/kml/ext/2.2">

  <Placemark>
    <name>LookAt.kml</name>
    <LookAt>
      <gx:TimeStamp>
        <when>1994</when>
      </gx:TimeStamp>
      <longitude>-122.363</longitude>
      <latitude>37.81</latitude>
      <altitude>2000</altitude>
      <range>500</range>
      <tilt>45</tilt>
      <heading>0</heading>
      <altitudeMode>relativeToGround</altitudeMode>
    </LookAt>
    <Point>
      <coordinates>-122.363,37.82,0</coordinates>
    </Point>
  </Placemark>
</kml>

Extiende

Contenida por

<Modelo>

Sintaxis

<Model id="ID">
  <!-- specific to Model -->
  <altitudeMode>clampToGround</altitudeMode>
      <!-- kml:altitudeModeEnum: clampToGround,relativeToGround,or absolute -->
      <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <Location>
    <longitude></longitude> <!-- kml:angle180 -->
    <latitude></latitude>   <!-- kml:angle90 -->
    <altitude>0</altitude>  <!-- double -->
  </Location>
  <Orientation>
    <heading>0</heading>    <!-- kml:angle360 -->
    <tilt>0</tilt>          <!-- kml:anglepos180 -->
    <roll>0</roll>          <!-- kml:angle180 -->
  </Orientation>
  <Scale>
    <x>1</x>                <!-- double -->
    <y>1</y>                <!-- double -->
    <z>1</z>                <!-- double -->
  </Scale>
  <Link>...</Link>
  <ResourceMap>
    <Alias>
      <targetHref>...</targetHref>   <!-- anyURI -->
      <sourceHref>...</sourceHref>   <!-- anyURI -->
    </Alias>
  </ResourceMap>
</Model>

Descripción

Un objeto 3D que se describe en un archivo COLLADA (al que se hace referencia en la etiqueta <Link>) Los archivos COLLADA tienen una extensión de archivo .dae. Los modelos se crean en su propio espacio de coordenadas y, a continuación, se ubican, ubican y escalan en Google Earth. Consulta la página "Temas de KML" en Modelos para obtener más información.

Google Earth admite el perfil común COLLADA, con las siguientes excepciones:

  • Google Earth sólo admite triángulos y líneas como tipos primitivos. La cantidad máxima de triángulos permitidos es 21,845.
  • Google Earth no admite la animación ni el diseño de interfaces.
  • Google Earth no admite referencias geométricas externas.

Elementos específicos del modelo

<altitudeMode>
Especifica cómo se interpreta la <altitude> especificada en <Location>. Los valores posibles son los siguientes:
  • clampToGround (predeterminado): Indica que se debe ignorar la especificación de <altitude> y colocar el modelo en el suelo.
  • relativeToGround: Interpreta la <altitude> como un valor en metros sobre el suelo.
  • absolute: Interpreta el valor de <altitude> como un valor en metros sobre el nivel del mar.
<gx:altitudeMode>
Es una extensión KML en el espacio de nombres de extensiones de Google, que permite altitudes relativas al lecho marino. Los valores son los siguientes:
  • relativeToSeaFloor: Interpreta la <altitude> como un valor en metros sobre el lecho marino. Si el punto se encuentra sobre el suelo en lugar de en el mar, se interpretará que la <altitude> está sobre el suelo.
  • clampToSeaFloor: Se ignora la especificación <altitude> y el modelo se posicionará en el lecho marino. Si el punto está en la tierra y no en el mar, el modelo se posicionará en el suelo.
<Ubicación>
Especifica las coordenadas exactas del origen del modelo en latitud, longitud y altitud. Las mediciones de latitud y longitud son una proyección de latitud y longitud estándar con el datum WGS84. La altitud es la distancia sobre la superficie de la Tierra en metros y se interpreta de acuerdo con <altitudeMode> o <gx:altitudeMode>.
<Location>
  <longitude>39.55375305703105</longitude>
  <latitude>-118.9813220168456</latitude>
  <altitude>1223</altitude>
</Location> 
<Orientation>
Describe la rotación del sistema de coordenadas de un modelo 3D para posicionar el objeto en Google Earth. Consulta los diagramas siguientes.
<Orientation>
  <heading>45.0</heading>
  <tilt>10.0</tilt>
  <roll>0.0</roll>
</Orientation> 

Las rotaciones se aplican a un modelo en el siguiente orden:

  1. <roll>
  2. <tilt>
  3. <heading>
<heading>
Rotación alrededor del eje z (normal respecto de la superficie de la Tierra). El valor 0 (predeterminado) equivale al norte. Una rotación positiva es en el sentido de las manecillas del reloj alrededor del eje z y se especifica en grados de 0 a 360.
<tilt>
Rotación alrededor del eje x. Una rotación positiva es en el sentido de las manecillas del reloj alrededor del eje x y se especifica en grados de 0 a 180.
<roll>
Rotación sobre el eje y. Una rotación positiva es en sentido horario alrededor del eje y, y se especifica en grados de 0 a 180.
La orientación, la inclinación y el rumbo se especifican en el sentido de las manecillas del reloj al mirar hacia abajo en el eje hacia el origen
En este diagrama, se ilustra la orientación típica de los ejes de un modelo:
Para un modelo típico, +x es a la derecha, +y está al frente y orientado al norte, y +z está arriba
<Scale>
Escala un modelo a lo largo de los ejes x, y y z en el espacio de coordenadas del modelo.
<Scale>
<x>2.5</x>
<y>2.5</y>
<z>3.5</z>
</Scale>
Especifica el archivo que se cargará y los parámetros opcionales de actualización. Consulta <Vínculo>.
<ResourceMap>
Especifica 0 o más elementos <Alias>, cada uno de los cuales es una asignación de la ruta del archivo de textura del archivo Collada original al archivo KML o KMZ que contiene el modelo. Este elemento te permite mover y renombrar archivos de textura sin tener que actualizar el archivo original de Collada que hace referencia a dichas texturas. Un elemento <ResourceMap> puede contener múltiples asignaciones de diferentes archivos Collada (fuente) en el mismo archivo KMZ (objetivo).
<Alias>
<targetHref>../images/foo.jpg</targetHref> <sourceHref>c:\mytextures\foo.jpg</sourceHref> </Alias>
<Alias> contiene una asignación de <sourceHref> a <targetHref>:
<targetHref>
Especifica el archivo de textura que Google Earth recuperará. Esta referencia puede ser una referencia relativa a un archivo de imagen dentro del archivo .kmz o puede ser una referencia absoluta al archivo (por ejemplo, una URL).
<sourceHref>
Es la ruta de acceso especificada para el archivo de textura en el archivo Collada .dae.
En Google Earth, si no se suministra esta asignación, se usan las siguientes reglas para localizar las texturas a las que se hace referencia en el archivo Collada (.dae):
  • Sin ruta: si el nombre de la textura no incluye una ruta, Google Earth buscará la textura en el mismo directorio que el archivo .dae que hace referencia a ella.
  • Ruta de acceso relativa: Si el nombre de la textura incluye una ruta de acceso relativa (por ejemplo, ../images/mytexture.jpg), Google Earth interpretará que la ruta de acceso es relativa al archivo .dae que hace referencia a ella.
  • Ruta de acceso absoluta: Si el nombre de la textura es una ruta de acceso absoluta (c:\mytexture.jpg) o una ruta de red (por ejemplo, http://myserver.com/mytexture.jpg), Google Earth busca el archivo en la ubicación especificada, independientemente de dónde se encuentre el archivo .dae.

Ejemplo

<Model id="khModel543"> 
<altitudeMode>relativeToGround</altitudeMode>
<Location>
<longitude>39.55375305703105</longitude>
<latitude>-118.9813220168456</latitude>
<altitude>1223</altitude>
</Location>
<Orientation>
<heading>45.0</heading>
<tilt>10.0</tilt>
<roll>0.0</roll>
</Orientation>
<Scale>
<x>1.0</x>
<y>1.0</y>
<z>1.0</z>
</Scale>
<Link>
<href>house.dae</href>
<refreshMode>once</refreshMode>
</Link>
<ResourceMap>
<Alias>
<targetHref>../files/CU-Macky---Center-StairsnoCulling.jpg</targetHref>
<sourceHref>CU-Macky---Center-StairsnoCulling.jpg</sourceHref>
</Alias>
<Alias>
<targetHref>../files/CU-Macky-4sideturretnoCulling.jpg</targetHref>
<sourceHref>CU-Macky-4sideturretnoCulling.jpg</sourceHref>
</Alias>
<Alias>
<targetHref>../files/CU-Macky-Back-NorthnoCulling.jpg</targetHref>
<sourceHref>CU-Macky-Back-NorthnoCulling.jpg</sourceHref>
</Alias>
</ResourceMap>
</Model>

Extiende

Contenida por

<MultiGeometry>

Sintaxis

<MultiGeometry id="ID">
  <!-- specific to MultiGeometry -->
  <!-- 0 or more Geometry elements -->
</MultiGeometry>

Descripción

Un contenedor para cero o más primitivas geométricas asociadas con la misma función.

Nota: La etiqueta <GeometryCollection> dejó de estar disponible. En su lugar, use <MultiGeometry>.

Elementos específicos de MultiGeometría

Ejemplo

<Placemark>
  <name>SF Marina Harbor Master</name>
<visibility>0</visibility>
<MultiGeometry> <LineString>
<!-- north wall --> <coordinates>
-122.4425587930444,37.80666418607323,0
-122.4428379594768,37.80663578323093,0 </coordinates>
</LineString> <LineString>
<!-- south wall -->
<coordinates>
-122.4425509770566,37.80662588061205,0
-122.4428340530617,37.8065999493009,0
</coordinates> </LineString>
</MultiGeometry> </Placemark>

Extiende

Contenida por

<gx:MultiTrack>

Este elemento es una extensión del estándar KML 2.2 de OGC y es compatible con Google Earth 5.2 y versiones posteriores. Más información

Sintaxis

<gx:MultiTrack id="ID">
  <!-- specific to MultiTrack -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <gx:interpolate>0<gx:interpolate>   <!-- boolean -->
  <gx:Track>...</gx:Track>            <!-- one or more gx:Track elements -->
</gx:MultiTrack>

Descripción

Un elemento de varias pistas se usa para combinar varios elementos de pistas en una sola unidad conceptual. Por ejemplo, supongamos que recopila datos de GPS para un viaje en bicicleta de un día que incluye varias paradas de descanso y una parada para almorzar. Debido a las interrupciones en el tiempo, un viaje en bicicleta podría aparecer como cuatro recorridos diferentes cuando se trazan los horarios y las posiciones. Al agrupar estos elementos <gx:Track> en un contenedor <gx:MultiTrack>, estos se muestran en Google Earth como secciones de una única ruta. Cuando el ícono llega al final de un segmento, se mueve al principio del siguiente. El elemento <gx:interpolate> especifica si debe detenerse al final de una pista e ir inmediatamente al inicio de la siguiente, o si desea interpolar los valores faltantes entre las dos pistas.

Elementos específicos de gx:MultiTrack

<altitudeMode>
Especifica cómo se interpretan los componentes de altitudes en el elemento <coordinates>. Los valores posibles son los siguientes:
  • clampToGround (predeterminado) indica que debe ignorar una especificación de altitud (por ejemplo, en el elemento <gx:coord>).
  • relativeToGround: Establece la altitud del elemento en relación con la elevación real del suelo de una ubicación específica. Por ejemplo, si la elevación del piso de una ubicación es exactamente a nivel del mar y la altitud de un punto se establece en 9 metros, la elevación para el ícono de la elevación de la marca de un punto será de 9 metros con este modo. Sin embargo, si la misma coordenada se establece en una ubicación en la que la elevación del suelo es de 10 metros sobre el nivel del mar, la elevación es de 19 metros.
  • absolute: Establece la altitud de la coordenada en relación con el nivel del mar, independientemente de la elevación real del terreno debajo del elemento. Por ejemplo, si defines una altitud de 10 metros con un modo de altitud absoluta, el ícono de marcador de posición aparecerá al nivel del suelo si el relieve inferior también se encuentra a 10 metros sobre el nivel del mar. Si el relieve se encuentra a 3 metros sobre el nivel del mar, el marcador aparecerá elevado por encima de 7 metros sobre el relieve.
<gx:altitudeMode>
Es una extensión KML en el espacio de nombres de extensiones de Google, que permite altitudes relativas al lecho marino. Los valores son los siguientes:
  • relativeToSeaFloor: Interpreta la altitud como un valor en metros sobre el lecho marino. Si el punto está sobre el suelo en lugar del mar, la altitud se interpretará como si estuviera sobre el suelo.
  • clampToSeaFloor: Se ignora la especificación de altitud, y el punto se posicionará en el lecho marino. Si el punto está en tierra en lugar de en el mar, el punto se posicionará en el suelo.
<gx:interpolate>
Valor booleano. Si el segmento múltiple contiene varios elementos <gx:Track>, especifica si se deben interpolar los valores faltantes entre el final de la primera pista y el comienzo de la siguiente. Cuando se utiliza el valor predeterminado (0), el ícono o modelo se detiene al final de una pista y luego salta al inicio de la siguiente.

Contenido

Sintaxis

<NetworkLink id="ID">
  <!-- inherited from Feature element --><name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
   <atom:link href=" "/>               <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 --> <!-- specific to NetworkLink --> <refreshVisibility>0</refreshVisibility> <!-- boolean --> <flyToView>0</flyToView> <!-- boolean --> <Link>...</Link> </NetworkLink>

Descripción

Hace referencia a un archivo KML o KMZ en una red local o remota. Utiliza el elemento <Link> para especificar la ubicación del archivo KML. Dentro de ese elemento, puedes definir las opciones de actualización del archivo según la hora y el cambio de cámara. Los NetworkLinks se pueden usar en combinación con regiones para administrar conjuntos de datos muy grandes de forma eficiente.

<refreshVisibility>
Valor booleano. El valor 0 deja la visibilidad de los elementos dentro del control del usuario de Google Earth. Establece el valor en 1 para restablecer la visibilidad de las funciones cada vez que se actualice el NetworkLink. Por ejemplo, supongamos que una marca de posición dentro del archivo KML vinculado tiene <visibility> configurada en 1, y NetworkLink tiene <refreshVisibility> en 1. Cuando el archivo se carga por primera vez en Google Earth, el usuario puede desactivar la casilla de verificación situada junto al elemento para desactivar la visualización en el visor 3D. No obstante, cuando se actualice el NetworkLink, el marcador se volverá a mostrar como visible, ya que su estado de visibilidad original era TRUE.
<flyToView>
Valor booleano. Un valor de 1 hace que Google Earth vuele a la vista de la cámara o la vista en la NetworkLinkControl (si existe). Si el NetworkLinkControl no contiene un elemento AbstractView, Google Earth volará al elemento LookAt o Camera del elemento secundario de la función dentro del elemento <kml> en el archivo actualizado. Si el elemento <kml> no cuenta con un LookAt o Cámara especificados, la vista no se modificará. Por ejemplo, Google Earth volaría a la vista <LookAt> del documento principal, no a la <LookAt> de los marcadores incluidos dentro del documento.

Sugerencia: Para mostrar la carpeta o el documento de nivel superior dentro de un vínculo de red en la vista de lista, asigna un ID a la carpeta o al documento. Sin este ID, solo se muestran los nombres de objetos secundarios en la vista de lista.

Ejemplo

<Document>
  <visibility>1</visibility>
  <NetworkLink>
    <name>NE US Radar</name>
    <refreshVisibility>1</refreshVisibility>
    <flyToView>1</flyToView>
    <Link>...</Link></NetworkLink>
</Document>

Extiende

Contenida por

<NetworkLinkControl>

Sintaxis

<NetworkLinkControl>
  <minRefreshPeriod>0</minRefreshPeriod>           <!-- float -->
  <maxSessionLength>-1</maxSessionLength>          <!-- float --> 
  <cookie>...</cookie>                             <!-- string -->
  <message>...</message>                           <!-- string -->
  <linkName>...</linkName>                         <!-- string -->
  <linkDescription>...</linkDescription>           <!-- string -->
  <linkSnippet maxLines="2">...</linkSnippet>      <!-- string -->
  <expires>...</expires>                           <!-- kml:dateTime -->
  <Update>...</Update>                             <!-- Change,Create,Delete -->
  <AbstractView>...</AbstractView>                 <!-- LookAt or Camera -->
</NetworkLinkControl>

Descripción

Controla el comportamiento de los archivos recuperados por una <NetworkLink>.

Elementos específicos de NetworkLinkControl

<minRefreshPeriod>
Especificado en segundos, <minRefreshPeriod> es el tiempo mínimo permitido entre recuperaciones del archivo. Este parámetro permite que los servidores limiten las recuperaciones de un archivo específico y que adapten las frecuencias de actualización a la frecuencia de cambio esperada de los datos. Por ejemplo, un usuario puede establecer una actualización de vínculo a 5 segundos, pero usted puede establecer el período mínimo de actualización a 3600 para limitar las actualizaciones una vez por hora.
<maxSessionLength>
Especificado en segundos, <maxSessionLength> es la cantidad máxima de tiempo durante la cual el NetworkLink puede seguir conectado. El valor predeterminado de -1 indica que no se debe finalizar la sesión de forma explícita.
Usa este elemento para agregar una string a la consulta de URL en la próxima actualización del vínculo de la red. Puedes usar estos datos en tu secuencia de comandos para proporcionar un manejo más inteligente del servidor, incluidas la consulta de versiones y la entrega condicional de archivos.
<message>
Puedes enviar un mensaje emergente, como lineamientos de uso para el vínculo de tu red. El mensaje aparece cuando el vínculo de red se carga por primera vez en Google Earth o cuando se modifica en el control de enlace de red.
<linkName>
Puedes controlar el nombre del vínculo de red desde el servidor, de modo que el servidor anule los cambios realizados en el nombre del cliente.
<linkDescription>
Puedes controlar la descripción del vínculo de red desde el servidor, de modo que el servidor anule los cambios realizados en la descripción del cliente.
<linksnippet maxLines="2" >
Puedes controlar el fragmento del vínculo de red desde el servidor, de modo que el servidor anule los cambios realizados en el fragmento en el cliente. <linkSnippet> tiene un atributo maxLines, un número entero que especifica la cantidad máxima de líneas que se mostrarán.
<expires>
Puedes especificar la fecha y la hora en las que se debería actualizar el vínculo. Esta especificación se aplica solo si el <refreshMode> de <Link> tiene el valor onExpire. Consulta <refreshMode>
.
<Update>
Con <Update>, puedes especificar cualquier cantidad de etiquetas Cambiar, Crear y Borrar para un archivo .kml o un archivo .kmz que se haya cargado con un vínculo de red. Consulta <Update>.
<AbstractView>

Ejemplo

<kml xmlns="http://www.opengis.net/kml/2.2">
<NetworkLinkControl>
   <message>This is a pop-up message. You will only see this once</message>
   <cookie>cookie=sometext</cookie>
   <linkName>New KML features</linkName>
   <linkDescription><![CDATA[KML now has new features available!]]></linkDescription>
</NetworkLinkControl>
</kml>

Extiende

  • Este es un elemento secundario directo del elemento <kml>.

Contenida por

  • <kml>

Consulta también

<Objeto>

Sintaxis

<!-- abstract element; do not create -->
<!-- Object id="ID" targetId="NCName" -->
<!-- /Object> -->

Descripción

Esta es una clase base abstracta y no se puede utilizar directamente en un archivo KML. Proporciona el atributo id, que permite la identificación única de un elemento KML, y el atributo targetId, que se usa para hacer referencia a objetos que ya se cargaron en Google Earth. Se debe asignar el atributo id [id] si se va a usar el mecanismo <Update>.

<Superposición>

Sintaxis

<!-- abstract element; do not create -->
<!-- Overlay id="ID" -->                    <!-- GroundOverlay,ScreenOverlay -->
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 --> <!-- specific to Overlay --> <color>ffffffff</color> <!-- kml:color --> <drawOrder>0</drawOrder> <!-- int --> <Icon> <href>...</href> </Icon> <!-- /Overlay -->

Descripción

Este es un elemento abstracto y no se puede utilizar directamente en un archivo KML. <Overlay> es el tipo de base para las superposiciones de imágenes dibujadas en la superficie del planeta o en la pantalla. <Icon> especifica la imagen que se usará y puede configurarse para volver a cargar imágenes según un temporizador o mediante cambios en la cámara. Este elemento también incluye especificaciones para apilar el orden de varias superposiciones y para agregar valores de color y transparencia a la imagen base.

Elementos específicos de la superposición

<color>
Los valores de color se expresan en notación hexadecimal, incluidos los valores de opacidad (Alfa). El orden de expresión es alfa, azul, verde y rojo (aabbggrr). El rango de valores de cualquier color es de 0 a 255 (de 00 a ff).. Para opacidad, 00 es completamente transparente y ff es completamente opaco. Por ejemplo, si deseas aplicar un color azul con una opacidad del 50% a una superposición, debes especificar lo siguiente: <color>7fff0000</color>

Nota: El elemento <geomColor> dejó de estar disponible. En su lugar, use <color>.

<drawOrder>
Este elemento define el orden de apilado de las imágenes en superposiciones de superposiciones. Las superposiciones con valores <drawOrder> superiores se dibujan encima de las superposiciones con valores <drawOrder> más bajos.
<Icon>
Define la imagen asociada con la superposición. El elemento <href> define la ubicación de la imagen que se usará como superposición. Esta ubicación puede estar en un sistema de archivos local o en un servidor web. Si se omite este elemento o no contiene <href>, se dibujará un rectángulo con el color y el tamaño definidos por la superposición de suelo o pantalla.
<Icon>
   <href>icon.jpg</href>
</Icon>

Extiende

Extendido por

<PhotoOverlay>.

Sintaxis

<PhotoOverlay>
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>            <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 --> <!-- inherited from Overlay element --> <color>ffffffff</color> <!-- kml:color --> <drawOrder>0</drawOrder> <!-- int --> <Icon> <href>...</href> <!-- anyURI --> ... </Icon> <!-- specific to PhotoOverlay --> <rotation>0</rotation> <!-- kml:angle180 --> <ViewVolume> <leftFov>0</leftFov> <!-- kml:angle180 --> <rightFov>0</rightFov> <!-- kml:angle180 --> <bottomFov>0</bottomFov> <!-- kml:angle90 --> <topFov>0</topFov> <!-- kml:angle90 --> <near>0</near> <!-- double --> </ViewVolume> <ImagePyramid> <tileSize>256</tileSize> <!-- int --> <maxWidth>...</maxWidth> <!-- int --> <maxHeight>...</maxHeight> <!-- int --> <gridOrigin>lowerLeft</gridOrigin> <!-- lowerLeft or upperLeft --> </ImagePyramid> <Point> <coordinates>...</coordinates> <!-- lon,lat[,alt] --> </Point> <shape>rectangle</shape> <!-- kml:shape --> </PhotoOverlay>

Descripción

El elemento <PhotoOverlay> te permite localizar geográficamente una fotografía en la Tierra y especificar los parámetros de visualización de esta PhotoOverlay. PhotoOverlay puede ser un rectángulo simple en 2D, un cilindro parcial o completo o una esfera (para panorámicas esféricas). La superposición se coloca en la ubicación especificada y se orienta hacia el punto de vista.

Debido a que <PhotoOverlay> deriva de <Feature>, puede contener uno de los dos elementos derivados de <AbstractView> (ya sea <Camera> o <LookAt>). La cámara (o LookAt) especifica un viewpoint y una dirección de visualización (también conocido como vector de vista). El elemento PhotoOverlay se posiciona en relación con el punto de vista. Específicamente, el plano de una imagen rectangular en 2D es ortogonal (en ángulos rectos con respecto al vector de vista). La normalidad de este plano, es decir, su frente, que es la parte de la foto, está orientada hacia el mirador.

La URL de la imagen PhotoOverlay se especifica en la etiqueta <Icon>, que se hereda de <Overlay>. La etiqueta <Icon> debe contener un elemento <href> que especifique el archivo de imagen que se usará para PhotoOverlay. En el caso de imágenes muy grandes, <href> es una URL especial que se indexa en una pirámide de imágenes de distintas resoluciones (consulta ImagePyramid).

Para obtener más información, consulta la página "Temas en KML" en PhotoOverlay.

Elementos específicos de PhotoOverlay

<rotation>
Ajusta la ubicación de la foto dentro del campo visual. Este elemento es útil si la foto se rotó y se desvía ligeramente de la vista horizontal deseada.
<ViewVolume>
Define qué porcentaje de la escena actual está visible. Especificar el campo de visión es análogo a especificar la apertura de la lente en una cámara física. Un campo de visión pequeño, como un teleobjetivo, se enfoca en una pequeña parte de la escena. Un gran campo de visión, como una lente de gran angular, se enfoca en una gran parte de la escena.
<leftFov>
Ángulo, en grados, entre la dirección de visión de la cámara y el lado izquierdo del volumen de vista.
<rightFov>
Ángulo, en grados, entre la dirección de visión de la cámara y el lado derecho del volumen de vista.
<bottomFov>
Ángulo, en grados, entre la dirección de visión de la cámara y el lado inferior del volumen de vista.
<topFov>
Ángulo, en grados, entre la dirección de visión de la cámara y el lado superior del volumen de vista.
<near>
Se miden en metros a lo largo de la dirección de visualización desde el punto de vista de la cámara hasta la forma de PhotoOverlay.
El campo de visión de un objeto PhotoOverlay se define con cuatro planos, cada uno de los cuales está especificado por un ángulo relativo al vector de vista. Estos cuatro planos definen los lados superior, inferior, izquierdo y derecho del campo visual, que tiene la forma de una pirámide truncada, como se muestra aquí:
Los siguientes diagramas muestran los cuatro ángulos del campo de visión dentro de esta pirámide:
<ImagePyramid>
Para imágenes muy grandes, deberás construir una pirámide de imágenes, que es un conjunto jerárquico de imágenes, cada una de las cuales es una versión cada vez más baja de la imagen original. Cada imagen de la pirámide se subdivide en mosaicos, por lo que solo se deben cargar las partes visibles. Google Earth calcula el punto de vista actual y carga los mosaicos que sean adecuados para la distancia del usuario desde la imagen. A medida que el punto de vista se acerca a la Superposición de fotos, Google Earth carga mosaicos de resolución más alta. Debido a que todos los píxeles en la imagen original no se pueden ver en la pantalla a la vez, este procesamiento previo permite a Google Earth alcanzar el máximo rendimiento porque carga solo las partes de la imagen que están a la vista, y sólo los detalles de píxeles que el usuario puede distinguir en el punto de vista actual.
Cuando especificas una pirámide de imágenes, también modificas el elemento <href> del elemento <Icon> a fin de incluir las especificaciones para los que se deben cargar los mosaicos.
<tileSize>
Tamaño de los mosaicos en píxeles. Los mosaicos deben ser cuadrados y <tileSize> debe tener una potencia de 2. Se recomienda un tamaño de mosaico de 256 (predeterminado) o 512. La imagen original se divide en mosaicos de este tamaño, en diferentes resoluciones.
<maxWidth>
Ancho en píxeles de la imagen original.
<maxHeight>
Altura en píxeles de la imagen original.
<gridOrigin>
Especifica dónde se deben comenzar a numerar los mosaicos de cada capa de la pirámide. Un valor de lowerLeft especifica que la fila 1, la columna 1 de cada capa está en la esquina inferior izquierda de la cuadrícula.
<Punto>
El elemento <Point> actúa como <Point> dentro de un elemento de <Placemark>. Dibuja un ícono para marcar la posición de la superposición de fotos. El ícono dibujado se especifica en los campos <styleUrl> y <StyleSelector>, al igual que para <Placemark>.
<shape>
The PhotoOverlay se proyecta en <shape>. <shape> puede ser uno de los siguientes:

rectangle (predeterminado): para una foto común.

cilindro: para panorámicas, que pueden ser cilindros parciales o completos

sphere: para panorámicas esféricas

Ejemplo

<PhotoOverlay>
  <!-- Feature elements -->
  <name>A simple non-pyramidal photo</name>
  <description>High above the ocean</description>
  <!-- Overlay elements -->
  <Icon>
  <!-- A simple normal jpeg image -->
  <href>small-photo.jpg</href>
  </Icon>
  <!-- PhotoOverlay elements -->
  <!-- default: <rotation> default is 0 -->
  <ViewVolume>
    <near>1000</near>
    <leftFov>-60</leftFov>
    <rightFov>60</rightFov>
    <bottomFov>-45</bottomFov>
    <topFov>45</topFov>
  </ViewVolume>
  <!-- if no ImagePyramid only level 0 is shown,
       fine for a non-pyramidal image -->
  <Point>
    <coordinates>1,1</coordinates>
  </Point>
  <!-- default: <shape> -->
</PhotoOverlay>

Extiende

Contenida por

<Placemark>

Sintaxis

<Placemark id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 -->
<!-- specific to Placemark element --> <Geometry>...</Geometry> </Placemark>

Descripción

Una marca de posición es un elemento con geometría asociada. En Google Earth, un marcador aparece como un elemento de lista en el panel Lugares. Una marca de posición con un punto tiene un ícono asociado que marca un punto en la Tierra en el visor 3D. (En el visor 3D de Google Earth, el marcador es el único objeto en el que se puede hacer clic o desplazarse. Otros objetos geométricos no tienen un icono en el visor 3D. Para darle al usuario algo en el que pueda hacer clic en el visor 3D, tendrás que crear un objeto MultiGeometry que contenga tanto un Punto como el otro objeto Geometría).

Elementos específicos de la marca de posición

Ejemplo

<Placemark>
  <name>Google Earth - New Placemark</name>
  <description>Some Descriptive text.</description>
  <LookAt>
    <longitude>-90.86879847669974</longitude>
    <latitude>48.25330383601299</latitude>
    <range>440.8</range>
    <tilt>8.3</tilt>
    <heading>2.7</heading>
  </LookAt>
  <Point>
    <coordinates>-90.86948943473118,48.25450093195546,0</coordinates>
  </Point>
</Placemark>

Extiende

Contenida por

Consulta también

<Point>

Sintaxis

<Point id="ID">
  <!-- specific to Point -->
  <extrude>0</extrude>                        <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <coordinates>...</coordinates>              <!-- lon,lat[,alt] -->
</Point>

Descripción

Ubicación geográfica definida por la longitud, la latitud y la altitud (opcional). Cuando un marcador está contenido en un marcador, este determina la posición del nombre y del ícono del marcador. Cuando se extruye un punto, este se conecta al suelo con una línea. Esta conexión mediante dispositivo portátil usa el estilo de línea actual.

Elementos específicos del punto

<extrude>
Valor booleano. Especifica si se debe conectar el punto al suelo con una línea. Para extruir un punto, el valor de <altitudeMode> debe ser relativeToGround, relativeToSeaFloor o absoluta. El punto se muestra en el centro de la esfera de la Tierra.
<altitudeMode>
Especifica cómo se interpretan los componentes de altitudes en el elemento <coordinates>. Los valores posibles son los siguientes:
  • clampToGround (predeterminado) indica que debe ignorar una especificación de altitud (por ejemplo, en la etiqueta <coordinates>).
  • relativeToGround: Establece la altitud del elemento en relación con la elevación real del suelo de una ubicación específica. Por ejemplo, si la elevación del piso de una ubicación es exactamente a nivel del mar y la altitud de un punto se establece en 9 metros, la elevación para el ícono de la elevación de la marca de un punto será de 9 metros con este modo. Sin embargo, si la misma coordenada se establece en una ubicación en la que la elevación del suelo es de 10 metros sobre el nivel del mar, la elevación es de 19 metros. Un uso típico de este modo es colocar postes telefónicos o una telesilla.
  • absolute: Establece la altitud de la coordenada en relación con el nivel del mar, independientemente de la elevación real del terreno debajo del elemento. Por ejemplo, si defines una altitud de 10 metros con un modo de altitud absoluta, el ícono de marcador de posición aparecerá al nivel del suelo si el relieve inferior también se encuentra a 10 metros sobre el nivel del mar. Si el relieve se encuentra a 3 metros sobre el nivel del mar, el marcador aparecerá elevado por encima de 7 metros sobre el relieve. Un modo de uso típico de este modo es la ubicación de aviones.
<gx:altitudeMode>
Es una extensión KML en el espacio de nombres de extensiones de Google, que permite altitudes relativas al lecho marino. Los valores son los siguientes:
  • relativeToSeaFloor: Interpreta la altitud como un valor en metros sobre el lecho marino. Si el punto está sobre el suelo en lugar del mar, la altitud se interpretará como si estuviera sobre el suelo.
  • clampToSeaFloor: Se ignora la especificación de altitud, y el punto se posicionará en el lecho marino. Si el punto está en tierra en lugar de en el mar, el punto se posicionará en el suelo.
<coordinates>(obligatorio)
Es una sola tupla con valores de punto flotante para la longitud, la latitud y la altitud (en ese orden). Los valores de longitud y latitud se expresan en grados, en los que
  • longitud ≥ −180, y <= 180
  • latitude ≥ −90 y ≤ 90
  • Los valores de altitude (opcional) están en metros sobre el nivel del mar
No incluyas espacios entre los tres valores que describan una coordenada.

Ejemplo

<Point>
  <coordinates>-90.86948943473118,48.25450093195546</coordinates>
</Point>

Extiende

Contenida por

<Polygon>

Sintaxis

<Polygon id="ID">
  <!-- specific to Polygon -->
  <extrude>0</extrude>                       <!-- boolean -->
  <tessellate>0</tessellate>                 <!-- boolean -->
  <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <outerBoundaryIs>
    <LinearRing>
      <coordinates>...</coordinates>         <!-- lon,lat[,alt] -->
    </LinearRing>
  </outerBoundaryIs>
  <innerBoundaryIs>
    <LinearRing>
      <coordinates>...</coordinates>         <!-- lon,lat[,alt] -->
    </LinearRing>
  </innerBoundaryIs>
</Polygon>

Descripción

Un polígono se define mediante un límite externo y cero o más límites internos. Los límites, a su vez, se definen mediante LinearRings. Cuando se extruye un polígono, sus límites se conectan al suelo para formar polígonos adicionales, lo que da la apariencia de un edificio o caja. Los polígonos extruidos utilizan <PolyStyle> para indicar su color, modo de color y relleno.

Las <coordinates> de los polígonos se deben especificar en el sentido antihorario. Los polígonos siguen la "regla de la derecha", que indica que si colocas los dedos de la mano derecha en la dirección en la que se especifican las coordenadas, el pulgar apunta en la dirección general de la normalidad geométrica del polígono. (En los gráficos 3D, la normal geométrica se utiliza para iluminar y apunta hacia el frente del polígono). Puesto que Google Earth cubre únicamente la cara frontal de los polígonos, obtendrás el efecto deseado únicamente cuando las coordenadas estén especificadas en el orden adecuado. De lo contrario, el polígono será de color gris.

Nota: En Google Earth, un polígono con un <altitudeMode> de clampToGround sigue líneas de rumbo constante. Sin embargo, un LinearRing (por sí solo) con un <altitudeMode> de clampToGround sigue excelentes líneas de círculo.

Elementos específicos del polígono

<extrude>
Valor booleano. Especifica si se debe conectar el polígono a la tierra. Para salir de un polígono, el modo de altitud debe ser relativeToGround, relativeToSeaFloor o absoluta. Solo se eliminan los vértices, no la geometría en sí (por ejemplo, un rectángulo se convierte en un cuadro con cinco caras). Los vértices del polígono están extruidos hacia el centro de la esfera de la Tierra.
<tessellate>
Polígono usa este campo. Para permitir que un polígono siga el relieve (es decir, para habilitar la teselación), especifica un modo de altitud de clampToGround o clampToSeaFloor.
<altitudeMode>
Especifica cómo se interpretan los componentes de altitudes en el elemento <coordinates>. Los valores posibles son los siguientes:
  • clampToGround (predeterminado) indica que debe ignorar una especificación de altitud (por ejemplo, en la etiqueta <coordinates>).
  • relativeToGround: Establece la altitud del elemento en relación con la elevación real del suelo de una ubicación específica. Por ejemplo, si la elevación del piso de una ubicación es exactamente a nivel del mar y la altitud de un punto se establece en 9 metros, la elevación para el ícono de la elevación de la marca de un punto será de 9 metros con este modo. Sin embargo, si la misma coordenada se establece en una ubicación en la que la elevación del suelo es de 10 metros sobre el nivel del mar, la elevación es de 19 metros. Un uso típico de este modo es colocar postes telefónicos o una telesilla.
  • absolute: Establece la altitud de la coordenada en relación con el nivel del mar, independientemente de la elevación real del terreno debajo del elemento. Por ejemplo, si defines una altitud de 10 metros con un modo de altitud absoluta, el ícono de marcador de posición aparecerá al nivel del suelo si el relieve inferior también se encuentra a 10 metros sobre el nivel del mar. Si el relieve se encuentra a 3 metros sobre el nivel del mar, el marcador aparecerá elevado por encima de 7 metros sobre el relieve. Un modo de uso típico de este modo es la ubicación de aviones.
<gx:altitudeMode>
Es una extensión KML en el espacio de nombres de extensiones de Google, que permite altitudes relativas al lecho marino. Los valores son los siguientes:
  • relativeToSeaFloor: Interpreta la <altitude> como un valor en metros sobre el lecho marino. Si el punto está sobre el suelo en lugar del mar, la altitud se interpretará como si estuviera sobre el suelo.
  • clampToSeaFloor: Se ignora la especificación de altitud, y el punto se posicionará en el lecho marino. Si el punto está en tierra en lugar de en el mar, el punto se posicionará en el suelo.
<outerBoundaryIs>(obligatorio)
Contiene un elemento <LinearRing>.
<innerBoundaryIs>
Contiene un elemento <LinearRing>. Un polígono puede contener varios elementos <innerBoundaryIs>, que crean múltiples cortes dentro del polígono.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>Polygon.kml</name>
<open>0</open>
<Placemark>
<name>hollow box</name>
<Polygon>
<extrude>1</extrude>
<altitudeMode>relativeToGround</altitudeMode>
<outerBoundaryIs>
<LinearRing>
<coordinates>
-122.366278,37.818844,30
-122.365248,37.819267,30
-122.365640,37.819861,30
-122.366669,37.819429,30
-122.366278,37.818844,30
</coordinates>
</LinearRing>
</outerBoundaryIs>
<innerBoundaryIs>
<LinearRing>
<coordinates>
-122.366212,37.818977,30
-122.365424,37.819294,30
-122.365704,37.819731,30
-122.366488,37.819402,30
-122.366212,37.818977,30
</coordinates>
</LinearRing>
</innerBoundaryIs>
</Polygon>
</Placemark>
</Document>
</kml>

Extiende

Contenida por

<PolyStyle>

Sintaxis

<PolyStyle id="ID">
  <!-- inherited from ColorStyle -->
  <color>ffffffff</color>            <!-- kml:color -->
  <colorMode>normal</colorMode>      <!-- kml:colorModeEnum: normal or random -->

  <!-- specific to PolyStyle -->
  <fill>1</fill>                     <!-- boolean -->
  <outline>1</outline>               <!-- boolean -->
</PolyStyle>

Descripción

Especifica el estilo de dibujo de todos los polígonos, incluidas las extrusiones de polígonos (que tienen el aspecto de paredes de edificios) y las extrusiones de líneas (que tienen forma de vallas sólidas).

Elementos específicos de PolyStyle

<fill>
Valor booleano. Especifica si se debe rellenar el polígono.
<outline>
Valor booleano. Especifica si se debe contorno el polígono. Los contornos de los polígonos utilizan el estilo de línea actual.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>PolygonStyle.kml</name>
<open>1</open>
<Style id="examplePolyStyle">
<PolyStyle>
<color>ff0000cc</color>
<colorMode>random</colorMode>
</PolyStyle>
</Style>
<Placemark>
<name>hollow box</name>
<styleUrl>#examplePolyStyle</styleUrl>
<Polygon>
<extrude>1</extrude>
<altitudeMode>relativeToGround</altitudeMode>
<outerBoundaryIs>
<LinearRing>
<coordinates>
-122.3662784465226,37.81884427772081,30 -122.3652480684771,37.81926777010555,30 -122.365640222455,37.81986126286519,30 -122.36666937925,37.81942987753481,30 -122.3662784465226,37.81884427772081,30 </coordinates>
</LinearRing>
</outerBoundaryIs>
<innerBoundaryIs>
<LinearRing>
<coordinates>
-122.366212593918,37.81897719083808,30 -122.3654241733188,37.81929450992014,30 -122.3657048517827,37.81973175302663,30 -122.3664882465854,37.81940249291773,30 -122.366212593918,37.81897719083808,30 </coordinates>
</LinearRing>
</innerBoundaryIs>
</Polygon>
</Placemark>
</Document>
</kml>

Extiende

Contenida por

<Region>

Sintaxis

<Region id="ID"> 
  <LatLonAltBox>
    <north></north>                            <!-- required; kml:angle90 -->
    <south></south>                            <!-- required; kml:angle90 -->
    <east></east>                              <!-- required; kml:angle180 -->
    <west></west>                              <!-- required; kml:angle180 -->
    <minAltitude>0</minAltitude>               <!-- float -->
    <maxAltitude>0</maxAltitude>               <!-- float -->
    <altitudeMode>clampToGround</altitudeMode>
        <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
        <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  </LatLonAltBox>
  <Lod>
    <minLodPixels>0</minLodPixels>             <!-- float -->
    <maxLodPixels>-1</maxLodPixels>            <!-- float -->
    <minFadeExtent>0</minFadeExtent>           <!-- float -->
    <maxFadeExtent>0</maxFadeExtent>           <!-- float -->
  </Lod>
</Region> 

Descripción

Una región contiene un cuadro de límite (<LatLonAltBox>) que describe un área de interés definida por las coordenadas y altitudes geográficas. Además, una región contiene una extensión de nivel de detalle (<Lod>) que define un rango de validez de la región asociada en términos de tamaño de pantalla proyectada. Se dice que una región está "activa" cuando el cuadro de límite está dentro de la vista del usuario y se cumplen los requisitos del nivel de detalle. Los objetos asociados con una región solo se dibujan cuando esta está activa. Cuando <viewRefreshMode> es onRegion, el vínculo o el ícono se carga solo cuando la región está activa. Consulte la página "Temas de KML" en Regiones para obtener más información. En una jerarquía de contenedores o NetworkLink, este cálculo utiliza la región que es el principal más cercano en la jerarquía.

Elementos específicos de la región

<LatLonAltBox>(obligatorio)
Cuadro de límite que describe un área de interés definida por las coordenadas y altitudes geográficas. Los valores predeterminados y los campos obligatorios son los siguientes:
<altitudeMode> o <gx:altitudeMode>
Los valores posibles para <altitudeMode> son clampToGround, relativeToGround y absolute. Los valores posibles para <gx:altitudeMode> son clampToSeaFloor y relativeToSeaFloor. Consulta también <LatLonBox>.
<minAltitude>
Se especifica en metros (y se ve afectada por la especificación del modo de altitud).
<maxAltitude>
Se especifica en metros (y se ve afectada por la especificación del modo de altitud).
<north> (obligatorio)
Especifica la latitud del borde norte del cuadro delimitador, en grados decimales, de 0 a ±90.
<south> (obligatorio)
Especifica la latitud del borde sur del cuadro de límite, en grados decimales, de 0 a ±90.
<east> (obligatorio)
Especifica la longitud del borde este del cuadro de límite, en grados decimales, de 0 a ±180.
<west> (obligatorio)
Especifica la longitud del borde oeste del cuadro de límite, en grados decimales, de 0 a ±180.
<LatLonAltBox>
<north>43.374</north>
<south>42.983</south>
<east>-0.335</east>
<west>-1.423</west>
<minAltitude>0</minAltitude>
<maxAltitude>0</maxAltitude>
</LatLonAltBox>
<Lod>
Lod es una abreviatura de Nivel de detalle. <Lod> describe el tamaño de la región proyectada en la pantalla que se requiere para que la región se considere “activa”. También especifica el tamaño de la rampa del píxel usada para el fundido de entrada (de transparente a opaco) y el fundido de salida (de opaco a transparente). Consulta el siguiente diagrama para obtener una representación visual de estos parámetros.
<Lod>
<minLodPixels>256</minLodPixels>
<maxLodPixels>-1</maxLodPixels>
<minFadeExtent>0</minFadeExtent>
<maxFadeExtent>0</maxFadeExtent>
</Lod>
<minLodPixels> (obligatorio)

Define un cuadrado en el espacio de pantalla, con lados del valor especificado en píxeles. Por ejemplo, 128 define un cuadrado de 128 x 128 píxeles. El cuadro de límite de la región debe ser mayor que este cuadrado (y menor que el cuadrado maxLodPixels) para que la región esté activa.

Encontrarás más detalles en el capítulo Cómo trabajar con regiones de la Guía para desarrolladores, así como en el instructivo Cómo evitar la sobrecarga con regiones de la documentación de Google Earth Solidario.

<maxLodPixels>
Medición en píxeles de pantalla que representa el límite máximo del rango de visibilidad para una región determinada. Un valor de −1, el valor predeterminado, indica "activo a tamaño infinito".
<minFadeExtent</a>
La distancia sobre la que se atenúa la geometría, desde totalmente opaco hasta completamente transparente. Este valor de rampa, expresado en píxeles de pantalla, se aplica en el extremo mínimo de los límites de nivel de visibilidad (visibilidad).
<maxFadeExtent>
La distancia sobre la que se atenúa la geometría, desde totalmente transparente hasta completamente opaca. Este valor, expresado en píxeles de pantalla, se aplica en el extremo máximo de los límites de nivel de detalle (visibilidad).
En el siguiente diagrama, si P=el tamaño de píxeles proyectados calculados, los números en círculo indican lo siguiente:
if (P < minLodPixels)
  opacity=0                                 //#1 in diagram
else if(P < minLodPixels + minFadeExtent)
  opacity=(P - minLodPixels)/minFadeExtent  //#2 in diagram
else if (P < maxLodPixels - maxFadeExtent)
  opacity=1                                 //#3 in diagram
else if (P < maxLodPixels)
  opacity=(maxLodPixels-P)/maxFadeExtent    //#4 in diagram
else
  opacity=0                                 //#5 in diagram

Ejemplo de <Región>

<Region>
  <LatLonAltBox>
    <north>50.625</north>
    <south>45</south>
    <east>28.125</east>
    <west>22.5</west>
    <minAltitude>10</minAltitude>
    <maxAltitude>50</maxAltitude>
  </LatLonAltBox>
  <Lod>
    <minLodPixels>128</minLodPixels>
    <maxLodPixels>1024</maxLodPixels>
    <minFadeExtent>128</minFadeExtent>
    <maxFadeExtent>128</maxFadeExtent>
  </Lod>
</Region> 

Extiende

Contenida por

<Esquema>

Sintaxis

<Schema name="string" id="ID">
  <SimpleField type="string" name="string">
    <displayName>...</displayName>            <!-- string -->
  </SimpleField>
</Schema>

Descripción

Especifica un esquema KML personalizado que se utiliza para agregar datos personalizados a las funciones KML. El atributo "id" es obligatorio y debe ser único dentro del archivo KML. <Schema> siempre es un elemento secundario de <Document>.

Elementos específicos del esquema

Un elemento de esquema contiene uno o más elementos SimpleField. En SimpleField, el esquema declara el type y el name del campo personalizado. De manera opcional, especifica un displayName (el formulario fácil de usar, con espacios y puntuación adecuada utilizada para mostrarse en Google Earth) para este campo personalizado.

<SimpleField type="string" name="string">
La declaración del campo personalizado, que debe especificar el type y el name de este campo. Si se omite type o name, el campo se ignora. El type puede ser uno de los siguientes:
  • string
  • int
  • uint
  • short
  • ushort
  • float
  • double
  • bool
<displayName>
El nombre, si corresponde, que se usará cuando se muestre el nombre del campo al usuario de Google Earth. Usa el elemento [CDATA] para escapar del lenguaje de marcado HTML estándar.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<Schema name="TrailHeadType" id="TrailHeadTypeId"> <SimpleField type="string" name="TrailHeadName"> <displayName><![CDATA[<b>Trail Head Name</b>]]></displayName> </SimpleField> <SimpleField type="double" name="TrailLength"> <displayName><![CDATA[<i>The length in miles</i>]]></displayName> </SimpleField> <SimpleField type="int" name="ElevationGain"> <displayName><![CDATA[<i>change in altitude</i>]]></displayName> </SimpleField> </Schema>
</Document>
</kml>

Extiende

Este es un elemento raíz.

Contenida por

Consulta también

<ScreenOverlay>

Sintaxis

<ScreenOverlay id="ID">
  <!-- inherited from Feature element -->
  <name>...</name>                      <!-- string -->
  <visibility>1</visibility>            <!-- boolean -->
  <open>0</open>                        <!-- boolean -->
  <atom:author>...<atom:author>         <!-- xmlns:atom -->
  <atom:link href=" "/>                <!-- xmlns:atom -->
  <address>...</address>                <!-- string -->
  <xal:AddressDetails>...</xal:AddressDetails>  <!-- xmlns:xal -->
<phoneNumber>...</phoneNumber> <!-- string -->
<Snippet maxLines="2">...</Snippet> <!-- string --> <description>...</description> <!-- string --> <AbstractView>...</AbstractView> <!-- Camera or LookAt --> <TimePrimitive>...</TimePrimitive> <styleUrl>...</styleUrl> <!-- anyURI --> <StyleSelector>...</StyleSelector> <Region>...</Region> <Metadata>...</Metadata> <!-- deprecated in KML 2.2 --> <ExtendedData>...</ExtendedData> <!-- new in KML 2.2 --> <!-- inherited from Overlay element --> <color>ffffffff</color> <!-- kml:color --> <drawOrder>0</drawOrder> <!-- int --> <Icon>...</Icon> <!-- specific to ScreenOverlay --> <overlayXY x="double" y="double" xunits="fraction" yunits="fraction"/> <!-- vec2 --> <!-- xunits and yunits can be one of: fraction, pixels, or insetPixels --> <screenXY x="double" y="double" xunits="fraction" yunits="fraction"/> <!-- vec2 --> <rotationXY x="double" y="double" xunits="fraction" yunits"fraction"/> <!-- vec2 --> <size x="double" y="double" xunits="fraction" yunits="fraction"/> <!-- vec2 --> <rotation>0</rotation> <!-- float --> </ScreenOverlay>

Descripción

Este elemento dibuja una superposición de imágenes fija en la pantalla. Algunos ejemplos de usos de ScreenOverlay son brújulas, logotipos y avisos emergentes. El tamaño de ScreenOverlay está determinado por el elemento <size>. La posición de la superposición se controla asignando un punto en la imagen especificado por <overlayXY> a un punto de la pantalla especificado por <screenXY>. Luego, la imagen gira a <rotation> grados aproximadamente sobre un punto relativo a la pantalla especificada por <rotationXY>.

El elemento secundario <href> de <Icon> especifica la imagen que se utilizará como superposición. Este archivo puede estar en un sistema de archivos local o en un servidor web. Si se omite este elemento o no contiene <href>, se dibujará un rectángulo con el color y el tamaño definidos por la superposición de pantalla.

Elementos específicos de ScreenOverlay

<overlayXY>
Especifica un punto (o fuera de) la imagen superpuesta que está asignada a la coordenada de la pantalla (<screenXY>). Requiere los valores x e y, y las unidades de esos valores.
Los valores x y y se pueden especificar de tres formas diferentes: como píxeles ("pixels"), como fracciones de la imagen ("fraction") o como píxeles de inserción ("insetPixels"), que es un desplazamiento de píxeles desde la esquina superior derecha de la imagen. Las posiciones x e y pueden especificarse de distintas maneras; por ejemplo, x puede estar en píxeles y y puede ser una fracción. El origen del sistema de coordenadas se encuentra en la esquina inferior izquierda de la imagen.
  • x: La cantidad de píxeles, un componente fraccionario de la imagen o una inserción de píxeles que indica el componente x de un punto en la imagen superpuesta.
  • y: La cantidad de píxeles, un componente fraccionario de la imagen o una inserción de píxeles que indica el componente y de un punto en la imagen superpuesta.
  • xunits: Unidades en las que se especifica el valor x. Un valor de "fraction" indica que el valor x es una fracción de la imagen. Un valor de "pixels" indica el valor x en píxeles. Un valor de "insetPixels" indica la sangría del borde derecho de la imagen.
  • yunidades: Unidades en las que se especifica el valor y. Un valor de "fraction" indica que el valor y es una fracción de la imagen. Un valor de "pixels" indica el valor y en píxeles. Un valor de "insetPixels" indica la sangría del borde superior de la imagen.
<screenXY>
Especifica un punto relativo al origen de la pantalla al que se asigna la imagen superpuesta. Los valores x e y se pueden especificar de tres maneras diferentes: como píxeles ("pixels"), como fracciones de la pantalla ("fraction") o píxeles incorporados("insetPixels"), que es un desplazamiento en píxeles desde la esquina superior derecha de la pantalla. Las posiciones x e y pueden especificarse de distintas maneras; por ejemplo, x puede estar en píxeles y y puede ser una fracción. El origen del sistema de coordenadas se encuentra en la esquina inferior izquierda de la pantalla.
  • x: La cantidad de píxeles, un componente fraccionario de la pantalla o una inserción de píxeles que indica el componente x de un punto en la pantalla.
  • y: La cantidad de píxeles, un componente fraccionario de la pantalla o una inserción de píxeles que indica el componente y de un punto en la pantalla.
  • xunits: Unidades en las que se especifica el valor x. Un valor de "fraction" indica que el valor x es una fracción de la pantalla. Un valor de "pixels" indica el valor x en píxeles. Un valor de "insetPixels" indica la sangría del borde derecho de la pantalla.
  • yunidades: Unidades en las que se especifica el valor y. Un valor de fracción indica que el valor y es una fracción de la pantalla. Un valor de "pixels" indica el valor y en píxeles. Un valor de "insetPixels" indica la sangría desde el borde superior de la pantalla.
Por ejemplo, <screenXY x=".5" y=".5" xunits="fraction" yunits="fraction"/> indica un punto en el medio de la pantalla.
Estos son algunos ejemplos:

Centra la imagen:

<ScreenOverlay>
  <overlayXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
  <screenXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
</ScreenOverlay>

Coloca la imagen en la parte superior izquierda:

<ScreenOverlay>
  <overlayXY x="0" y="1" xunits="fraction" yunits="fraction"/>
  <screenXY x="0" y="1" xunits="fraction" yunits="fraction"/>
</ScreenOverlay> 

Coloca la imagen a la derecha de la pantalla:

<ScreenOverlay>
  <overlayXY x="1" y="1" xunits="fraction" yunits="fraction"/>
  <screenXY x="1" y="1" xunits="fraction" yunits="fraction"/>
</ScreenOverlay>  
<rotationXY>
Apunta a la pantalla alrededor de la que se rota la superposición.
<size>
Especifica el tamaño de la imagen para la superposición de la pantalla de la siguiente manera:
  • Un valor de −1 indica que se debe usar la dimensión nativa
  • El valor 0 indica que se debe mantener la proporción.
  • Un valor de n establece el valor de la dimensión
Por ejemplo:

Para forzar que la imagen conserve las dimensiones originales de x y de y, establece los valores en −1:

<size x="-1" y="-1" xunits="fraction" yunits="fraction"/> 

Para forzar que la imagen conserve su dimensión horizontal, pero que ocupe un 20% del espacio vertical de la pantalla:

<size x="-1" y="0.2" xunits="fraction" yunits="fraction"/> 

Para forzar el cambio de tamaño de la imagen a 100 x 500 píxeles, haz lo siguiente:

<size x="100" y="500" xunits="pixels" yunits="pixels"/> 
<rotation>
Indica el ángulo de rotación del objeto principal. Un valor de 0 significa que no hay rotación. El valor es un ángulo, en grados, a la izquierda, que comienza desde el norte. Usa ±180 para indicar la rotación del objeto principal desde 0. El centro de la <rotación>, si no es (.5,.5), se especifica en <rotaciónXY>.

Ejemplo

En el siguiente ejemplo, se coloca una imagen en el centro exacto de la pantalla, mediante el ancho, la altura y la relación de aspecto originales.

<ScreenOverlay id="khScreenOverlay756">
  <name>Simple crosshairs</name>
  <description>This screen overlay uses fractional positioning
   to put the image in the exact center of the screen</description>
  <Icon>
    <href>http://myserver/myimage.jpg</href>
  </Icon>
  <overlayXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
  <screenXY x="0.5" y="0.5" xunits="fraction" yunits="fraction"/>
  <rotation>39.37878630116985</rotation>
  <size x="0" y="0" xunits="pixels" yunits="pixels"/>
</ScreenOverlay>

Extiende

Contenida por

<Style>

Sintaxis

<Style id="ID">
<!-- extends StyleSelector -->

<!-- specific to Style -->
  <IconStyle>...</IconStyle>
  <LabelStyle>...</LabelStyle>
  <LineStyle>...</LineStyle>
  <PolyStyle>...</PolyStyle>
  <BalloonStyle>...</BalloonStyle>
  <ListStyle>...</ListStyle>
</Style>

Descripción

Un estilo define un grupo de estilos que se puede abordar y al que StyleMaps y sus funciones pueden hacer referencia. Los estilos afectan el modo en que se presenta la geometría en el visor 3D y la manera en que los elementos aparecen en el panel Lugares de la vista de lista. Los estilos compartidos se recopilan en un <Document> y deben tener un id definido para que se pueda hacer referencia a ellos mediante las funciones individuales que los usan.

Use un id para hacer referencia al estilo de una <styleUrl>.

Ejemplo

<Document>
  <!-- Begin Style Definitions -->
  <Style id="myDefaultStyles">
    <IconStyle>
      <color>a1ff00ff</color>
      <scale>1.399999976158142</scale>
      <Icon>
        <href>http://myserver.com/icon.jpg</href>
      </Icon>
    </IconStyle>
    <LabelStyle>
      <color>7fffaaff</color>
      <scale>1.5</scale>
    </LabelStyle>
    <LineStyle>
      <color>ff0000ff</color>
      <width>15</width>
    </LineStyle>
    <PolyStyle>
      <color>7f7faaaa</color>
      <colorMode>random</colorMode>
    </PolyStyle>
  </Style>
  <!-- End Style Definitions -->
  <!-- Placemark #1 -->
  <Placemark>
    <name>Google Earth - New Polygon</name>
    <description>Here is some descriptive text</description>
    <styleUrl>#myDefaultStyles</styleUrl>
    . . .
  </Placemark>
  <!-- Placemark #2 -->
  <Placemark>
    <name>Google Earth - New Path</name>
    <styleUrl>#myDefaultStyles</styleUrl>
      . . . .
  </Placemark>
</Document>
</kml>

Extiende

Contenida por

Elementos específicos para el estilo

<StyleMap>

Sintaxis

<StyleMap id="ID">
  <!-- extends StyleSelector -->
  <!-- elements specific to StyleMap -->
  <Pair id="ID">
    <key>normal</key>              <!-- kml:styleStateEnum:  normal or highlight -->
    <styleUrl>...</styleUrl> or <Style>...</Style>
  </Pair>
</StyleMap>

Descripción

Un <StyleMap> se asigna entre dos estilos diferentes. Normalmente, un elemento <StyleMap> se utiliza para proporcionar estilos normales normales y destacados para un marcador, de modo que la versión resaltada aparezca cuando el usuario pase el mouse sobre el ícono en Google Earth.

Elementos específicos de StyleMap

<Pair>(obligatorio)
Define un par clave-valor que asigna un modo (normal o highlight) al <styleUrl> predefinido. <Pair> contiene dos elementos (ambos son obligatorios):
  • <key>, que identifica la clave
  • <styleUrl> o <Style>, que hace referencia al estilo En <styleUrl>, para los elementos de estilo de referencia que son locales del documento KML se utiliza un simple # de referencia. Para los estilos que se encuentran en archivos externos, usa una URL completa junto con # referencia. Por ejemplo:
<Pair> 
  <key>normal</key>
  <styleUrl>http://myserver.com/populationProject.xml#example_style_off</styleUrl>
</Pair> 

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">
<Document>
<name>StyleMap.kml</name>
<open>1</open>
<Style id="normalState">
<IconStyle>
<scale>1.0</scale>
<Icon>
<href>http://maps.google.com/mapfiles/kml/pal3/icon55.png</href>
</Icon>
</IconStyle>
<LabelStyle>
<scale>1.0</scale>
</LabelStyle>
</Style>
<Style id="highlightState">
<IconStyle>
<Icon>
<href>http://maps.google.com/mapfiles/kml/pal3/icon60.png</href>
</Icon>
<scale>1.1</scale>
</IconStyle>
<LabelStyle>
<scale>1.1</scale>
<color>ff0000c0</color>
</LabelStyle>
</Style>
<StyleMap id="styleMapExample">
<Pair>
<key>normal</key>
<styleUrl>#normalState</styleUrl>
</Pair>
<Pair>
<key>highlight</key>
<styleUrl>#highlightState</styleUrl>
</Pair>
</StyleMap>
<Placemark>
<name>StyleMap example</name>
<styleUrl>#styleMapExample</styleUrl>
<Point>
<coordinates>-122.368987,37.817634,0</coordinates>
</Point>
</Placemark>
</Document>
</kml>

Extiende

Contenida por

<StyleSelector>

Sintaxis

<!-- abstract element; do not create -->
<!-- StyleSelector id="ID" -->                 <!-- Style,StyleMap -->
<!-- /StyleSelector -->

Descripción

Este es un elemento abstracto y no se puede utilizar directamente en un archivo KML. Es el tipo de base para los elementos <Style> y <StyleMap>. El elemento StyleMap selecciona un estilo en función del modo actual de la marca de posición. Un elemento derivado de StyleSelector se identifica de forma única por su id y su url.

Elementos específicos de StyleSelector

Este elemento abstracto no contiene ningún elemento secundario.

Extiende

Extendido por

<TimePrimitive>.

Sintaxis

<!-- abstract element; do not create -->
<!-- TimePrimitive id="ID" -->            <!-- TimeSpan,TimeStamp -->
  <!-- extends Object -->
<!-- /TimePrimitive -->

Descripción

Este es un elemento abstracto y no se puede utilizar directamente en un archivo KML. Los elementos <TimeSpan> y <TimeStamp> extienden este elemento.

Extiende

Extendido por

<TimeSpan>

Sintaxis

<TimeSpan id="ID">
  <begin>...</begin>     <!-- kml:dateTime -->
  <end>...</end>         <!-- kml:dateTime -->
</TimeSpan>

Descripción

Representa una extensión de tiempo limitada por dateTimes de comienzo y finalización.

Si falta <begin> o <end>, entonces ese final del período no está delimitado (consulta el ejemplo a continuación).

El valor dateTime se define según el horario del esquema XML (consulta la Parte 2 del esquema XML: tipos de datos de segunda edición). El valor se puede expresar como aaaa-mm-ddThh:mm:ss.ssszzzzzz, donde T es el separador entre la fecha y la hora, y la zona horaria es Z (para UTC) o zzzzzz, que representa ±hh:mm en relación con UTC. Además, el valor se puede expresar solo como fecha. Consulta <TimeStamp> para ver ejemplos.

Elementos específicos de TimeSpan

<begin>
Describe el instante inicial de un período. Si está ausente, el comienzo del período es ilimitado.
<end>
Describe el instante final de un período. Si está ausente, el final del período es ilimitado.

Ejemplo

En el siguiente ejemplo, se muestra el período que representa el estado de Colorado. Contiene solo una etiqueta <begin> porque Colorado se convirtió en un estado el 1 de agosto de 1876 y sigue siendo un estado:

<Placemark>
  <name>Colorado</name>
  .
  .
  .
  <TimeSpan>
    <begin>1876-08-01</begin>
  </TimeSpan>
</Placemark>

Extiende

Contenida por

<TimeStamp>

Sintaxis

<TimeStamp id="ID">
  <when>...</when>      <!-- kml:dateTime -->
</TimeStamp> 

Descripción

Representa un momento específico. Este es un elemento simple y no contiene elementos secundarios. Su valor es un dateTime, especificado en horario XML (consulta Esquema XML, parte 2: tipos de datos de segunda edición). La precisión de TimeStamp se determina según el valor dateTime del elemento <when>.

Elementos específicos de TimeStamp

<when>
Especifica un solo momento. El valor es un dateTime, que puede ser uno de los siguientes:
  • dateTime brinda una segunda resolución.
  • date representa la resolución del día
  • gYearMonth proporciona una resolución mensual.
  • gYear ofrece una resolución de año

En los siguientes ejemplos, se muestran diferentes resoluciones para el valor <when>:

  • gYear (YYYY)
<TimeStamp>
  <when>1997</when>
</TimeStamp>
  • gYearMonth (YYYY-MM)
<TimeStamp>
  <when>1997-07</when>
</TimeStamp> 
  • date (AAAA-MM-DD)
<TimeStamp>
  <when>1997-07-16</when>
</TimeStamp> 
  • dateTime (YYYY-MM-DDThh:mm:ssZ)
    Aquí, T es el separador entre el calendario y la notación de hora por hora, y Z indica UTC. (Los segundos son obligatorios).
<TimeStamp>
  <when>1997-07-16T07:30:15Z</when>
</TimeStamp>
  • dateTime (YYYY-MM-DDThh:mm:sszzzzzz)
    En este ejemplo, se muestra la hora local y, luego, la conversión de ± a UTC.
<TimeStamp>
  <when>1997-07-16T10:30:15+03:00</when>
</TimeStamp>

Extiende

Contenida por

<gx:TimeSpan> y <gx:TimeStamp>

Este elemento es una extensión del estándar KML 2.2 de OGC y es compatible con Google Earth 5.0 y versiones posteriores. Más información

Una copia de los elementos <TimeSpan> y <TimeStamp>, en el espacio de nombres de la extensión. Esto permite la inclusión de valores de tiempo en AbstractViews (<Camera> y <LookAt>). Los valores de tiempo se usan para controlar las imágenes históricas, la luz solar y la visibilidad de los atributos con marca de tiempo.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">

  <Document>
    <name>Views with Time</name>
    <open>1</open>
    <description>
      In Google Earth, enable historical imagery and sunlight,
      then click on each placemark to fly to that point in time.
    </description>

    <Placemark>
      <name>Sutro Baths in 1946</name>
      <Camera>
        <gx:TimeStamp>
          <when>1946-07-29T05:00:00-08:00</when>
        </gx:TimeStamp>
        <longitude>-122.518172</longitude>
        <latitude>37.778036</latitude>
        <altitude>221.0</altitude>
        <heading>70.0</heading>
        <tilt>75.0</tilt>
      </Camera>
    </Placemark>

    <Placemark>
      <name>Palace of Fine Arts in 2002</name>
      <Camera>
        <gx:TimeStamp>
          <when>2002-07-09T19:00:00-08:00</when>
        </gx:TimeStamp>
        <longitude>-122.444633</longitude>
        <latitude>37.801899</latitude>
        <altitude>139.629438</altitude>
        <heading>-70.0</heading>
        <tilt>75</tilt>
      </Camera>
    </Placemark>

  </Document>
</kml>

<gx:Recorrido

Este elemento es una extensión del estándar KML 2.2 de OGC y es compatible con Google Earth 5.0 y versiones posteriores. Más información

Sintaxis

<gx:Tour id="ID">
  <name>...</name>
  <description>...</description>
  <gx:Playlist>

    <!-- any number of gx:TourPrimitive elements -->

  </gx:Playlist>
</gx:Tour>

Descripción

<gx:Tour> puede contener un solo elemento <gx:Playlist>, que, a su vez, contiene una lista ordenada de elementos gx:TourPrimitive que definen un viaje en cualquier navegador KML. Obtén más información sobre las visitas guiadas.

Ejemplo

Puedes encontrar varios ejemplos de visitas guiadas en el capítulo Viajes de la Guía para programadores de KML.

Contenido

  • gx:Playlist: contiene cualquier cantidad de elementos gx:TourPrimitive. Puede haber cero o un elemento <gx:Playlist> dentro de un elemento <gx:Tour>.
    <gx:Tour>
      <gx:Playlist>
        <!-- gx:TourPrimitive -->
          ...
        <!-- /gx:TourPrimitive -->
    
        <!--- Any number of gx:TourPrimitive elements can be included --->
      </gx:Playlist>
    </gx:Tour>

<gx:TourPrimitive>

Este elemento es una extensión del estándar KML 2.2 de OGC y es compatible con Google Earth 5.0 y versiones posteriores. Más información

Sintaxis

<gx:Tour>
  <gx:Playlist>

    <!-- abstract element; do not create -->
    <!-- gx:TourPrimitive -->    <!-- gx:AnimatedUpdate, gx:FlyTo, gx:TourControl, gx:SoundCue, gx:Wait -->
        <!-- extends Object -->
    <!-- /gx:TourPrimitive -->

  </gx:Playlist>
</gx:Tour>

Descripción

Este es un elemento abstracto y no se puede utilizar directamente en un archivo KML. Los elementos <gx:FlyTo>, <gx:AnimatedUpdate>, <gx:TourControl>, <gx:Wait> y <gx:SoundCue> extienden este elemento.

Los elementos que se extienden desde gx:TourPrimitive proporcionan instrucciones a los navegadores KML durante los viajes, incluidos los puntos para llegar a destino y la duración de esos vuelos, pausas, actualizaciones de las funciones KML y archivos de sonido para reproducir.

Estos elementos deben incluirse en un elemento <gx:Playlist>, que, a su vez, está contenido en un elemento <gx:Tour>.

Ejemplo

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2">

  <Document>
    <name>gx:AnimatedUpdate example</name>
    <open>1</open>

    <Style>
      <IconStyle id="iconstyle">
        <scale>1.0</scale>
      </IconStyle>
    </Style>

    <Placemark id="mountainpin1">
      <name>New Zealand's Southern Alps</name>
      <styleUrl>#style</styleUrl>
      <Point>
        <coordinates>170.144,-43.605,0</coordinates>
      </Point>
    </Placemark>

    <gx:Tour>
      <name>Play me!</name>
      <gx:Playlist>

        <!-- The order and duration of TourPrimitives is important;
             in this example, the AnimatedUpdate needs
             6.5 seconds to complete. The FlyTo provides 4.1,
             and the Wait 2.4, giving the update time to
             complete before the Tour ends. AnimatedUpdates
             don't hold Tours open, but FlyTos and Waits do.

             For more information, refer to:
             http://developers.google.com/kml/documentation/touring#tourtimelines
        -->

        <gx:AnimatedUpdate>
          <gx:duration>6.5</gx:duration>
          <Update>
            <targetHref></targetHref>
            <Change>
                <IconStyle targetId="iconstyle">
                  <scale>10.0</scale>
                </IconStyle>
            </Change>
          </Update>
        </gx:AnimatedUpdate>

        <gx:FlyTo>
          <gx:duration>4.1</gx:duration>
          <Camera>
            <longitude>170.157</longitude>
            <latitude>-43.671</latitude>
            <altitude>9700</altitude>
            <heading>-6.333</heading>
            <tilt>33.5</tilt>
            <roll>0</roll>
          </Camera>
        </gx:FlyTo>

        <gx:Wait>
          <gx:duration>2.4</gx:duration>  <!-- waiting for the AnimatedUpdate to complete -->
        </gx:Wait>

      </gx:Playlist>
    </gx:Tour>
  </Document>
</kml>

Contenida por

Extendido por

  • <gx:AnimatedUpdate>
  • <gx:FlyTo>
  • <gx:SoundCue>
    <gx:SoundCue id="ID">
      <href>http://www.example.com/audio/trumpets.mp3</href>   <!-- any URI -->
      <gx:delayedStart>0</gx:delayedStart>                     <!-- double -->
    </gx:SoundCue>
    Contiene un elemento <href> que especifica un archivo de sonido para reproducir en formato MP3, M4A o AAC. No contiene una duración. El archivo de sonido se reproduce en paralelo con el resto del viaje, lo que significa que el siguiente recorrido básico tendrá lugar inmediatamente después de alcanzar el primitivo del viaje <gx:SoundCue>. Si otro archivo de sonido está en fila antes de que el primero haya terminado de reproducirse, los archivos se mezclan. El elemento <gx:delayedStart> especifica para retrasar el inicio del sonido durante una cantidad determinada de segundos antes de reproducir el archivo.
  • <gx:TourControl>
    <gx:TourControl id="ID">
      <gx:playMode>pause</gx:playMode>    <!-- gx:playModeEnum: pause -->
    </gx:TourControl>
    Contiene un solo elemento <gx:playMode>, que permite pausar el viaje hasta que un usuario realice una acción para continuarlo.
  • <gx:Wait>
    <gx:Wait id="ID">
      <gx:duration>0.0</gx:duration>    <!-- double -->
    </gx:Wait>
    La cámara permanece quieta, en el último gx:AbstractView definido, por la cantidad de segundos especificados antes de reproducir el siguiente gx:TourPrimitive. Ten en cuenta que la espera no detiene el cronograma del viaje. Los archivos de sonido que se estén reproduciendo y las actualizaciones animadas seguirán reproduciéndose mientras la cámara espera.

Extiende

<gx:Seguimiento>

Este elemento es una extensión del estándar KML 2.2 de OGC y es compatible con Google Earth 5.2 y versiones posteriores. Más información

Sintaxis

<gx:Track id="ID">
  <!-- specific to Track -->
  <altitudeMode>clampToGround</altitudeMode>
      <!-- kml:altitudeModeEnum: clampToGround, relativeToGround, or absolute -->
      <!-- or, substitute gx:altitudeMode: clampToSeaFloor, relativeToSeaFloor -->
  <when>...</when>                         <!-- kml:dateTime -->
  <gx:coord>...</gx:coord>                 <!-- string -->
  <gx:angles>...</gx:angles>               <!-- string -->
  <Model>...</Model>
  <ExtendedData>
    <SchemaData schemaUrl="anyURI">
      <gx:SimpleArrayData kml:name="string">
        <gx:value>...</gx:value>            <!-- string -->
      </gx:SimpleArrayData>
    <SchemaData>
  </ExtendedData>
</gx:Track>

Descripción

Un seguimiento describe cómo un objeto se mueve por el mundo durante un período determinado. Esta función te permite crear un objeto visible en Google Earth (ya sea un icono de Punto o un Modelo) que codifica múltiples posiciones para el mismo objeto varias veces. En Google Earth, el deslizador de tiempo permite al usuario mover la vista a través del tiempo, lo cual anima la posición del objeto.

Un elemento gx:MultiTrack se usa para recopilar múltiples pistas en una unidad conceptual con un ícono (o modelo) asociado que se mueve a lo largo de la pista. Esta función es útil si tienes varias pistas para el mismo objeto real. El elemento booleano <gx:interpolate> de <gx:MultiTrack> especifica si se deben interpolar entre las pistas de una pista múltiple. Si este valor es 0, el punto o modelo se detiene al final de una pista y salta al inicio de la siguiente. (Por ejemplo, si deseas que una sola marca de posición represente tus viajes en dos días y que tu unidad de GPS se desactive durante cuatro horas durante este período, debes mostrar una discontinuidad entre los puntos en los que se desactivó la unidad y, luego, se volvió a activar). Si el valor de <gx:interpolate> es 1, los valores entre el final de la primera pista y el comienzo de la siguiente pista se interpolan para que la pista aparezca como una única ruta continua.

Consulta la Guía del usuario de Google Earth para obtener información sobre cómo importar datos GPS a Google Earth.

¿Por qué son útiles las pistas?

Las versiones anteriores de KML (anteriores a Google Earth 5.2) te permiten asociar un elemento temporal con cualquier elemento (marca de posición, superposición de suelo, etc.). Sin embargo, solo puedes asociar un elemento de tiempo con un elemento determinado. Los seguimientos son un mecanismo más eficiente para asociar datos de tiempo con elementos visibles, ya que creas solo un atributo, que puede asociarse con varios elementos de tiempo a medida que el objeto se mueve por el espacio.

Además, el elemento de seguimiento es más eficaz que el mecanismo anterior (descrito en el capítulo Tiempo y animación de la Guía para programadores de KML) debido a que <Track> proporciona un mecanismo para interpolar la posición del objeto en cualquier momento a lo largo del recorrido. Con esta nueva función, Google Earth muestra un gráfico de perfiles de elevación y velocidad (más datos personalizados, si existen) para el objeto a lo largo del tiempo.

Datos "dispersos"

Cuando faltan valores de datos para posiciones en la pista, se pueden proporcionar etiquetas <coord/> (<coord></coord>) o <angles/> (<angles></angles>) vacías a fin de equilibrar las matrices. Una etiqueta <coord/> o <angles/> vacía indica que no existen tales datos para un dato dado, y que el valor debe interpolarse entre los dos puntos de datos bien especificados más cercanos. Este comportamiento también se aplica a ExtendedData para una pista. Todos los elementos, excepto <when>, pueden estar vacíos y se interpolarán entre los dos elementos bien especificados que se encuentren más cerca.

Elementos específicos del seguimiento

<altitudeMode>
Especifica cómo se interpretan los componentes de altitudes en el elemento <coordinates>. Los valores posibles son los siguientes:
  • clampToGround (predeterminado) indica que debe ignorar una especificación de altitud (por ejemplo, en la etiqueta <gx:coord>).
  • relativeToGround: Establece la altitud del elemento en relación con la elevación real del suelo de una ubicación específica. Por ejemplo, si la elevación del piso de una ubicación es exactamente a nivel del mar y la altitud de un punto se establece en 9 metros, la elevación para el ícono de la elevación de la marca de un punto será de 9 metros con este modo. Sin embargo, si la misma coordenada se establece en una ubicación en la que la elevación del suelo es de 10 metros sobre el nivel del mar, la elevación es de 19 metros.
  • absolute: Establece la altitud de la coordenada en relación con el nivel del mar, independientemente de la elevación real del terreno debajo del elemento. Por ejemplo, si defines una altitud de 10 metros con un modo de altitud absoluta, el ícono de marcador de posición aparecerá al nivel del suelo si el relieve inferior también se encuentra a 10 metros sobre el nivel del mar. Si el relieve se encuentra a 3 metros sobre el nivel del mar, el marcador aparecerá elevado por encima de 7 metros sobre el relieve.
<gx:altitudeMode>
Es una extensión KML en el espacio de nombres de extensiones de Google, que permite altitudes relativas al lecho marino. Los valores son los siguientes:
  • relativeToSeaFloor: Interpreta la altitud como un valor en metros sobre el lecho marino. Si el punto está sobre el suelo en lugar del mar, la altitud se interpretará como si estuviera sobre el suelo.
  • clampToSeaFloor: Se ignora la especificación de altitud, y el punto se posicionará en el lecho marino. Si el punto está en tierra en lugar de en el mar, el punto se posicionará en el suelo.
<cuándo>
Un valor de time que corresponde a una position (especificada en un elemento <gx:coord>). La cantidad de elementos <when> en un elemento <Track> debe ser igual a la cantidad de elementos <gx:coord> (y elementos <gx:angles>, si se incluyen).
<gx:coord>
Es un valor de coordenadas que consta de tres valores para la longitud, la latitud y la altitud, sin separadores de coma. Por ejemplo:
<gx:coord>-122.207881 37.371915 156.000000</gx:coord>

Ten en cuenta que la sintaxis del elemento <gx:coord> es diferente de la sintaxis del elemento <coordinates>, que utiliza comas para separar los componentes de longitud, latitud y altitud. La cantidad de elementos especificados debe ser igual a la cantidad de tiempo () y elementos de posición (). Puedes especificar un elemento <gx:coord> vacío para un valor faltante si es necesario.

<gx:angles>
Este valor se usa para especificar un valor adicional de orientación, inclinación y lanzamiento para el ícono o el modelo de cada hora o posición dentro de la pista. Los tres valores de punto flotante se enumeran sin separadores de coma y representan grados de rotación. Si no se especifica <gx:angles>, Google Earth inferirá la orientación, la inclinación y el desplazamiento del objeto a partir de su seguimiento. La cantidad de elementos <gx:angles> especificados debe ser igual a la cantidad de elementos de tiempo (<when>) y de posición (<gx:coord>). Puedes especificar un elemento <gx:angles> vacío para un valor faltante si es necesario.

Actualmente, los íconos solo admiten encabezados, pero los modelos admiten los tres valores.

Este es un ejemplo de cómo establecer este valor:

<gx:angles>45.54676 66.2342 77.0</gx:angles>
<Modelo>
Si se especifica, el modelo reemplaza al ícono del punto que se usa para indicar la posición actual en la pista. Cuando se especifica un <Model> en <gx:Track>, los elementos secundarios de la función <Model> se muestran de la siguiente manera:
  • Se ignora el elemento <Location>.
  • Se ignora el elemento <altitudeMode>.
  • El valor de <Orientation> se combina con la orientación de la pista de la siguiente manera. Primero, se aplica la rotación <Orientation>, que traslada el modelo de su sistema de coordenadas local (x, y, z) a la orientación orientada hacia el norte. Luego, se aplica una rotación que corresponde a la interpolación de los valores <gx:angles> que afectan la orientación, la inclinación y el giro del modelo a medida que se mueve a lo largo del recorrido. Si no se especifican ángulos, la orientación y la inclinación se deducen del movimiento del modelo.

    Sugerencia: si no estás seguro de cómo especificar la orientación, omite el elemento <Orientation> de <Model> y observa cómo Google Earth posiciona el modelo a medida que se mueve a lo largo del recorrido. Si observa que el frente del modelo está orientado hacia el costado, modifique el elemento <heading> en <Orientation> para rotar el modelo de modo que apunte al frente. Si el modelo no está derecho, intenta modificar los elementos <tilt> o <roll>.

<ExtendedData>

Elementos de datos personalizados que se definieron en un <Schema> anteriormente en el archivo KML.

A menudo, es útil agregar datos extendidos asociados con cada intervalo de tiempo o posición en una pista. Los viajes en bicicleta, por ejemplo, pueden incluir datos de ritmo cardíaco, cadencia y potencia, como se muestra en Ejemplo de seguimiento con datos extendidos. En <Schema>, define un <gx:SimpleArrayField> para cada tipo de datos personalizado. Luego, para cada tipo de datos, incluye un elemento <gx:SimpleArrayData> que contenga elementos <gx:value> que correspondan a cada hora o posición en la pista. Consulte el capítulo Cómo agregar datos personalizados de la Guía para programadores de KML a fin de obtener más información sobre cómo agregar nuevos campos de datos. En Google Earth, los datos personalizados se muestran en el perfil de elevación de la ruta.

Ejemplo simple

En este ejemplo muy básico, se muestra cómo crear "arreglos" paralelos para los valores <when> y <gx:coord>. La cantidad de valores de tiempo y posición debe ser igual.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
 xmlns:gx="http://www.google.com/kml/ext/2.2">
<Folder>
  <Placemark>
    <gx:Track>
      <when>2010-05-28T02:02:09Z</when>
      <when>2010-05-28T02:02:35Z</when>
      <when>2010-05-28T02:02:44Z</when>
      <when>2010-05-28T02:02:53Z</when>
      <when>2010-05-28T02:02:54Z</when>
      <when>2010-05-28T02:02:55Z</when>
      <when>2010-05-28T02:02:56Z</when>
      <gx:coord>-122.207881 37.371915 156.000000</gx:coord>
      <gx:coord>-122.205712 37.373288 152.000000</gx:coord>
      <gx:coord>-122.204678 37.373939 147.000000</gx:coord>
      <gx:coord>-122.203572 37.374630 142.199997</gx:coord>
      <gx:coord>-122.203451 37.374706 141.800003</gx:coord>
      <gx:coord>-122.203329 37.374780 141.199997</gx:coord>
      <gx:coord>-122.203207 37.374857 140.199997</gx:coord>
    </gx:Track>
  </Placemark>
</Folder>
</kml>

Ejemplo de seguimiento con datos extendidos

El tipo de negrita de este ejemplo destaca los elementos que se usan para definir y especificar los datos personalizados de un paseo en bicicleta. Los campos de datos personalizados se denominan internamente "frecuencia cardíaca", "cadencia" y "poder". El elemento <Schema> define el nombre que se mostrará para cada conjunto de valores (Ritmo cardíaco, cadencia y Potencia) y especifica el tipo de datos para cada campo nuevo (la frecuencia cardíaca y la cadencia son del tipo int, y la energía es del tipo float). En Google Earth, estos datos personalizados se muestran con el perfil de elevación de la ruta.

Este ejemplo es una presentación más realista de una pista, con íconos personalizados y estilos separados de íconos y líneas para modos destacados y normales. Sin embargo, ten en cuenta que en el ejemplo solo se incluyen siete conjuntos de valores de datos. El ejemplo real incluye decenas de miles de valores. (Datos cortesía de Sean Broeder. Estos datos se recopilaron con un dispositivo Garmin Edge 705 con un monitor de frecuencia cardíaca y un medidor de alimentación asociados.

<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2" xmlns:gx="http://www.google.com/kml/ext/2.2">
  <Document>
    <name>GPS device</name>
    <Snippet>Created Wed Jun 2 15:33:39 2010</Snippet>

    <!-- Normal track style -->
    <LookAt>
      <gx:TimeSpan>
        <begin>2010-05-28T02:02:09Z</begin>
        <end>2010-05-28T02:02:56Z</end>
      </gx:TimeSpan>
      <longitude>-122.205544</longitude>
      <latitude>37.373386</latitude>
      <range>1300.000000</range>
    </LookAt>
    <Style id="track_n">
      <IconStyle>
        <scale>.5</scale>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-none.png</href>
        </Icon>
      </IconStyle>
      <LabelStyle>
        <scale>0</scale>
      </LabelStyle>

    </Style>
    <!-- Highlighted track style -->
    <Style id="track_h">
      <IconStyle>
        <scale>1.2</scale>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-none.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <StyleMap id="track">
      <Pair>
        <key>normal</key>
        <styleUrl>#track_n</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#track_h</styleUrl>
      </Pair>
    </StyleMap>
    <!-- Normal multiTrack style -->
    <Style id="multiTrack_n">
      <IconStyle>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-0.png</href>
        </Icon>
      </IconStyle>
      <LineStyle>
        <color>99ffac59</color>
        <width>6</width>
      </LineStyle>

    </Style>
    <!-- Highlighted multiTrack style -->
    <Style id="multiTrack_h">
      <IconStyle>
        <scale>1.2</scale>
        <Icon>
          <href>http://earth.google.com/images/kml-icons/track-directional/track-0.png</href>
        </Icon>
      </IconStyle>
      <LineStyle>
        <color>99ffac59</color>
        <width>8</width>
      </LineStyle>
    </Style>
    <StyleMap id="multiTrack">
      <Pair>
        <key>normal</key>
        <styleUrl>#multiTrack_n</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#multiTrack_h</styleUrl>
      </Pair>
    </StyleMap>
    <!-- Normal waypoint style -->
    <Style id="waypoint_n">
      <IconStyle>
        <Icon>
          <href>http://maps.google.com/mapfiles/kml/pal4/icon61.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <!-- Highlighted waypoint style -->
    <Style id="waypoint_h">
      <IconStyle>
        <scale>1.2</scale>
        <Icon>
          <href>http://maps.google.com/mapfiles/kml/pal4/icon61.png</href>
        </Icon>
      </IconStyle>
    </Style>
    <StyleMap id="waypoint">
      <Pair>
        <key>normal</key>
        <styleUrl>#waypoint_n</styleUrl>
      </Pair>
      <Pair>
        <key>highlight</key>
        <styleUrl>#waypoint_h</styleUrl>
      </Pair>
    </StyleMap>
    <Style id="lineStyle">
      <LineStyle>
        <color>99ffac59</color>
        <width>6</width>
      </LineStyle>
    </Style>
    <Schema id="schema">
      <gx:SimpleArrayField name="heartrate" type="int">
        <displayName>Heart Rate</displayName>
      </gx:SimpleArrayField>
      <gx:SimpleArrayField name="cadence" type="int">
        <displayName>Cadence</displayName>
      </gx:SimpleArrayField>
      <gx:SimpleArrayField name="power" type="float">
        <displayName>Power</displayName>
      </gx:SimpleArrayField>
    </Schema>
    <Folder>
      <name>Tracks</name>
      <Placemark>
        <name>2010-05-28T01:16:35.000Z</name>
        <styleUrl>#multiTrack</styleUrl>
        <gx:Track>
          <when>2010-05-28T02:02:09Z</when>
          <when>2010-05-28T02:02:35Z</when>
          <when>2010-05-28T02:02:44Z</when>
          <when>2010-05-28T02:02:53Z</when>
          <when>2010-05-28T02:02:54Z</when>
          <when>2010-05-28T02:02:55Z</when>
          <when>2010-05-28T02:02:56Z</when>
          <gx:coord>-122.207881 37.371915 156.000000</gx:coord>
          <gx:coord>-122.205712 37.373288 152.000000</gx:coord>
          <gx:coord>-122.204678 37.373939 147.000000</gx:coord>
          <gx:coord>-122.203572 37.374630 142.199997</gx:coord>
          <gx:coord>-122.203451 37.374706 141.800003</gx:coord>
          <gx:coord>-122.203329 37.374780 141.199997</gx:coord>
          <gx:coord>-122.203207 37.374857 140.199997</gx:coord>
          <ExtendedData>
            <SchemaData schemaUrl="#schema">
              <gx:SimpleArrayData name="cadence">
                <gx:value>86</gx:value>
                <gx:value>103</gx:value>
                <gx:value>108</gx:value>
                <gx:value>113</gx:value>
                <gx:value>113</gx:value>
                <gx:value>113</gx:value>
                <gx:value>113</gx:value>
              </gx:SimpleArrayData>
              <gx:SimpleArrayData name="heartrate">
                <gx:value>181</gx:value>
                <gx:value>177</gx:value>
                <gx:value>175</gx:value>
                <gx:value>173</gx:value>
                <gx:value>173</gx:value>
                <gx:value>173</gx:value>
                <gx:value>173</gx:value>
              </gx:SimpleArrayData>
              <gx:SimpleArrayData name="power">
                <gx:value>327.0</gx:value>
                <gx:value>177.0</gx:value>
                <gx:value>179.0</gx:value>
                <gx:value>162.0</gx:value>
                <gx:value>166.0</gx:value>
                <gx:value>177.0</gx:value>
                <gx:value>183.0</gx:value>
              </gx:SimpleArrayData>
            </SchemaData>
          </ExtendedData>
        </gx:Track>
      </Placemark>
    </Folder>
  </Document>
</kml>

Extiende

Contenida por

<Actualizar>

Sintaxis

<Update>
  <targetHref>...</targetHref>    <!-- URL -->
  <Change>...</Change>
  <Create>...</Create>
  <Delete>...</Delete>
</Update>

Descripción

Especifica la adición, el cambio o la eliminación de los datos KML que ya se cargaron mediante la URL especificada. <targetHref> especifica el archivo .kml o .kmz cuyos datos (dentro de Google Earth) deben modificarse. <Update> siempre se encuentra en un NetworkLinkControl. Además, el archivo que contiene NetworkLinkControl debe haber sido cargado por un NetworkLink. Consulta la página "Temas de KML" en Actualizaciones para ver un ejemplo detallado de cómo funciona la actualización.

Elementos específicos para actualizar

Puede contener cualquier cantidad de elementos <Change>, <Create> y <Delete> que se procesarán en orden.

<targetHref>(obligatorio)
Una URL que especifica el archivo .kml o .kmz cuyos datos (dentro de Google Earth) se deben modificar mediante un elemento <Update>. Este archivo KML ya se debe haber cargado a través de un <NetworkLink>. En ese archivo, el elemento que se va a modificar ya debe tener un atributo id explícito definido.
<Change>
Modifica los valores de un elemento que ya se cargó con un elemento <NetworkLink>. En el elemento Change, el elemento secundario que se modifique debe incluir un atributo targetId que haga referencia al id del elemento original.
Esta actualización puede considerarse como una “actualización dispersa”: en el elemento modificado, solo se reemplazan los valores enumerados en <Change>. Los demás valores permanecen intactos. Cuando se aplica <Change> a un conjunto de coordenadas, las nuevas coordenadas reemplazan las actuales.
Los elementos secundarios de este elemento son los que se modificarán, los cuales se identifican mediante el atributo targetId.
<Create>
Agrega nuevos elementos a una Carpeta o Documento que ya se cargó mediante un elemento <NetworkLink>. El elemento <targetHref> de <Update> especifica la URL del archivo .kml o .kmz que contenía la Carpeta o el Documento original. Dentro de ese archivo, la carpeta o el documento que contendrá los datos nuevos ya debe tener un id explícito definido. Se hace referencia a este id como el atributo targetId de la carpeta o del documento dentro de <Create> que contiene el elemento que se agregará.
Una vez que se crea un objeto y se carga en Google Earth, este recibe la URL del Documento principal de la carpeta original. Para realizar actualizaciones posteriores de los objetos agregados con este mecanismo Actualizar/Crear, establece <targetHref> en la URL del Documento o la Carpeta original (no la URL del archivo que cargó las actualizaciones intermedias).
<Delete>
Borra elementos de un elemento complejo que ya se cargó mediante un elemento <NetworkLink>. El elemento <targetHref> de <Update> especifica el archivo .kml o .kmz que contiene los datos que se borrarán. Dentro de ese archivo, el elemento que se borrará ya debe tener un id explícito definido. El elemento <Delete> hace referencia a este id en el atributo targetId.
Los elementos secundarios de <Delete>, que son los únicos elementos que se pueden borrar, son Document, Folder, GroundOverlay, Placemark, y ScreenOverlay.

Ejemplo de <Change>

<NetworkLinkControl>
  <Update>
    <targetHref>http://www/~sam/January14Data/Point.kml</targetHref>
    <Change> 
      <Point targetId="point123">
        <coordinates>-95.48,40.43,0</coordinates>
      </Point>
    </Change>
  </Update>
</NetworkLinkControl> 

Ejemplo de <Create>

Este ejemplo crea un nuevo marcador en un documento creado previamente, que tiene un atributo id [id] de “region24”. Ten en cuenta que, si quieres realizar más actualizaciones a "placemark891", aún usarás http://myserver.com/Point.kml como <targetHref>.

<Update>
  <targetHref>http://myserver.com/Point.kml</targetHref>
  <Create>
    <Document targetId="region24">
      <Placemark id="placemark891">
        <Point>
          <coordinates>-95.48,40.43,0</coordinates>
        </Point>
      </Placemark>
    </Document>
  </Create> 
</Update>

Ejemplo de <Delete>

Este ejemplo elimina una marca de posición cargada con anterioridad en Google Earth. (es posible que este marcador se haya cargado directamente a través de un vínculo de red con la dirección URL especificada, o se cargó con una actualización posterior del documento original).

<Update>
  <targetHref>http://www.foo.com/Point.kml</targetHref>
  <Delete>
    <Placemark targetId="pa3556"></Placemark>
  </Delete>
</Update> 

Contenida por

<Url>

Nota: Este elemento dejó de estar disponible en la versión 2.1 de KML y se reemplazó por <Link>, que proporciona la funcionalidad adicional de regiones. La etiqueta <Url> seguirá funcionando en Google Earth, pero se recomienda el uso de la etiqueta <Link> más reciente.

Utiliza este elemento para establecer la ubicación del vínculo al archivo KML, para definir las opciones de actualización de los cambios del servidor y el visor, y para completar una variable que muestre la información útil del cliente al servidor.

Volver al principio