KML Referansı

Örnek

<?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>

Uzatmalar

• <RenkStil Stili>

İçerir

• <Stil>

Başa dön

<gx:balonGörünürlük>

Söz dizimi

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

Açıklama

Açıklama balonunun görünürlüğünü açar/kapatır. Güncellenecek balon, nesnenin XML kimliğiyle tanımlanmalıdır (ör. <Placemark targetId="xxx">).

Örnekler

İlk örnekte yer işareti olan <gx:balloonVisibility> gösteriliyor. Yer işareti yüklendiğinde, açıklama balonu açılır.
balonGörünürlüğü_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>

İkinci örnek, <gx:balloonVisibility> özelliğinin bir tur içinde kullanımını göstermektedir. Tur sırasında çeşitli balonlar açılır ve kapanır, izleyiciye bilgiler sağlanır.
balonGörünürlüğü_turexample.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>

Uzatmalar

• <Özellik>

<Kamera>

Söz dizimi

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

Açıklama

Sahneyi görüntüleyen sanal kamerayı tanımlar. Bu öğe, Dünya'nın yüzeyine göre kameranın konumunu ve kameranın görüntüleme yönünü tanımlar. Kamera konumu; <boylam>, <Enlem>, <rakam> ve <heightMode> ya da <gx:heightMode> tarafından tanımlanır. Kameranın görüntülenme yönü <heading>, <tilt> ve <roll> ile tanımlanır. <Kamera> herhangi bir özelliğin veya <NetworkLinkControl> öğesinin alt öğesi olabilir. Bir <Kamera> öğesi, <Kamera> ve

<Kamera>, görünüm üzerinde altı serbestlik derecesi üzerinde tam kontrol sağlar. Böylece Kamerayı uzayda konumlandırabilir, ardından da X, Y ve Z eksenlerinde döndürebilirsiniz. Daha da önemlisi, kamera görünümünü ufka doğru gökyüzüne bakacak şekilde yatırabilirsiniz.

<Kamera> simgesi bir Zaman Primeri (<gx:TimeSpan> veya <gx:TimeStamp>) de içerebilir. Kamera'daki zaman değerleri geçmiş görüntüleri, güneş ışığını ve zaman damgalı özelliklerin görüntüsünü etkiler. Daha fazla bilgi edinmek için Geliştirici Kılavuzu'ndaki Zaman ve Animasyon bölümünde bulunan Soyut Görüntülemeli Süre'yi okuyun.

Görünüm Tanımlama

Özellik veya <NetworkLinkControl> içinde bir <Kamera> ya da <LookAt> nesnesi kullanın (ancak aynı nesnede ikisini birden kullanmayın). <Kamera> nesnesi, görüş noktasını görüntüleyen kişinin konumu ve yönü açısından tanımlar. <Kamera> nesnesi, Dünya yüzeyinde olmayan bir görünüm belirtmenizi sağlar. <LookAt> nesnesi, görüntülenme noktasını görüntüleme süresine göre tanımlar. <LookAt> nesnesi, kapsamı <Kamera>'dan daha sınırlıdır ve genellikle görünümün yüzeyinin Dünya yüzeyi ile kesişmesini gerektirir.

Aşağıdaki şemada, sanal kameraya takılan X, Y ve Z eksenleri gösterilmektedir.

• X ekseni kameranın sağına işaret eder ve sağ vektör olarak adlandırılır.
• Y ekseni, ekrana göre "yukarı" yönünü tanımlar ve yukarı vektör olarak adlandırılır.
• Z ekseni, ekranın ortasından göz noktasına doğru uzanır. Kamera, ‐Z eksenine bakar. Bu eksene görüntü vektörü denir.

Dönüşüm Sırası

Rotasyon sırası önemlidir. Varsayılan olarak, kamera Dünya'ya doğru ‐Z ekseninde aşağıya bakmaktadır. Rotasyonlar yapılmadan önce, kamera Z ekseni boyunca <rakıma> dönüştürülür. Dönüşümlerin sırası şu şekildedir:

1. <altitude> - Z ekseni boyunca ve <rakam> değerlerini çevir
2. <heading> - Z ekseninin etrafında döndürün.
3. <tilt> - X ekseninin etrafında döndürün.
4. <roll> - Z eksenini döndürün (tekrar).

Rotasyon her uygulandığında, kamera eksenlerinden ikisinin yönünün değiştiğini unutmayın.

Kameraya Özgü Öğeler

<boylam>

Sanal kameranın boylamı (göz noktası). Başlangıç Meridyenine göre derece cinsinden açı mesafesi. Meridian'ın batısındaki değerler ‐180 ile 0 derece arasında değişir. Meridyen'in doğusundaki değerler 0-180 derece arasında değişir.

<Enlem>

Sanal kameranın enlemi. Ekvatorun kuzeyi veya güneyinde derece. Değerler ‐90 derece ile 90 derece arasında değişir.

<rakım>

Dünyanın yüzeyinden metre cinsinden uzaklık. Kameranın <heightMode> veya <gx:heightMode> ayarına göre yorumlanır.

<başlık>

Kameranın derecesi (azimut) derece. Default=0 (true North). (Şemayı inceleyin.) Değerler 0 ile 360 derece arasında değişir.

<tilt>

Kameranın X ekseni etrafında derece cinsinden derecesi. 0 değeri, görünümün doğrudan dünyaya (en yaygın durum) yönelik olduğunu belirtir. <tilt> için 90 değeri, görünümün ufuğa doğru işaret ettiğini gösterir. 90'dan büyük değerler, görünümü gökyüzüne doğru işaret eder. <tilt> değerleri +180 derece sabitlenir.

<roll>

Kameranın Z ekseni etrafında derece cinsinden derecesi. Değerler ‐180 ile +180 derece arasında değişir.

<heightMode>

Kamera için belirtilen <rakam> değerinin nasıl yorumlanacağını belirtir. Olası değerler aşağıdaki gibidir:

• relatedToGround - (varsayılan) <height> değerini yerden metre cinsinden bir değer olarak yorumlar. Nokta su üzerindeyse <rakım>, deniz seviyesinin üzerindeki metre cinsinden bir değer olarak yorumlanır. Deniz tabanına göre noktaları belirtmek için aşağıdaki <gx:heightMode> bölümüne bakın.
• clampToGround: Kamerayı arazi yüksekliğine tam olarak yerleştirmek, gözün araziyle kesişeceği (ve görünümün engelleneceği) anlamına geleceğinden kamera için bu ayar da GöreToGround'u yerleştirir.
• mutlak- <rakam> değerini, deniz seviyesinin üzerindeki metre cinsinden bir değer olarak yorumlar.

<gx:heightMode>

Google uzantısı ad alanında bulunan ve deniz tabanına göre rakımlara izin veren bir KML uzantısı. Değerler şu şekildedir:

• relatedToSeaFloor - <rakam> değerini, deniz tabanının üzerindeki metre cinsinden bir değer olarak yorumlar. Nokta deniz yerine karanın üzerindeyse <rakam> yer üzerinde olacak şekilde yorumlanır.
• clampToSeaFloor: <height> spesifikasyonu dikkate alınmaz ve Kamera, deniz tabanına yerleştirilir. Nokta denizden ziyade karaya bağlıysa Kamera kameraya karaya yerleştirilir.

Uzatmalar

• <AbstractView>

İçerir

• <Feature> etiketinden türetilen herhangi bir öğe
• <Ağ Bağlantısı Denetimi>

Başa dön

<Renk Stili>

Söz dizimi

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

Açıklama

Bu, soyut bir öğedir ve doğrudan bir KML dosyasında kullanılamaz. Genişletilmiş stil türlerinin renk ve renk modunu belirtmek için öğeler sağlar.

ColorStyle'a Özel Öğeler

<color>

Renk ve opaklık (alfa) değerleri, onaltılı gösterimle ifade edilir. Herhangi bir renk aralığı 0 - 255 (00 - ff) arasındadır. Alfa için 00 tamamen şeffaftır ve ff opaktır. İfadenin sırası aabbggrr şeklindedir. Burada aa=alpha (00 to ff); bb=blue (00 to ff); gg=green (00 to ff); rr=red (00-ff) Örneğin, bir yer paylaşımına yüzde 50 opaklık içeren mavi bir renk uygulamak için şunları belirtirsiniz: <color>7fff0000</color>; burada alfa=0x7f, mavi=0xff, yeşil=0x00 ve kırmızı=0x00.

<renkModu>

<colorMode> değerleri normal (etkisiz) ve rastgele değerlerdir. random değeri, taban <color> özelliğine aşağıdaki gibi rastgele bir doğrusal ölçek uygular.

• Tamamen rastgele bir renk seçimi elde etmek için temel bir <color> beyaz belirtin.
• Tek bir renk bileşeni belirtirseniz (örneğin, kırmızı için ff0000ff değeri) tek bir bileşen (kırmızı) için rastgele renk değerleri seçilir. Bu durumda, değerler 00 (siyah) ile ff (tam kırmızı) arasında değişir.
• İki veya üç renk bileşeninin değerlerini belirtirseniz her renk bileşenine rastgele bir doğrusal ölçek uygulanır ve sonuçlar her bileşen için siyahtan maksimum değerlere kadar değişebilir.
• Bir rengin opaklığı <color> alfa bileşeninden gelir ve hiçbir zaman rastgele hale getirilmez.

Uzatmalar

• <Nesne>

Şunun Tarafından Uzatıldı:

• <Simge Stili>
• <Etiket Stili>
• <Çizgi Stili>
• <PolyStil>

Başa dön

<Kapsayıcı>

Söz dizimi

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

Açıklama

Bu, soyut bir öğedir ve doğrudan bir KML dosyasında kullanılamaz. Kapsayıcı öğeleri bir veya daha fazla özelliğe sahiptir ve iç içe hiyerarşilerin oluşturulmasına olanak sağlar.

Uzatmalar

• <Özellik>

Şunun Tarafından Uzatıldı:

• <Doküman>
• <Klasör>

Başa dön

<Doküman>

Söz dizimi

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

Açıklama

Doküman, özellik ve stiller için kullanılan bir kapsayıcıdır. KML dosyanız paylaşılan stiller kullanıyorsa bu öğe gereklidir. Paylaşılan stilleri kullanmanız önerilir. Bunun için şu adımları uygulamanız gerekir:

1. Bir Dokümandaki Tüm Stilleri Tanımlayın. Her Stile benzersiz bir kimlik atayın.
2. Belirli bir Özellik veya StyleMap içinde bir <styleUrl> öğesini kullanarak Stilin kimliğine başvurun.

Paylaşılan stillerin dokümandaki özellikler tarafından devralınmadığını unutmayın.

Her özellik, bir <styleUrl> öğesinde kullandığı stillere açıkça referans vermelidir. ListStyle gibi bir Doküman için geçerli olan Stil için dokümanın kendisi açıkça <styleUrl> referansı olmalıdır. Örneğin:

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

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

Paylaşılan stilleri bir Klasör'e yerleştirmeyin.

Aşağıdaki örnekte paylaşılan bir stilin kullanımı gösterilmektedir.

Örnek

<?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>

Uzatmalar

• <Kapsayıcı>

İçerikler

• <Feature> etiketinden türetilen 0 veya daha fazla öğe
• <StyleSelector> türünden türetilen 0 veya daha fazla öğe
• <Schema> kaynağından türetilen 0 veya daha fazla öğe

Başa dön

<gx:duration>

Söz dizimi

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

Açıklama

<gx:duration>, etkinlikler için bir zaman aralığı belirterek gx:TourPrimitive süresini uzatır. Saat, XML'nin çift veri türü kullanılarak saniye cinsinden yazılır.

Süre ve <gx:FlyTo>

Süre, bir <gx:FlyTo> öğesinin içine dahil edildiğinde, tarayıcının önceki noktadan belirli bir noktaya gitmek için harcadığı süreyi belirtir.

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

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

Süre ve <gx:AnimatedUpdate>

Güncellemenin ne kadar süreceğini belirtir. Tam sayı, kayan ve renk alanları süre boyunca orijinalden yeni değere sorunsuz bir şekilde animasyonlu hale getirilir. Boole, dize ve interpolasyon yapmayan diğer değerler sürenin sonunda güncellenir.

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

    ....

  </Update>
</gx:AnimatedUpdate>

<Genişletilmiş Veri>

Söz dizimi

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

Açıklama

Genişletilmiş Veri öğesi, bir KML Özelliğine (NetworkLink, Yer İşareti, GroundOverlay, PhotoOverlay, ScreenOverlay, Document, Folder) özel veri eklemek için üç teknik sunar. Bu teknikler

• <Data> öğesini kullanarak temelsiz veri/değer çiftleri ekleme (temel)
• <Schema> öğesini kullanarak yeni yazılan alanların tanımlanması ve <SchemaData> öğesinin kullanılmasıyla tamamlanmaları
• KML dosyasındaki harici ad alanına bakarak diğer ad alanlarında tanımlanan XML öğelerine başvuruda bulunma (temel)

Bu teknikler, farklı veri parçaları için tek bir KML dosyası veya Özellik içinde birleştirilebilir.

Daha fazla bilgi edinmek için "KML'deki konular" başlıklı makalenin Özel Veri Ekleme bölümüne bakın.

Genişletilmiş Verilere Özgü Öğeler

<Veri adı ="string">

Yazılmamış bir ad/değer çifti oluşturur. Adın iki sürümü olabilir: name ve displayName. name özelliği, KML dosyasındaki veri çiftini tanımlamak için kullanılır. Google Earth'te boşluk ve HTML biçimlendirmesine sahip, uygun şekilde biçimlendirilmiş bir ad gösterildiğinde displayName öğesi kullanılır. <BalloonStyle>'ın <text> öğesinde, $[name/displayName] notasyonunun yerini <displayName> alır. <Data> öğesinin name özelliğinin değerini bu biçimde (örneğin, $[ altındaYardage]) değiştirirseniz özellik değeri <value> olarak değiştirilir. Varsayılan olarak, yer işaretiyle ilişkilendirilen balon adı/değeri gösterir.

<displayName>

Görüntüleme amacıyla kullanılacak, ad şeklindeki isteğe bağlı olarak biçimlendirilmiş bir sürüm.

<değer>

Veri çiftinin değeri.

<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="herhangibirURI">

Bu öğe, KML Özelliğine yazılan özel verileri eklemek için <Schema> ile birlikte kullanılır. Şema öğesi (schemaUrl özelliği ile tanımlanır) özel veri türünü tanımlar. Gerçek veri nesneleri ("özel verilerin örnekleri") SchemaData öğesi kullanılarak tanımlanır.

<schemaURL> tam bir URL, harici bir KML dosyasında tanımlanan Şema Kimliğine veya aynı KML dosyasında tanımlanan Şema Kimliğine referans olabilir. Aşağıdaki spesifikasyonların tümü kabul edilebilir:

schemaUrl="http://host.com/PlacesIHaveLived.kml#my-schema-id"

schemaUrl="AnotherFile.kml#my-schema-id"

schemaUrl="#schema-id"   <!-- same file -->

Şema öğesi her zaman Doküman'ın alt öğesidir. Genişletilmiş Veri öğesi, Özel verileri içeren Özelliğin alt öğesidir.

<BasitVeri adı="dize">

Bu öğe, name özelliği tarafından tanımlanan özel veri alanına bir değer atar. Bu özel veri alanının türü ve adı <Schema> öğesinde belirtilir.

İki özel veri öğesini tanımlama örneğini aşağıda bulabilirsiniz:

<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:diğer>

Bu öğe, türlenmemiş özel veriler eklemenize olanak tanır. Dosyanızın <KML> öğesindeki veya <ExpandedData> öğesinin bir özelliği olarak ad alanı ön ekine başvurduğunuzdan ve her veri öğesinin adının ad alanı önekini aldığını kontrol edin. Bu şekilde eklenen özel veriler KML dosyasında korunur, ancak Google Earth tarafından hiçbir şekilde kullanılmaz. Dosyayla birlikte her zaman kaydedilir.

Aşağıdaki örnekte "camp" ad alanı ön eki kullanılmıştır:

<ExtendedData xmlns:prefix="camp">
  <camp:number>14</camp:number>
  <camp:parkingSpaces>2</camp:parkingSpaces>
  <camp:tentSites>4</camp:tentSites>
</ExtendedData>

İçerir

• <Feature> etiketinden türetilen herhangi bir öğe

İlgili Konular

• Şema

<Özellik>

Söz dizimi

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

Açıklama

Bu, soyut bir öğedir ve doğrudan bir KML dosyasında kullanılamaz. Aşağıdaki şemada, bir Özellik'in bazı öğelerinin Google Earth'te nasıl göründüğü gösterilmektedir.

Özelliğe Uygun Öğeler

<ad>

3D görüntüleyicide nesne için etiket olarak görünen (ör. Yer işareti, Klasör veya Ağ Bağlantısı için) kullanıcı tanımlı metin.

<görünürlük>

Boole değeri. Özelliğin, ilk yüklendiğinde 3B görüntüleyicide çizilip çizilmeyeceğini belirtir. Bir özelliğin görünür olması için üst öğelerinin <visible> etiketi de 1 olarak ayarlanmalıdır. Google Earth Liste Görünümü'nde, her özelliğin, kullanıcıların söz konusu özelliğin görünürlüğünü denetlemesine olanak tanıyan bir onay kutusu bulunur.

<açık>

Boole değeri. Yerler paneline ilk yüklendiğinde doküman veya klasörlerin kapalı mı açık mı olacağını belirtir. 0=daraltılmış (varsayılan), 1=genişletilmiş. Ayrıca bkz. <ListStyle>. Bu öğe sadece Docs, Folder ve NetworkLink için geçerlidir.

<atom:author>

KML 2.2, KML dosyanıza yazar ve ilgili web sitesiyle ilgili verileri dahil etmek için yeni öğeleri destekler. Bu bilgiler, hem Google Earth gibi Earth tarayıcılarında hem de Google Haritalar gibi diğer uygulamalarda coğrafi arama sonuçlarında görüntülenir. KML'de kullanılan komut dosyası öğeleri şunlardır:

• atom:author öğesi - atom:name için üst öğe
• atom:name element - yazarın adı
• atom:link öğesi - href özelliğini içerir
• href özelliği - KML/KMZ dosyasını içeren web sayfasının URL'si

Bu öğeler, Atom Sendikasyon Biçimi'nde tanımlanmıştır. Spesifikasyonun tamamını http://atompub.org adresinde bulabilirsiniz. (aşağıdaki örneği inceleyin).

<atom:author> öğesi, KML özelliğinin yazarını belirten <atom:name> üst öğesidir.

<atom:link href="..." >

Bu KML veya KMZ dosyasını içeren web sitesinin URL'sini belirtir. Bu öğenin ad alanını, kullanıldığı tüm KML dosyalarına eklediğinizden emin olun: xmlns:atom="http://www.w3.org/2005/Atom" (aşağıdaki örneği inceleyin).

<address>

Yapılandırılmamış bir adresi standart sokak, şehir, eyalet adresi ve/veya posta kodu olarak yazılan dize değeri. Enlem ve boylam koordinatlarını kullanmak yerine bir noktanın konumunu belirtmek için <address> etiketini kullanabilirsiniz. (Bununla birlikte, bir <Point> sağlanmışsa bu <address> önceliğine göre önceliklidir.) Google Earth'te bu etiket için hangi yerel ayarların desteklendiğini öğrenmek üzere Google Haritalar Yardımı'na gidin.

<xal:AddressDetails>

Adres biçimlendirmesine yönelik uluslararası bir standart olan xAL veya eXtensible Address Language olarak biçimlendirilmiş bir yapılandırılmış adres. <xal:AddressDetails>, KML tarafından yalnızca Google Haritalar'da coğrafi kodlama için kullanılır. Ayrıntılar için Google Haritalar API'sı dokümanlarına bakın. Şu anda Google Earth bu öğeyi kullanmamaktadır; bunun yerine <address> özelliğini kullanın. Bu öğenin ad alanını, kullanıldığı tüm KML dosyalarına eklediğinizden emin olun: xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"

<telefonNumarası>

Bir telefon numarasını temsil eden dize değeri. Bu öğe yalnızca Google Haritalar Mobil tarafından kullanılır. Java özellikli cep telefonları için endüstri standardı RFC2806'dır.
Daha fazla bilgi için http://www.ietf.org/rfc /rfc2806.txt sayfasına bakın. 

<Snippet maxLines="2" >

Özelliğin kısa bir açıklaması. Bu açıklama, Google Earth'te, özellik adının altındaki Yerler panelinde görüntülenir. Snippet sağlanmazsa <description> öğesinin ilk iki satırı kullanılır. Google Earth'te, bir Yer İşareti hem açıklama hem de Snippet içeriyorsa Yerler panelindeki Yer İşareti'nin altında <Snippet>, Yer İşareti'nin açıklama balonunda ise <açıklama> görünür. Bu etiket, HTML işaretlemesini desteklemiyor. <Snippet>, görüntülenecek maksimum satır sayısını belirten bir tam sayı olan maxLines özelliğine sahiptir.

<description>

Açıklama balonunda kullanıcı tarafından sağlanan içerikler görünür.

<description> öğesi için desteklenen içerik Google Earth 4.3'ten 5.0'a değiştirildi. Her sürüme özgü bilgiler ve ardından her ikisi için de ortak bilgiler listelenir.

Google Earth 5.0

Google Earth 5.0 (ve üstü), açıklama balonlarında düz metin içeriğinin yanı sıra tam HTML ve JavaScript'i destekler. Açıklama etiketinin içeriği WebKit açık kaynak web tarayıcısı motoru tarafından oluşturulur ve WebKit tabanlı herhangi bir tarayıcıda olduğu gibi görüntülenir.

Genel kısıtlamalar

Yerel dosya bağlantılarına genellikle izin verilmez. Bu, kötü amaçlı kodların sisteminize zarar vermesini veya verilerinize erişmesini engeller. Yerel dosya sisteminize erişim izni vermek istiyorsanız Tercihler > Yerel dosyalara ve kişisel verilere erişime izin ver'i seçin. <img> etiketi içinde yer alıyorsa yerel dosya sistemindeki resim dosyalarına bağlantılara her zaman izin verilir.

KMZ dosyası olarak sıkıştırılmış içeriğe yerel dosya sisteminde olsa bile erişilebilir.

Çerezler etkinleştirilir, ancak aynı kaynak politikasının amaçları doğrultusunda, yerel içerik bir alanı başka hiçbir içerikle (diğer yerel içerikler dahil) paylaşmaz.

HTML

HTML çoğunlukla herhangi bir WebKit tarayıcıda olduğu gibi oluşturulur.

Hedefler, doğrudan KML'ye yazılan HTML'ye dahil edildiğinde yoksayılır; bu tür bağlantıların tümü, hedef _blank olarak ayarlanmış gibi açılır. Belirtilen tüm hedefler yoksayılır.

Bununla birlikte, iFrame içinde yer alan veya JavaScript ya da DHTML ile dinamik olarak oluşturulan HTML'de varsayılan olarak target="_self" kullanılır. Başka hedefler belirtilebilir ve desteklenir.

iFrame'in içerdiği HTML'de KMZ dosyalarının, yerel bağlayıcı bağlantılarının ve ;flyto yöntemlerinin içeriği hedeflenemez.

Kullanıcı bir iFrame genişliği için width="100%" değerini belirtiyorsa iFrame'in genişliği balondaki diğer tüm içeriğe bağlı olur. Temelde, düzen boyutu hesaplanırken dikkate alınmamalıdır. Bu kural, balon içerisindeki diğer engelleme öğeleri için de geçerlidir.

JavaScript

Çoğu JavaScript desteklenir. İletişim kutusu oluşturulamaz. Alert() ve istemi() gibi işlevler gösterilmez. Ancak diğer hatalar ve istisnalar gibi sistem konsoluna da yazılır.

CSS

CSS'ye izin verilir. Normal bir web tarayıcısında CSS'de olduğu gibi CSS de metin ve sayfa öğelerinin stilini belirlemek, ayrıca açıklama balonunun boyutunu ve görünümünü kontrol etmek için kullanılabilir.

Google Earth 4.3

<description> öğesi, hem düz metinleri hem de tablolar dahil olmak üzere HTML biçimlendirme öğelerinin bir alt kümesini destekler (aşağıdaki KML örneğini inceleyin). Dinamik sayfa işaretleme (PHP, JSP, ASP), komut dosyası dilleri (VBScript, JavaScript) veya uygulama dilleri (Java, Python) gibi diğer web tabanlı teknolojileri desteklemez. Google Earth sürüm 4.2'de video desteklenir. (Aşağıdaki Örnek'e bakın.)

Sık kullanılan bilgiler

Açıklamanızda HTML işaretlemesi yoksa Google Earth, yeni satırları <br> ile ve URL'leri bağlantı etiketleriyle sarmalayarak biçimlendirmeyi dener. World Wide Web için geçerli bir URL dizesi otomatik olarak bu URL'ye bir köprüye dönüştürülür (ör. http://www.google.com). Dolayısıyla, basit bir bağlantı elde etmek için URL'yi <a href="http://.."></a> etiketlerinin içine almanız gerekmez.

Belirli bir kelimenin etrafında köprü oluşturmak için HTML'yi kullanırken veya HTML'ye resim eklerken açılı ayraçları, kesme işaretlerini ve diğer özel karakterleri kod dışına almak için HTML öğe başvurularını ya da CDATA öğesini kullanmanız gerekir. CDATA öğesi, XML ayrıştırıcıya köşeli parantez içinde kullanılan özel karakterleri yoksaymasını bildirir. Bu öğe şu biçimlerden oluşur:

<![CDATA[
  special characters here
]]> 

CDATA öğesini kullanmamayı tercih ederseniz tüm özel karakterleri değiştirmek için varlık referanslarını kullanabilirsiniz.

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

<a> Öğesinin Kullanılmasıyla Belirtilen Diğer Davranışlar

KML <a> öğesi içinde iki özelliğin kullanımını destekler: href ve type.

<a> bağlantı öğesi, URL'yi belirten bir href özelliği içeriyor.

href bir KML dosyasıysa ve .KML ya da .kmz dosya uzantısına sahipse Google Earth bu dosyayı kullanıcı tıkladığında doğrudan yükler. URL, Google Earth tarafından tanınmayan bir uzantıyla (ör. .html) bitiyorsa tarayıcıya gönderilir.

href, yani parçalı bir URL (yani # işaretinin ardından gelen bir KML tanımlayıcısı) bir URL olabilir. Kullanıcı, parça URL'si içeren bir bağlantıyı tıkladığında varsayılan olarak tarayıcı, kimliği parçayla eşleşen Özellik'e gider. Özellik bir LookAt veya Kamera öğesi içeriyorsa bu özellik belirtilen bakış noktasından görüntülenir.

Davranış, parça URL'sine aşağıdaki üç dizeden biri eklenerek de belirtilebilir:

• ;flyto (varsayılan) - Özelliğe git
• ;bubble - Özellik balonunu aç ancak Özellik'e gitme
• ;BubbleFlyto: Özellik balonunu açın ve Özellik'e gidin

Örneğin, aşağıdaki kod CraftsFairs.KML dosyasını açıp kimliğini "Albuquerque" olan Yer İşareti'ne gider ve balonunu açar:

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

href, .KML veya .kmz ile bitmezse <a> öğesinin içinde type özelliği kullanılır ancak referansın KML bağlamında yorumlanması gerekir. Aşağıdakileri belirtin:

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

Örneğin, aşağıdaki URL, Google Earth'e, dosya uzantısı .cp olsa bile dosyayı yüklemeyi denemesi gerektiğini bildirmek için type özelliğini kullanır:

<a href="myserver.com/cgi-bin/generate-kml.php#placemark123"
   type="application/vnd.google-earth.kml+xml">

<AbstractView>

Özellikten türetilen öğelerle ilişkilendirilmiş bir görüntüleme noktasını tanımlar. <Kamera> ve <LookAt> başlıklı makaleleri inceleyin.

<TimePrimitive>

Bu özelliği bir dönemle (<TimeSpan>) veya belirli bir noktayla (<TimeStamp>) ilişkilendirir.

<styleUrl>

Dokümanda tanımlanan <Style> veya <StyleMap> URL'si. Stil aynı dosyadaysa bir # referansı kullanın. Stil harici bir dosyada tanımlanıyorsa, # referansıyla birlikte tam URL'yi kullanın. Örnekler:

<styleUrl>#myIconStyleID</styleUrl>

<styleUrl>http://someserver.com/somestylefile.xml#restaurant</styleUrl>

<styleUrl>eateries.kml#my-lunch-spot</styleUrl>

<StilSeçici>

Bir veya daha fazla Stil ve Stil Stili, Yer İşaretindeki Özellik ya da Geometriden türetilen herhangi bir öğenin görünümünü özelleştirmek için tanımlanabilir. (<BalloonStyle>, <ListStyle>, <StyleSelector> ve <ColorStyle>tan türetilen stillere bakın. Bir özellikte tanımlanan stil, "satır içi stil" olarak adlandırılır ve yalnızca onu içeren özellik için geçerlidir. Bir <Doküman> alt öğesi olarak tanımlanan stile "paylaşılan stil" denir. Paylaşılan stilin tanımlı bir id'si olmalıdır. Bu kimliğe, <Belge> içindeki bir veya daha fazla özellik tarafından başvuruda bulunulur. Bir stil öğesinin hem paylaşılan stilde hem de bir özellik için satır içi stilde tanımlandığı durumlarda (ör. klasör, GroundOverlay, NetworkLink, Yer işareti ya da Ekran Yer Paylaşımı), Özellik'in satır içi stilinin değeri, paylaşılan stilin değerine göre önceliklidir.

<Bölge>

Bir Bölgeyle ilişkilendirilen özellikler ve geometri yalnızca Bölge etkin olduğunda çizilir. <Bölge> bölümünü inceleyin.

<Meta veri>

<Genişletilmiş Veri>

KML dosyasına özel veriler eklemenize olanak tanır. Bu veriler (1) harici bir XML şemasına referans veren veriler, (2) yazılmamış veri/değer çiftleri veya (3) türlere ayrılmış veriler olabilir. Belirli bir KML Özelliği bu tür özel verilerin bir kombinasyonunu içerebilir.

Açıklama Metninde HTML Öğelerinin Örnek Kullanımı

Bu örnekte, Google Earth 4.3'teki <description> öğesi tarafından desteklenen HTML öğelerinin tamamı gösterilmektedir. Google Earth 5.0 ve sonraki sürümler, tam HTML ve JavaScript desteği sağlar.

<?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>

Alfabetik Öğelerin Örnek Kullanımı

Bu örnek, Atom ad alanındaki <atom:author>, <atom:name> ve <atom:link> öğelerinin kullanımını gösterir. Bu ad alanını <KML> öğesi içinde belirtmeniz gerektiğini unutmayın.

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

Örnek Video

Bu örnekte, bir Flash videonun Balon'a nasıl yerleştirileceği gösterilmektedir.

<?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>

Uzatmalar

• <Nesne>

Şunun Tarafından Uzatıldı:

• <Kapsayıcı>
• <Yer paylaşımı>
• <Yer işareti>
• <Ağ Bağlantısı>
• <gx:Tur>

<gx:Ankara>

Söz dizimi

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

Açıklama

<gx:FlyTo>, tarayıcının tur sırasında uçacağı bir alanı belirtir. Bir AbstractView içermelidir ve mevcut noktadan tanımlanan noktaya gitmek için gereken süreyi ve uçuş yöntemini sırasıyla belirten <gx:duration> ve <gx:flyToMode> öğelerini içermelidir.

<gx:flyToMode>

<gx:flyToMode> için izin verilen iki değer vardır: smooth ve geri dönen.

• Smooth FlyTos, bir noktadan diğerine (ve açıktan) bölünmemiş uçuşa izin verir. Kırılmamış bir dizi FlyTos, sıfır hızda başlayıp bitecek ve her noktada yavaş olmayacak. Bir dizi FlyTos öğesi, aşağıdaki öğelerden herhangi birine göre bozulmuştur:
  • <gx:flyToMode>bounce</gx:flyToMode>
  • <gx:Wait>
  Bu, yukarıdaki öğelerin herhangi birinden hemen önce yumuşak FlyTo'da hızın sıfır olacağı anlamına gelir. Bir dizi FlyTos öğesi, <gx:AnimatedUpdate> öğeleri ile ayrılmaz.


• Hemen çıkma FlyTos'un başlangıç ve bitiş hızı sıfır.

Örnek

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

Uzatmalar

• <gx:TurPriftive>

İçerikler

• <gx:duration>
• <gx:flyToMode>
• <AbstractView>

<Klasör>

Söz dizimi

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

Açıklama

Klasör, diğer özellikleri (Klasörler, Yer İşaretleri, Ağ Bağlantıları veya Yer Paylaşımları) hiyerarşik olarak düzenlemek için kullanılır. Bir özelliği yalnızca kendisi ve tüm üst öğeleri görülebilirse görebilir.

Örnek

<?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>

Uzatmalar

• <Kapsayıcı>

İçerikler

• <Feature> etiketinden türetilen herhangi bir öğe

<Geometri>

Söz dizimi

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

Açıklama

Bu, soyut bir öğedir ve doğrudan bir KML dosyasında kullanılamaz. Türetilmiş tüm Geometri nesneleri için bir yer tutucu nesne sağlar.

Uzatmalar

• <Nesne>

Şunun Tarafından Uzatıldı:

• <Nokta>
• <LineString>
• <Doğrusal Ring>
• <Poligon>
• <Çoklu Geometri>
• <gx:Çoklu İzleme>
• <Model>
• <gx:İzleme>

<Groundground>

Söz dizimi

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

Açıklama

Bu öğe, araziye yerleştirilmiş bir resim yer paylaşımı çizer. <Icon> öğesinin <href> alt öğesi, yer paylaşımı olarak kullanılacak resmi belirtir. Bu dosya yerel bir dosya sisteminde veya bir web sunucusunda olabilir. Bu öğe atlanırsa veya <href> içermezse zemin yer paylaşımıyla tanımlanan renk ve LatLonBox sınırları kullanılarak bir dikdörtgen çizilir.

Zemin Yer Paylaşımına Özgü Öğeler

<rakım>

Dünya yüzeyinin uzaklığını metre cinsinden belirtir ve rakım moduna göre yorumlanır.

<heightMode>

<Rakımın> nasıl yorumlandığını belirtir. Olası değerler:

• clampToGround - (varsayılan) Rakım spesifikasyonunu yoksaymayı ve bindirmeyi arazi üzerinde kaplamayı belirtir.
• mutlak - Yer paylaşımının, öğenin altındaki arazinin gerçek yüksekliğinden bağımsız olarak, deniz seviyesine göre yüksekliğini belirler. Örneğin, mutlak rakım modunda bindirmenin rakımını 10 metreye ayarlarsanız, yer altındaki arazinin de deniz yüksekliğinden 10 metre yüksek olması durumunda bindirme yer seviyesinde görünür. Arazi, deniz seviyesinin 3 metre üzerindeyse yer paylaşımı, arazinin 7 metre üzerine çıkar.

<gx:heightMode>

Google uzantısı ad alanında bulunan ve deniz tabanına göre rakımlara izin veren bir KML uzantısı. Değerler şu şekildedir:

• relatedToSeaFloor - <rakam> değerini, deniz tabanının üzerindeki metre cinsinden bir değer olarak yorumlar. Nokta deniz yerine karanın üzerindeyse <rakam> yer üzerinde olacak şekilde yorumlanır.
• clampToSeaFloor: <height> spesifikasyonu dikkate alınmaz ve yer paylaşımı, deniz tabanının üzerine uygulanır. Nokta deniz yerine karadaysa yer paylaşımı zemine yerleştirilir.

<LatLonBox>

Zeminde yer paylaşımı için sınırlayıcı kutunun üst, alt, sağ ve sol taraflarının nerede hizalandığını belirtir.

• <north> Sınırlama kutusunun kuzey kenarının enlemini, 0 ile ~90 arasında ondalık derece olarak belirtir.
• <south> Sınırlama kutusunun güney kenarının enlemini 0 ile ‐90 aralığında ondalık derece olarak belirtir.
• <east> Sınırlayıcı kutunun doğu kenarının boylamını 0 ile ‐180 arasında ondalık derece olarak belirtir. (180° boylamın meridyeniyle örtüşen yer paylaşımları için değerler bu aralığın dışına çıkabilir.)
• <west> Sınırlayıcı kutunun batı kenarının boylamını 0 ile ‐180 arasında ondalık derece olarak belirtir. (180° boylamın meridyeniyle örtüşen yer paylaşımları için değerler bu aralığın dışına çıkabilir.)
• <rotation> Bindirmenin merkeziyle ilgili olarak derece cinsinden rotasyonunu belirtir. Değerler ~180 olabilir. Varsayılan değer 0'dır (kuzey). Rotasyonlar saat yönünün tersine yönde belirtilir.

<LatLonBox>
   <north>48.25475939255556</north>
   <south>48.25207367852141</south>
   <east>-90.86591508839973</east>
   <west>-90.8714285289695</west>
   <rotation>39.37878630116985</rotation>
</LatLonBox> 

<gx:LatLonQuad>

Dikdörtgen olmayan dörtgen zemin bindirmeleri için kullanılır.

Örnek

<?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>

Uzatmalar

• <Özellik>
• <Yer paylaşımı>

İçerir

• <Doküman>
• <Klasör>

<Simge>

Söz dizimi

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

Açıklama

Bir Simge stili veya yer paylaşımıyla ilişkili bir resmi tanımlar. Gerekli <href> alt öğesi, yer paylaşımı olarak veya yer işareti için simge olarak kullanılacak resmin konumunu tanımlar. Bu konum bir yerel dosya sisteminde veya uzak bir web sunucusunda olabilir. <gx:x>, <gx:y>, <gx:w> ve <gx:h> öğeleri, birden fazla simge içeren (genellikle simge paleti olarak adlandırılır) bir resimden bir simge seçmek için kullanılır.

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

Simgeye Özgü Öğeler

<href>

Simgeyi yüklemek için kullanılan HTTP adresi veya yerel dosya spesifikasyonu.

<gx:x>

ve

<gx:y>

<href> simgesi bir simge paleti belirtiyorsa bu öğeler, simge paletinin sol alt köşesinden ofsetleri piksel cinsinden tanımlar.x ve y için herhangi bir değer belirtilmezse simge paletinin sol alt köşesinin kullanılması, simgenin sol alt köşesi olarak kabul edilir.

<gx:w>

ve

<gx:y>

<href> simgesi bir simge paleti belirtiyorsa bu öğeler, kullanılacak simgenin genişliğini (<gx:w>) ve yüksekliğini (<gx:h>) piksel cinsinden belirtir.

<refreshMode>

<RefreshMode> ve aşağıda listelenen diğer unsurlarla ilgili açıklama için <Link> bölümüne bakın.

<refreshInterval>

<viewRefreshMode>

<viewRefreshTime>

<viewBoundScale>

<viewFormat>

<httpQuery>

İçerir

• <Groundground>
• <Ekran Bindirme>
• <Simge Stili>

<Simge Stili>

Söz dizimi

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

Açıklama

Yerler panelinde ve Google Earth'ün 3D görüntüleyicisinde Yer işaretleri noktası simgelerinin nasıl çizileceğini belirtir. <Icon> öğesi, simge resmini belirtir. <scale> öğesi, simgenin x, y ölçeklendirmesini belirtir. <IconStyle>'ın <color> öğesinde belirtilen renk <Icon>'ın rengiyle karışmış.

IconStyle'a Özel Öğeler

<ölçek>

Simgeyi yeniden boyutlandırır.

Not: <geomScale> etiketi kullanımdan kaldırılmıştır. Bunun yerine <scale> seçeneğini kullanın.

<başlık>

Derece (yani Kuzey, Güney, Doğu, Batı). Varsayılan=0 (Kuzey). (Şemayı inceleyin.) Değerler 0 ile 360 derece arasında değişir.

<Simge>

Özel simge. <IconStyle>'da <Icon> öğesinin tek alt öğesi <href>:

• <href>: Bir simgeyi yüklemek için kullanılan HTTP adresi veya yerel dosya spesifikasyonudur.

<hotSpot x="0,5" y="0,5" xunits="fraction" yunits="fraction">

Simge içindeki <Point> konumuna sabitlenen konumu belirtir. x ve y değerleri üç farklı şekilde belirtilebilir: piksel ("pixels"), simgenin kesirleri ("fraction") veya simgenin sağ üst köşesinden piksel cinsinden ofset olan girinti ("insetPixels") olarak. x ve y konumları farklı şekillerde belirtilebilir. Örneğin, x piksel olarak ve y kesirli olabilir. Koordinat sisteminin kaynağı simgenin sol alt köşesindedir.

• x: Piksel sayısı, simgenin bir kesirli bileşeni veya simgedeki bir noktanın x bileşenini gösteren bir piksel girişi.
• y - Piksel sayısı, simgenin kesirli bileşeni veya simgedeki bir noktanın y bileşenini gösteren piksel girişi.
• xunits: x değerinin belirtildiği birimler. Kesirli değer, x değerinin simgenin bir kesiri olduğunu gösterir. pixels değeri, x değerini piksel cinsinden belirtir. insetPixels değeri, simgenin sağ kenarından girintiyi gösterir.
• yunits: y değerinin belirtildiği birimler. Kesirli değer, y değerinin simgenin bir kesiri olduğunu gösterir. pixels değeri, y değerini piksel cinsinden belirtir. insetPixels değeri, simgenin üst kenarından girintiyi gösterir.

Örnek

<?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>

Uzatmalar

• <RenkStil Stili>

İçerir

• <Stil>

İçerikler

• <Icon> alt öğesi olarak <href>

<KML>

Söz dizimi

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

Açıklama

Bir KML dosyasının kök öğesi. Bu öğe zorunludur. Dosyanın başındaki xml bildirimini takip eder. İpucu özelliği, Google Earth'e dosyayı göksel veriler olarak göstermesi için sinyal olarak kullanılır.

<KML> öğesi, dosyada başvurulan harici XML şemalarının ad alanını da içerebilir.

Temel bir <KML> öğesi 0 veya 1 Özellik ve 0 veya 1 NetworkLinkControl içerir:

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

<Etiket Stili>

Söz dizimi

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

Açıklama

Bir özelliğin <name> öğesinin 3D görüntüleyicide nasıl çizileceğini belirtir. Etiket (ad) için özel bir renk, renk modu ve ölçek belirtilebilir.

Not: <labelColor> etiketi kullanımdan kaldırılmıştır. Bunun yerine <LabelStyle> kullanın.

<LabelStyle> için özel

<ölçek>

Etiketi yeniden boyutlandırır.

Örnek

<?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>

Uzatmalar

• <RenkStil Stili>

İçerir

• <Stil>

<gx:LatLonQuad>

Bu öğe, OGC KML 2.2 standardının bir uzantısıdır ve Google Earth 5.0 ve sonraki sürümlerinde desteklenir. Daha fazla bilgi

Söz dizimi

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

Açıklama

Dikdörtgen olmayan dörtgen zemin yer paylaşımlarına izin verir.

Bindirme alanını tanımlayan dörtgenin dört köşe noktasının koordinatlarını belirtir. Hem boylam hem de enlem için kayan nokta değerlerinden oluşan tam olarak dört koordinat noktası sağlanmalıdır. Çiftler arasına boşluk bırakın. Tünel içinde boşluk bırakmayın. Koordinatlar, saat dilimi cinsinden, ilk koordinat yer paylaşımlı resmin sol alt köşesine karşılık gelecek şekilde belirtilmelidir. Bu köşeler tarafından açıklanan şekil kontur olmalıdır.

Herhangi bir bağlantı parçasına (rakıma temsil edilen) üçüncü bir değer eklenirse yok sayılır. Yükseklik <altitude> ve <altitudeMode> (veya <gx:altitudeMode>) kullanılarak ve <GroundOverlay> uzatılıyor. İzin verilen rakım modları mutlak, clampToGround ve clampToSeaFloor'dur.

Örnek

<?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>

Uzatmalar

• <Nesne>

İçerir

• <Groundground>

<Doğrusal Ring>

Söz dizimi

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

Açıklama

Bir çokgenin dış sınırını (kapalı) tanımlar. İsteğe bağlı olarak, bir Çokgenin, Çokgende delik oluşturmak için iç kenar olarak kullanılması da mümkündür. Poligon, iç kenarlık olarak kullanılan birden fazla <DoğrusalRing> öğesi içerebilir.

Not: Google Earth'te <heightMode> clampToGround olan bir Poligon sabit sabit hatlarını izler, ancak <heightMode> clampToGround olan bir Doğrusal Ring mükemmel daire çizgilerini izler.

Doğrusal Ring'e Özel Öğeler

<gx:Rahat Ofseti>

Rakım değerlerinin oluşturulma şeklini değiştiren Google uzantısı ad alanındaki bir KML uzantısı. Bu ofset, Doğrusal Ring'i oluşturan bağımsız koordinat değerlerini değiştirmeden bir bütün olarak Doğrusal Ring'i bir birim olarak yukarı veya aşağı taşımanıza olanak tanır. (Doğrusal Ring, rakım ofseti değeri kullanılarak gösterilse de orijinal rakım değerleri KML dosyasında korunur.) Birimler metre cinsindendir.

<lisans>

Boole değeri. Doğrusal Ring'in yere bağlanıp bağlanmayacağını belirtir. Bu geometriyi genişletmek için rakım modu GöreToGround, relToSeaFloor veya mutlak olmalıdır. Geometrinin merkezi değil, yalnızca Doğrusal Rings köşeleri uzatılır. Köşeler, Dünya Küresi'nin merkezine doğru uzatılır.

<tessellate>

Boole değeri. Doğrusal Ring'in araziyi izlemesine izin verilip verilmeyeceğini belirtir. Satışı etkinleştirmek için <heightMode> değeri clampToGround veya clampToSeaFloor olmalıdır. Çok büyük Doğrusal Ring'ler, dünyanın eğriliğini takip edebilmeleri için kurşun özelliğini etkinleştirmelidir. Aksi takdirde, yer altında gizlenebilir ve gizlenebilirler.

<heightMode>

<ords> öğesinde rakım bileşenlerinin nasıl yorumlanacağını belirtir. Olası değerler:

• clampToGround - (varsayılan) Rakım spesifikasyonunun yoksayılmasını belirtir (örneğin, <ords> etiketinde).
• relToGround - Öğenin rakımını, belirli bir konumun gerçek zemin yüksekliğine göre ayarlar. Örneğin, bir yerin zemin yüksekliği tam olarak deniz seviyesindeyse ve bir noktanın rakımı 9 metreye ayarlıysa bu modla nokta yer işareti yüksekliğinin yüksekliği 9 metre olur. Ancak aynı koordinat, zemin yüksekliğinin deniz seviyesinden 10 metre yüksek olduğu bir konuma ayarlanırsa koordinatın yüksekliği 19 metredir. Bu modun tipik bir kullanım alanı telefon direkleri veya telesiyej kullanmaktır.
• mutlak - Öğenin altındaki arazinin gerçek yüksekliğinden bağımsız olarak koordinatın deniz seviyesine göre yüksekliğini belirler. Örneğin, bir koordinatın rakımını mutlak rakım moduyla 10 metreye ayarlarsanız, altındaki arazi de deniz seviyesinden 10 metre fazlaysa nokta yer işaretinin simgesi yer seviyesinde görünür. Arazi, deniz seviyesinin 3 metre üzerindeyse yer işareti, arazinin üzerinde 7 metre yüksekliğinde görünür. Bu modun genel kullanım alanı uçak yerleşimidir.

<gx:heightMode>

Google uzantısı ad alanında bulunan ve deniz tabanına göre rakımlara izin veren bir KML uzantısı. Değerler şu şekildedir:

• relatedToSeaFloor - <rakam> değerini, deniz tabanının üzerindeki metre cinsinden bir değer olarak yorumlar. Nokta deniz yerine karanın üzerindeyse <rakam> yer üzerinde olacak şekilde yorumlanır.
• clampToSeaFloor: <height> spesifikasyonu dikkate alınmaz ve nokta deniz tabanında konumlandırılır. Nokta deniz yerine karadaysa nokta karaya yerleştirilir.

< Koordinatörs>(zorunlu)

Her biri boylam, enlem ve rakım için kayan nokta değerlerinden oluşan dört veya daha fazla üç unsur. Rakım bileşeni isteğe bağlıdır. Tünel içinde boşluk bırakmayın. Son koordinat ilk koordinatla aynı olmalıdır. Koordinatlar yalnızca ondalık derece olarak ifade edilir.

Örnek

<?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>

Uzatmalar

• <Geometri>

İçerir

• <Çoklu Geometri>
• <Yer işareti>
• <dahiliBoundaryIs>
• <outerBoundaryIs>

<LineString>

Söz dizimi

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

Açıklama

Bağlı bir satır segmenti grubunu tanımlar. Çizginin rengini, renk modunu ve genişliğini belirtmek için <LineStyle> öğesini kullanın. Bir çizgi dizesi genişletildiğinde, çizgi zemine uzatılarak biraz duvar veya çit gibi görünen bir çokgen oluşturulur. Ekstrüye edilmiş LineStrings için, çizgi mevcut LineStyle'ı, uzantı ise mevcut PolyStyle'ı kullanır. LineString (veya yol) örnekleri için KML Eğitimi bölümüne bakın.

LineString'e Özel Öğeler

<gx:height Offset>

Rakım değerlerinin oluşturulma şeklini değiştiren Google uzantısı ad alanındaki bir KML uzantısı. Bu ofset, LineString'i oluşturan tüm bağımsız koordinat değerlerini değiştirmeden LineString öğesinin tamamını bir birim olarak yukarı veya aşağı taşımanıza olanak tanır. (LineString, rakım ofseti değeri kullanılarak gösterilse de, orijinal rakım değerleri KML dosyasında korunur.) Birimler metre cinsindendir.

<lisans>

Boole değeri. LineString'in zemine bağlanıp bağlanmayacağını belirtir. Bir LineString'i genişletmek için rakım modu relatedToGround, relToSeaFloor veya mutlak olmalıdır. LineString'in tepe noktaları, Dünya'nın kürenin ortasına doğru uzatılıyor.

<tessellate>

Boole değeri. LineString'in araziyi izlemesine izin verilip verilmeyeceğini belirtir. Satışı etkinleştirmek için rakım modu clampToGround veya clampToSeaFloor olmalıdır. Çok büyük LineString'ler, dünyanın eğriliğini takip edebilmeleri için Teasell'i etkinleştirmelidir (aksi durumda, yeraltında olabilir ve gizlenebilirler).

<heightMode>

<ords> öğesinde rakım bileşenlerinin nasıl yorumlanacağını belirtir. Olası değerler:

• clampToGround - (varsayılan) Bir rakım spesifikasyonunun (ör. < Koordinatörs> etiketinde) yoksayılacağını belirtir.
• relToGround - Öğenin rakımını, belirli bir konumun gerçek zemin yüksekliğine göre ayarlar. Örneğin, bir yerin zemin yüksekliği tam olarak deniz seviyesindeyse ve bir noktanın rakımı 9 metreye ayarlıysa bu modla nokta yer işareti yüksekliğinin yüksekliği 9 metre olur. Ancak aynı koordinat, zemin yüksekliğinin deniz seviyesinden 10 metre yüksek olduğu bir konuma ayarlanırsa koordinatın yüksekliği 19 metredir. Bu modun tipik bir kullanım alanı telefon direkleri veya telesiyej kullanmaktır.
• mutlak - Öğenin altındaki arazinin gerçek yüksekliğinden bağımsız olarak koordinatın deniz seviyesine göre yüksekliğini belirler. Örneğin, bir koordinatın rakımını mutlak rakım moduyla 10 metreye ayarlarsanız, altındaki arazi de deniz seviyesinden 10 metre fazlaysa nokta yer işaretinin simgesi yer seviyesinde görünür. Arazi, deniz seviyesinin 3 metre üzerindeyse yer işareti, arazinin üzerinde 7 metre yüksekliğinde görünür. Bu modun genel kullanım alanı uçak yerleşimidir.

<gx:heightMode>

Google uzantısı ad alanında yer alan ve deniz tabanına göre rakımlara izin veren bir KML uzantısı. Değerler şu şekildedir:

• relatedToSeaFloor - <rakam> değerini, deniz tabanının üzerindeki metre cinsinden bir değer olarak yorumlar. Nokta deniz yerine karanın üzerindeyse <rakam> yer üzerinde olacak şekilde yorumlanır.
• clampToSeaFloor: <height> spesifikasyonu dikkate alınmaz ve nokta deniz tabanında konumlandırılır. Nokta deniz yerine karadaysa nokta karaya yerleştirilir.

<gx:drawOrder>

Birden fazla satırdan oluşan dizelerin sırasını belirten tam sayı değeri. Önce çizilen Çizgi Dizeleri, daha sonra çizim sırası olan Çizgi Dizeleri tarafından kısmen veya tamamen engellenebilir. Çift renkli çizgiler birbirinin altına geçtiğinde <LineStyle>'da <gx:outerColor> ve <gx:outerWidth> öğeleri ile birlikte bu öğe gerekebilir.

< Koordinatörs>(zorunlu)

Her biri boylam, enlem ve rakım değerleri için kayan noktalı değerlerden oluşan iki veya daha fazla koordinat noktası grubu. Rakım bileşeni isteğe bağlıdır. Çiftler arasına boşluk bırakın. Tünel içinde boşluk bırakmayın.

Örnek

<?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>

Uzatmalar

• <Geometri>

İçerir

• <Çoklu Geometri>
• <Yer işareti>

<Çizgi Stili>

Söz dizimi

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

Açıklama

Tüm çizgi geometrisinin çizim stilini (renk, renk modu ve çizgi genişliği) belirtir. Çizgi geometrisi, ana hatları çizilmiş çokgenlerin ana hatlarını ve yer işareti simgelerinin çıkıntılı "tether"ını (ayarlama etkinleştirildiyse) içerir.

LineStyle'a Özel Öğeler

<genişlik>

Çizginin piksel cinsinden genişliği.

<gx:outerColor>

Çizginin <gx:outerWidth> tarafından tanımlanan bölümünün rengi. <Polygon> ve <DoğrusalRing>'e <LineStyle> uygulandığında <gx:outerColor> ve <gx:outerWidth> öğelerinin yoksayıldığını unutmayın.

<gx:outerWidth>

0'dan 1.0'a kadar olan ve <gx:outerColor> kullanan çizginin oranını belirten değer. Yalnızca <gx:physicalWidth> genişliğinin ayarlandığı satırlar için geçerlidir; <width> kullanılan satırlar için geçerli değildir. Ayrıca <LineString> içindeki <gx:drawOrder> bölümüne bakın. Çift renkli çizgiler birbirini kesiyorsa (örneğin, otoyol paylaşımlarını göstermek için) çizim siparişi değeri gerekli olabilir.

<gx:fizikselGenişlik>

Çizginin metre cinsinden fiziksel genişliği.

<gx:labelVisibility>

Bir LineString öğesinde metin etiketi gösterilip gösterilmeyeceğini belirleyen boole. Bir LineString etiketi, <LineString> öğesinin kardeş olması <name> öğesinde yer alır (yani aynı <Placemark> öğesinde yer alır).

Google Earth 6.1 ve sonraki sürümler, varsayılan olarak etiket göstermez. <gx:labelVisibility> alanının 1 olarak ayarlanmasıyla bunların her bir LineString için etkinleştirilmesi gerekir.

Google Earth 6.1 ile ilgili bilinen sorun: <gx:physicalWidth> öğesi olmayan LineStrings, etiketi yalnızca satır uzunluğu 100 m'den * büyükse etiketteki karakter sayısından büyükse gösterir. Örneğin, yedi karakter ("örnek") içeren bir etiket yalnızca satır 700 metreden büyükse görüntülenir. Bu, <gx:physicalWidth> değerine sahip LineStrings'i etkilemez.

Örnek

Aşağıdaki örnekte 4 piksel genişliğinde, %50 opak kırmızı çizgi gösterilmektedir.

<?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>

Uzatmalar

• <RenkStil Stili>

İçerir

• <Stil>

<Bağlantı>

Söz dizimi

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

Açıklama

<Link> şunlardan herhangi birinin konumunu belirtir:

• Ağ bağlantıları tarafından getirilen KML dosyaları
• Herhangi bir Yer Paylaşımında kullanılan resim dosyaları (<Icon> öğesi, Yer Paylaşımlı resmi belirtir; <Simge>, <Bağlantı> alanıyla aynı alanlara sahiptir)
• <Model> öğesinde kullanılan model dosyaları

Dosya, burada sağlanan yenileme parametrelerine bağlı olarak koşullu olarak yüklenir ve yenilenir. İki farklı yenileme parametresi grubu belirtilebilir: Bir grup saate (<RefreshMode> ve <RefreshInterval>) göre, bir grup geçerli "kamera" görünümüne (<viewRefreshMode> ve <viewRefreshTime>) dayanır. Ayrıca Bağlantı, sunucuya gönderilen sınırlayıcı kutu parametrelerinin ölçeklendirilip ölçeklendirilmeyeceğini (<viewBoundScale>) belirtir ve gönderilebilecek isteğe bağlı bir görüntüleme parametreleri grubu olan isteğe bağlı bir görüntüleme parametresi grubu sağlar (ayrıca görüntüleme biçimi olarak bir tür görüntüleme parametresi ve bununla birlikte bir dizi görünüm parametresi de sağlanır)

Bir dosya getirildiğinde, sunucuya gönderilen URL üç bilgiden oluşur:

• Yüklenecek dosyayı belirten href (Köprü Metni Referansı).
• (a) <viewFormat> öğesinde belirttiğiniz parametrelerden veya (b) sınırlayıcı kutu parametrelerinden oluşturulmuş bir isteğe bağlı biçim dizesidir (bu, varsayılan seçenektir ve dosyaya <viewFormat> öğesi eklenmemişse kullanılır).
• <httpQuery> öğesinde belirtilen ikinci bir biçim dizesidir.

<href> dosyasında belirtilen dosya yerel bir dosyaysa <viewFormat> ve <httpQuery> öğeleri kullanılmaz.

<Link> öğesi, daha önceki KML sürümlerinde yer alan <NetworkLink> öğesinin <Url> öğesinin yerini alır ve <Region> öğesinin işlevlerini ekler (KML 2.1'de kullanıma sunulmuştur). Google Earth 3.0 ve önceki sürümlerde <Link> öğesi yoksayılır.

Bağlantıya Özel Öğeler

<href>

URL (HTTP adresi veya yerel dosya spesifikasyonu). <Link> üst öğesi bir NetworkLink ise <href> bir KML dosyasıdır. <Link> üst öğesi bir Model olduğunda <href> bir COLLADA dosyasıdır. <Icon> öğesinin üst öğesi (<Link> ile aynı alanlar) bir yer paylaşımı olduğunda, <href> bir resimdir. Göreli URL'ler bu etikette kullanılabilir ve kendilerini çevreleyen KML dosyasına göre değerlendirilir. KML ve KMZ dosyalarında göreli başvurular oluşturmaya ilişkin ayrıntılar için KMZ Dosyaları sayfasına göz atın.

<yenilemeModu>

Zamana dayalı yenileme modunu belirtir. Bu mod aşağıdakilerden biri olabilir:

• onChange - Dosya yüklendiğinde ve Bağlantı parametreleri değiştiğinde (varsayılan) yenileyin.
• onInterval: n saniyede bir yenilenir (<RefreshInterval> içinde belirtilir).
• onExpire - Geçerlilik bitiş zamanı geldiğinde dosyayı yenileyin. Getirilen bir dosya NetworkLinkControl içeriyorsa <expires> süresi,HTTP üst bilgilerinde belirtilen geçerlilik sürelerine göre öncelikli olur. <expires> zamanı belirtilmezse HTTP max-age üstbilgisi kullanılır (varsa). max-age yoksa Geçerlilik sonu HTTP üst bilgisi kullanılır (varsa). (HTTP başlık alanlarıyla ilgili ayrıntılar için Köprü Metni Aktarım Protokolü - HTTP 1.1'in RFC261b bölümüne bakın.)

<RefreshInterval>

Dosyanın n saniyede bir yenileneceğini belirtir.

<viewRefreshMode>

"Kamera" değiştiğinde bağlantının nasıl yenileneceğini belirtir.

Aşağıdakilerden biri olabilir:

• hiçbir zaman (varsayılan) - Görünümdeki değişiklikleri yoksayar. Ayrıca varsa <viewFormat> parametrelerini yoksayın.
• onStop - Dosyayı taşımadan n saniye sonra yenileyin, burada <viewRefreshTime> öğesinde n belirtilir.
• onRequest: Yalnızca kullanıcı açıkça istediğinde dosyayı yenileyin. (Örneğin, kullanıcı Google Earth'te sağ tıklayıp Bağla menüsünde Yenile'yi seçer.)
• onRegion - Bölge etkinleştirildiğinde dosyayı yenileyin. Bkz. <Bölge>.

<viewRefreshSaat>

Kamera hareketi durduktan sonra, görünümü yenilemeden önce beklenecek saniye sayısını belirtir. (Yukarıdaki <viewRefreshMode> ve onStop bölümlerine bakın.)

<viewBoundScale>

BBOX parametrelerini sunucuya göndermeden önce ölçeklendirir. 1'den küçük bir değer, tam görünümden (ekran) daha az bir kullanım olacağını belirtir. 1'den büyük bir değer, geçerli görünümün kenarlarından daha geniş bir alanı getirmek için belirtir.

<viewBiçim>

Dosya getirilmeden önce Bağlantının <href> bölümüne eklenen sorgu dizesinin biçimini belirtir.(<href> yerel bir dosyayı belirtiyorsa bu öğe yoksayılır.)

<onRefreshMode> için onStop değerini belirtirseniz ve dosyaya <viewFormat> etiketini dahil etmezseniz sorgu dizesine otomatik olarak aşağıdaki bilgiler eklenir:

BBOX=[bboxWest],[bboxGüney],[bboxEast],[bboxNorth]

Bu bilgiler, Web Harita Hizmeti (WMS) sınırlayıcı kutu spesifikasyonuyla eşleşir.

Boş bir <viewFormat> etiketi belirtirseniz sorgu dizesine hiçbir bilgi eklenmez.

Ayrıca, sorgu dizesine eklenecek özel bir görüntüleme parametresi grubu belirtebilirsiniz. Biçim dizesi sağlarsanız BBOX bilgisi yerine kullanılır. BBOX bilgilerini de istiyorsanız bu parametreleri özel parametrelerle birlikte eklemeniz gerekir.

Biçim dizenizde aşağıdaki parametrelerden herhangi birini kullanabilirsiniz (ve Google Earth, sorgu dizesini oluştururken geçerli geçerli değeri değiştirir):

• [lookatLon], [lookatLat] - <LookAt> ürününün görüntülediği noktanın boylamı ve enlemi
• [lookatRange], [lookatHeight], [lookatHeading] - <LookAt> öğesi tarafından kullanılan değerler (<LookAt> sayfasında <range>, <tilt> ve <heading> açıklamalarına bakın)
• [lookatTerrainLon], [lookatTerrainLat], [lookatTerrainAlt] - <LookAt> ürününün görüntülediği, derece/metre cinsinden arazinin üzerine gelin
• [cameraLon], [cameraLat], [cameraAlt] - kameranın gözlem noktası/derecesi
• [horizFov], [vertFov] - kameranın yatay, dikey görüş alanı
• [horizPixels], [vertPixels] - 3D görüntüleyicinin piksel cinsinden boyutu
• [terrainEnabled] - 3D görüntüleyicinin arazi gösterip göstermediğini belirtir

<httpSorgu>

Belirtilen parametrelere bağlı olarak sorgu dizesine bilgi ekler. (Google Earth, sorgu dizesini oluştururken uygun geçerli değeri değiştirir.) Aşağıdaki parametreler desteklenir:

• [istemciSürüm]
• [KMLVersion]
• [istemciAdı]
• [dil]

Örnek

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

Uzatmalar

• <Nesne>

İçerir

• <Model>
• <Ağ Bağlantısı>

İlgili Konular

• <Ağ Bağlantısı Denetimi>
• <Bölge>

<Liste Stili>

Söz dizimi

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

Açıklama

Bir özelliğin liste görünümünde nasıl gösterileceğini belirtir. Liste görünümü, kapsayıcılar ve alt öğeler hiyerarşisidir. Google Earth'te bu, Yerler panelidir.

ListStyle'a Özel Öğeler

<listItemType>

Bir özelliğin, liste görünümünde nasıl gösterileceğini belirtir. Olası değerler:

• check (varsayılan) - Özelliğin görünürlüğü, öğenin onay kutusuna bağlıdır.
• radioFolder: Bir Kapsayıcı için belirtildiğinde, aynı anda Kapsayıcı öğelerinden yalnızca bir tanesi görünür
• checkOffOnly: Bir Kapsayıcı veya Ağ Bağlantısı için belirtilirse tüm öğelerin aynı anda görünür olmasını engeller. Yani kullanıcı Kapsayıcı veya Ağ Bağlantısı'ndaki her şeyi kapatabilir, ancak her şeyi aynı anda etkinleştiremez. Bu ayar, büyük miktarda veri içeren Kapsayıcılar veya Ağ Bağlantıları için yararlıdır.
• checkHiddenChildren - Görünürlük için normal bir onay kutusu kullanın ancak Kapsayıcı veya Ağ Bağlantısı'nın alt öğelerini liste görünümünde göstermeyin. Onay kutusu, kullanıcının görüntüleyendeki alt nesnelerin görünürlüğünü açıp kapatmasını sağlar.

<bgRenk>

Snippet'in arka plan rengi. Renk ve opaklık değerleri onaltılı gösterimle ifade edilir. Herhangi bir renk aralığı 0 - 255 (00 - ff) arasındadır. Alfa için 00 tamamen şeffaftır ve ff opaktır. İfadenin sırası aabbggrr şeklindedir. Burada aa=alpha (00 to ff); bb=blue (00 to ff); gg=green (00 to ff); rr=red (00-ff) Örneğin, bir yer paylaşımına %50 opaklık içeren mavi bir renk uygulamak istiyorsanız şunları belirtirsiniz: <color>7fff0000</color>. Burada alfa=0x7f, mavi=0xff, yeşil=0x00 ve kırmızı=0x00.

<ItemIcon>

Liste görünümünde kullanılan Klasör veya Bağlantı getirme işleminin durumunu yansıtan simge. Klasörler ve Ağ Bağlantıları için, açık ve kapalı modlarıyla ilişkili simgeler kullanılır. Bağlantı, getirme0, getirme1 ve getirme2 modlarıyla ilişkili simgeler ağ bağlantıları için kullanılır. Aşağıdaki ekran görüntüsünde, bu durumlara ait Google Earth simgeleri gösterilmektedir:

<durum>

NetworkLink veya Klasör'ün mevcut durumunu belirtir. Olası değerler open, closed, error, Fetching0, Fetching1 ve Fetching2 değerleridir. Bu değerler, iki değer (virgül olmadan) arasına bir boşluk eklenerek birleştirilebilir.

<href>

Özellik için Liste Görünümü'nde kullanılan resmin URI'sını belirtir.

Örnek

<?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>

Uzatmalar

• <Nesne>

İçerir

• <Stil>

<Bak>

Söz dizimi

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

Açıklama

Özellikten türetilen herhangi bir öğeyle ilişkilendirilmiş bir sanal kamera tanımlar. LookAt öğesi, "kamerayı" görüntülenen nesneye göre konumlandırır. Kullanıcı, Yerler panelindeki bir öğeyi veya 3D görüntüleyicideki bir simgeyi çift tıkladığında görünüm, Google Earth'te bu LookAt gözlem noktasına "gider".

LookAt'a Özel Öğeler

<boylam>

Kameranın baktığı noktanın boylamı. Başlangıç Meridyenine göre derece cinsinden açı mesafesi. Meridian'ın batısındaki değerler ‐180 ile 0 derece arasında değişir. Meridyen'in doğusundaki değerler 0-180 derece arasında değişir.

<Enlem>

Kameranın baktığı noktanın enlemi. Ekvatorun kuzeyi veya güneyinde derece. Değerler ‐90 derece ile 90 derece arasında değişir.

<rakım>

Dünya yüzeyinin metre cinsinden uzaklığı. LookAt'ın rakım moduna göre yorumlanır.

<başlık>

Derece (yani Kuzey, Güney, Doğu, Batı). Varsayılan=0 (Kuzey). (Aşağıdaki diyagrama bakın.) Değerler 0 ile 360 derece arasında değişir.

<tilt>

LookAt pozisyonu ile dünyanın yüzeyi arasındaki açı. (Aşağıdaki diyagrama bakın.) Değerler 0 ile 90 derece arasında değişir. <tilt> değerleri negatif olamaz. 0 derece <tilt> değeri doğrudan üstten görüntülemeyi belirtir. 90 dereceden bir <tilt> değeri, ufuk boyunca görüntülenir.

<aralık>(zorunlu)

<boylam>, <enlem> ve <Rakım> ile belirtilen noktanın LookAt konumuna olan mesafesi. (Aşağıdaki diyagrama bakın.)

<heightMode>

LookAt noktası için belirtilen <rakam> değerinin nasıl yorumlanacağını belirtir. Olası değerler aşağıdaki gibidir:

• clampToGround - (varsayılan) <height> spesifikasyonunu yoksaymayı ve LookAt konumunu yere yerleştirmeyi belirtir.
• relToGround - <height> değerini yerden metre cinsinden bir değer olarak yorumlar.
• mutlak- <rakam> değerini, deniz seviyesinin üzerindeki metre cinsinden bir değer olarak yorumlar.

<gx:heightMode>

Google uzantısı ad alanında bulunan ve deniz tabanına göre rakımlara izin veren bir KML uzantısı. Değerler şu şekildedir:

• relatedToSeaFloor - <rakam> değerini, deniz tabanının üzerindeki metre cinsinden bir değer olarak yorumlar. Nokta deniz yerine karanın üzerindeyse <rakam> yer üzerinde olacak şekilde yorumlanır.
• clampToSeaFloor: <height> spesifikasyonu dikkate alınmaz ve LookAt, deniz tabanında konumlandırılır. Nokta denizden ziyade karaya bağlıysa LookAt denizde konumlandırılır.

Bu şemada <range>, <tilt> ve <height> öğeleri gösterilmektedir:

 

Bu şemada, <heading> öğesi gösterilmektedir:

 

<?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>

Uzatmalar

• <AbstractView>

İçerir

• <Feature> etiketinden türetilen herhangi bir öğe
• <Ağ Bağlantısı Denetimi>

<Model>

Söz dizimi

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

Açıklama

Bir COLLADA dosyasında açıklanan 3D nesne (<Link> etiketinde başvurulur). COLLADA dosyalarının bir .dae dosya uzantısı vardır. Modeller, kendi koordinat alanlarında oluşturulur ve ardından Google Earth'te konumlandırılır, konumlandırılır ve ölçeklendirilir. Daha fazla ayrıntı için Modeller sayfasındaki "KML'deki konular" sayfasına göz atın.

Google Earth, aşağıdaki istisnalarla COLLADA ortak profilini destekler:

• Google Earth, basit türler olarak yalnızca üçgenleri ve çizgileri destekler. İzin verilen maksimum üçgen sayısı 21845'tir.
• Google Earth, animasyon veya dış görünümü desteklemiyor.
• Google Earth, harici geometri referanslarını desteklemez.

Modele Özel Öğeler

<heightMode>

<Konum> alanında belirtilen <rakam> değerinin nasıl yorumlanacağını belirtir. Olası değerler aşağıdaki gibidir:

• clampToGround - (varsayılan) <height> spesifikasyonunu yoksayıp Model'i yere yerleştirir.
• relToGround - <height> değerini yerden metre cinsinden bir değer olarak yorumlar.
• mutlak- <rakam> değerini, deniz seviyesinin üzerindeki metre cinsinden bir değer olarak yorumlar.

<gx:heightMode>

Google uzantısı ad alanında bulunan ve deniz tabanına göre rakımlara izin veren bir KML uzantısı. Değerler şu şekildedir:

• relatedToSeaFloor - <rakam> değerini, deniz tabanının üzerindeki metre cinsinden bir değer olarak yorumlar. Nokta deniz yerine karanın üzerindeyse <rakam> yer üzerinde olacak şekilde yorumlanır.
• clampToSeaFloor: <height> spesifikasyonu dikkate alınmaz ve Model deniz tabanına yerleştirilir. Nokta deniz yerine karadaysa model zemin üzerinde konumlandırılır.

<Konum>

Modelin kalkış noktasının enlem, boylam ve rakım değerlerini tam olarak belirtir. Enlem ve boylam ölçümleri, WGS84 verisi içeren standart lat-lon tahminidir. Rakım, dünya yüzeyinin metre cinsinden uzaklığıdır ve <heightMode> veya <gx:heightMode>'a göre yorumlanır.

<Location>
  <longitude>39.55375305703105</longitude>
  <latitude>-118.9813220168456</latitude>
  <altitude>1223</altitude>
</Location> 

<Yön>

Bir 3D modelin koordinat sisteminin nesneyi Google Earth'te konumlandırmak için döndürmesini açıklar. Aşağıdaki şemaları inceleyin.

<Orientation>
  <heading>45.0</heading>
  <tilt>10.0</tilt>
  <roll>0.0</roll>
</Orientation> 

Rotasyonlar bir Modele aşağıdaki sırayla uygulanır:

1. <roll>
2. <tilt>
3. <başlık>

<başlık>

Z ekseni çevresinde dönüş (Dünya yüzeyine normal). 0 (varsayılan) değeri Kuzey'e eşittir. Pozitif rotasyon, z ekseninin etrafında saat yönünde ve 0 ile 360 derece arasında belirtilir.

<tilt>

x ekseni etrafında döndürme. Pozitif rotasyon, x ekseninin etrafında saat yönünde ve 0 ile 180 derece arasında belirtilir.

<roll>

y ekseni etrafında döndürme. Pozitif rotasyon, y ekseninde saat yönünde ve 0 ile 180 derece arasında belirtilir.

Bu şema, bir modelin eksenlerinin tipik yönünü göstermektedir:

<Ölçek>

Modeli, koordinat alanındaki x, y ve z eksenleri üzerinden ölçeklendirir.

<Scale>
  <x>2.5</x>
  <y>2.5</y>
  <z>3.5</z>
</Scale>

<Bağlantı>

Yüklenecek dosyayı ve isteğe bağlı yenileme parametrelerini belirtir. <Link> bağlantısını tıklayın.

<ResourceMap>

0 veya daha fazla <Alias> öğesi belirtir. Her biri, orijinal Collada dosyasından Model içeren KML veya KMZ dosyasına bir doku dosyası yolu için eşlemedir. Bu öğe, doku dosyalarını referans alan orijinal Collada dosyasını güncellemek zorunda kalmadan doku dosyalarını taşımanıza ve yeniden adlandırmanıza olanak tanır. Bir <ResourceMap> öğesi, farklı (kaynak) Collada dosyalarından aynı (hedef) KMZ dosyasına birden fazla eşleme içerebilir.

<Alias>
  <targetHref>../images/foo.jpg</targetHref>
  <sourceHref>c:\mytextures\foo.jpg</sourceHref>
</Alias>

<Alias>, <sourceHref> ile <targetHref> arasında eşleme içeriyor:

<targetHref>

Google Earth tarafından getirilen doku dosyasını belirtir. Bu başvuru, .kmz arşivindeki bir resim dosyası için göreli bir başvuru veya dosyaya mutlak bir başvuru (örneğin, bir URL) olabilir.

<sourceHref>

Colada .dae dosyasındaki doku dosyası için belirtilen yol mu?

Google Earth'te bu eşleme sağlanmazsa Collada (.dae) dosyasında başvurulan dokuları bulmak için aşağıdaki kurallar kullanılır:

• Yol yok: Doku adı bir yol içermiyorsa Google Earth, dokuya başvuruda bulunan .dae dosyasıyla aynı dizinde arama yapar.
• Göreli yol: Doku adı göreli bir yol içeriyorsa (örneğin, ../images/mytexture.jpg), Google Earth yolu, ona referans veren .dae dosyasına göre değerlendirir.
• Mutlak yol: Doku adı mutlak bir yol (c:\mytexture.jpg) veya bir ağ yolu (örneğin, http://sunucum.com.tr/benimmetre.jpg) ise Google Earth, .dae dosyasının bulunduğu yere bakılmaksızın dosyayı belirtilen konumda arar.

Örnek

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

Uzatmalar

• <Geometri>

İçerir

• <Çoklu Geometri>
• <Yer işareti>

<Çoklu Geometri>

Söz dizimi

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

Açıklama

Aynı özellikle ilişkilendirilmiş sıfır veya daha fazla geometriye sahip kapsayıcı için bir kapsayıcı.

Not: <GeometryCollection> etiketi kullanımdan kaldırılmıştır. Bunun yerine <MultiGeometry> kullanın.

Çoklu Geometriye Özgü Öğeler

• 0 veya daha fazla <Geometry> öğesi

Örnek

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

Uzatmalar

• <Geometri>

İçerir

• <Çoklu Geometri>
• <Yer işareti>

<gx:Çoklu İzleme>

Bu öğe, OGC KML 2.2 standardının bir uzantısıdır ve Google Earth 5.2 ve sonraki sürümlerinde desteklenir. Daha fazla bilgi

Söz dizimi

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

Açıklama

Birden çok parçalı öğe, birden fazla parça öğesini tek bir kavram biriminde birleştirmek için kullanılır. Örneğin, birkaç günlük dinlenme ve öğle yemeği için mola veren bir bisiklet yolunun GPS verilerini topladığınızı varsayalım. Zamandaki kesintiler nedeniyle, zaman ve konumlar gösterilirken bir bisiklet yolculuğu dört farklı hat olarak görünebilir. Bu <gx:Track> öğelerini bir <gx:MultiTrack> kapsayıcısında gruplamak, Google Earth'te tek bir yolun bölümleri olarak gösterilmesine neden olur. Simge bir segmentin sonuna geldiğinde, sonraki segmentin başına gider. <gx:interpolate> öğesi, bir parçanın sonunda durup sonraki parçanın başlangıcına atlamaya veya iki parça arasında eksik değerleri birleştirmeye imkan tanır.

gx:MultiTrack öğesine özel öğeler

<heightMode>

<ords> öğesinde rakım bileşenlerinin nasıl yorumlanacağını belirtir. Olası değerler:

• clampToGround - (varsayılan) Rakım spesifikasyonunun yoksayılmasını belirtir (örneğin, <gx:coord> öğesinde).
• relToGround - Öğenin rakımını, belirli bir konumun gerçek zemin yüksekliğine göre ayarlar. Örneğin, bir yerin zemin yüksekliği tam olarak deniz seviyesindeyse ve bir noktanın rakımı 9 metreye ayarlıysa bu modla nokta yer işareti yüksekliğinin yüksekliği 9 metre olur. Ancak aynı koordinat, zemin yüksekliğinin deniz seviyesinden 10 metre yüksek olduğu bir konuma ayarlanırsa koordinatın yüksekliği 19 metredir.
• mutlak - Öğenin altındaki arazinin gerçek yüksekliğinden bağımsız olarak koordinatın deniz seviyesine göre yüksekliğini belirler. Örneğin, bir koordinatın rakımını mutlak rakım moduyla 10 metreye ayarlarsanız, altındaki arazi de deniz seviyesinden 10 metre fazlaysa nokta yer işaretinin simgesi yer seviyesinde görünür. Arazi, deniz seviyesinin 3 metre üzerindeyse yer işareti, arazinin üzerinde 7 metre yüksekliğinde görünür.

<gx:heightMode>

Google uzantı ad alanında yer alan ve deniz tabanına göre rakımlara izin veren bir KML uzantısıdır. Değerler şu şekildedir:

• relatedToSeaFloor - Rakımı, deniz tabanının üzerinden metre cinsinden bir değer olarak yorumlar. Nokta denizden değil karadan fazlaysa rakım, yerden yüksek olarak yorumlanır.
• clampToSeaFloor: Rakım spesifikasyonu göz ardı edilir ve nokta deniz tabanına konumlandırılır. Nokta deniz yerine karadaysa nokta karaya yerleştirilir.

<gx:interpolate>

Boole değeri. Çoklu parça birden fazla <gx:Track> öğesi içeriyorsa ilk değerlerin sonu ile sonraki parçanın başı arasında eksik değerlerin birleştirilip birleştirilmeyeceğini belirtir. Varsayılan değer (0) kullanıldığında, simge veya model bir kanalın sonunda durur ve bir sonraki parçanın başına geçer.

İçerikler

• <gx:İzleme>

<Ağ Bağlantısı>

Söz dizimi

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

Açıklama

Yerel veya uzak ağdaki bir KML dosyasına ya da KMZ arşivine başvurur. KML dosyasının konumunu belirtmek için <Link> öğesini kullanın. Bu öğede, zaman ve kamera değişikliğine bağlı olarak dosyayı güncellemek için yenileme seçeneklerini tanımlayabilirsiniz. NetworkLink'ler, çok büyük veri kümelerini verimli bir şekilde işlemek için Bölgeler ile birlikte kullanılabilir.

NetworkLink'e Özel Öğeler

<RefreshGörünürlük>

Boole değeri. 0 değeri, özelliklerin görünürlüğünü Google Earth kullanıcısının denetiminde bırakır. NetworkLink her yenilendiğinde özelliklerin görünürlüğünü sıfırlamak için değeri 1 olarak ayarlayın. Örneğin, bağlı KML dosyasının içindeki bir Yer İşareti'nin <görünürlük> 1 ve Ağ Bağlantısının <yenilemeGörünürlük> değerini 1 olarak ayarladığını varsayalım. Dosya Google Earth'e ilk kez yüklendiğinde, 3B görüntüleyicide görüntüyü kapatmak için kullanıcı öğenin yanındaki onay kutusunu temizleyebilir. Bununla birlikte, Ağ Bağlantısı yenilendiğinde, orijinal görünürlük durumu TRUE olduğundan yer işareti tekrar görünür olur.

<flyToView>

Boole değeri. 1 değeri, Google Earth'ün NetworkLinkControl'de (varsa) LookAt veya Kamera görünümüne uçmasına neden olur. NetworkLinkControl bir AbstractView öğesi içermiyorsa Google Earth, yenilenen dosyadaki <KML> öğesindeki Özellik alt öğesi içinde LookAt veya Kamera öğesine gider. <KML> öğesinde bir LookAt veya Kamera belirtilmemişse görünüm değişmez. Örneğin, Google Earth, dokümanın içindeki Yer İşaretlerinin <LookAt> görünümüyle değil, üst Dokümanın <LookAt> görünümüyle uçar.

<Link>(zorunlu)

İpucu: Üst düzey klasörü veya dokümanı liste görünümünde bir ağ bağlantısında görüntülemek için klasöre veya dokümana bir kimlik atayın. Bu kimlik olmadan, liste görünümünde yalnızca alt nesne adları gösterilir.

Örnek

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

Uzatmalar

• <Özellik>

İçerir

• <Kapsayıcı> terimlerinden türetilen herhangi bir öğe

<Ağ Bağlantısı Denetimi>

Söz dizimi

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

Açıklama

<NetworkLink> tarafından getirilen dosyaların davranışını kontrol eder.

NetworkLinkControl'a Özel Öğeler

<minRefreshPeriod>

Saniye cinsinden belirtilir. <minRefreshPeriod>, dosya getirmeler arasında izin verilen minimum süredir. Bu parametre, sunucuların belirli bir dosyayı getirmesini azaltmasına ve yenileme hızlarını verilerde beklenen değişiklik oranına uyarlamasına olanak tanır. Örneğin, bir kullanıcı, bağlantı yenileme işlemini 5 saniyeye ayarlayabilir, ancak yenileme güncellemelerini her saatle sınırlamak için minimum yenileme süresini 3600 olarak ayarlayabilirsiniz.

<maxSessionLength>

<maxSessionLength> saniye cinsinden belirtilir. Bu, istemci NetworkLink'in bağlı kalabileceği maksimum süredir. -1 olan varsayılan değer, oturumu açık bir şekilde sonlandırmayacağını gösterir.

<çerez>

Ağ bağlantısının yenilenmesinde URL sorgusuna dize eklemek için bu öğesini kullanın. Komut dosyası oluştururken bu verileri, sunucu tarafında daha akıllı işleme sağlamak için (sürüm sorgulama ve koşullu dosya yayınlama dahil) kullanabilirsiniz.

<message>

Ağ bağlantınıza yönelik kullanım kuralları gibi bir pop-up mesaj gönderebilirsiniz. Mesaj, ağ bağlantısı Google Earth'e ilk kez yüklendiğinde veya ağ bağlantısı kontrolünde değiştirildiğinde görünür.

<bağlantıAdı>

Ağ bağlantısının adını sunucudan kontrol edebilirsiniz. Böylece istemci tarafında adında yapılan değişiklikler sunucu tarafından geçersiz kılınır.

<linkDescription>

Ağ bağlantısının açıklamasını sunucudan kontrol edebilirsiniz. Böylece istemci tarafında açıklamada yapılan değişiklikler sunucu tarafından geçersiz kılınır.

<linkSnippet maxLines="2" >

Ağ bağlantısı için snippet'i sunucudan kontrol edebilirsiniz. Böylece istemci tarafında snippet'te yapılan değişiklikler sunucu tarafından geçersiz kılınır. <linkSnippet>, görüntülenecek maksimum satır sayısını belirten bir tam sayı olan maxLines özelliğine sahiptir.

<süresi doluyor>

Bağlantının yenileneceği tarihi/saati belirtebilirsiniz. Bu spesifikasyon yalnızca <Link> öğesindeki <renewMode> değeri onExpire ise geçerli olur. Bkz. <RefreshMode>

<Güncelle>

<Güncelle> ile, daha önce bir ağ bağlantısıyla yüklenmiş .km dosyası veya .kmz arşivi için istediğiniz sayıda Değiştir, Oluştur ve Sil etiketi belirtebilirsiniz. <Update> bölümünü inceleyin.

<AbstractView>

Örnek

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

Uzatmalar

• Bu, <KML> öğesinin doğrudan alt öğesidir.

İçerir

• <KML>

İlgili Konular

• <Güncelle>
• <Ağ Bağlantısı>

<Nesne>

Söz dizimi

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

Açıklama

Bu, soyut bir temel sınıftır ve doğrudan bir KML dosyasında kullanılamaz. Bir KML öğesinin benzersiz bir şekilde tanımlanmasına olanak tanıyan id özelliğini ve Google Earth'e önceden yüklenmiş nesneleri referans almak için kullanılan targetId özelliğini sağlar. <Update> mekanizması kullanılacaksa id özelliği atanmalıdır.

<Yer paylaşımı>

Söz dizimi

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

Açıklama

Bu, soyut bir öğedir ve doğrudan bir KML dosyasında kullanılamaz. <Yer paylaşımı>, gezegenin yüzeyine veya ekrana çizilen görüntü bindirmelerinin temel türüdür. <Icon> kullanılacak resmi belirtir ve bir zamanlayıcıya veya kamera değişikliklerine göre resimleri yeniden yükleyecek şekilde yapılandırılabilir. Bu öğe, birden fazla bindirmenin yığılmasıyla ilgili sıralamanın yanı sıra temel resme renk ve şeffaflık değerleri eklenmesi için de spesifikasyonlar içerir.

Yer Paylaşımına Özel Öğeler

<color>

Renk değerleri opaklık (alfa) değerleri dahil olmak üzere on altılı gösterimle ifade edilir. İfadenin sırası alfa, mavi, yeşil, kırmızı (aabbggrr) şeklindedir. Herhangi bir renk aralığı 0-255 arasındadır (00 - ff). Opaklık için 00 tamamen opak, ff ise tamamen opaktır. Örneğin, yer paylaşımına yüzde 50 opaklık olan mavi bir renk uygulamak için aşağıdakileri belirtirsiniz: <color>7fff0000</color>

Not: <geomColor> öğesi kullanımdan kaldırıldı. Bunun yerine <color> kullanın.

<çizgi sırası>

Bu öğe, çakışan yer paylaşımlarında resimlerin yığın sırasını tanımlar. Daha yüksek <drawOrder> değerlerine sahip yer paylaşımları, daha düşük <drawOrder> değerlerine sahip yer paylaşımlarının üzerine çizilir.

<Simge>

Yer paylaşımıyla ilişkili görüntüyü tanımlar. <href> öğesi, Yer Paylaşımı olarak kullanılacak resmin konumunu tanımlar. Bu konum yerel bir dosya sisteminde veya bir web sunucusunda olabilir. Bu öğe atlanırsa veya <href> içermezse zemin veya ekran yer paylaşımı tarafından tanımlanan renk ve boyut kullanılarak bir dikdörtgen çizilir.

<Icon>
   <href>icon.jpg</href>
</Icon>

Uzatmalar

• <Özellik>

Şunun Tarafından Uzatıldı:

• <Groundground>
• <Fotoğraf Bindirme>
• <Ekran Bindirme>

<Fotoğraf Bindirme>

Söz dizimi

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

Açıklama

<Fotoğraf Bindirme> öğesi, Dünya üzerinde bir fotoğrafı coğrafi olarak bulmanıza ve bu Yer Paylaşımlı fotoğraf için görüntüleme parametrelerini belirtmenize olanak sağlar. Fotoğraf Bindirme basit bir 2D dikdörtgen, bir kısmi veya tam silindir ya da bir küre (küresel panoramalar) olabilir. Yer paylaşımı, belirtilen konuma yerleştirilir ve seyir noktasına yönlendirilir.

< PhotoOverlay> <Feature> etiketinden türetildiğinden, <AbstractView> öğesinden türetilen iki öğeden birini içerebilir: <Kamera> veya <LookAt>. Kamera (veya LookAtlan) bir görüntü noktası ve bir görüntü yönü (görüntü vektörü olarak da adlandırılır) belirtir. Fotoğraf Bindirme, görüş noktasına göre konumlandırılır. Özellikle, 2D dikdörtgen resmin düzlemi, görünüm vektörünün dikey (dik açıda) düzlemidir. Bu uçağın normali, yani fotoğrafın parçası olan ön cephe, bakış açısına yönelmiştir.

PhotoOverlay resminin URL'si, <Overlay> etiketinden devralınan <Icon> etiketinde belirtilir. <Icon> etiketi, PhotoOverlay için kullanılacak resim dosyasını belirten bir <href> öğesi içermelidir. Çok büyük bir resim söz konusu olduğunda, <href> farklı çözünürlüklere sahip resimlerden oluşan bir piramitle dizine eklenen özel bir URL'dir (bkz. ImagePyramid).

Daha fazla bilgi için Fotoğraf Bindirmesi'ndeki "KML'deki Konular" sayfasına bakın.

PhotoOverlay'e Özel Öğeler

<rotasyon>

Fotoğrafın görüş alanının içine nasıl yerleştirileceğini ayarlar. Bu öğe, fotoğrafınız döndürüldüyse ve istediğiniz yatay görünümde biraz sapma gösteriyorsa yararlıdır.

<ViewVolume>

Mevcut sahnenin ne kadarının görünür olduğunu tanımlar. Görüş alanı, objektif kamerada açılan camı belirtmeye benzer. Telefoto lens gibi, küçük bir görüş alanı sahnenin küçük bir kısmına odaklanır. Geniş açı lens gibi geniş bir görüş alanı, sahnenin büyük bir kısmına odaklanır.

<leftFov>

Kameranın görüntüleme yönü ile görüntüleme hacminin sol tarafı arasındaki derece cinsinden derece.

<sağFov>

Kameranın görüntüleme yönü ile görüntüleme hacminin sağ tarafı arasındaki derece cinsinden derece.

<bottomFov>

Kameranın görüntüleme yönü ile görüntüleme hacminin alt kenarı arasındaki derece cinsinden derece.

<topFov>

Kameranın görüntüleme yönü ile görüntüleme hacminin üst tarafı arasındaki derece cinsinden derece.

<yakın>

Kameranın görüş noktasından PhotoOverlay şekline kadar, görüntüleme yönü boyunca metre cinsinden ölçüm.

Bir Fotoğraf Bindirmesinin görüş alanı, her biri görüntü vektörüne göre bir açıyla belirtilen dört düzlemle tanımlanır. Bu dört düzlem, aşağıda gösterildiği gibi kesilmiş bir piramit şeklinde görünen görüş alanının üst, alt, sol ve sağ taraflarını tanımlar:

Aşağıdaki diyagramlarda, bu piramitteki dört görüş alanı açısı gösterilmektedir:

<Görüntü Piramidi>

Çok büyük resimlerde, her biri orijinal resmin gitgide daha düşük çözünürlüklü bir sürümü olan hiyerarşik resim kümesi olan bir piramit oluşturmanız gerekir. Piramitteki her resim parçalara ayrıldığından yalnızca görüntülenen bölümlerin yüklenmesi gerekir. Google Earth geçerli bakış noktasını hesaplar ve kullanıcının görsele olan mesafesine uygun karoları yükler. Seyir noktası PhotoOverlay'e yaklaştıkça Google Earth daha yüksek çözünürlüklü bloklar yükler. Orijinal resimdeki tüm pikseller ekranda aynı anda görüntülenemediğinden, bu ön işleme Google Earth'ün yalnızca görüntüde görünen bölümlerini ve yalnızca kullanıcının geçerli bakış açısıyla algılayabileceği piksel ayrıntılarını yüklediğinden maksimum performans elde etmesine olanak tanır.

Bir resim piramidi belirlerken, hangi karoların yükleneceğine dair spesifikasyonlar eklemek için <Icon> öğesindeki <href> öğesini de değiştirebilirsiniz.

<tileSize>

Karoların piksel cinsinden boyutu. Parçalar kare ve <tileSize> 2'nin kuvveti olmalıdır. 256 (varsayılan) veya 512 boyutunda bir karo önerilir. Orijinal resim, farklı çözünürlüklerde bu boyuttaki parçalara bölünür.

<maxWidth>

Orijinal resmin piksel cinsinden genişliği.

<maxHeight>

Orijinal resmin piksel cinsinden yüksekliği.

<gridOrigin>

Piramitin her katmanındaki karoları numaralandırmaya nereden başlayacağınızı belirtir. lowerLeft değeri, her bir katmanın 1. satırının, 1. sütununun ızgaranın sol alt köşesinde olduğunu belirtir.

<Nokta>

<Point> öğesi, bir <bookmark> öğesinin içinde <Point> olarak çalışır. PhotoOverlay'in konumunu işaretlemek için bir simge çizer. Çizilen simge, <styleUrl> ve <StyleSelector> alanları tarafından <bookmark> için olduğu gibi belirtilir.

<şekil>

Fotoğraf Bindirmesinin projeksiyonu <şekil> olarak öngörülür. <şekil> şunlardan biri olabilir:

dikdörtgen (varsayılan) - normal bir fotoğraf için

silindir: Kısmi veya tam silindir olabilecek panoramik resimler için

küre: Küresel panoramalar

Örnek

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

Uzatmalar

• <Yer paylaşımı>

İçerir

• <Folder>, <Document> veya <KML>

<Yer işareti>

Söz dizimi

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

Açıklama

Yer işareti, ilişkili geometriye sahip bir özelliktir. Google Earth'te, Yer İşaretleri'nde bir yer işareti liste olarak görünür. Noktalı Yer İşareti, kendisiyle ilişkilendirilmiş bir simgeye sahiptir. Bu simge, 3B görüntüleyicideki Dünya üzerinde bir noktayı işaret eder. (Google Earth 3D görüntüleyicisinde bir Nokta Yer İşareti, tıklayabileceğiniz veya üzerine getirebileceğiniz tek nesnedir. Diğer geometrik nesnelerin 3D görüntüleyicide bir simgesi yoktur. Kullanıcıya 3D görüntüleyicide tıklaması için bir şey vermek isterseniz hem Nokta hem de diğer bir Geometri nesnesini içeren bir MultiGeometry nesnesi oluşturmanız gerekir.)

Yer İşaretine Özel Öğeler

• 0 veya bir <Geometry> öğesi

Örnek

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

Uzatmalar

• <Özellik>

İçerir

• <Doküman>
• <Klasör>

İlgili Konular

• <Simge>

<Nokta>

Söz dizimi

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

Açıklama

Boylam, enlem ve (isteğe bağlı) rakımla tanımlanan bir coğrafi konum. Nokta bir Yer İşareti'ne dahil olduğunda, noktanın kendisi Yer İşareti'nin adının ve simgesinin konumunu belirler. Bir Nokta geri çekildiğinde, zemine bir çizgiyle bağlı olur. Bu "tether", mevcut LineStyle'ı kullanır.

Noktaya Özgü Öğeler

<lisans>

Boole değeri. Noktaya zemine bir çizgiyle bağlanılıp bağlanmayacağını belirtir. Bir Noktayı genişletmek için <heightMode> değeri alakalıToGround, relToSeaFloor veya mutlak olmalıdır. Nokta, Dünya Küresi'nin merkezine doğru uzatılır.

<heightMode>

<ords> öğesinde rakım bileşenlerinin nasıl yorumlanacağını belirtir. Olası değerler:

• clampToGround - (varsayılan) Bir rakım spesifikasyonunun (ör. < Koordinatörs> etiketinde) yoksayılacağını belirtir.
• relToGround - Öğenin rakımını, belirli bir konumun gerçek zemin yüksekliğine göre ayarlar. Örneğin, bir yerin zemin yüksekliği tam olarak deniz seviyesindeyse ve bir noktanın rakımı 9 metreye ayarlıysa bu modla nokta yer işareti yüksekliğinin yüksekliği 9 metre olur. Ancak aynı koordinat, zemin yüksekliğinin deniz seviyesinden 10 metre yüksek olduğu bir konuma ayarlanırsa koordinatın yüksekliği 19 metredir. Bu modun tipik bir kullanım alanı telefon direkleri veya telesiyej kullanmaktır.
• mutlak - Öğenin altındaki arazinin gerçek yüksekliğinden bağımsız olarak koordinatın deniz seviyesine göre yüksekliğini belirler. Örneğin, bir koordinatın rakımını mutlak rakım moduyla 10 metreye ayarlarsanız, altındaki arazi de deniz seviyesinden 10 metre fazlaysa nokta yer işaretinin simgesi yer seviyesinde görünür. Arazi, deniz seviyesinin 3 metre üzerindeyse yer işareti, arazinin üzerinde 7 metre yüksekliğinde görünür. Bu modun genel kullanım alanı uçak yerleşimidir.

<gx:heightMode>

Google uzantısı ad alanında bulunan ve deniz tabanına göre rakımlara izin veren bir KML uzantısı. Değerler şu şekildedir:

• relatedToSeaFloor - Rakımı, deniz tabanının üzerinden metre cinsinden bir değer olarak yorumlar. Nokta denizden değil karadan fazlaysa rakım, yerden yüksek olarak yorumlanır.
• clampToSeaFloor: Rakım spesifikasyonu göz ardı edilir ve nokta deniz tabanına konumlandırılır. Nokta deniz yerine karadaysa nokta karaya yerleştirilir.

< Koordinatörs>(zorunlu)

boylam, enlem ve boylam için (bu sırayla) kayan nokta değerlerinden oluşan tek bir unsur. Boylam ve enlem değerleri derece cinsinden sunulur.

• boylam ≥ ÷ 180 ve <= 180
• enlem ≥ 90 ve ≤ 90
• rakım değerleri (isteğe bağlı) metre, deniz seviyesinin üzerindedir

Bir koordinasyonu açıklayan üç değer arasına boşluk eklemeyin.

Örnek

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

Uzatmalar

• <Geometri>

İçerir

• <Çoklu Geometri>
• <Yer işareti>

<Poligon>

Söz dizimi

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

Açıklama

Poligon, dış sınır ve 0 veya daha fazla iç kenarlıkla tanımlanır. Sınırlar ise Doğrusal Ring'ler tarafından tanımlanır. Bir Çokgen genişletildiğinde, sınırları zemine bağlı olarak daha fazla poligon oluşturur. Bu, bir bina veya kutunun görünümünü sağlar. Genişletilen Poligonlar renk, renk modu ve dolgu için <PolyStyle> kullanır.

Poligonlar için <koordinatlar> saat yönünün tersine belirtilmelidir. Poligonlar "sağ kuralı"nı izler. Bu kural, sağ parmağınızı parmaklarınızı koordinatların belirtildiği yöne konumlandırdığınızda başparmağınızın poligon için genel geometrik yönü işaret ettiği anlamına gelir. (3D grafiklerde, geometrik normallik aydınlatma için kullanılır ve çokgenin ön yüzünden uzaklaştırılır.) Google Earth poligonların yalnızca ön yüzünü doldurduğundan, koordinatlar doğru sırada belirtildiğinde istenen etkiyi elde edersiniz. Aksi takdirde, çokgen gri olur.

Not: Google Earth'te <heightMode> clampToGround olan bir Poligon sabit sabit hatlarını izler, ancak <heightMode> clampToGround olan bir Doğrusal Ring mükemmel daire çizgilerini izler.

Poligona Özgü Öğeler

<lisans>

Boole değeri. Poligon'un yere bağlanıp bağlanmayacağını belirtir. Bir Çokgeni genişletmek için rakım modu gösterinToGround, relToSeaFloor veya mutlak olmalıdır. Yalnızca kesitler geometrinin içine değil uzatılır (örneğin, bir dikdörtgen beş yüz içeren bir kutuya dönüşür). Poligonların tepesi Dünya'nın ortasına doğru uzanır.

<tessellate>

Bu alan, Polygon tarafından kullanılmıyor. Bir Poligon'un araziyi takip etmesine izin vermek (yani yönlendirmeyi etkinleştirmek) için clampToGround veya clampToSeaFloor rakım modunu belirtin.

<heightMode>

<ords> öğesinde rakım bileşenlerinin nasıl yorumlanacağını belirtir. Olası değerler:

• clampToGround - (varsayılan) Bir rakım spesifikasyonunun (ör. < Koordinatörs> etiketinde) yoksayılacağını belirtir.
• relToGround - Öğenin rakımını, belirli bir konumun gerçek zemin yüksekliğine göre ayarlar. Örneğin, bir yerin zemin yüksekliği tam olarak deniz seviyesindeyse ve bir noktanın rakımı 9 metreye ayarlıysa bu modla nokta yer işareti yüksekliğinin yüksekliği 9 metre olur. Ancak aynı koordinat, zemin yüksekliğinin deniz seviyesinden 10 metre yüksek olduğu bir konuma ayarlanırsa koordinatın yüksekliği 19 metredir. Bu modun tipik bir kullanım alanı telefon direkleri veya telesiyej kullanmaktır.
• mutlak - Öğenin altındaki arazinin gerçek yüksekliğinden bağımsız olarak koordinatın deniz seviyesine göre yüksekliğini belirler. Örneğin, bir koordinatın rakımını mutlak rakım moduyla 10 metreye ayarlarsanız, altındaki arazi de deniz seviyesinden 10 metre fazlaysa nokta yer işaretinin simgesi yer seviyesinde görünür. Arazi, deniz seviyesinin 3 metre üzerindeyse yer işareti, arazinin üzerinde 7 metre yüksekliğinde görünür. Bu modun genel kullanım alanı uçak yerleşimidir.

<gx:heightMode>

Google uzantısı ad alanında bulunan ve deniz tabanına göre rakımlara izin veren bir KML uzantısı. Değerler şu şekildedir:

• relatedToSeaFloor - <rakam> değerini, deniz tabanının üzerindeki metre cinsinden bir değer olarak yorumlar. Nokta denizden değil karadan fazlaysa rakım, yerden yüksek olarak yorumlanır.
• clampToSeaFloor: Rakım spesifikasyonu göz ardı edilir ve nokta deniz tabanına konumlandırılır. Nokta deniz yerine karadaysa nokta karaya yerleştirilir.

<outerBoundaryIs>(zorunlu)

<DoğrusalRing> öğesi içerir.

<dahiliBoundaryIs>

<DoğrusalRing> öğesi içerir. Poligon, birden fazla <internalBoundaryIs> öğesi içerebilir. Bu öğeler, Poligon içinde birden fazla kesim oluşturur.

Örnek

<?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>

Uzatmalar

• <Geometri>

İçerir

• <Çoklu Geometri>
• <Yer işareti>

<PolyStil>

Söz dizimi

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

Açıklama

Poligonlar (binaların duvarları gibi görünür) ve çizgi hariç tutmalar (sabit çitler gibi görünür) dahil, tüm poligonların çizim stilini belirtir.

PolyStyle'a Özel Öğeler

<dolgu>

Boole değeri. Poligonun doldurulup doldurulmayacağını belirtir.

<outline>

Boole değeri. Poligonun dış çizgili olup olmadığını belirtir. Poligon ana hatları mevcut Çizgi Stilini kullanır.

Örnek

<?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>

Uzatmalar

• <RenkStil Stili>

İçerir

• <Stil>

<Bölge>

Söz dizimi

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

Açıklama

Bölge, coğrafi koordinatlar ve rakımlarla tanımlanan bir ilgi alanını tanımlayan sınır kutusu (<LatLonAltBox>) içerir. Ayrıca Bölge, tahmini Ekran boyutu olarak ilişkili Bölgenin geçerlilik aralığını tanımlayan bir LOD (ayrıntı düzeyi) kapsamı (<Lod>) içerir. Sınırlayıcı kutu, kullanıcının gördüğü kapsama alanı içindeyken ve LOD koşulları karşılandığında bir bölgenin "etkin" olduğu söylenir. Bir Bölgeyle ilişkili nesneler yalnızca Bölge etkin olduğunda çekilir. <viewRefreshMode> onRegion olduğunda, Bağlantı veya Simge yalnızca Bölge etkin olduğunda yüklenir. Daha ayrıntılı bilgi için Bölgeler'deki "KML'deki konular" sayfasını inceleyin. Kapsayıcı veya NetworkLink hiyerarşisinde bu hesaplama, hiyerarşideki en yakın üst öğe olan Bölgeyi kullanır.

Bölgeye Özel Öğeler

<LatLonAltBox>(zorunlu)

İlgi alanlarını coğrafi koordinatlar ve rakımlarla tanımlayan sınırlayıcı kutu. Varsayılan değerler ve zorunlu alanlar aşağıdaki gibidir:

<heightMode> veya <gx:heightMode>

<heightMode> için olası değerler clampToGround, relToGround ve Mutlak'tır. <gx:heightMode> için olası değerler clampToSeaFloor ve relatedToSeaFloor'dur. Ayrıca <LatLonBox> sayfasına bakın.

<minRakım>

Metre cinsinden belirtilir (ve rakım modu spesifikasyonundan etkilenir).

<maxRakım>

Metre cinsinden belirtilir (ve rakım modu spesifikasyonundan etkilenir).

<north> (zorunlu)

Sınırlama kutusunun kuzey kenarının enlemini, 0 ile ~90 arasında ondalık derece olarak belirtir.

<south> (zorunlu)

Sınırlama kutusunun güney kenarının enlemini, 0 ile %%90 arasında ondalık derece olarak belirtir.

<east> (zorunlu)

Sınırlayıcı kutunun doğu kenarının boylamını 0 ile ‐180 arasında ondalık derece olarak belirtir.

<west> (zorunlu)

Sınırlayıcı kutunun batı kenarının boylamını 0 ile ‐180 arasında ondalık derece olarak belirtir.

<LatLonAltBox>
  <north>43.374</north>
  <south>42.983</south>
  <east>-0.335</east>
  <west>-1.423</west>
  <minAltitude>0</minAltitude>
  <maxAltitude>0</maxAltitude>
</LatLonAltBox>

<Yüksek>

Lod, Ayrıntı Düzeyi'nin kısaltması. <Lod>, bölgenin "etkin" olarak kabul edilmesi için gereken tahmini proje boyutunu tanımlar. Şeffaflaşmak (şeffaftan opak) veya opaklaşmak (opaktan şeffafa) için kullanılan piksel rampasının boyutunu da belirtir. Bu parametrelerin görsel temsili için aşağıdaki şemaya bakın.

<Lod>
  <minLodPixels>256</minLodPixels>
  <maxLodPixels>-1</maxLodPixels>
  <minFadeExtent>0</minFadeExtent>
  <maxFadeExtent>0</maxFadeExtent>
</Lod>

<minLodPixels> (zorunlu)

Ekran alanının içinde, belirtilen değerin yanlarını piksel cinsinden belirten bir kare tanımlar. Örneğin, 128, 128 x 128 piksellik bir kareyi tanımlar. Bölgenin etkin olması için bölgenin sınırlama kutusu bu kareden büyük (ve maxLodPixels kareden küçük) olmalıdır.

Daha fazla ayrıntıyı hem Geliştirici Kılavuzu'nun Bölgelerle Çalışma bölümünde hem de Google Earth Destek dokümanlarının Bölgelerle Aşırı Yüklemeden kaçınma eğiticisinde bulabilirsiniz.

<maxLodPixels>

Belirli bir bölge için görünürlük aralığının maksimum sınırını temsil eden ekran pikselleri cinsinden ölçüm. Varsayılan olarak ÷1 değeri, "etkinten sonsuza kadar boyut" değerini gösterir.

<minFadeExtt>

Tamamen opak olan şeffaftan tamamen şeffaf olan geometriye sahip kararma mesafesi. Ekran pikselleriyle ifade edilen bu rampa değeri, LOD (görünürlük) sınırlarının minimum ucunda uygulanır.

<maxFadeExtt>

Tamamen şeffaftan tamamen opak olacak şekilde geometrik rengin göründüğü mesafe. Ekran pikselleriyle ifade edilen bu rampa değeri, LOD (görünürlük) sınırlarının maksimum ucunda uygulanır.

Aşağıdaki şemada, P=hesaplanan tahmini piksel boyutu şu şekildedir, dairesel sayılar aşağıdakileri belirtir:

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

<Bölge> örneği

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

Uzatmalar

• <Nesne>

İçerir

• <Feature> etiketinden türetilen herhangi bir öğe

<Şema>

Söz dizimi

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

Açıklama

KML Özellikleri'ne özel veri eklemek için kullanılan özel bir KML şemasını belirtir. "id" özelliği gereklidir ve KML dosyası içinde benzersiz olmalıdır. <Schema> her zaman <document> alt öğesidir.

Şemaya Özel Öğeler

Bir Şema öğesi, bir veya daha fazla SimpleField öğesi içeriyor. SimpleField'ta Schema, özel alanın type ve name alanını tanımlar. İsteğe bağlı olarak bu özel alan için displayName (Google Earth'te görüntülemede boşluklar ve uygun noktalama işaretleriyle birlikte kullanıcı dostu form) belirtir.

<BasitAlan türü="string" name="string">

Özel alanın beyanı. Bu alanın hem türü hem de adı belirtilmelidir. type veya name atlanırsa alan yoksayılır. Tür, aşağıdakilerden biri olabilir:

• string
• int
• ipucu
• kısa video
• kısa
• kayan noktalı
• double
• bool

<displayName>

Alan adı Google Earth kullanıcısına gösterildiğinde kullanılacak ad (varsa). Standart HTML işaretlemesini kod dışına almak için [CDATA] öğesini kullanın.

Örnek

<?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>

Uzatmalar

Bu bir kök öğedir.

İçerir

• <Doküman>

İlgili Konular

• <SchemaData>

<Ekran Bindirme>

Söz dizimi

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

Açıklama

Bu öğe, ekrana sabitlenmiş bir resim yer paylaşımı çizer. Ekran Yer Paylaşımları'nın kullanım alanları arasında pusulalar, logolar ve uyarı ekranları bulunur. Ekran Yer Paylaşımı boyutlandırması <size> öğesi tarafından belirlenir. Bindirmenin konumlandırması, <overlayXY> tarafından belirtilen resimdeki bir noktanın <screenXY> tarafından ekrandaki bir noktayla eşlenmesiyle gerçekleştirilir. Daha sonra resim, <rotationXY> tarafından belirtilen ekrana göre bir noktayla ilgili olarak <rotasyon> derece döndürülür.

<Icon> öğesinin <href> alt öğesi, yer paylaşımı olarak kullanılacak resmi belirtir. Bu dosya yerel bir dosya sisteminde veya bir web sunucusunda olabilir. Bu öğe atlanırsa veya <href> içermezse ekran yer paylaşımı tarafından tanımlanan renk ve boyut kullanılarak bir dikdörtgen çizilir.

Ekran Yer Paylaşımına Özel Öğeler

<overlayXY>

Ekran koordinatı (<screenXY>) ile eşlenen yer paylaşımı resminin üzerinde (veya dışında) bir nokta belirtir. x ve y değerleri ile bu değerler için birimler kullanılması gerekir.

x ve y değerleri üç farklı şekilde belirtilebilir: piksel ("pixels"), resmin kesirleri ("fraction") veya resmin sağ üst köşesinden piksel cinsinden ofset olan iç piksel ("insetPixels") olarak. x ve y konumları farklı şekillerde belirtilebilir. Örneğin, x piksel olarak ve y kesirli olabilir. Koordinat sisteminin kaynağı resmin sol alt köşesindedir.

• x: Piksel sayısı, resmin kesirli bir bileşeni veya bindirme görüntüsündeki bir noktanın x bileşenini gösteren bir piksel girişi.
• y - Piksel sayısı, resmin kesirli bir bileşeni veya bindirme resmindeki bir noktanın y bileşenini gösteren bir piksel girişi.
• xunits: x değerinin belirtildiği birimler. "fraction" değeri, x değerinin resmin bir kesiri olduğunu gösterir. "pixels" değeri, piksel cinsinden x değerini gösterir. "insetPixels" değeri, resmin sağ kenarından girintiyi belirtir.
• yunits: y değerinin belirtildiği birimler. "fraction" değeri, y değerinin resmin bir kesiri olduğunu gösterir. "pixels" değeri, piksel cinsinden y değerini gösterir. "insetPixels" değeri, resmin üst kenarından girintiyi gösterir.

<ekranXY>

Yer paylaşımı resminin eşlendiği ekran kaynağına göre bir nokta belirtir. x ve y değerleri üç farklı şekilde belirtilebilir: piksel ("pixels"), ekranın kesirleri ("fraction") veya ekranın sağ üst köşesinden piksel cinsinden ofset olan iç piksel ("insetPixels") olarak. x ve y konumları farklı şekillerde belirtilebilir. Örneğin, x piksel olarak ve y kesirli olabilir. Koordinat sisteminin kaynağı ekranın sol alt köşesindedir.

• x: Piksel sayısı, ekranın bir kesirli bileşeni veya ekrandaki bir noktanın x bileşenini gösteren bir piksel girişi.
• y: Ekrandaki bir noktanın y bileşenini gösteren piksel sayısı, ekranın kesirli bir bileşeni veya bir piksel girişi.
• xunits: x değerinin belirtildiği birimler. "fraction" değeri, x değerinin ekranın bir kısmı olduğunu belirtir. "pixels" değeri, piksel cinsinden x değerini gösterir. "insetPixels" değeri, ekranın sağ kenarından girintiyi gösterir.
• yunits: y değerinin belirtildiği birimler. Kesirli değeri, y değerinin ekranın bir kısmı olduğunu belirtir. "pixels" değeri, piksel cinsinden y değerini gösterir. "insetPixels" değeri, ekranın üst kenarından girintiyi gösterir.

Örneğin, <screenXY x=".5" y=".5" xunits="fraction" yunits="fraction"/> ekranın ortasındaki bir noktayı gösterir.

Bazı örnekler:

Görüntüyü ortalayın:

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

Resmi sol üste yerleştirin:

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

Görseli ekranın sağına yerleştirin:

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

<rotasyonXY>

Ekranın yer paylaşımı döndürüldüğü ekrana göre işaret eder.

<boyut>

Ekran yer paylaşımı için resmin boyutunu aşağıdaki gibi belirtir:

• ‐1 değeri, yerel boyutun kullanılacağını gösterir
• 0 değeri, en boy oranını koruyacağını gösterir
• n değeri, boyutun değerini belirler

Örneğin:

Görüntüyü orijinal x ve y boyutlarını saklamaya zorlamak için değerleri ‐1 olarak ayarlayın:

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

Resmin yatay boyutunu korumasına ve dikey ekran alanının %20'sini kaplamaya zorlamak için:

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

Resmin 100x500 piksel boyutunda yeniden boyutlandırılmasını sağlamak için:

<size x="100" y="500" xunits="pixels" yunits="pixels"/> 

<rotasyon>

Üst nesnenin dönüş açısını belirtir. 0 değeri, rotasyonun olmadığı anlamına gelir. Değer, kuzeyden saat yönünün tersine bir derecedir. Üst nesnenin 0'dan dönüşünü belirtmek için ‐180'i kullanın. <rotation> merkezi, değilse (.5,.5) <rotationXY> içinde belirtilir.

Örnek

Aşağıdaki örnekte, resim orijinal genişliği, yüksekliği ve en boy oranı kullanılarak ekranın tam merkezine yerleştirilmektedir.

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

Uzatmalar

• <Özellik>
• <Yer paylaşımı>

İçerir

• <Doküman>
• <Klasör>

<Stil>

Söz dizimi

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

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

Açıklama

Stil, StyleMaps ve Özellikler'de başvurulabilen, adreslenebilir bir stil grubunu tanımlar. Stiller, 3B görüntüleyicide Geometri'nin sunulma şeklini ve Özelliklerin, Liste görünümünün Yerler panelinde nasıl görüneceğini etkiler. Paylaşılan stiller bir <Belge>'de toplanır ve bunları kullanan bağımsız Özellikler tarafından referans olarak kullanılabilmeleri için bir id ile tanımlanmalıdır.

<styleUrl> stiline atıfta bulunmak için bir id kullanın.

Örnek

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

Uzatmalar

• <StilSeçici>

İçerir

• Herhangi bir <Özellik>

Stile Özel Öğeler

• <Balon Stili>
• <Simge Stili>
• <Etiket Stili>
• <Çizgi Stili>
• <ListStyle>
• <PolyStyle>

<StyleMap>

Söz dizimi

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

Açıklama

Bir <StyleMap> iki farklı Stil arasında eşlenir. Genellikle bir <StyleMap> öğesi, bir yer işareti için ayrı normal ve vurgulanan stiller sağlamak üzere kullanılır. Böylece, kullanıcı Google Earth'teki simgenin üzerine geldiğinde vurgulanan sürüm görünür.

StyleMap'e Özel Öğeler

<Eşle>(zorunlu)

Bir modu (normal veya vurgu) önceden tanımlanmış <styleUrl> ile eşleyen bir anahtar/değer çifti tanımlar. <Eşlem> iki öğe içerir (her ikisi de gerekli):

• Anahtarı tanımlayan <key>
• Stile referans veren <styleUrl> veya <Style>. <styleUrl> uygulamasında, KML dokümanında yerel olan başvurulan stil öğeleri için basit bir # başvuru kullanılır. Harici dosyalarda bulunan stiller için # referansıyla birlikte tam URL kullanın. Örneğin:

<Pair> 
  <key>normal</key>
  <styleUrl>http://myserver.com/populationProject.xml#example_style_off</styleUrl>
</Pair> 

Örnek

<?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>

Uzatmalar

• <StilSeçici>

İçerir

• Herhangi bir <Özellik>

<StilSeçici>

Söz dizimi

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

Açıklama

Bu, soyut bir öğedir ve doğrudan bir KML dosyasında kullanılamaz. <Style> ve <StyleMap> öğelerinin temel türüdür. StyleMap öğesi, yer işaretinin mevcut moduna göre bir stil seçiyor. StyleSelector'dan türetilen bir öğe, id'si ve url'si ile benzersiz şekilde tanımlanır.

StyleSelector'a Özel Öğeler

Bu soyut öğe alt öğe içermiyor.

Uzatmalar

• <Nesne>

Şunun Tarafından Uzatıldı:

• <Stil>
• <StilHarita>

<Zaman Pratik>

Söz dizimi

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

Açıklama

Bu, soyut bir öğedir ve doğrudan bir KML dosyasında kullanılamaz. Bu öğe, <TimeSpan> ve <TimeStamp> öğeleri tarafından uzatıldı.

Uzatmalar

• <Nesne>

Şunun Tarafından Uzatıldı:

• <Zaman Kaydırma>
• <Zaman Damgası>

<Zaman Kaydırma>

Söz dizimi

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

Açıklama

Başlangıç ve bitiş dateTimes ile sınırlı bir süreyi gösterir.

<begin> veya <end> eksikse dönemin bu sınırı sınırsız değildir (Aşağıdaki örneğe bakın).

dateTime, XML Schema zamanına göre tanımlanır (XML Schema 2. Bölüm: Datatypes Second Edition'a bakın). Değer, yyyy-aa-ggTss:dd:ss.ssszzzzzz şeklinde ifade edilebilir. Burada T, tarih ve saat arasındaki ayırıcıdır, saat dilimi ise Z (UTC için) veya zzzzzz'dır. UTC ile ilişkili olarak ‐ss:dd değerini temsil eder. Ayrıca, değer yalnızca tarih olarak ifade edilebilir. Örnekler için <TimeStamp> bölümüne bakın.

TimeSpan'e Özel Öğeler

<başlangıç>

Bir dönemin başlangıç anını açıklar. Mevcut değilse dönemin başlangıcı sınırsızdır.

<bitiş>

Belirli bir dönemdeki bitiş anını açıklar. Mümkün değilse dönemin sonu sınırsızdır.

Örnek

Aşağıdaki örnekte Colorado'nun eyalet durumunu temsil eden dönem gösterilmektedir. Kolorado, 1 Ağustos 1876 tarihinde eyalet olduğu ve eyalet olmaya devam ettiği için yalnızca bir <begin> etiketi içerir:

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

Uzatmalar

• <Zamana Bağlı>

İçerir

• <Feature> etiketinden türetilen herhangi bir öğe

<Zaman Damgası>

Söz dizimi

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

Açıklama

Tek bir zamanı temsil eder. Bu basit bir öğedir ve alt öğe içermez. Değeri, XML zamanında belirtilen bir dateTime'dır (XML Şeması 2. Bölüm: Veri Türleri İkinci Sürüm bölümüne bakın). TimeStamp'ın kesinliği, <when> öğesindeki dateTime değeriyle belirlenir.

Zaman Damgasına Özel Öğeler

<ne zaman>

Belirli bir zamanı belirtir. Değer bir dateTime'dır. Aşağıdakilerden biri olabilir:

• dateTime ikinci bir çözünürlük sağlar
• date, gün için çözüm sunar
• gYearMonth, ay için çözüm sunar
• gYear, yıl çözümü sunar

Aşağıdaki örneklerde <when> değeri için farklı çözünürlükler gösterilmektedir:

• gYear (YYYY)

<TimeStamp>
  <when>1997</when>
</TimeStamp>

• gYearAy (YYYY-AA)

<TimeStamp>
  <when>1997-07</when>
</TimeStamp> 

• tarih (YYYY-AA-GG)

<TimeStamp>
  <when>1997-07-16</when>
</TimeStamp> 

• dateTime (YYYY-AA-GGTss:dd:ssZ)
  Burada, T takvim ve saat gösterimi arasındaki ayırıcıdır ve Z UTC'yi belirtir. (Saniye gerektirir.)

<TimeStamp>
  <when>1997-07-16T07:30:15Z</when>
</TimeStamp>

• dateTime (YYYY-AA-GGGss:dd:sszzzzzz)
  Bu örnek yerel saati, ardından UTC'ye UTC dönüşümünü verir.

<TimeStamp>
  <when>1997-07-16T10:30:15+03:00</when>
</TimeStamp>

Uzatmalar

• <Zamana Bağlı>

İçerir

• <Feature> öğesini genişleten herhangi bir öğe

<gx:TimeSpan> ve <gx:TimeStamp>

Bu öğe, OGC KML 2.2 standardının bir uzantısıdır ve Google Earth 5.0 ve sonraki sürümlerinde desteklenir. Daha fazla bilgi

Uzantı ad alanındaki <TimeSpan> ve <TimeStamp> öğelerinin kopyası. Bu, zaman değerlerinin AbstractView'lara (<Camera> ve <LookAt>) dahil edilmesine olanak tanır. Zaman değerleri tarihsel görüntüler, güneş ışığı ve zaman damgalı Özelliklerin görünürlüğünü kontrol etmek için kullanılır.

Örnek

<?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:Tur>

Bu öğe, OGC KML 2.2 standardının bir uzantısıdır ve Google Earth 5.0 ve sonraki sürümlerinde desteklenir. Daha fazla bilgi

Söz dizimi

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

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

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

Açıklama

<gx:Tour> tek bir <gx:Playlist> öğesi içerebilir. Bu sayede, herhangi bir KML tarayıcısında turu tanımlayan gx:TourPrimitive öğelerinin sıralı listesi yer alır. Turlar hakkında daha fazla bilgi edinin.

Örnek

KML Geliştirici Kılavuzu'nun Tur bölümünde turla ilgili çeşitli örnekler bulabilirsiniz.

İçerikler

• gx:Playlist - İstediğiniz sayıda gx:TourPrimitive öğesi içerir. Bir <gx:Tour> öğesinin içinde sıfır veya bir <gx:Playlist> öğesi bulunabilir.

  <gx:Tour>
    <gx:Playlist>
      <!-- gx:TourPrimitive -->
        ...
      <!-- /gx:TourPrimitive -->
  
      <!--- Any number of gx:TourPrimitive elements can be included --->
    </gx:Playlist>
  </gx:Tour>

<gx:Turgut>>

Bu öğe, OGC KML 2.2 standardının bir uzantısıdır ve Google Earth 5.0 ve sonraki sürümlerinde desteklenir. Daha fazla bilgi

Söz dizimi

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

Açıklama

Bu, soyut bir öğedir ve doğrudan bir KML dosyasında kullanılamaz. Bu öğe <gx:FlyTo>, <gx:AnimatedUpdate>, <gx:TourControl>, <gx:Wait> ve <gx:SoundCue> öğeleriyle genişletildi.

gx:TourPrimitive uzantısından alınan öğeler, turlar sırasında KML tarayıcılarına talimatları (uçulacak noktalar ve bu uçuşların süresi, duraklamalar, KML özelliklerindeki güncellemeler ve çalınacak ses dosyaları gibi) sağlar.

Bu öğeler bir <gx:Playlist> öğesinin içinde bulunmalıdır. Bu öğe <gx:Tour> öğesi içerir.

Örnek

<?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>

İçerir

• <gx:Oynatma listesi>

Genişleten

• <gx:AnimedGüncelleme>
• <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>

  MP3, M4A veya AAC biçiminde çalınacak bir ses dosyası belirten bir <href> öğesi içerir. Süre içermez. Ses dosyası, turun geri kalanıyla paralel bir şekilde oynatılır. Diğer bir deyişle, bir sonraki tur temel öğesi <gx:SoundCue> turu temel öğesine ulaşıldıktan hemen sonra gerçekleşir. İlk ses oynatılmadan önce başka bir ses dosyası seçilmişse dosyalar karıştırılır. <gx:delayedStart> öğesi, dosyayı oynatmadan önce sesin belirli bir süre boyunca başlatılmasını geciktirmeyi belirtir.
• <gx:TourControl>

  <gx:TourControl id="ID">
    <gx:playMode>pause</gx:playMode>    <!-- gx:playModeEnum: pause -->
  </gx:TourControl>

  Tek bir <gx:playMode> öğesi içerir. Bu sayede, kullanıcı tura devam etmek için işlem yapana kadar tur duraklatılır.
• <gx:Wait>

  <gx:Wait id="ID">
    <gx:duration>0.0</gx:duration>    <!-- double -->
  </gx:Wait>

  Kamera, son gx:TourPrimitive gx:AbstractView sırasında sonraki gx:TourPrimitive oynatılmadan önce belirtilen saniye boyunca sabit kalır. Beklemenin tur zaman çizelgesini duraklatmadığını unutmayın. Şu anda oynatılan ses dosyaları ve animasyonlu güncellemeler kamera beklenirken oynatılmaya devam eder.

Uzatmalar

• <Nesne>

<gx:İzleme>

Bu öğe, OGC KML 2.2 standardının bir uzantısıdır ve Google Earth 5.2 ve sonraki sürümlerinde desteklenir. Daha fazla bilgi

Söz dizimi

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

Açıklama

İzleme, bir nesnenin belirli bir dönem boyunca dünya genelinde nasıl hareket ettiğini açıklar. Bu özellik, Google Earth'te aynı nesne için birden çok konumu birden çok kez kodlayan tek bir görünür nesne (Nokta simgesi veya Model) oluşturmanıza olanak tanır. Google Earth'te zaman kaydırma çubuğu, kullanıcının görünümün hareket etmesini sağlar. Bu da nesnenin konumunu canlandırır.

gx:MultiTrack öğesi, birden fazla kanalı tek bir kavram birimi üzerinde toplamak için kullanılır ve ilişkili bir simge (veya Model) ile parkur boyunca hareket eder. Bu özellik, aynı gerçek nesne için birden fazla parçanız varsa yararlıdır. <gx:MultiTrack> öğesinin <gx:interpolate> Boole öğesi, bir çoklu parçadaki parçalar arasında interpolasyon yapıp yapamayacağını belirtir. Bu değer 0 ise, nokta veya Model bir parçanın sonunda durur ve sonraki parçanın başlangıcına geçer. (Örneğin, tek bir yer işaretinin seyahatlerinizi iki gün içinde temsil etmesini istiyorsanız ve GPS biriminiz bu süre boyunca dört saatliğine kapalıysa, birimin kapatıp tekrar açık olduğu noktalar arasında süreksizlik göstermek istersiniz.) <gx:interpolate> değeri 1 ise, ilk parçanın sonu ile bir sonraki parçanın başı arasındaki değerler interpolasyon yaparak parçanın sürekli bir yol halinde görünmesini sağlar.

GPS verilerini Google Earth'e aktarmayla ilgili bilgi için Google Earth Kullanıcı Kılavuzu'na bakın.

Parçalar neden yararlıdır?

KML'nin önceki sürümleri (Google Earth 5.2 öncesi), bir zaman öğesini herhangi bir Özellikle (yer işareti, zemin yer paylaşımı vb.) ilişkilendirmenize olanak tanır. Bununla birlikte, belirli bir özellikle yalnızca bir zaman öğesi ilişkilendirebilirsiniz. Nesne uzayda ilerlerken birden fazla zaman öğesiyle ilişkilendirilebilecek tek bir özellik oluşturduğunuzdan kanallar, zaman verilerini görünür Özelliklerle ilişkilendirmek için daha verimli bir mekanizmadır.

Ayrıca, izleme öğesi önceki mekanizmadan daha güçlüdür (KML Geliştirici Kılavuzu'nun Zaman ve Animasyon bölümünde açıklanmıştır). <Track>, parçasının herhangi bir zamanda nesnesinin konumunu interpole etmek için bir mekanizma sağlar. Bu yeni özellik sayesinde Google Earth, zaman içinde nesne için yükseklik ve hız profillerine (ayrıca, varsa özel verilere) ait bir grafik gösterir.

"Sade" Veriler

Parçadaki konumlar için bazı veri değerleri eksik olduğunda dizileri dengelemek için boş <coord/> (<coord></coord>) veya <angles/> (<angles></angles>) etiketleri sağlanabilir. Boş bir <coord/> veya <angles/> etiketi, belirli bir veri noktası için böyle bir verinin mevcut olmadığını ve değerin, iyi belirtilen en yakın iki veri noktası arasında interpolasyon yapılması gerektiğini belirtir. Bu davranış, bir parçanın Genişletilmiş Verileri için de geçerlidir. <when> dışındaki tüm öğeler boş olabilir ve iyi belirtilen, en yakın iki öğe arasında interpolasyon yapabilir.

Kanala Özel Öğeler

<heightMode>

<ords> öğesinde rakım bileşenlerinin nasıl yorumlanacağını belirtir. Olası değerler:

• clampToGround - (varsayılan) Rakım spesifikasyonunun yoksayılmasını belirtir (örneğin, <gx:coord> etiketinde).
• relToGround - Öğenin rakımını, belirli bir konumun gerçek zemin yüksekliğine göre ayarlar. Örneğin, bir yerin zemin yüksekliği tam olarak deniz seviyesindeyse ve bir noktanın rakımı 9 metreye ayarlıysa bu modla nokta yer işareti yüksekliğinin yüksekliği 9 metre olur. Ancak aynı koordinat, zemin yüksekliğinin deniz seviyesinden 10 metre yüksek olduğu bir konuma ayarlanırsa koordinatın yüksekliği 19 metredir.
• mutlak - Öğenin altındaki arazinin gerçek yüksekliğinden bağımsız olarak koordinatın deniz seviyesine göre yüksekliğini belirler. Örneğin, bir koordinatın rakımını mutlak rakım moduyla 10 metreye ayarlarsanız, altındaki arazi de deniz seviyesinden 10 metre fazlaysa nokta yer işaretinin simgesi yer seviyesinde görünür. Arazi, deniz seviyesinin 3 metre üzerindeyse yer işareti, arazinin üzerinde 7 metre yüksekliğinde görünür.

<gx:heightMode>

Google uzantısı ad alanında bulunan ve deniz tabanına göre rakımlara izin veren bir KML uzantısı. Değerler şu şekildedir:

• relatedToSeaFloor - Rakımı, deniz tabanının üzerinden metre cinsinden bir değer olarak yorumlar. Nokta denizden değil karadan fazlaysa rakım, yerden yüksek olarak yorumlanır.
• clampToSeaFloor: Rakım spesifikasyonu göz ardı edilir ve nokta deniz tabanına konumlandırılır. Nokta deniz yerine karadaysa nokta karaya yerleştirilir.

<when>

position'a karşılık gelen time değeri (<gx:coord> öğesinde belirtilir). <Track> öğesindeki <when> öğelerinin sayısı, <gx:coord> öğelerinin (ve varsa <gx:angles> öğelerinin) sayısına eşit olmalıdır.

<gx:coord>

Virgül, ayırıcı olmadan boylam, enlem ve rakım için üç değerden oluşan bir koordinat değeri. Örneğin:

<gx:coord>-122.207881 37.371915 156.000000</gx:coord>

<gx:coord> öğesinin söz diziminin, boylam, enlem ve rakım bileşenlerini ayırmak için virgül kullanan < Koordinatörs> öğesinin söz diziminden farklı olduğunu unutmayın. Belirtilen öğelerinin sayısı, zaman () ve konum () öğelerinin sayısına eşit olmalıdır. Gerekirse eksik bir değer için boş bir <gx:coord> öğesi belirtebilirsiniz.

<gx:angles>

Bu değer, kanal içindeki her zaman/konum için simge veya modele ek bir başlık, eğim ve yuvarlama değeri belirtmek amacıyla kullanılır. Kayan nokta şeklindeki üç değer, virgül ayırıcısı olmadan listelenir ve rotasyon derecelerini temsil eder. <gx:angles> belirtilmemişse Google Earth, nesneyi kendi yolundan yola çıkarak tahmin eder, yatırır ve yuvarlar. Belirtilen <gx:angles> öğelerinin sayısı, süre (<when>) ve konum (<gx:coord>) öğelerinin sayısına eşit olmalıdır. Gerekirse eksik bir değer için boş bir <gx:angles> öğesi belirtebilirsiniz.

Şu anda simgeler yalnızca başlığı desteklese de modeller üç değeri de desteklemektedir.

Aşağıda bu değerin ayarlanmasına bir örnek verilmiştir:

<gx:angles>45.54676 66.2342 77.0</gx:angles>

<Model>

Belirtilmişse Model, kanaldaki mevcut konumu belirtmek için kullanılan Nokta simgesinin yerini alır. Bir <gx:Track> içinde <Model> belirtildiğinde, <Model>in alt öğeleri şu şekilde çalışır:

• <Location> öğesi yoksayılır.
• <heightMode> öğesi yok sayıldı.
• <Orientation> değeri, parçanın yönüyle aşağıdaki gibi birleştirilir. İlk olarak, modeli yerel (x, y, z) koordinat sisteminden sağdan sola, kuzeye dönük yöne getiren <Orientation> rotasyonu uygulanır. Daha sonra, <gx:angles> değerlerinin kanal boyunca ilerlerken başlığını, eğimini ve yuvarlamasını etkileyen bir interpolasyona karşılık gelen bir rotasyon uygulanır. Açı belirtilmemişse, başlık ve eğim modelin hareketinden elde edilir.

  İpucu: Yönü nasıl belirteceğinizden emin değilseniz <Model> öğesinden <Orientation> öğesini çıkarın ve Google Earth'ün rayda ilerlerken modeli nasıl konumlandırdığını izleyin. Modelin ön tarafının yanlara baktığını fark ederseniz modeli ön tarafa gelecek şekilde döndürmek için <Yön> bölümündeki <heading> öğesini değiştirin. Model dik değilse <tilt> veya <roll> öğelerini değiştirmeyi deneyin.

<Genişletilmiş Veri>

KML dosyasının önceki bir <Şemasında> tanımlanan özel veri öğeleri.

Genellikle bir kanaldaki her zaman/konum ile ilişkili genişletilmiş verileri eklemeniz yararlı olur. Örneğin, bisiklet yolculukları nabız dinleyici örneğinde gösterildiği gibi nabız, kadans ve güç verilerini içerebilir. <Schema> sayfasında her özel veri türü için bir <gx:SimpleArrayField> tanımlarsınız. Ardından, her veri türü için kanaldaki her zamana/konuma karşılık gelen <gx:value> öğeleri içeren bir <gx:SimpleArrayData> öğesi ekleyin. Yeni veri alanları ekleme hakkında daha fazla bilgi için KML Geliştirici Kılavuzu'nun Özel Veri Ekleme bölümüne bakın. Google Earth'te, özel veriler parkurun Yükseklik Profili'nde görüntülenir.

Basit Örnek

Bu çok temel örnekte, <when> ve <gx:coord> için paralel "dizilerin" nasıl oluşturulacağı gösterilmektedir. Saat ve konum değerleri eşit olmalıdır.

<?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>

Genişletilmiş Veri İçeren İzleme Örneği

Bu örnekteki kalın yazı tipi, bir bisiklet yolculuğu için özel verileri tanımlamak ve belirtmek üzere kullanılan öğeleri vurgular. Özel veri alanları dahili olarak "nabız", "ritim" ve "güç" olarak adlandırılır. <Schema> öğesi, her değer grubu (Kalp Hızı, Kadans ve Güç) için görüntülenecek adı tanımlar ve her yeni alan için veri türünü belirtir (kalp ve kadans int, güç türü float). Google Earth'te bu özel veriler parçanın yükseklik profiliyle gösterilir.

Bu örnekte, özel simgeler ile vurgulama ve normal modlar için ayrı simge ve çizgi stilleri kullanılan bir parçanın daha gerçekçi bir sunumu gösterilmektedir. Ancak, örneğin yalnızca yedi veri değeri grubu içerdiğini unutmayın. Gerçek örnek on binlerce değer içeriyor. (Veriler: Sean Broeder. Bu veriler, ilişkili bir nabız monitörü ve güç ölçer ile birlikte Garmin Edge 705 ile toplanmıştır.

<?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>

Uzatmalar

• <Geometri>

İçerir

• <Çoklu Geometri>
• <gx:Çoklu İzleme>
• <Yer işareti>

<Güncelle>

Söz dizimi

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

Açıklama

Belirtilen URL kullanılarak önceden yüklenmiş olan KML verilerinin eklenmesi, değiştirilmesi veya silinmesini belirtir. <targetHref>, verileri (Google Earth içinde) değiştirilecek .KML veya .kmz dosyasını belirtir. <Update>, her zaman NetworkLinkControl kapsamındadır. Ayrıca, NetworkLinkControl'ü içeren dosyanın bir NetworkLink tarafından yüklenmiş olması gerekir. Güncellemenin nasıl çalıştığına dair ayrıntılı bir örnek için Güncellemeler bölümündeki "KML'deki konular" sayfasına göz atın.

Güncellemeye Özel Öğeler

İstediğiniz sayıda işlenecek <Change>, <Create> ve <Delete> öğeleri içerebilir.

<targetHref>(zorunlu)

Verileri (Google Earth'te) bir <Update> öğesi ile değiştirilecek .KML veya .kmz dosyasını belirten URL. Bu KML dosyası zaten bir <NetworkLink> aracılığıyla yüklenmiş olmalıdır. Değiştirilecek öğenin bu dosya için önceden tanımlanmış bir id özelliği tanımlanmış olmalıdır.

<Değiştir>

Bir <NetworkLink> ile zaten yüklenmiş olan öğedeki değerleri değiştirir. Değiştirilecek alt öğede, değiştirilecek alt öğe, orijinal öğenin kimliğine referans veren bir targetId özelliği içermelidir.

Bu güncelleme "sıfır güncelleme" olarak kabul edilebilir: Değiştirilen öğede yalnızca <Change> içinde listelenen değerler değiştirilir; diğer tüm değerler değişmeden kalır. Bir koordinat grubuna <Change> uygulandığında yeni koordinatlar mevcut koordinatların yerini alır.

Bu öğenin alt öğeleri, değiştirilecek öğelerdir ve targetId özelliği ile tanımlanır.

<Oluştur>

<NetworkLink> aracılığıyla zaten yüklenmiş bir Klasör veya Dokümana yeni öğeler ekler. <Update> içindeki <targetHref> öğesi, orijinal Klasörü veya Dokümanı içeren .KML ya da .kmz dosyasının URL'sini belirtir. Bu dosyada, yeni verileri içerecek Klasör veya Dokümanda zaten açık bir kimlik tanımlanmış olmalıdır. Eklenecek öğeyi içeren <Create> içindeki Klasörü veya Dokümanı targetId özelliği olarak bu id değeri kullanılır.

Nesne oluşturulduktan ve Google Earth'e yüklendikten sonra orijinal üst Klasör Belgesi'nin URL'si alınır. Bu Güncelleme/Oluşturma mekanizmasıyla eklenen nesnelerle ilgili sonraki güncellemeleri gerçekleştirmek için <targetHref> URL'sini orijinal Belge veya Klasör'ün URL'sine ayarlayın (araya giren güncellemeleri yükleyen dosyanın URL'si değil).

<Sil>

Özellikleri, <NetworkLink> aracılığıyla zaten yüklenmiş olan karmaşık bir öğeden siler. <Update> içindeki <targetHref> öğesi, silinecek verileri içeren .KML veya .kmz dosyasını belirtir. Silinecek öğenin kendisine ait açık bir id öğesi olması gerekir. <Delete> öğesi, targetId özelliğinde bu id öğesini referans alır.

Yalnızca silinebilen <Delete> alt öğeleri şunlardır: Document, Klasör, GroundOverlay, Bookmarks ve ScreenOverlay.

<Change> örneği

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

<Create> örneği

Bu örnekte, daha önce oluşturulmuş bir dokümanda "region24" id değerine sahip yeni bir Yer İşareti oluşturulur. "placemark891" için daha sonra güncelleme yapmak istiyorsanız, <targetHref> olarak http://myserver.com/Point.KML adresini kullanmaya devam edeceğinizi unutmayın.

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

<Delete> örneği

Bu örnek, daha önce Google Earth'e yüklenmiş bir Yer İşaretini siler. (Bu Yer İşareti, belirtilen URL ile doğrudan bir Ağ Bağlantısı tarafından yüklenmiş olabilir veya daha sonra orijinal Dokümanda Güncelleme tarafından yüklenmiş olabilir.)

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

İçerir

• <Ağ Bağlantısı Denetimi>

<Url>

Not: Bu öğe, KML Sürümü 2.1'de kullanımdan kaldırılmıştır ve yerini Bölgeler'in ek işlevini sağlayan <Link> almıştır. <Url> etiketi Google Earth'te çalışmaya devam etse de yeni <Link> etiketinin kullanılması önerilir.

KML dosyasına olan bağlantının konumunu ayarlamak, sunucu ve görüntüleyici değişikliklerine ilişkin yenileme seçeneklerini tanımlamak ve sunucuya yararlı istemci bilgileri döndürecek bir değişken doldurmak için bu öğeyi kullanın.

Başa dön