KML संदर्भ

इस सेक्शन में KML वर्शन 2.2 में बताए गए सभी KML एलिमेंट शामिल हैं. साथ ही, Google एक्सटेंशन नेमस्पेस में एलिमेंट भी हैं. KML एलिमेंट के लिए क्लास ट्री नीचे दिखाया गया है. इस डायग्राम में, ट्री की किसी खास ब्रांच के दाईं ओर मौजूद एलिमेंट, एलिमेंट के एक्सटेंशन हैं. उदाहरण के लिए, प्लेसमार्क एक खास तरह की सुविधा है. इसमें, Feature से जुड़े सभी एलिमेंट शामिल होते हैं. साथ ही, इसमें प्लेसमार्क एलिमेंट के लिए खास तौर पर कुछ एलिमेंट जुड़ जाते हैं.

KML आधिकारिक रूप से OpenGIS® KML एन्कोडिंग मानक (OGC KML) एक खुला मानक है. इसका रखरखाव ओपन जियोस्पेशियल कंसोर्शियम, इंक. (ओजीसी) करता है. OGC KML की पूरी जानकारी http://www.opengeospatial.org/standards/KML/ पर मिल सकती है.

KML के लिए पूरा एक्सएमएल स्कीमा http://schemas.opengis.net/KML/ पर मौजूद है.

ध्यान दें: रेफ़रंस डायग्राम में किसी एलिमेंट की एंट्री पर जाने के लिए, उसमें इस एलिमेंट के नाम पर क्लिक करें.

ध्यान दें कि डायग्राम में मौजूद ऐब्स्ट्रैक्ट एलिमेंट का इस्तेमाल KML फ़ाइलों में नहीं किया जाता है. ये एलिमेंट एक ही एलिमेंट के लिए, काम के कई एलिमेंट के लिए प्रोग्रामैटिक बेसिक के तौर पर काम करने का एक उपयोगी तरीका है. ऑब्जेक्ट के हिसाब से क्रम में मौजूद डेटा को समझना भी आपके लिए KML सीखने का एक अच्छा तरीका है, क्योंकि आप इससे मिलते-जुलते एलिमेंट के ग्रुप आसानी से देख सकते हैं.

ऑब्जेक्ट से मिलने वाले सभी एलिमेंट में उन्हें एक id असाइन किया जा सकता है. इस id का इस्तेमाल KML अपडेट करने का तरीका करता है. (नेटवर्क अपडेट की मदद से लोड की गई फ़ाइलों के लिए, <Update> देखें). इसका इस्तेमाल, शेयर की गई स्टाइल से भी होता है (<Style> देखें). id एक स्टैंडर्ड एक्सएमएल आईडी है.

KML एक्सएमएल व्याकरण और फ़ाइल फ़ॉर्मैट वाला होता है. इसलिए, टैग के नाम केस-सेंसिटिव (बड़े और छोटे अक्षरों में अंतर) होते हैं. ये यहां दिखाए गए के मुताबिक होने चाहिए. अगर आपको एक्सएमएल के बारे में जानकारी है, तो आप केएमएल 2.2 स्कीमा में भी दिलचस्पी ले सकते हैं. KML टेक्स्ट फ़ाइलों में बदलाव करते समय, आप इस स्कीमा को किसी भी एक्सएमएल एडिटर में लोड कर सकते हैं और इसके साथ अपने KML कोड की पुष्टि कर सकते हैं.

सलाह: Google Earth की सुविधाओं के लिए KML देखना

यहां Google Earth की काम की सुविधा दी गई है, जिससे किसी भी सुविधा के लिए KML फ़ाइल आसानी से देखी जा सकती है. Google Earth में, आप 'जगहें' पैनल में किसी सुविधा पर दायां क्लिक करके, उसे कॉपी कर सकते हैं. कॉपी किए गए ऑब्जेक्ट से जुड़ी KML फ़ाइल देखने के लिए, अपना पसंदीदा टेक्स्ट एडिटर खोलें और चुने हुए टेक्स्ट को इसमें चिपकाएं.

कम्पैटबिलटी

KML वर्शन में दो नंबरिंग सिस्टम होता है: majorVersion.minorVersion. एक ही majorVersion के सभी वर्शन इसके साथ काम करते हैं. इसी वजह से, अगर नेमस्पेस को "2.2" में बदला जाता है, तो KML 2.1 फ़ाइलें, KML 2.2 स्कीमा में मान्य होती हैं.xmlns="http://www.opengis.net/kml/2.2"

इस रेफ़रंस के बारे में जानकारी

हर रेफ़रंस एंट्री में एक सिंटैक्स सेक्शन होता है. इस सिंटैक्स में मुख्य एलिमेंट में मौजूद एलिमेंट मौजूद होते हैं. यह सिंटैक्स सेक्शन एक अनौपचारिक सूची है. इसमें, एलिमेंट के बारे में खास जानकारी देने के लिए, आसान शॉर्टहैंड का इस्तेमाल किया जाता है. इस सेक्शन में ये चीज़ें भी शामिल हैं:

• हर एलिमेंट के लिए, डिफ़ॉल्ट वैल्यू (या अगर यह कोई कॉम्प्लेक्स एलिमेंट है, तो यह एलिप्स बनाता है) या कोई डिफ़ॉल्ट वैल्यू नहीं है
• वैल्यू का टाइप (KML फ़ील्ड देखें)

सिंटैक्स फ़ाइल को कॉपी करके, KML फ़ाइल में मौजूद ऐसे एलिमेंट के लिए टेंप्लेट के तौर पर इस्तेमाल किया जा सकता है जो ऐब्स्ट्रैक्ट नहीं है.

KML एक्सटेंशन नेमस्पेस और gx उपसर्ग

OGC KML मानक एक्सटेंशन के लिए एक प्रक्रिया देता है - अतिरिक्त एलिमेंट जिनमें मानक में उपलब्ध जानकारी से अलग जानकारी शामिल होती है (w3.org पर एक्सएमएल नेमस्पेस के बारे में ज़्यादा जानें). Google Earth 5.0 के लॉन्च होने पर, Google ने कई नई सुविधाओं के साथ काम करने के लिए KML को एक्सटेंशन दिए हैं. ये एक्सटेंशन, gx प्रीफ़िक्स और यहां दिए गए नेमस्पेस यूआरआई का इस्तेमाल करते हैं:

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

gx-प्रीफ़िक्स वाले एलिमेंट का इस्तेमाल करके, किसी भी KML फ़ाइल में <kml> एलिमेंट में यह नेमस्पेस जोड़ा जाना चाहिए:

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

हो सकता है कि KML के एक्सटेंशन सभी जियो-ब्राउज़र में समर्थित न हों. अगर आपके ब्राउज़र पर कुछ खास एक्सटेंशन काम नहीं करते, तो उन एक्सटेंशन के डेटा पर कोई ध्यान नहीं देना चाहिए. साथ ही, बाकी KML फ़ाइल में कोई गड़बड़ी नहीं होनी चाहिए.

फ़िलहाल, gx प्रीफ़िक्स का इस्तेमाल करने वाले एलिमेंट ये हैं:

• gx:heightMode
• gx:height Offset
• gx:ऐंगल
• gx:ऐनिमेटेड ऐनिमेशन
• gx:गुब्बारा किसको दिखे
• gx:coord
• gx:delayedStart
• gx:drawOrder
• gx:duration
• gx:FlyTo
• gx:flyToMode
• gx:h
• gx:horizFov
• gx:इंटरपोलेट
• gx:लेबल किसको दिखे
• gx:LatLonQuad
• gx:मल्टीट्रैक
• gx:दर्शक विकल्प
• gx:outerColor
• gx:outerWidth
• gx:भरोसा है
• gx:प्लेलिस्ट
• gx:playMode
• gx:SoundCue
• gx:टाइमस्पैन
• gx:टाइमस्टैंप
• gx:टूर
• gx:TourControl
• gx:TourPrimitive
• gx:ट्रैक
• gx:ViewerOptions
• gx:वॉट
• gx:प्रतीक्षा करें
• gx:x
• gx:y

इस एक्सटेंशन नेमस्पेस में एलिमेंट के लिए, पूरा एक्सएमएल स्कीमा http://developers.google.com/KML/schema/KML22gx.xsd पर मौजूद है.

KML फ़ील्ड

KML सामान्य एक्सएमएल टाइप का इस्तेमाल करता है, जैसे कि बूलियन, स्ट्रिंग, डबल, फ़्लोट, और इंटेट. साथ ही, यह कई तरह के फ़ील्ड एलिमेंट के बारे में बताता है. नीचे दी गई टेबल में, आम तौर पर इस्तेमाल किए जाने वाले KML के कुछ टाइप दिए गए हैं. साथ ही, उनमें इस तरह के एलिमेंट का इस्तेमाल करने वाले एलिमेंट के लिंक दिए गए हैं:

फ़ील्ड टाइप	वैल्यू	इस्तेमाल का उदाहरण
heightModeEnum	clampToGround, सापेक्ष ToGround, निरपेक्ष	<LookAt> और <REGION> देखें
angle90	वैल्यू ≥−90 और ≤90	<मॉडल> में <Latitude> देखें
94x90	वैल्यू ≥0 और ≤90	<LookAt> में <tilt> देखें
angle180	वैल्यू ≥180 और ≤180	<मॉडल> में <देशांतर> देखें
angle360	वैल्यू ≥−360 और ≤360	<Orientation> में <heading> देखें
रंग	हेक्सिबिनरी वैल्यू: aaggggrr	<ColorStyle> को बड़ा करने वाला कोई भी एलिमेंट देखें
colorModeEnum	सामान्य, रैंडम	<ColorStyle> को बड़ा करने वाला कोई भी एलिमेंट देखें
तारीख और समय	dateTime, तारीख, gYearMonth, gYear	<TimeSpan> और <TimeStamp> देखें
displayModeEnum	डिफ़ॉल्ट, छिपाएं	<BaloonStyle> देखें
gridOrigin	लोअर लेफ़्ट, अपर लेफ़्ट	< PhotoOverlay> देखें
रीफ़्रेशमोडEnum	onChange, onInterval, onExpire	<Link> देखें
sizeEnum	आयताकार, सिलेंडर, स्फ़ीयर	< PhotoOverlay> देखें
styleStateEnum	सामान्य, हाइलाइट	<StyleMap> देखें
unitsEnum	अंश, पिक्सेल, insetPixels	<IconStyle>, <ScreenOverlay> में <hotSpot> को देखें
vec2	x=दोगुने xunits=KML:unitsEnum y=दोगुने yunits=KML:unitsEnum	<IconStyle>, <ScreenOverlay> में <hotSpot> देखें
viewेशनEnum	कभी नहीं, onRequest, onStop, onregion	<Link> देखें

 

<AbstractView>

सिंटैक्स

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

जानकारी

यह एक ऐब्स्ट्रैक्ट एलिमेंट है और इसे सीधे KML फ़ाइल में इस्तेमाल नहीं किया जा सकता. इस एलिमेंट को <Camera> और <LookAt> एलिमेंट इस्तेमाल करके बढ़ाया जा सकता है.

विस्तृत

• <ऑब्जेक्ट>

खास जानकारी के लिए खास एलिमेंट

<gx:ViewerOptions>

यह एलिमेंट, Google Earth 6.0 और इसके बाद के वर्शन में, वीडियो देखने के खास मोड को चालू करता है. इसमें एक या एक से ज़्यादा <gx:option> चाइल्ड एलिमेंट हैं. <gx:option> एलिमेंट में name एट्रिब्यूट और enabled एट्रिब्यूट है. name, इनमें से किसी एक के बारे में बताता है: स्ट्रीट व्यू की तस्वीरों का संग्रह ("स्ट्रीट"), ऐतिहासिक तस्वीरों का संग्रह ("ऐतिहासिक तस्वीरों का संग्रह") और दिन के किसी खास समय के लिए धूप के असर (सूरज की रोशनी) enabled एट्रिब्यूट का इस्तेमाल, दिए गए व्यू मोड को चालू या बंद करने के लिए किया जाता है.

<gx:horizFov>

टूर के दौरान ऐब्स्ट्रैक्ट व्यू के हॉरिज़ॉन्टल फ़ील्ड के बारे में बताता है. इस एलिमेंट का टूर के बाहर, AbstractViews पर कोई असर नहीं पड़ता. <gx:horizFov> को Google Earth क्लाइंट (वर्शन 6.1+) से अपने-आप सम्मिलित किया जाता है. सामान्य AbstractViews को 60 का मान असाइन किया जाता है; Street View में मौजूद व्यू को 85 की वैल्यू असाइन की जाती है. यह Google Earth में, Street View के स्टैंडर्ड फ़ील्ड से मेल खाता है. सेट हो जाने के बाद, वैल्यू को बाद के व्यू पर लागू किया जाएगा, जब तक कि एक नई वैल्यू नहीं दी जाती.

इस तारीख तक बढ़ाया गया

• <कैमरा>
• <LookAt>

<gx:heightMode>

यह एलिमेंट, OGC KML 2.2 स्टैंडर्ड का एक्सटेंशन है. इसे Google Earth 5.0 और इसके बाद के वर्शन में इस्तेमाल किया जा सकता है. ज़्यादा जानें

सिंटैक्स

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

जानकारी

इसका इस्तेमाल OGC KML मानक <altitudeMode> एलिमेंट के बजाय किया जा सकता है. इसके लिए मानक ऊंचाई मोड मानों के साथ-साथ नीचे दिए गए मान भी स्वीकार किए जाते हैं:

• relativeToSeaFloor - समुद्र तल से ऊंचाई को मीटर में मापता है. अगर KML सुविधा समुद्र के बजाय ज़मीन से ऊपर की है, तो ऊंचाई को जमीन से ऊपर होने के रूप में माना जाएगा.
• clampToSeaFloor - ऊंचाई की खासियत को नज़रअंदाज़ कर दिया जाता है, और KML सुविधा समुद्र के तल पर रखी जाएगी. अगर KML सुविधा समुद्र के बजाय ज़मीन पर है, तो clampToSeaFloor इसके बजाय ज़मीन पर क्लैंप करेगा.

<altitudeMode> की तरह ही, <gx:altitudeMode> पर भी इसका असर होगा:

• <coordinates> एलिमेंट में ऊंचाई के निर्देशांक
• <LatLonAltBox> में <minAltitude> और <maxAltitude>
• <Location>, <GroundOverlay>, और AbstractView (<LookAt> और <Camera>) में <altitude>.

ऊंचाई मोड के बारे में ज़्यादा जानकारी KML डेवलपर की गाइड के वैकल्पिक मोड चैप्टर में उपलब्ध है.

उदाहरण

heightmode_reference.KML

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

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

</kml>

 

<gx:ऐनिमेटेड ऐनिमेशन

यह एलिमेंट, OGC KML 2.2 स्टैंडर्ड का एक्सटेंशन है. इसे Google Earth 5.0 और इसके बाद के वर्शन में इस्तेमाल किया जा सकता है. ज़्यादा जानें

सिंटैक्स

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

जानकारी

<gx:AnimatedUpdate>, <Update> का इस्तेमाल करके, KML सुविधाओं के बारे में जानने के लिए किए गए बदलावों को कंट्रोल करता है. KML सुविधाओं में किए गए बदलावों से DOM में कोई बदलाव नहीं होगा - इसका मतलब है कि टूर खत्म होने के बाद सभी बदलाव वापस आ जाएंगे और उन्हें किसी भी समय KML में सेव नहीं किया जाएगा.

<gx:AnimatedUpdate> में <gx:duration> की वैल्यू भी होनी चाहिए, ताकि यह अपडेट होने में लगने वाले सेकंड की समयसीमा बताई जा सके. पूरी अवधि में इंटिजर, फ़्लोट, और कलर फ़ील्ड, मूल से नए वैल्यू पर आसानी से ऐनिमेट किए जाते हैं. बूलियन, स्ट्रिंग, और ऐसे दूसरे वैल्यू जो इंटरपोलेशन को नहीं बताते हैं, उन्हें अवधि के आखिर में अपडेट किया जाता है.

<gx:AnimatedUpdate> के बारे में जानकारी और <gx:AnimatedUpdate> टाइमलाइन के बारे में जानकारी के लिए, KML डेवलपर की गाइड के चैप्टर में टूर टाइमलाइन देखें.

<gx:duration>

सेकंड की अवधि बताती है, जिस दौरान अपडेट होता है.

<gx:delayedStart>

अपडेट शुरू करने से पहले (इनलाइन स्टार्ट की स्थिति के बाद) इंतज़ार करने के लिए सेकंड की संख्या बताता है.

उदाहरण

नीचे दिए गए उदाहरण में आइकॉन के साइज़ में हुए बदलाव को दिखाया गया है. इस बदलाव को पांच सेकंड की अवधि में ऐनिमेट किया जाएगा.

ऐनिमेटेडअपडेट_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">

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

  <Style id="pushpin">
    <IconStyle id="mystyle">
      <Icon>
        <href>http://maps.google.com/mapfiles/kml/pushpin/ylw-pushpin.png</href>
        <scale>1.0</scale>
      </Icon>
    </IconStyle>
  </Style>

  <Placemark id="mountainpin1">
    <name>Pin on a mountaintop</name>
    <styleUrl>#pushpin</styleUrl>
    <Point>
      <coordinates>170.1435558771009,-43.60505741890396,0</coordinates>
    </Point>
  </Placemark>

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

    <gx:Playlist>

      <gx:FlyTo>
        <gx:flyToMode>bounce</gx:flyToMode>
        <gx:duration>3</gx:duration>
        <Camera>
          <longitude>170.157</longitude>
          <latitude>-43.671</latitude>
          <altitude>9700</altitude>
          <heading>-6.333</heading>
          <tilt>33.5</tilt>
        </Camera>
      </gx:FlyTo>

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

      <gx:Wait>
        <gx:duration>5</gx:duration>
      </gx:Wait>

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

</Document>
</kml>

विस्तृत

• <gx:TourPrimitive>

इसमें ये शामिल हैं

• <gx:duration>
• <अपडेट करें>

<BaloonStyle>

सिंटैक्स

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

जानकारी

इससे पता चलता है कि प्लेसमार्क के लिए विवरण गुब्बारा कैसे बनाया जाता है. अगर <ggColor> बताया गया है, तो इसका इस्तेमाल गुब्बारा के बैकग्राउंड रंग के रूप में किया जाता है. सुविधा> से यह डायग्राम देखें. इसमें बताया गया है कि Google Earth में, डिफ़ॉल्ट बलून बलून कैसा दिखता है.

गुब्बारा स्टाइल के लिए खास एलिमेंट

<bgरंग>

गुब्बारे के बैकग्राउंड का रंग (ज़रूरी नहीं). रंग और अपारदर्शिता (ऐल्फ़ा) की वैल्यू, हेक्साडेसिमल संकेतन में दिखाई जाती हैं. किसी एक रंग के लिए मान की श्रेणी 0 से 255 (00 से ff) होती है. व्यंजक का क्रम aabbggrr होता है, जहां aa=alpha (00 से ff); bb=blue (00 से ff); gg=green (00 से ff); rr=red (00 से ff) है. ऐल्फ़ा के लिए, 00 पूरी तरह से पारदर्शी है और ff पूरी तरह से अपारदर्शी है. उदाहरण के लिए, अगर आपको किसी ओवरले पर 50 प्रतिशत पारदर्शिता के साथ नीला रंग लागू करना है, तो आप यह जानकारी देंगे: ऐल्फ़ा=0x7f, नीला=0xff, हरा=0x00, और लाल=0x00. डिफ़ॉल्ट तौर पर, सफ़ेद रंग का टेक्स्ट नहीं दिखता है.

ध्यान दें: <BaloonStyle> में <color> एलिमेंट के इस्तेमाल पर रोक लगा दी गई है. इसके बजाय <bgColor> का इस्तेमाल करें.

<textरंग>

टेक्स्ट का फ़ोरग्राउंड का रंग. डिफ़ॉल्ट रूप से काला (ff000000) होता है.

<text>

गुब्बारे में दिखाया जाने वाला टेक्स्ट. अगर कोई टेक्स्ट तय नहीं है, तो Google Earth डिफ़ॉल्ट गुब्बारा दिखाता है (बोल्डफ़ेस में <name> सुविधा के साथ, सुविधा <description>, ड्राइविंग दिशा-निर्देश के लिंक, एक सफ़ेद बैकग्राउंड, और एक पूंछ जो सुविधा के पॉइंट निर्देशांक से जुड़ी होती है, अगर बताया गया हो).

सुविधा के चाइल्ड एलिमेंट को रेफ़र करने के लिए, यहां दिए गए फ़ॉर्मैट का इस्तेमाल करके इकाइयों को <text> टैग में जोड़ा जा सकता है: $[name], $[description], $[address], $[id], $[snippet]. Google Earth संबंधित स्ट्रिंग इकाई के लिए मौजूदा सुविधा को देखता है और उस जानकारी को गुब्बारा में बदलता है. गुब्बारा में To यहाँयहां से ड्राइविंग दिशा निर्देश शामिल करने के लिए, $[geDirections] टैग का इस्तेमाल करें. किसी गुब्बारा में ड्राइविंग दिशा-निर्देश के लिंक को दिखने से रोकने के लिए, <text> कुछ कॉन्टेंट के साथ <text> एलिमेंट को शामिल करें या बुनियादी सुविधा <description> को बदलने के लिए $.[description] का इस्तेमाल करें.

उदाहरण के लिए, नीचे दिए गए KML अंश, $[name] और $[description] फ़ील्ड को इस गुब्बारा स्टाइल में मिले सुविधा एलीमेंट <name> और <description> से बदल दिया जाएगा:

<displayMode>

अगर <displayMode> डिफ़ॉल्ट है, तो Google Earth, गुब्बारा बनाने के लिए <text> में दी गई जानकारी का इस्तेमाल करता है . अगर <displayMode> hide है, तो Google Earth में गुब्बारा नहीं दिखता है. Google Earth में, जिस प्लेसमार्क के गुब्बारे का <displayMode> छिपाएं है उसके लिए 'सूची की तरह देखें' आइकॉन पर क्लिक करके, Google Earth उस प्लेसमार्क पर जाता है.

उदाहरण

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

विस्तृत

• <ColorStyle>

कॉन्टेंट का मालिक

• <स्टाइल>

पेज पर सबसे ऊपर जाएं

<gx:गुब्बारा किस तरह का है>

यह एलिमेंट, OGC KML 2.2 स्टैंडर्ड का एक्सटेंशन है. इसे Google Earth 5.0 और इसके बाद के वर्शन में इस्तेमाल किया जा सकता है. ज़्यादा जानें

सिंटैक्स

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

जानकारी

विवरण गुब्बारों की दृश्यता टॉगल करता है. अपडेट किए जाने वाले गुब्बारा को ऑब्जेक्ट के एक्सएमएल आईडी से पहचाना जाना चाहिए (उदाहरण के लिए, <Placemark targetId="xxx">).

उदाहरण

पहले उदाहरण में, प्लेसमार्क के साथ <gx:balloonVisibility> दिखाया गया है. जब प्लेसमार्क लोड होता है, तो विवरण गुब्बारा खुलता है.
दावा जालसाज़ी_example.KML

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

  <Placemark>
    <name>Eiffel Tower</name>
    <description>
        Located in Paris, France. 
        
        This description balloon opens 
        when the Placemark is loaded.
    </description>
    <gx:balloonVisibility>1</gx:balloonVisibility>
    <Point>
      <coordinates>2.294785,48.858093,0</coordinates>
    </Point>
  </Placemark>

</kml>

दूसरे उदाहरण में, टूर के दौरान <gx:balloonVisibility> का इस्तेमाल दिखाया गया है. टूर के दौरान कई गुब्बारे खोले और बंद किए जाते हैं, ताकि दर्शकों को जानकारी दी जा सके.
दावा जायज़_टूर_टू_टेक्स्ट उदाहरण.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>

विस्तृत

• <सुविधा>

<कैमरा>

सिंटैक्स

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

जानकारी

उस वर्चुअल कैमरे के बारे में बताता है जो सीन देखता है. यह तत्व पृथ्वी की सतह से कैमरे की स्थिति और कैमरे की देखने की दिशा तय करता है. कैमरे की स्थिति, <देशांतर>, <अक्षांश>, <ऊंचाई>, और <heightMode> या <gx:heightMode> से तय होती है. कैमरे को देखने की दिशा , <heading>, <tilt>, और <role> के हिसाब से तय की जाती है. <Camera> में किसी भी सुविधा का चाइल्ड एलिमेंट या <NetworkLinkControl> दोनों शामिल नहीं किए जा सकते.

<Camera> फ़िल्टर का इस्तेमाल करके, व्यू पर छह डिग्री का फ़्री कंट्रोल दिया जा सकता है. इस तरह, कैमरे को स्पेस में जगह दी जा सकती है. इसके बाद, उसको X, Y, और Z ऐक्सिस पर घुमाया जा सकता है. सबसे महत्वपूर्ण रूप से, आप कैमरे के दृश्य को झुका सकते हैं, ताकि आप क्षितिज के ऊपर से आसमान की ओर नज़र डाल सकें.

<Camera> में TimePrimitive (<gx:TimeSpan> या <gx:TimeStamp>) का इस्तेमाल भी किया जा सकता है. कैमरे में मौजूद समय की जानकारी से ऐतिहासिक तस्वीरों के संग्रह, धूप या समय के साथ स्टैंप वाली सुविधाओं पर असर पड़ता है. ज़्यादा जानकारी के लिए, डेवलपर गाइड के समय और ऐनिमेशन चैप्टर में ऐब्स्ट्रैक्ट व्यू के साथ समय पढ़ें.

व्यू तय करना

किसी फ़ीचर या <NetworkLinkControl> में, <Camera> या <LookAt> ऑब्जेक्ट का इस्तेमाल किया जा सकता है, लेकिन दोनों का इस्तेमाल एक ही ऑब्जेक्ट के लिए नहीं किया जा सकता. <Camera> ऑब्जेक्ट, व्यू की जगह और ओरिएंटेशन के हिसाब से व्यूपॉइंट को तय करता है. <कैमरा> ऑब्जेक्ट की मदद से आप ऐसा व्यू तय कर सकते हैं जो पृथ्वी की सतह पर नहीं होता. <LookAt> ऑब्जेक्ट, देखे जा रहे कॉन्टेंट के हिसाब से व्यूपॉइंट को तय करता है. <LookAt> ऑब्जेक्ट, <Camera> के मुकाबले ज़्यादा काम नहीं करता. साथ ही, व्यू के लिए अर्थ की जगह, पृथ्वी की सतह से मेल खाना ज़रूरी है.

नीचे दिया गया डायग्राम X, Y, और Z ऐक्सिस दिखाता है. ये ऐक्सिस वर्चुअल कैमरे से जुड़े होते हैं.

• X ऐक्सिस कैमरे की दाईं ओर है. इसे राइट वेक्टर कहा जाता है.
• Y ऐक्सिस स्क्रीन के हिसाब से "ऊपर" की दिशा को बताता है और इसे अप वेक्टर कहा जाता है.
• Z ऐक्सिस, स्क्रीन के बीच वाले हिस्से से आई पॉइंट की तरफ़ पॉइंट करता है. कैमरा −Z ऐक्सिस पर नज़र रखता है, जिसे व्यू वेक्टर कहा जाता है.

बदलावों का क्रम

घुमाव का क्रम अहम है. डिफ़ॉल्ट रूप से, कैमरा −Z अक्ष को नीचे पृथ्वी की ओर देखता है. घुमाने से पहले, कैमरे का Z अक्ष के साथ <ऊंचाई> में अनुवाद किया जाता है. बदलावों का क्रम नीचे दिया गया है:

1. <altitude> - Z ऐक्सिस के साथ <height> में अनुवाद करें
2. <heading> - Z ऐक्सिस पर घुमाएं.
3. <tilt> - X ऐक्सिस पर घुमाएं.
4. <roll> - Z ऐक्सिस के चारों ओर घुमाएं.

ध्यान दें कि हर बार रोटेशन लागू करने पर, दो कैमरा ऐक्सिस अपनी दिशा बदल देते हैं.

कैमरे के लिए खास एलिमेंट

<देशांतर>

वर्चुअल कैमरे का देशांतर (आई पॉइंट). प्राइम मेरिडियन के मुकाबले, डिग्री में ऐंगुलर दूरी. मेरिडियन के पश्चिमी इलाकों की वैल्यू -180 से 0 डिग्री के बीच है. मेरीडियन के पूर्व में 0 से 180 डिग्री के बीच श्रेणी हैं.

<अक्षांश>

वर्चुअल कैमरे का अक्षांश. भूमध्य रेखा के उत्तर या दक्षिण में डिग्री. वैल्यू -90 डिग्री से लेकर 90 डिग्री तक होती हैं.

<ऊंचाई>

पृथ्वी की सतह से कैमरे की दूरी मीटर में. कैमरे की <heightMode> या <gx:heightMode> के हिसाब से जानकारी.

<शीर्षक>

कैमरे की दिशा (अज़िमथ) डिग्री में है. डिफ़ॉल्ट=0 (सही उत्तर). ( डायग्राम देखें.) वैल्यू की सीमा 0 से 360 डिग्री तक है.

<टिल्ट>

X ऐक्सिस पर कैमरे का घुमाव. 0 की वैल्यू से पता चलता है कि व्यू को सीधे धरती की ओर लक्षित किया जाएगा (सबसे सामान्य मामला). <tilt> के लिए 90 की वैल्यू दिखाती है कि व्यू क्षितिज की ओर है. 90 से बड़े मान संकेत देते हैं कि दृश्य आकाश में है. <tilt> की वैल्यू को 180 डिग्री पर क्लैंप किया जाता है.

<रोल>

कैमरे को Z ऐक्सिस पर डिग्री में घुमाएं. वैल्यू 180 से 180 डिग्री के बीच हो सकती हैं.

<heightMode>

यह बताता है कि कैमरे के लिए तय किया गया <ऊंचाई> कैसे तय किया गया है. ये वैल्यू हो सकती हैं:

• relativeToGround - (डिफ़ॉल्ट) <height> को ज़मीन से मीटर में मान के रूप में समझता है. अगर बिंदु पानी पर है, तो <ऊंचाई> को समुद्र तल से मीटर में मान के रूप में समझा जाएगा. समुद्र तल से संबंधित बिंदु बताने के लिए नीचे <gx:heightMode> देखें.
• clampToGround - कैमरे के लिए, यह सेटिंग relativeToGround को भी रखती है, क्योंकि कैमरे को ऊंचाई वाले इलाके में रखने का मतलब यह होगा कि आंख, इलाके को काट देगी (और व्यू ब्लॉक हो जाएगा).
• संपूर्ण - <ऊंचाई> को समुद्र तल से मीटर में मान के रूप में देखता है.

<gx:heightMode>

Google एक्सटेंशन नेमस्पेस में KML एक्सटेंशन, जो समुद्र तल से ऊंचाई को अनुमति देता है. वैल्यू ये हैं:

• relativeToSeaFloor - समुद्र तल के ऊपर मीटर में मान के रूप में <height> की व्याख्या करता है. अगर बिंदु समुद्र के बजाय ज़मीन से ऊपर है, तो <ऊंचाई> को ज़मीन से ऊपर होने के तौर पर समझा जाएगा.
• clampToSeaFloor - <ऊंचाई> की खास जानकारी को नज़रअंदाज़ कर दिया जाता है और कैमरा समुद्र के तल पर लगा दिया जाता है. अगर बिंदु समुद्र के बजाय ज़मीन पर है, तो कैमरा ज़मीन पर रखा जाएगा.

विस्तृत

• AbstractView>

कॉन्टेंट का मालिक

• <Feature> से मिला कोई भी एलिमेंट
• <NetworkLinkControl>

पेज पर सबसे ऊपर जाएं

<ColorStyle>

सिंटैक्स

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

जानकारी

यह एक ऐब्स्ट्रैक्ट एलिमेंट है और इसे सीधे KML फ़ाइल में इस्तेमाल नहीं किया जा सकता. यह एक्सटेंडेड स्टाइल टाइप के कलर और कलर मोड की जानकारी देने के लिए एलिमेंट उपलब्ध कराता है.

ColorStyle के लिए खास एलिमेंट

<रंग>

रंग और पारदर्शिता (ऐल्फ़ा) की वैल्यू, हेक्साडेसिमल संकेतन में दिखाई जाती हैं. किसी भी एक रंग के लिए मानों की श्रेणी 0 से 255 (00 से ff) होती है. ऐल्फ़ा के लिए, 00 पूरी तरह से पारदर्शी है और ff पूरी तरह से अपारदर्शी है. एक्सप्रेशन का क्रम abggrr है, जहां aa=alpha (00 से ff); bb=blue (00 से ff); gg=green (00 to ff); rr=red (00 से ff) है. उदाहरण के लिए, अगर आपको किसी ओवरले पर 50 प्रतिशत ओपैसिटी के साथ नीला रंग लागू करना है, तो आपको यह जानकारी देनी होगी: <color>7fff0000</color>, जहां ऐल्फ़ा=0x7f, नीला=0xff, हरा=0x00, और लाल=0x00 है.

<colorMode>

> <colorMode> के लिए वैल्यू सामान्य (कोई असर नहीं) और रैंडम हैं. रैंडम की वैल्यू में, नीचे दिए गए तरीके से बेसिक <color> पर रैंडम लीनियर स्केल लागू किया जाता है.

• रंगों का सही क्रम चुनने के लिए, आधार का रंग <color> सफ़ेद (ffff) तय करें.
• किसी एक कलर कॉम्पोनेंट के बारे में बताने पर (उदाहरण के लिए, red के लिए ff0000ff का वैल्यू), उस एक कॉम्पोनेंट (लाल) के लिए रैंडम कलर वैल्यू चुनी जाएंगी. इस मामले में, वैल्यू 00 (काली) से ff (फ़ुल रेड) तक होगी.
• अगर आप दो या सभी तीन कलर कॉम्पोनेंट के लिए वैल्यू तय करते हैं, तो हर कलर कॉम्पोनेंट पर एक रैंडम स्केल लागू किया जाता है. इसमें काले रंग से लेकर हर कॉम्पोनेंट के लिए तय ज़्यादा से ज़्यादा वैल्यू के नतीजे शामिल होते हैं.
• रंग की अपारदर्शिता <color> के ऐल्फ़ा कॉम्पोनेंट से मिलती है और इसे कभी भी रैंडम नहीं किया जाता है.

विस्तृत

• <ऑब्जेक्ट>

इस तारीख तक बढ़ाया गया

• <IconStyle>
• <LabelStyle>
• <LineStyle>
• <PolyStyle>

पेज पर सबसे ऊपर जाएं

<कंटेनर>

सिंटैक्स

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

जानकारी

यह एक ऐब्स्ट्रैक्ट एलिमेंट है और इसे सीधे KML फ़ाइल में इस्तेमाल नहीं किया जा सकता. कंटेनर एलिमेंट में एक या ज़्यादा सुविधाएं होती हैं और यह नेस्ट किए गए पदानुक्रम बनाने की अनुमति देती है.

विस्तृत

• <सुविधा>

इस तारीख तक बढ़ाया गया

• <दस्तावेज़>
• <फ़ोल्डर>

पेज पर सबसे ऊपर जाएं

<दस्तावेज़>

सिंटैक्स

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

जानकारी

दस्तावेज़, सुविधाओं और स्टाइल के लिए एक कंटेनर होता है. अगर आपकी KML फ़ाइल शेयर की गई शैली का इस्तेमाल करती है, तो यह एलिमेंट ज़रूरी है. हमारा सुझाव है कि आप शेयर किए गए स्टाइल का इस्तेमाल करें, इसके लिए यह तरीका अपनाएं:

1. दस्तावेज़ में सभी स्टाइल तय करें. हर शैली को एक खास आईडी असाइन करें.
2. किसी दिए गए फ़ीचर या StyleMap में, <styleUrl> एलिमेंट का इस्तेमाल करके स्टाइल के आईडी का संदर्भ लें.

ध्यान दें कि शेयर की गई शैलियां, दस्तावेज़ में मौजूद सुविधाओं से इनहेरिट नहीं की जाती हैं.

हर सुविधा में उन स्टाइल का साफ़ तौर पर ज़िक्र होना चाहिए जो वह किसी <styleUrl> एलिमेंट में इस्तेमाल करता है. दस्तावेज़ पर लागू होने वाली शैली (जैसे कि ListStyle), के लिए दस्तावेज़ को साफ़ तौर पर <styleUrl> का संदर्भ देना होगा. उदाहरण के लिए:

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

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

शेयर की गई स्टाइल को फ़ोल्डर में न रखें.

नीचे दिए गए उदाहरण में शेयर की गई स्टाइल के इस्तेमाल को दिखाया गया है.

उदाहरण

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

विस्तृत

• <कंटेनर>

इसमें ये शामिल हैं

• <सुविधा> से मिले 0 या ज़्यादा एलिमेंट
• <StyleSelector> से मिले 0 या उससे ज़्यादा एलिमेंट
• <Schema> से मिले 0 या ज़्यादा एलिमेंट

पेज पर सबसे ऊपर जाएं

<gx:duration>

यह एलिमेंट, OGC KML 2.2 स्टैंडर्ड का एक्सटेंशन है. इसे Google Earth 5.0 और इसके बाद के वर्शन में इस्तेमाल किया जा सकता है. ज़्यादा जानें

सिंटैक्स

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

जानकारी

<gx:duration>, इवेंट के लिए किसी समयावधि को तय करके gx:TourPrimitive को बढ़ाता है. एक्सएमएल के डबल डेटाटाइप का इस्तेमाल करके, समय को सेकंड के तौर पर लिखा जाता है.

कुल समय और <gx:FlyTo>

जब किसी <gx:FlyTo> एलिमेंट में कुल समय शामिल होता है, तो यह तय करता है कि पिछले पॉइंट से तय पॉइंट तक पहुंचने में, ब्राउज़र को कितना समय लगेगा.

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

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

कुल समय और <gx:AnimatedUpdate>

अपडेट होने के समय की जानकारी देता है. पूरी अवधि में इंटिजर, फ़्लोट, और कलर फ़ील्ड, मूल से नए वैल्यू पर आसानी से ऐनिमेट किए जाते हैं. बूलियन, स्ट्रिंग, और ऐसे दूसरे वैल्यू जो इंटरपोलेशन को नहीं बताते हैं, उन्हें अवधि के आखिर में अपडेट किया जाता है.

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

    ....

  </Update>
</gx:AnimatedUpdate>

 

<एक्सटेंडेड डेटा>

सिंटैक्स

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

जानकारी

एक्सटेंडेड डेटा एलिमेंट, KML सुविधा (कस्टम नेटवर्क लिंक, प्लेसमार्क, GroundOverlay, PhotoOverlay, स्क्रीन ओवरले, दस्तावेज़, फ़ोल्डर) में कस्टम डेटा जोड़ने के लिए तीन तकनीकें पेश करता है. ये सभी तकनीकें

• <Data> एलिमेंट (बेसिक) का इस्तेमाल करके, बिना डेटा वाले डेटा/वैल्यू पेयर जोड़ना
• <Schema> एलिमेंट का इस्तेमाल करके, नए टाइप किए गए फ़ील्ड बताना और <SchemaData> एलिमेंट (बेहतर) का इस्तेमाल करके उन्हें बढ़ाना
• KML फ़ाइल में बुनियादी नेमस्पेस का रेफ़रंस देकर, अन्य नेमस्पेस में तय किए गए एक्सएमएल एलिमेंट का रेफ़रंस देना (बेसिक)

डेटा को अलग-अलग हिस्सों में बांटने के लिए, इन तकनीकों को किसी एक KML फ़ाइल या सुविधा के साथ जोड़ा जा सकता है.

ज़्यादा जानकारी के लिए, "KML में विषय" में कस्टम डेटा जोड़ना देखें.

एक्सटेंडेड डेटा के लिए खास एलिमेंट

<Data name ="स्ट्रिंग">

बिना नाम वाला नाम/वैल्यू जोड़ा बनाता है. नाम के दो वर्शन हो सकते हैं: name और displayName. name एट्रिब्यूट का इस्तेमाल, KML फ़ाइल में मौजूद डेटा पेयर की पहचान करने के लिए किया जाता है. displayName एलिमेंट का इस्तेमाल तब किया जाता है, जब Google Earth में स्पेस और एचटीएमएल फ़ॉर्मैटिंग के साथ सही फ़ॉर्मैट वाला नाम दिखाया जाता है. <BaloonStyle> के <text> एलिमेंट में, नोटेशन $[name/displayName] को <displayName> से बदल दिया जाता है. अगर आपने इस फ़ॉर्मैट में <Data> एलिमेंट की नाम एट्रिब्यूट की वैल्यू को बदला है (उदाहरण के लिए, $[होलYardage], तो एट्रिब्यूट की वैल्यू को <value> से बदल दिया जाता है. डिफ़ॉल्ट रूप से, प्लेसमार्क का गुब्बारा, नाम/वैल्यू पेयर से जुड़ा नाम दिखाता है.

<displayName>

डिसप्ले के मकसद से इस्तेमाल करने के लिए, नाम का वैकल्पिक फ़ॉर्मैट वाला वर्शन.

<वैल्यू>

डेटा जोड़े का मान.

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

इस एलिमेंट का इस्तेमाल, टाइप किए गए कस्टम डेटा को KML सुविधा में जोड़ने के लिए, <Schema> के साथ किया जाता है. स्कीमा एलिमेंट, schemaUrl एट्रिब्यूट से पहचाना जाता है और कस्टम डेटा टाइप के बारे में बताता है. असल डेटा ऑब्जेक्ट (कस्टम डेटा के "इंस्टेंस") SchemaData एलिमेंट का इस्तेमाल करके तय किए जाते हैं.

<schemaURL> में पूरा यूआरएल हो सकता है. इसके अलावा, बाहरी KML फ़ाइल में मौजूद स्कीमा आईडी का संदर्भ या ऐसी KML फ़ाइल में मौजूद स्कीमा आईडी का रेफ़रंस भी हो सकता है. ये सभी विशेषताएं स्वीकार की जाती हैं:

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

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

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

स्कीमा एलिमेंट हमेशा दस्तावेज़ का हिस्सा होता है. एक्सटेंडेड डेटा एलिमेंट उस सुविधा का हिस्सा है जिसमें कस्टम डेटा होता है.

<SimpleData name="स्ट्रिंग">

यह एलिमेंट, नाम एट्रिब्यूट से पहचाने जाने वाले कस्टम डेटा फ़ील्ड के लिए कोई वैल्यू असाइन करता है. इस कस्टम डेटा फ़ील्ड के टाइप और नाम के बारे में <Schema> एलिमेंट में बताया गया है.

यहां कस्टम डेटा के दो एलिमेंट के बारे में बताया गया है:

<Placemark>
  <name>Easy trail</name>
  <ExtendedData>
    <SchemaData schemaUrl="#TrailHeadTypeId">
      <SimpleData name="TrailHeadName">Pi in the sky</SimpleData>
      <SimpleData name="TrailLength">3.14159</SimpleData>
      <SimpleData name="ElevationGain">10</SimpleData>
    </SchemaData>
    </ExtendedData>
    <Point>
      <coordinates>-122.000,37.002</coordinates>
    </Point>
</Placemark>
<Placemark>
  <name>Difficult trail</name>
  <ExtendedData>
    <SchemaData schemaUrl="#TrailHeadTypeId">
      <SimpleData name="TrailHeadName">Mount Everest</SimpleData>
      <SimpleData name="TrailLength">347.45</SimpleData>
      <SimpleData name="ElevationGain">10000</SimpleData>
    </SchemaData>
  </ExtendedData>
  <Point>
    <coordinates>-122.000,37.002</coordinates>
  </Point>
</Placemark>

<namespace_prefix:other>

इस एलिमेंट की मदद से, टाइप न किया गया कस्टम डेटा जोड़ा जा सकता है. पक्का करें कि आपकी फ़ाइल के <KML> एलिमेंट में नेमस्पेस के प्रीफ़िक्स की जानकारी दी गई हो या <एक्सटेंडेड डेटा> एलिमेंट के एट्रिब्यूट के तौर पर और हर डेटा एलिमेंट के नाम के शुरुआत में नेमस्पेस का प्रीफ़िक्स जोड़ा गया हो. इस तरह से जोड़ा गया कस्टम डेटा KML फ़ाइल में सुरक्षित रहता है, लेकिन Google Earth इसका इस्तेमाल किसी भी तरह से नहीं करता है. इसे हमेशा फ़ाइल के साथ सेव किया जाता है.

नीचे दिए गए उदाहरण में, "camp" नेमस्पेस का इस्तेमाल करके दिखाया गया है:

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

कॉन्टेंट का मालिक

• <Feature> से मिला कोई भी एलिमेंट

यह भी देखें

• स्कीमा

<सुविधा>

सिंटैक्स

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

जानकारी

यह एक ऐब्स्ट्रैक्ट एलिमेंट है और इसे सीधे KML फ़ाइल में इस्तेमाल नहीं किया जा सकता. यह डायग्राम दिखाता है कि Google Earth में किसी सुविधा के कुछ एलिमेंट कैसे दिखते हैं.

सुविधा के लिए खास एलिमेंट

<नाम>

3D व्यूअर में ऑब्जेक्ट के लेबल के रूप में दिखाया गया उपयोगकर्ता-तय टेक्स्ट (उदाहरण के लिए, प्लेसमार्क, फ़ोल्डर या NetworkLink).

<किसको दिखे>

बूलियन मान. यह बताती है कि सुविधा को शुरुआत में लोड होते समय, 3D व्यूअर में बनाया जाए या नहीं. किसी सुविधा के दिखने के लिए, उसके सभी पूर्वजों का <visible> टैग भी 1 पर सेट होना चाहिए. Google धरती सूची दृश्य में, प्रत्येक सुविधा में एक चेकबॉक्स होता है जो उपयोगकर्ता को सुविधा की दृश्यता को नियंत्रित करने देता है.

<खोलें>

बूलियन मान. बताता है कि स्थान पैनल में पहली बार लोड किए जाने पर कोई दस्तावेज़ या फ़ोल्डर बंद दिखता है या खुला होता है. 0=छोटा (डिफ़ॉल्ट), 1=बड़ा किया गया. <ListStyle> भी देखें. यह एलिमेंट सिर्फ़ दस्तावेज़, फ़ोल्डर, और NetworkLink पर लागू होता है.

<atom:author>

KML 2.2, आपकी KML फ़ाइल में लेखक और संबंधित वेबसाइट के बारे में डेटा शामिल करने के लिए नए तत्वों का समर्थन करता है. यह जानकारी Google Earth जैसे अर्थ ब्राउज़र और Google Maps जैसे दूसरे ऐप्लिकेशन में भौगोलिक खोज नतीजों में दिखाई जाती है. KML में इस्तेमाल किए गए स्क्रिप्ट एलिमेंट इस तरह के होते हैं:

• atom:author एलिमेंट - atom:name के लिए पैरंट एलिमेंट
• atom:name एलिमेंट - लेखक का नाम
• atom:link एलिमेंट - इसमें href एट्रिब्यूट शामिल है
• href एट्रिब्यूट - उस वेब पेज का यूआरएल जिसमें KML/KMZ फ़ाइल होती है

इन चीज़ों को एटम सिंडिकेशन फ़ॉर्मैट में बताया गया है. इससे जुड़ी पूरी जानकारी http://atompub.org पर मौजूद है. (इसके बाद आने वाला सैंपल देखें).

<atom:author> एलिमेंट, <atom:name> का पैरंट एलिमेंट है. इससे, KML सुविधा के लेखक की जानकारी मिलती है.

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

उस वेबसाइट का यूआरएल बताता है जिसमें KML या KML फ़ाइल होती है. इस एलिमेंट का इस्तेमाल करने वाली किसी भी KML फ़ाइल में इसे शामिल करना न भूलें: xmlns:atom="http://www.w3.org/2005/Atom" (इसके बाद, आने वाला सैंपल देखें).

<पता>

किसी स्ट्रक्चर्ड सड़क, शहर, राज्य के पते, और/या पिन कोड के रूप में लिखे गए अनस्ट्रक्चर्ड पते के बारे में बताने वाली स्ट्रिंग. आप अक्षांश और देशांतर निर्देशांकों का इस्तेमाल करने के बजाय, बिंदु की जगह बताने के लिए <address> टैग का इस्तेमाल कर सकते हैं. हालांकि, अगर <Point> दिया गया है, तो उसे <address> के ऊपर प्राथमिकता दी जाती है.) यह जानने के लिए कि Google Earth में इस टैग के लिए कौनसी स्थान-भाषाएं काम करती हैं, Google Maps सहायता पर जाएं.

<xal:AddressDetails>

एक स्ट्रक्चर्ड पता, जिसे xAL के तौर पर फ़ॉर्मैट किया जाता है या eXटेनेबल अड्रेस लैंग्वेज, जो पता फ़ॉर्मैटिंग के लिए एक अंतरराष्ट्रीय स्टैंडर्ड है. <xal:AddressDetails> का इस्तेमाल KML सिर्फ़ Google Maps में जियोकोडिंग के लिए करता है. जानकारी के लिए, Google Maps API दस्तावेज़ देखें. फ़िलहाल, Google Earth इस एलिमेंट का इस्तेमाल नहीं करता है; इसके बजाय <address> का इस्तेमाल करें. इस एलिमेंट का इस्तेमाल करने वाली किसी भी KML फ़ाइल में इसे नेमस्पेस शामिल करना न भूलें: xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"

<फ़ोन नंबर>

टेलीफ़ोन नंबर को दिखाने वाला स्ट्रिंग मान. इस एलिमेंट का इस्तेमाल, सिर्फ़ Google Maps मोबाइल के ज़रिए किया जाता है. Java-सक्षम सेलफ़ोन के लिए उद्योग मानक RFC2806 है.
ज़्यादा जानकारी के लिए, http://www.ietf.org/rfc /rfc2806.txt देखें. 

<स्निपेट maxLines="2" >

सुविधा के बारे में कम शब्दों में जानकारी. Google Earth में, यह सुविधा 'जगहें' पैनल में सुविधा के नाम के नीचे दिखती है. अगर स्निपेट नहीं दिया गया है, तो <description> की पहली दो लाइनों का इस्तेमाल किया जाता है. Google Earth में, अगर किसी प्लेसमार्क में ब्यौरा और एक स्निपेट, दोनों होते हैं, तो <snippet> प्लेस पैनल में प्लेसमार्क के नीचे और <description> प्लेसमार्क के विवरण गुब्बारे में दिखाई देता है. यह टैग, एचटीएमएल मार्कअप के साथ काम नहीं करता. <snippet> एक maxLines विशेषता का इस्तेमाल करता है. यह एक पूर्णांक होता है, जो दिखने वाली लाइनों की ज़्यादा से ज़्यादा संख्या के बारे में बताता है.

<ब्यौरा>

उपयोगकर्ता की ओर से उपलब्ध कराया गया कॉन्टेंट, जो जानकारी के गुब्बारे में दिखता है.

<description> एलिमेंट का इस्तेमाल करने वाले कॉन्टेंट को Google Earth 4.3 से बदलकर 5.0 कर दिया गया है. हर वर्शन की खास जानकारी नीचे दी गई है. इसके बाद, दोनों वर्शन में आम तौर पर इस्तेमाल होने वाली जानकारी दी जाती है.

Google Earth 5.0

Google Earth 5.0 (और बाद के वर्शन) सादे गुब्बारे का समर्थन करता है. साथ ही, यह जानकारी वाले गुब्बारों में पूरे एचटीएमएल और JavaScript का समर्थन करता है. जानकारी देने वाले टैग के कॉन्टेंट को WebKit ओपन सोर्स वेब ब्राउज़र इंजन से रेंडर किया जाता है और ये उसी तरह दिखाए जाते हैं जैसे वे किसी भी WebKit वाले ब्राउज़र में मिलते हैं.

सामान्य पाबंदियां

स्थानीय फ़ाइलों के लिंक की अनुमति नहीं दी जाती है. इससे, नुकसान पहुंचाने वाले कोड को आपके सिस्टम को नुकसान पहुंचने या आपका डेटा ऐक्सेस करने से रोका जा सकता है. अपने स्थानीय फ़ाइल सिस्टम को ऐक्सेस करने की अनुमति देने के लिए, प्राथमिकताएं > स्थानीय फ़ाइलों और निजी डेटा का ऐक्सेस दें को चुनें. अगर <img> टैग में शामिल हों, तो लोकल फ़ाइल सिस्टम पर मौजूद इमेज फ़ाइलों के लिंक हमेशा इस्तेमाल किए जा सकते हैं.

हालांकि, इसके लिए ज़रूरी है कि कॉन्टेंट को KML फ़ाइल में कंप्रेस किया जाए. भले ही, वह लोकल फ़ाइल सिस्टम पर कंप्रेस हो.

कुकी चालू की गई हैं, लेकिन एक ही ऑरिजिन से जुड़ी नीति के लिए, लोकल कॉन्टेंट किसी अन्य कॉन्टेंट के साथ डोमेन शेयर नहीं करता (इसमें अन्य स्थानीय कॉन्टेंट भी शामिल है).

एचटीएमएल

एचटीएमएल को ज़्यादातर वेबकिट ब्राउज़र की तरह रेंडर किया जाता है.

टारगेट को सीधे KML में लिखे गए एचटीएमएल में शामिल करने पर अनदेखा किया जाता है; ऐसे सभी लिंक को इस तरह से खोला जाता है जैसे टारगेट को _blank पर सेट किया गया हो. किसी भी टारगेट को अनदेखा किया जाता है.

हालांकि, किसी iFrame में शामिल HTML, या JavaScript या DHTML के साथ डायनामिक रूप से जनरेट किया गया HTML, डिफ़ॉल्ट रूप से target="_self" का इस्तेमाल करेगा. दूसरे टारगेट के बारे में बताया जा सकता है और वे इस्तेमाल किए जा सकते हैं.

iFrame फ़ाइलों में शामिल HTML से, KML फ़ाइलों, स्थानीय ऐंकर लिंक, और ;flyto तरीकों के कॉन्टेंट को टारगेट नहीं किया जा सकता.

अगर उपयोगकर्ता किसी iFrame की चौड़ाई के लिए width="100%" तय करता है, तो iFrame की चौड़ाई, गुब्बारा के बाकी कॉन्टेंट पर निर्भर करेगी. लेआउट साइज़ का हिसाब लगाते समय इसे अनदेखा किया जाना चाहिए. यह नियम गुब्बारा के अंदर मौजूद किसी भी दूसरे ब्लॉक एलिमेंट पर भी लागू होता है.

JavaScript

ज़्यादातर JavaScript काम करती है. डायलॉग बॉक्स नहीं बनाए जा सकते - अलर्ट() और प्रॉम्प्ट() जैसे फ़ंक्शन नहीं दिखाए जाएंगे. हालांकि, उन्हें सिस्टम कंसोल में, दूसरी गड़बड़ियों और अपवादों की तरह लिखा जाएगा.

सीएसएस

सीएसएस की अनुमति है. किसी सामान्य वेब ब्राउज़र में सीएसएस की तरह, सीएसएस का इस्तेमाल टेक्स्ट स्टाइल, पेज एलिमेंट को शैली देने, और ब्यौरे के गुब्बारा का साइज़ और दिखने को कंट्रोल करने के लिए किया जा सकता है.

Google Earth 4.3

<description> एलिमेंट, सादे लेख के साथ-साथ एचटीएमएल फ़ॉर्मैटिंग एलिमेंट के सबसेट के साथ काम करता है, जिनमें टेबल भी शामिल हैं (KML उदाहरण देखें). यह अन्य वेब-आधारित प्रौद्योगिकी का समर्थन नहीं करता है, जैसे गतिशील पेज मार्कअप (PHP, JSP, ASP), स्क्रिप्टिंग भाषाएं (VBScript, JavaScript) और न ही ऐप्लिकेशन भाषाएं (Java, Python). Google Earth के रिलीज़ किए गए वर्शन 4.2 में, वीडियो की सुविधा है. (उदाहरण नीचे देखें.)

सामान्य जानकारी

अगर आपके विवरण में कोई HTML मार्कअप नहीं है, तो Google Earth उसे फ़ॉर्मैट करने की कोशिश करता है. इसमें नई लाइनों को <br> से बदल दिया जाता है और यूआरएल को ऐंकर टैग से रैप कर दिया जाता है. वर्ल्ड वाइड वेब के लिए एक मान्य यूआरएल स्ट्रिंग, अपने-आप उस यूआरएल के हाइपरलिंक में बदल जाती है (उदाहरण, http://www.google.com). नतीजतन, आपको एक आसान लिंक पाने के लिए यूआरएल को <a href="http://."></a> टैग के बीच रखना नहीं पड़ेगा.

किसी खास शब्द के आस-पास हाइपरलिंक बनाने या एचटीएमएल में इमेज शामिल करने के लिए, ऐंगल ब्रैकेट, अपॉस्ट्रफ़ी, और दूसरे खास वर्णों से बचने के लिए, एचटीएमएल एंटिटी के रेफ़रंस या CDATA एलिमेंट का इस्तेमाल करना चाहिए. CDATA एलिमेंट, XML पार्सर को बताता है कि ब्रैकेट में इस्तेमाल किए गए विशेष वर्णों को नज़रअंदाज़ करें. यह एलिमेंट इस तरह का होता है:

<![CDATA[
  special characters here
]]> 

अगर आपको CDATA एलिमेंट का इस्तेमाल नहीं करना है, तो सभी खास वर्णों को बदलने के लिए एंटिटी के रेफ़रंस का इस्तेमाल किया जा सकता है.

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

<a> एलिमेंट के इस्तेमाल से तय होने वाला अन्य व्यवहार

KML, <a> एलिमेंट में दो एट्रिब्यूट के इस्तेमाल की अनुमति देता है: href और type.

एंकर एलिमेंट <a> में एक href एट्रिब्यूट होता है, जो यूआरएल के बारे में बताता है.

अगर href KML फ़ाइल है और इसमें .KML या .KMZ फ़ाइल एक्सटेंशन है, तो Google Earth उस फ़ाइल को उपयोगकर्ता के क्लिक करने पर सीधे लोड करता है. अगर यूआरएल के आखिर में एक्सटेंशन होता है और वह Google Earth (उदाहरण के लिए, .html) से नहीं जुड़ा है, तो ब्राउज़र को यूआरएल भेजा जाता है.

href कोई फ़्रैगमेंट यूआरएल हो सकता है (यानी कि # साइन और उसके बाद KML आइडेंटिफ़ायर). जब कोई उपयोगकर्ता किसी ऐसे लिंक पर क्लिक करता है जिसमें फ़्रैगमेंट यूआरएल शामिल होता है, तो ब्राउज़र डिफ़ॉल्ट रूप से उस सुविधा पर पहुंच जाता है जिसका आईडी, फ़्रैगमेंट से मेल खाता है. अगर सुविधा में LookAt या कैमरा एलिमेंट है, तो सुविधा को तय किए गए व्यूपॉइंट से देखा जाता है.

नीचे दिए गए तीन स्ट्रिंग में से किसी एक को फ़्रैगमेंट यूआरएल में जोड़कर, व्यवहार को और ज़्यादा बताया जा सकता है:

• ;flyto (डिफ़ॉल्ट) - सीधे सुविधा पर जाएं
• ; हेलर - सुविधा का गुब्बारा खोलें, लेकिन सुविधा पर न जाएं
• ;मरानाफ्लाइटो - सुविधा का गुब्बारा खोलें और सुविधा के लिए उड़ान भरें

उदाहरण के लिए, नीचे दिया गया कोड CraftsFairs.KML फ़ाइल को खोलने के लिए है. उस प्लेसमार्क पर जाएं जिसका आईडी "अल्बुकर्क" है और उसका गुब्बारा खोलें:

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

type एट्रिब्यूट का इस्तेमाल तब किया जाता है, जब <a> एलिमेंट में href एट्रिब्यूट, .KML या .KMZ पर खत्म नहीं होता. हालांकि, रेफ़रंस के बारे में KML के हिसाब से बताना ज़रूरी होता है. यह जानकारी दें:

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

उदाहरण के लिए, इस यूआरएल में type एट्रिब्यूट का इस्तेमाल करके, Google Earth को बताया जाता है कि उसे फ़ाइल लोड करने की कोशिश करनी चाहिए. भले ही, फ़ाइल का एक्सटेंशन .php हो:

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

<AbstractView>

सुविधा से मिले किसी भी एलिमेंट से जुड़े व्यूपॉइंट को तय करता है. <Camera> और <LookAt> देखें.

<TimePrimitive>

इस सुविधा को समय की अवधि (<TimeSpan>) या समय के किसी हिस्से (<TimeStamp>) से जोड़ता है.

<styleUrl>

किसी दस्तावेज़ में बताए गए <Style> या <StyleMap> का यूआरएल. अगर स्टाइल एक ही फ़ाइल में है, तो # रेफ़रंस का इस्तेमाल करें. अगर स्टाइल को किसी बाहरी फ़ाइल में बताया गया है, तो # रेफ़रंस के साथ एक पूरे यूआरएल का इस्तेमाल करें. उदाहरण

<styleUrl>#myIconStyleID</styleUrl>

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

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

<StyleSelector>

एक या ज़्यादा स्टाइल और स्टाइल मैप को, किसी प्लेसमार्क में सुविधा या ज्यामिति की मदद से बनाए गए किसी भी एलिमेंट के रंग-रूप को तय करने के लिए तय किया जा सकता है. (<BaloonStyle>, <ListStyle>, <StyleSelector>, और <ColorStyle> से मिली स्टाइल देखें.) किसी सुविधा में तय किए गए स्टाइल को "इनलाइन स्टाइल" कहते हैं और यह सिर्फ़ उस सुविधा पर लागू होता है जिसमें यह मौजूद होता है. <Document> के चाइल्ड के रूप में परिभाषित की गई शैली को "शेयर की गई शैली" कहा जाता है. शेयर किए गए स्टाइल के लिए एक id तय होना चाहिए. इस आईडी का संदर्भ <Document> में एक या उससे ज़्यादा सुविधाओं के ज़रिए दिया जाता है. जिन मामलों में किसी स्टाइल एलिमेंट को शेयर की गई स्टाइल और किसी सुविधा के लिए इनलाइन स्टाइल, दोनों में परिभाषित किया गया है—यानी, फ़ोल्डर, GroundOverlay, NetworkLink, प्लेसमार्क या ScreenOverlay—सुविधा के इनलाइन स्टाइल के मान को शेयर की गई स्टाइल की वैल्यू पर प्राथमिकता दी जाती है.

<क्षेत्र>

किसी क्षेत्र से जुड़ी सुविधाएं और ज्यामिति केवल तब बनाई जाती हैं, जब क्षेत्र सक्रिय होता है. <region> में देखें.

<मेटाडेटा>

<बढ़ाया गया डेटा>

इससे, आप KML फ़ाइल में कस्टम डेटा जोड़ सकते हैं. यह डेटा (1) ऐसा डेटा हो सकता है जो किसी बाहरी एक्सएमएल स्कीमा के बारे में बताता है, (2) टाइप न किए गए डेटा/वैल्यू के जोड़े हैं या (3) टाइप किया गया डेटा है. किसी खास KML सुविधा में इस तरह के कस्टम डेटा का एक संयोजन हो सकता है.

किसी ब्यौरे में एचटीएमएल एलिमेंट के इस्तेमाल का सैंपल

यह उदाहरण Google Earth 4.3 में <description> एलिमेंट के साथ काम करने वाले एचटीएमएल एलिमेंट के पूरे सेट को दिखाता है. Google Earth 5.0 और उसके बाद के वर्शन, संपूर्ण HTML और JavaScript का समर्थन करते हैं.

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

स्क्रिप्ट में एलिमेंट का इस्तेमाल करना

इस उदाहरण में ऐटम नेमस्पेस के <atom:author>, <atom:name>, और <atom:link> एलिमेंट के इस्तेमाल को दिखाया गया है. ध्यान दें कि आपको इस नेमस्पेस को <<a href=" एलिमेंट में रखना होगा.

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

सैंपल वीडियो

इस उदाहरण में, गुब्बारा वीडियो में Flash वीडियो जोड़ने का तरीका बताया गया है.

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

विस्तृत

• <ऑब्जेक्ट>

इस तारीख तक बढ़ाया गया

• कंटेनर>
• <ओवरले>
• <प्लेसमार्क>
• <NetworkLink>
• <gx:टूर>

<gx:FlyTo>

यह एलिमेंट, OGC KML 2.2 स्टैंडर्ड का एक्सटेंशन है. इसे Google Earth 5.0 और इसके बाद के वर्शन में इस्तेमाल किया जा सकता है. ज़्यादा जानें

सिंटैक्स

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

जानकारी

<gx:FlyTo>, स्पेस में उस जगह के बारे में बताता है जहां ब्राउज़र को सफ़र के दौरान भेजा जाएगा. इसमें एक AbstractView होना चाहिए और इसमें <gx:duration> और <gx:flyToMode> एलिमेंट होने चाहिए, जो मौजूदा पॉइंट से, तय पॉइंट तक पहुंचने में लगने वाले समय और फ़्लाइट के तरीके के बारे में बताते हैं.

<gx:flyToMode>

<gx:flyToMode> के लिए दो वैल्यू इस्तेमाल की जा सकती हैं: स्मूद और बाउंस.

• बराबर FlyTos बिंदु से बिंदु (और चालू) में एक सीधी फ़्लाइट की अनुमति देता है. आसान ToTos की एक खंडित शृंखला शून्य वेग से शुरू और खत्म होगी और किसी भी बिंदु पर धीमी नहीं होगी. आसानी से काम करने वाले FlyTos की सीरीज़ को इनमें से किसी एक एलिमेंट से तोड़ा जाता है:
  • <gx:flyToMode>bounce</gx:flyToMode>
  • <gx:Wait>
  इसका मतलब यह है कि ऊपर बताए गए किसी भी एलिमेंट के ठीक पहले, स्मूद FlyTo पर वेलोसिटी शून्य होगी. आसानी से काम करने वाले FlyTos की सीरीज़ को <gx:AnimatedUpdate> एलिमेंट से अलग नहीं किया गया है.


• बाउंस FlyTos हर एक शून्य वेग से शुरू और खत्म होता है.

उदाहरण

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

विस्तृत

• <gx:TourPrimitive>

इसमें ये शामिल हैं

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

<फ़ोल्डर>

सिंटैक्स

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

जानकारी

फ़ोल्डर का इस्तेमाल, दूसरी सुविधाओं को क्रम से लगाने के लिए किया जाता है. जैसे: फ़ोल्डर, प्लेसमार्क, NetworkLinks या ओवरले. कोई विशेषता केवल तभी दिखाई देती है जब वह और उसके सभी पूर्वज दिखाई देते हों.

उदाहरण

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

विस्तृत

• <कंटेनर>

इसमें ये शामिल हैं

• <Feature> से मिला कोई भी एलिमेंट

<ज्यामिति>

सिंटैक्स

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

जानकारी

यह एक ऐब्स्ट्रैक्ट एलिमेंट है और इसे सीधे KML फ़ाइल में इस्तेमाल नहीं किया जा सकता. यह सभी जमा ज्यॉमेट्री ऑब्जेक्ट के लिए प्लेसहोल्डर ऑब्जेक्ट देता है.

विस्तृत

• <ऑब्जेक्ट>

इस तारीख तक बढ़ाया गया

• <पॉइंट>
• <LineString>
• <LinearRing>
• <पॉलीगॉन>
• <मल्टीजियोमेट्री>
• <gx:मल्टीट्रैक>
• <मॉडल>
• <gx:ट्रैक>

<ग्राउंड ओवरले>

सिंटैक्स

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

जानकारी

यह एलिमेंट, इलाके के लिए इमेज ओवरले बनाता है. <Icon> का चाइल्ड, <href> चाइल्ड, ओवरले के रूप में इस्तेमाल की जाने वाली इमेज के बारे में बताता है. यह फ़ाइल किसी लोकल फ़ाइल सिस्टम या वेब सर्वर पर मौजूद हो सकती है. अगर इस एलिमेंट को छोड़ा जाता है या इसमें कोई <href> मौजूद नहीं है, तो ग्राउंड ओवरले से तय किए गए रंग और LatLonBox की सीमाओं का इस्तेमाल करके, आयत बनाया जाता है.

GroundOverlay के लिए खास एलिमेंट

<ऊंचाई>

पृथ्वी की सतह के ऊपर मीटर में दूरी बताता है और इसकी गणना ऊंचाई मोड के अनुसार की जाती है.

<heightMode>

बताता है कि <height> के बारे में क्या जानकारी दी गई है. वैल्यू

• clampToGround - (डिफ़ॉल्ट) यह बताता है कि ऊंचाई की विशेषताओं को अनदेखा करना है और ओवरले पर ओवरले को कवर करना है.
• निरपेक्ष - ओवरले की ऊंचाई समुद्र तल से जोड़कर तय करता है, एलिमेंट के नीचे के इलाके की वास्तविक ऊंचाई पर ध्यान दिए बिना. उदाहरण के लिए, किसी ओवरले की ऊंचाई 10 मीटर पर सेट करना. हालांकि, इसके नीचे का इलाका 10 मीटर की ऊंचाई पर सेट होना चाहिए. हालांकि, नीचे का इलाका, समुद्र तल से 10 मीटर ऊपर है. अगर इलाका, समुद्र तल से 3 मीटर ऊपर है, तो ऊपर से ओवरले, 7 मीटर की ऊंचाई पर दिखेगा.

<gx:heightMode>

Google एक्सटेंशन नेमस्पेस में KML एक्सटेंशन, जो समुद्र तल से ऊंचाई को अनुमति देता है. वैल्यू ये हैं:

• relativeToSeaFloor - समुद्र तल के ऊपर मीटर में मान के रूप में <height> की व्याख्या करता है. अगर बिंदु समुद्र के बजाय ज़मीन से ऊपर है, तो <ऊंचाई> को ज़मीन से ऊपर होने के तौर पर समझा जाएगा.
• clampToSeaFloor - <ऊंचाई> की खास बातों को अनदेखा कर दिया जाता है और ओवरले को समुद्र के तल पर ले जाया जाएगा. अगर बिंदु समुद्र के बजाय ज़मीन पर है, तो ओवरले ज़मीन पर रखा जाएगा.

<LatLonBox>

यह बताता है कि ग्राउंड ओवरले के लिए बाउंडिंग बॉक्स की ऊपर, नीचे, दाईं, और बाईं ओर कहां अलाइन हैं.

• <north> बाउंडिंग बॉक्स के उत्तरी किनारे का अक्षांश, 0 से ±90 के बीच दशमलव डिग्री में तय करता है.
• <south> बाउंडिंग बॉक्स के दक्षिणी किनारे का अक्षांश, 0 से ±90 के बीच दशमलव डिग्री में तय करता है.
• <east> बाउंडिंग बॉक्स के पूर्वी किनारे का देशांतर बताता है, 0 से ±180 तक दशमलव डिग्री में. (180 डिग्री के देशांतर को ओवरलैप करने वाले ओवरले के लिए, वैल्यू उस सीमा से ज़्यादा भी हो सकती हैं.)
• <west> बाउंडिंग बॉक्स के पश्चिमी किनारे का देशांतर बताता है, 0 से ±180 के बीच दशमलव डिग्री में. (180 डिग्री के देशांतर को ओवरलैप करने वाले ओवरले के लिए, वैल्यू उस सीमा से ज़्यादा भी हो सकती हैं.)
• <rotation> ओवरले के केंद्र के बारे में डिग्री में, घुमाव तय करता है. वैल्यू ±180 हो सकती है. डिफ़ॉल्ट 0 (उत्तर) है. घुमाव घड़ी की उल्टी दिशा दिशा में तय किए जाते हैं.

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

<gx:LatLonQuad>

इसके अलावा, आयताकार चतुर्भुज ग्राउंड ओवरले के लिए इस्तेमाल किया जाता है.

उदाहरण

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

विस्तृत

• <सुविधा>
• <ओवरले>

कॉन्टेंट का मालिक

• <दस्तावेज़>
• <फ़ोल्डर>

<आइकॉन>

सिंटैक्स

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

जानकारी

आइकॉन की स्टाइल या ओवरले से जुड़ी इमेज के बारे में बताती है. ज़रूरी <href> चाइल्ड एलिमेंट, इमेज की वह जगह तय करता है जिसे ओवरले के तौर पर या प्लेसमार्क के आइकॉन के तौर पर इस्तेमाल किया जाना है. यह स्थान या तो स्थानीय फ़ाइल सिस्टम या किसी रिमोट वेब सर्वर पर हो सकता है. <gx:x>, <gx:y>, <gx:w>, और <gx:h> एलिमेंट का इस्तेमाल, किसी ऐसी इमेज से एक आइकॉन को चुनने के लिए किया जाता है जिसमें कई आइकॉन होते हैं. इन्हें अक्सर आइकॉन पैलेट कहा जाता है.

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

खास तौर पर आइकॉन के लिए एलिमेंट

<href>

किसी एचटीटीपी पते या लोकल फ़ाइल की खास बातों से, आइकॉन लोड होता है.

<gx:x>

और

<gx:y>

अगर <href> किसी आइकॉन पैलेट को तय करता है, तो इन एलिमेंट में आइकॉन की पैलेट के निचले बाएं कोने से ऑफ़सेट की पहचान की जाती है.अगर x और y के लिए कोई मान तय नहीं है, तो यह माना जाता है कि आइकॉन पैलेट के निचले बाएं कोने को आइकॉन का सबसे नीचे वाला बायां कोना माना जाता है.

<gx:w>

और

<gx:h>

अगर <href> किसी आइकॉन के पैलेट की जानकारी देता है, तो ये एलिमेंट इस्तेमाल किए जाने वाले आइकॉन की चौड़ाई (<gx:w>) और ऊंचाई (<gx:h>) को पिक्सल में बताते हैं.

<refreshMode>

<रीफ़्रेश मोड> और नीचे दी गई दूसरी चीज़ों की जानकारी के लिए, <लिंक> देखें.

<refreshInterval>

<viewRefreshMode>

<viewRefreshTime>

<viewBoundScale>

<viewFormat>

<httpQuery>

कॉन्टेंट का मालिक

• <GroundOverlay>
• <स्क्रीन ओवरले>
• <IconStyle>

<IconStyle>

सिंटैक्स

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

जानकारी

बताता है कि पॉइंट प्लेसमार्क के लिए आइकॉन कैसे 'जगहें' पैनल और Google Earth के 3D व्यूअर में बनाए जाते हैं. <Icon> एलिमेंट, आइकॉन की इमेज दिखाता है. <Scale> तत्व, आइकन की x, y स्केलिंग बताता है. <IconStyle> के <color> एलिमेंट में दिए गए रंग को <Icon> के रंग से मिला दिया जाता है.

आइकॉन की स्टाइल के लिए खास एलिमेंट

<स्केल>

आइकॉन का साइज़ बदलता है.

ध्यान दें: <geomScale> टैग को रोक दिया गया है. इसके बजाय, <Scale> का इस्तेमाल करें.

<शीर्षक>

दिशा (यानी, उत्तर, दक्षिण, पूर्व, पश्चिम), डिग्री में. डिफ़ॉल्ट=0 (उत्तरी). ( डायग्राम देखें.) वैल्यू की सीमा 0 से 360 डिग्री तक है.

<आइकॉन>

एक कस्टम आइकॉन. <IconStyle> में, <Icon> का इकलौता चाइल्ड एलिमेंट <href> है:

• <href>: कोई एचटीटीपी पता या लोकल फ़ाइल की खास बातें, जो किसी आइकॉन को लोड करने में इस्तेमाल की जाती हैं.

<hotSpot x="0.5" y="0.5" xunits="fraction" yunits="fraction">

यह प्लेसमार्क में बताए गए <Point> के लिए आइकॉन में मौजूद पोज़िशन बताता है. x और y की वैल्यू को तीन अलग-अलग तरीकों से दिखाया जा सकता है: आइकॉन के पिक्सल ("pixels"), आइकॉन ("fraction") के फ़्रेक्शन के तौर पर या इंटसेट पिक्सल ("insetPixels") के तौर पर. यह आइकॉन के ऊपरी दाएं कोने से पिक्सल में ऑफ़सेट होता है. x और y स्थितियों को अलग-अलग तरीकों से तय किया जा सकता है—उदाहरण के लिए, x को पिक्सल में दिखाया जा सकता है और y को कुछ दिखाया जा सकता है. निर्देशांक सिस्टम का शुरुआती बिंदु आइकॉन के निचले बाएं कोने में है.

• x - आइकॉन की संख्या या पिक्सल की संख्या या पिक्सल इनसेट, जो आइकॉन पर किसी पॉइंट के x कॉम्पोनेंट को दिखाता है.
• y - आइकॉन की संख्या या पिक्सल इंसेट या पिक्सल इनसेट, जो आइकॉन पर पॉइंट के y कॉम्पोनेंट को दिखाता है.
• xunits - ऐसी यूनिट जिनमें x वैल्यू की जानकारी दी गई है. fraction की वैल्यू से यह पता चलता है कि x वैल्यू, आइकॉन का एक हिस्सा है. पिक्सल की वैल्यू से पता चलता है कि पिक्सल में x वैल्यू है. insetPixels की वैल्यू, आइकॉन के दाएं किनारे से इंडेंट का संकेत देती है.
• yunits - यूनिट जिनमें y की वैल्यू बताई गई है. fraction की वैल्यू से यह पता चलता है कि y वैल्यू, आइकॉन का एक हिस्सा है. pixel की वैल्यू पिक्सल में y वैल्यू दिखाती है. insetPixels की वैल्यू, आइकॉन के ऊपरी किनारे से इंडेंट का पता लगाती है.

उदाहरण

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

विस्तृत

• <ColorStyle>

कॉन्टेंट का मालिक

• <स्टाइल>

इसमें ये शामिल हैं

• <Icon> के चाइल्ड के रूप में <href>

<KML>

सिंटैक्स

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

जानकारी

KML फ़ाइल का रूट एलिमेंट. यह एलिमेंट ज़रूरी है. यह फ़ाइल की शुरुआत में एक्सएमएल एलान के मुताबिक होती है. संकेत विशेषता का उपयोग Google Earth को सिग्नल के रूप में करने के लिए, फ़ाइल को खगोलीय डेटा के रूप में दिखाया जाता है.

<KML> एलिमेंट में ऐसे बाहरी एक्सएमएल स्कीमा के लिए नेमस्पेस भी शामिल हो सकती है जो फ़ाइल में दिए गए हैं.

एक बेसिक <KML> एलिमेंट में 0 या 1 सुविधा और 0 या 1 NetworkLinkControl मौजूद होता है:

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

<LabelStyle>

सिंटैक्स

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

जानकारी

यह बताता है कि 3D व्यूअर में किसी सुविधा का <name> कैसे बनाया जाता है. लेबल के लिए, पसंद के मुताबिक रंग, कलर मोड, और स्केल के बारे में बताया जा सकता है.

ध्यान दें: <labelColor> टैग को बंद कर दिया गया है. इसके बजाय <LabelStyle> का इस्तेमाल करें.

<LabelStyle> के लिए विशेष

<स्केल>

लेबल का आकार बदलता है.

उदाहरण

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

विस्तृत

• <ColorStyle>

कॉन्टेंट का मालिक

• <स्टाइल>

<gx:LatLonQuad>

यह एलिमेंट, OGC KML 2.2 स्टैंडर्ड का एक्सटेंशन है. इसे Google Earth 5.0 और इसके बाद के वर्शन में इस्तेमाल किया जा सकता है. ज़्यादा जानें

सिंटैक्स

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

जानकारी

गैर-आयताकार चतुर्भुज ग्राउंड ओवरले की अनुमति देता है.

ओवरले क्षेत्र को परिभाषित करने वाले चतुर्भुज के चारों कोने बिंदुओं के निर्देशांक बताता है. सटीक रूप से चार निर्देशांक ट्यूपल दिए जाने हैं, जिनमें से प्रत्येक में देशांतर और अक्षांश के लिए फ़्लोटिंग पॉइंट मान होते हैं. ट्यूल के बीच एक स्पेस डालें. टपल के अंदर स्पेस न डालें. निर्देशांकों को घड़ी की विपरीत दिशा में, ओवरले किए गए चित्र के नीचे-बाएं कोने से संबंधित पहले निर्देशांक के साथ तय करना होगा. इन कोनों के हिसाब से आकार की सजावट खाली होनी चाहिए.

अगर किसी बैंगनी (ऊंचाई को दिखाने वाली) इमेज में कोई तीसरी वैल्यू डाली जाती है, तो उस पर ध्यान नहीं दिया जाएगा. ऊंचाई को <altitude> और <altitudeMode> (या <gx:altitudeMode>) <GroundOverlay> का विस्तार करके सेट किया गया है. ऊंचाई के लिए मान्य मोड, clampToGround, और clampToSeaFloor इस्तेमाल किए जा सकते हैं.

उदाहरण

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

विस्तृत

• <ऑब्जेक्ट>

शामिल है

• <GroundOverlay>

<लीनियर रिंगिंग>

सिंटैक्स

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

जानकारी

बंद लाइन स्ट्रिंग की जानकारी देता है, आम तौर पर पॉलीगॉन की बाहरी सीमा. इसके अलावा, एक LinearRing का इस्तेमाल, पॉलीगॉन में छेद करने के लिए पॉलीगॉन की अंदरूनी सीमा के तौर पर भी किया जा सकता है. पॉलीगॉन में, आंतरिक सीमाओं के रूप में इस्तेमाल किए जाने वाले कई <LinearRing> एलिमेंट शामिल हो सकते हैं.

ध्यान दें: Google Earth में, clampToGround की <heightMode> वाली पॉलीगॉन, लगातार बने रहने वाली लाइनों की लाइन पर काम करती है. हालांकि, clampToGround के <लीनियर मोड> के साथ एक लीनियर रिंग, बढ़िया सर्कल लाइनों को फ़ॉलो करती है.

लीनियर रिंग के खास एलिमेंट

<gx:height Offset>

Google एक्सटेंशन नेमस्पेस में मौजूद KML एक्सटेंशन, ऊंचाई की वैल्यू को रेंडर करने के तरीके में बदलाव करता है. इस ऑफ़सेट से आप LinearRing को बनाने वाले सभी अलग-अलग निर्देशांक मानों को बदले बिना, पूरी LinearRing को एक इकाई के रूप में ऊपर या नीचे ले जा सकते हैं. (उदाहरण के लिए, LinearRing को ऊंचाई के ऑफ़सेट मान का इस्तेमाल करके दिखाया जाता है, लेकिन ऊंचाई के मूल मानों को KML फ़ाइल में सुरक्षित रखा जाता है.) यूनिट मीटर में होते हैं.

<extrude>

बूलियन मान. इस नीति से यह तय होता है कि लीनियर रिंग को ज़मीन से जोड़ना है या नहीं. इस ज्यामिति को निकालने के लिए, ऊंचाई मोड या तो relativeToGround, relactiveToSeaFloor या संपूर्ण होना चाहिए. लीनियर रिंगिंग के ऊपरी हिस्से को निकाला जाता है, ज्यामिति के केंद्र को नहीं. वर्टेक्स को धरती के गोले के केंद्र की ओर निकाला जाता है.

<tessella>

बूलियन मान. इस नीति से यह तय होता है कि लीनियर रिंग को इलाके का पालन करने की अनुमति देनी है या नहीं. टेस्सेल चालू करने के लिए, <heightMode> का मान clampToGround या clampToSeaFloor होना चाहिए. बहुत बड़े LinearRings को टेस्सेलेशन सक्षम करना चाहिए ताकि वे धरती की वक्रता का पालन करें (अन्यथा वे अंडरग्राउंड हो सकते हैं और छिप सकते हैं).

<heightMode>

तय करता है कि <निर्देशांक> एलिमेंट में ऊंचाई कॉम्पोनेंट को कैसे समझा जाता है. वैल्यू

• clampToGround - (डिफ़ॉल्ट) यह बताता है कि ऊंचाई की खास बातों को अनदेखा किया जाए (उदाहरण के लिए, <निर्देशक> टैग में).
• reliveToGround - किसी खास जगह की वास्तविक ऊंचाई के मुकाबले एलिमेंट की ऊंचाई सेट करता है. उदाहरण के लिए, अगर किसी जगह की ज़मीन पर ऊंचाई बिलकुल समुद्र के स्तर पर है और किसी बिंदु के लिए ऊंचाई 9 मीटर पर सेट है, तो पॉइंट प्लेसमार्क की ऊंचाई के आइकॉन की ऊंचाई 9 मीटर होती है. हालांकि, अगर निर्देशांक उस जगह पर सेट है जहां ज़मीन की ऊंचाई समुद्र तल से 10 मीटर ऊपर है, तो निर्देशांक की ऊंचाई 19 मीटर होगी. इस मोड का इस्तेमाल आम तौर पर, टेलीफ़ोन पोल या स्की लिफ़्ट लगाने के लिए किया जाता है.
• संपूर्ण - तत्व के नीचे के भू-भाग की वास्तविक ऊंचाई पर ध्यान दिए बिना, समुद्र स्तर से संबंधित निर्देशांक की ऊंचाई सेट करता है. उदाहरण के लिए, अगर किसी निर्देशांक की ऊंचाई को संपूर्ण ऊंचाई मोड के साथ 10 मीटर पर सेट किया जाता है, तो नीचे की जगह समुद्र तल से 10 मीटर ऊपर है, तो बिंदु प्लेसमार्क का आइकॉन ग्राउंड लेवल पर दिखेगा. अगर इलाका, समुद्र तल से 3 मीटर ऊपर है, तो इलाका, ऊपर की ओर 7 मीटर से ऊंचा दिखता है. इस मोड का इस्तेमाल आम तौर पर, हवाई जहाज़ में रखकर किया जाता है.

<gx:heightMode>

Google एक्सटेंशन नेमस्पेस में KML एक्सटेंशन, जो समुद्र तल से ऊंचाई को अनुमति देता है. वैल्यू ये हैं:

• relativeToSeaFloor - समुद्र तल के ऊपर मीटर में मान के रूप में <height> की व्याख्या करता है. अगर बिंदु समुद्र के बजाय ज़मीन से ऊपर है, तो <ऊंचाई> को ज़मीन से ऊपर होने के तौर पर समझा जाएगा.
• clampToSeaFloor - <ऊंचाई> की खास बातों को अनदेखा कर दिया जाता है और पॉइंट को समुद्र के तल पर लगा दिया जाता है. अगर बिंदु समुद्र के बजाय ज़मीन पर है, तो बिंदु ज़मीन पर लगा दिया जाएगा.

<निर्देशांक>(ज़रूरी)

चार या ज़्यादा ट्यूल, जिनमें देशांतर, Latitude, और ऊंचाई शामिल हैं. ऊंचाई कॉम्पोनेंट ज़रूरी नहीं है. टपल के अंदर स्पेस न डालें. अंतिम निर्देशांक पहले निर्देशांक जैसा ही होना चाहिए. निर्देशांकों को केवल दशमलव डिग्री में दिखाया जाता है.

उदाहरण

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

विस्तृत

• <ज्यामिति>

कॉन्टेंट का मालिक

• <मल्टीजियोमेट्री>
• <प्लेसमार्क>
• <innerBoundaryIs>
• <outerBoundaryIs>

<LineString>

सिंटैक्स

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

जानकारी

इससे कनेक्ट किए गए लाइन सेगमेंट के सेट की जानकारी मिलती है. लाइन का रंग, कलर मोड, और चौड़ाई बताने के लिए <LineStyle> का इस्तेमाल करें. जब किसी Lineस्ट्रिंग को निकाला जाता है, तो लाइन को ज़मीन की ओर बढ़ा दिया जाता है. यह पॉलीगॉन बनती है जो कुछ हद तक दीवार या फ़ेंस की तरह दिखती है. निकाली गई LineStrings के लिए, पंक्ति अपने स्वयं के वर्तमान LineStyle का उपयोग करती है और बाहर निकालने वाला वर्तमान PolyStyle का उपयोग करता है. LineStrings (या पाथ) के उदाहरणों के लिए, KML ट्यूटोरियल देखें.

LineString के लिए विशिष्ट तत्व

<gx:heightoffset>

Google एक्सटेंशन नेमस्पेस में मौजूद KML एक्सटेंशन, ऊंचाई की वैल्यू को रेंडर करने के तरीके में बदलाव करता है. इस ऑफ़सेट की मदद से आप LineString में मौजूद सभी अलग-अलग निर्देशांक वैल्यू को बदले बिना, पूरी LineString को एक इकाई के रूप में ऊपर या नीचे ले जा सकते हैं. (हालांकि, LineString को ऊंचाई ऑफ़सेट मान का इस्तेमाल करके दिखाया जाता है, लेकिन मूल ऊंचाई मानों को KML फ़ाइल में सुरक्षित रखा जाता है. यूनिट मीटर में होते हैं.

<extrude>

बूलियन मान. यह तय करता है कि LineString को ज़मीन से कनेक्ट करे या नहीं. LineString को निकालने के लिए, ऊंचाई मोड relativeToGround, relativeToSeaFloor या absolute होना चाहिए. लाइनस्ट्रिंग के शीर्ष, धरती के गोले के केंद्र की ओर निकाले जाते हैं.

<tessella>

बूलियन मान. इस नीति से तय होता है कि LineString को इलाके को फ़ॉलो करने की अनुमति देनी है या नहीं. टेस्सेल चालू करने के लिए, ऊंचाई मोड clampToGround या clampToSeaFloor होना चाहिए. बहुत बड़े LineStrings को टेस्सेलेशन सक्षम करना चाहिए ताकि वे धरती की वक्रता का पालन करें (अन्यथा वे अंडरग्राउंड हो सकते हैं और छिप सकते हैं).

<heightMode>

तय करता है कि <निर्देशांक> एलिमेंट में ऊंचाई कॉम्पोनेंट को कैसे समझा जाता है. वैल्यू

• clampToGround - (डिफ़ॉल्ट) यह बताता है कि ऊंचाई के स्पेसिफ़िकेशन को अनदेखा करना है (उदाहरण के लिए, <निर्देशक> टैग में).
• reliveToGround - किसी खास जगह की वास्तविक ऊंचाई के मुकाबले एलिमेंट की ऊंचाई सेट करता है. उदाहरण के लिए, अगर किसी जगह की ज़मीन पर ऊंचाई बिलकुल समुद्र के स्तर पर है और किसी बिंदु के लिए ऊंचाई 9 मीटर पर सेट है, तो पॉइंट प्लेसमार्क की ऊंचाई के आइकॉन की ऊंचाई 9 मीटर होती है. हालांकि, अगर निर्देशांक उस जगह पर सेट है जहां ज़मीन की ऊंचाई समुद्र तल से 10 मीटर ऊपर है, तो निर्देशांक की ऊंचाई 19 मीटर होगी. इस मोड का इस्तेमाल आम तौर पर, टेलीफ़ोन पोल या स्की लिफ़्ट लगाने के लिए किया जाता है.
• संपूर्ण - तत्व के नीचे के भू-भाग की वास्तविक ऊंचाई पर ध्यान दिए बिना, समुद्र स्तर से संबंधित निर्देशांक की ऊंचाई सेट करता है. उदाहरण के लिए, अगर किसी निर्देशांक की ऊंचाई को संपूर्ण ऊंचाई मोड के साथ 10 मीटर पर सेट किया जाता है, तो नीचे की जगह समुद्र तल से 10 मीटर ऊपर है, तो बिंदु प्लेसमार्क का आइकॉन ग्राउंड लेवल पर दिखेगा. अगर इलाका, समुद्र तल से 3 मीटर ऊपर है, तो इलाका, ऊपर की ओर 7 मीटर से ऊंचा दिखता है. इस मोड का इस्तेमाल आम तौर पर, हवाई जहाज़ में रखकर किया जाता है.

<gx:heightMode>

Google एक्सटेंशन नेमस्पेस में KML एक्सटेंशन, जो समुद्र तल से ऊंचाई को अनुमति देता है. वैल्यू ये हैं:

• relativeToSeaFloor - समुद्र तल के ऊपर मीटर में मान के रूप में <height> की व्याख्या करता है. अगर बिंदु समुद्र के बजाय ज़मीन से ऊपर है, तो <ऊंचाई> को ज़मीन से ऊपर होने के तौर पर समझा जाएगा.
• clampToSeaFloor - <ऊंचाई> की खास बातों को अनदेखा कर दिया जाता है और पॉइंट को समुद्र के तल पर लगा दिया जाता है. अगर बिंदु समुद्र के बजाय ज़मीन पर है, तो बिंदु ज़मीन पर लगा दिया जाएगा.

<gx:drawOrder>

एक पूर्णांक वैल्यू, जो एक से ज़्यादा लाइन स्ट्रिंग को खींचने के क्रम को तय करती है. LineStrings को पहले ड्रॉ किया गया LineStrings बाद में कोई ड्रॉ के क्रम में आंशिक या पूरी तरह से धुंधला हो सकता है. जब दो-रंग वाली लाइनें एक-दूसरे को पार करती हैं, तब इस एलिमेंट को <gx:outerColor> और <gx:outerWidth> एलिमेंट के साथ जोड़ना ज़रूरी हो सकता है.

<निर्देशांक>(ज़रूरी)

दो या ज़्यादा निर्देशांक ट्यूपल हैं, जिनमें से हर में देशांतर, अक्षांश, और ऊंचाई के लिए फ़्लोटिंग पॉइंट मान हैं. ऊंचाई कॉम्पोनेंट ज़रूरी नहीं है. ट्यूल के बीच एक स्पेस डालें. टपल के अंदर स्पेस न डालें.

उदाहरण

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

विस्तृत

• <ज्यामिति>

कॉन्टेंट का मालिक

• <मल्टीजियोमेट्री>
• <प्लेसमार्क>

<LineStyle>

सिंटैक्स

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

जानकारी

सभी लाइन ज्यामिति के लिए ड्रॉइंग शैली (रंग, रंग मोड, और लाइन चौड़ाई) तय करता है. रेखा की ज्यामिति में आउटलाइन किए गए पॉलीगॉन की आउटलाइन और निकाले गए प्लेसमार्क आइकॉन का "टेदर" शामिल है (अगर बाहर निकाला गया विकल्प चालू है).

LineStyle के लिए खास एलिमेंट

<चौड़ाई>

लाइन की चौड़ाई, पिक्सल में.

<gx:outerColor>

<gx:outerWidth> के ज़रिए तय की गई लाइन के हिस्से का रंग. ध्यान रखें कि <LineStyle> को <Color> और <LinearRing> पर लागू करने पर, <gx:outerColor> और <gx:outerWidth> के एलिमेंट को अनदेखा कर दिया जाता है.

<gx:outerWidth>

0.0 और 1.0 के बीच का कोई मान, जो <gx:outerColor> का इस्तेमाल करने वाली लाइन का अनुपात बताता है. सिर्फ़ <gx:physicalWidth> वाली चौड़ाई सेटिंग पर लागू होता है; यह <width> इस्तेमाल करने वाली लाइनों पर लागू नहीं होता है. <LineString> में <gx:drawOrder> भी देखें. अगर दो-रंग की लाइनें एक-दूसरे को क्रॉस कर रही हैं, तो ड्रॉ के ऑर्डर की वैल्यू ज़रूरी हो सकती है. उदाहरण के लिए, फ़्रीवे इंटरचेंज दिखाने के लिए.

<gx:materialWidth>

मीटर में चौड़ाई.

<gx:labelVisibility>

बूलियन यह तय करता है कि LineString पर टेक्स्ट लेबल दिखाया जाए या नहीं. LineString का लेबल, <name> एलिमेंट में शामिल होता है जो <LineString> के भाई-बहन हैं (उदाहरण के लिए, <Placemark> एलिमेंट में मौजूद).

Google Earth का 6.1+ वर्शन, लेबल को डिफ़ॉल्ट रूप से नहीं दिखाता है. इन्हें हर LineString के लिए <gx:labelVisibility> को 1 पर सेट करके चालू किया जाना चाहिए.

Google Earth 6.1 पहले से मालूम समस्या: <gx:physicalWidth> एलिमेंट के बिना LineStrings तब ही लेबल दिखाएगा, जब लाइन की लंबाई 100 मीटर * से ज़्यादा हो. उदाहरण के लिए, सात वर्णों वाला लेबल ("example") सिर्फ़ तब दिखेगा, जब लाइन 700 मीटर से ज़्यादा लंबी होगी. इससे <gx:physicalWidth> वैल्यू वाले LineStrings पर कोई असर नहीं पड़ता.

उदाहरण

नीचे दिए गए उदाहरण में 4 पिक्सल की चौड़ाई के साथ 50 प्रतिशत अपारदर्शी लाल लाइन दिखाई गई है.

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

विस्तृत

• <ColorStyle>

कॉन्टेंट का मालिक

• <स्टाइल>

<लिंक>

सिंटैक्स

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

जानकारी

<Link> इनमें से किसी एक की जगह के बारे में बताता है:

• नेटवर्क फ़ाइलों से फ़ेच की गई KML फ़ाइलें
• किसी भी ओवरले में इस्तेमाल की गई इमेज फ़ाइलें (<Icon> एलिमेंट, ओवरले में इमेज के बारे में बताता है; <Icon> के फ़ील्ड <लिंक> की तरह होते हैं)
• <Model> एलिमेंट में इस्तेमाल की गई मॉडल फ़ाइलें

यहां दिए गए रीफ़्रेश पैरामीटर के आधार पर, फ़ाइल को शर्तों के साथ लोड और रीफ़्रेश किया जाता है. रीफ़्रेश पैरामीटर के दो अलग-अलग सेट तय किए जा सकते हैं: एक सेट समय (<रीफ़्रेश मोड> और <रीफ़्रेश इंटरवल>) पर आधारित होता है और दूसरा सेट मौजूदा "कैमरा" व्यू (<view केवल रीफ़्रेश> और <viewरीफ़्रेश समय> पर आधारित होता है. इसके अलावा, लिंक को सर्वर पर <b लक्ष्य स्केल> लागू करने वाली भेजने की स्ट्रिंग का विकल्प उपलब्ध कराने वाले होते हैं.

जब कोई फ़ाइल फ़ेच की जाती है, तो सर्वर को भेजे जाने वाले यूआरएल में तीन तरह की जानकारी शामिल होती है:

• href (हाइपरटेक्स्ट रेफ़रंस) से, लोड होने वाली फ़ाइल के बारे में पता चलता है.
• आर्बिट्ररी फ़ॉर्मैट स्ट्रिंग जो (a) पैरामीटर से बनाई गई है (a) ऐसे पैरामीटर जिन्हें आपने <viewFormat> एलिमेंट में डाला है या (b) बाउंडिंग बॉक्स पैरामीटर (यह डिफ़ॉल्ट है और फ़ाइल में कोई <viewFormat> एलिमेंट शामिल नहीं होने पर इस्तेमाल किया जाता है).
• दूसरी फ़ॉर्मैट स्ट्रिंग है, जो <httpQuery> एलिमेंट में दी गई है.

अगर <href> में बताई गई फ़ाइल, लोकल फ़ाइल है, तो <viewFormat> और <httpQuery> एलिमेंट का इस्तेमाल नहीं किया जाता.

<Link> एलिमेंट, पहले के KML रिलीज़ में मौजूद <NetworkLink> के <Url> एलिमेंट की जगह ले लेता है और <region> में मौजूद फ़ंक्शन जोड़ता है (यह KML 2.1 में उपलब्ध है). Google Earth के 3.0 और इससे पहले के वर्शन में, <Link> एलिमेंट को अनदेखा किया जाता है.

लिंक के लिए खास एलिमेंट

<href>

यूआरएल (एचटीटीपी पता या स्थानीय फ़ाइल की खास बातें). <Link> के पैरंट के पास NetworkLink है, तो <href> KML फ़ाइल है. जब <Link> का पैरंट कोई मॉडल होता है, तो <href> कोई मापदंड फ़ाइल होती है. जब <Icon> के पैरंट (<Link> के जैसे फ़ील्ड) ओवरले होते हैं, तो <href> इमेज होती है. इस टैग में रिलेटिव यूआरएल का इस्तेमाल किया जा सकता है और उनका आकलन, एनएमएल फ़ाइल के हिसाब से किया जा सकता है. KML और KML फ़ाइलों में मिलते-जुलते संदर्भ बनाने के बारे में जानने के लिए, KMZ फ़ाइलें देखें.

<रीफ़्रेश मोड>

समय के हिसाब से रीफ़्रेश मोड के बारे में बताता है. यह इनमें से कोई एक हो सकता है:

• onChange - जब फ़ाइल लोड हो और जब लिंक पैरामीटर (डिफ़ॉल्ट) बदल जाए, तब रीफ़्रेश करें.
• onInterval - हर n सेकंड में रीफ़्रेश करें (<रीफ़्रेशInterval> में बताया गया है).
• onexpire - फ़ाइल की समयसीमा खत्म होने पर उसे रीफ़्रेश करें. अगर फ़ेच की गई फ़ाइल में कोई NetworkLinkControl है, तो <expires> समय को एचटीटीपी हेडर में बताए गए समय खत्म होने के समय से पहले दिखाया जाता है. अगर कोई <expires> समय नहीं बताया गया है, तो एचटीटीपी ज़्यादा से ज़्यादा उम्र हेडर का इस्तेमाल किया जाता है (अगर मौजूद हो). अगर ज़्यादा से ज़्यादा उम्र मौजूद नहीं है, तो खत्म होने की तारीख एचटीटीपी हेडर का इस्तेमाल किया जाता है (अगर मौजूद हो). (एचटीटीपी हेडर फ़ील्ड के बारे में जानकारी के लिए, हाइपरटेक्स्ट ट्रांसफ़र प्रोटोकॉल - एचटीटीपी 1.1 का सेक्शन RFC261b देखें.)

< दर्शकों को रीफ़्रेश करें>

हर n सेकंड में फ़ाइल को रीफ़्रेश करने का संकेत देता है.

<viewरीफ़्रेशमोड>

तय करें कि "कैमरा" बदलने पर, लिंक कैसे रीफ़्रेश होता है.

इनमें से कोई एक हो सकता है:

• कभी नहीं (डिफ़ॉल्ट) - व्यू में हुए बदलावों को अनदेखा करें. अगर कोई है, तो <viewFormat> पैरामीटर को भी अनदेखा करें.
• onStop - हलचल बंद होने के n सेकंड बाद फ़ाइल रीफ़्रेश करें, जहां <viewरीफ़्रेश समय> में n बताया गया है.
• onRequest - फ़ाइल को सिर्फ़ तब रीफ़्रेश करें, जब उपयोगकर्ता उसे साफ़ तौर पर ऐक्सेस करने का अनुरोध करे. उदाहरण के लिए, Google Earth में उपयोगकर्ता दायां क्लिक करता है और संदर्भ मेन्यू में 'रीफ़्रेश करें' चुनता है.
• onregion - 'क्षेत्र' के चालू होने पर फ़ाइल रीफ़्रेश करें. <region> में शामिल हों.

<viewरीफ़्रेश समय>

कैमरे की हलचल बंद होने पर, व्यू रीफ़्रेश करने से पहले सेकंड की संख्या तय करें. (ऊपर <viewरीफ़्रेशMode> और onStop देखें.)

<viewBoundScale>

BBOX पैरामीटर को सर्वर पर भेजने से पहले उन्हें स्केल करता है. एक से कम वैल्यू तय होती है कि फ़ुल व्यू (स्क्रीन) से कम इस्तेमाल किया जाए. वैल्यू की वैल्यू 1 से ज़्यादा होने पर, मौजूदा व्यू के किनारों से ज़्यादा एरिया को फ़ेच करना होता है.

<viewformat>

फ़ाइल के फ़ेच होने से पहले लिंक की <href> में जोड़ी गई क्वेरी स्ट्रिंग का फ़ॉर्मैट तय करता है.(अगर <href> कोई लोकल फ़ाइल बताता है, तो इस एलिमेंट को अनदेखा कर दिया जाता है.)

अगर onStop का कोई <viewरीफ़्रेशMode> बताया जाता है और फ़ाइल में <viewFormat> टैग शामिल नहीं किया जाता है, तो नीचे दी गई जानकारी अपने-आप क्वेरी स्ट्रिंग में जुड़ जाती है:

BBOX=[bboxWest],[bboxSouth],[bboxEast],[bboxउत्तरी]

यह जानकारी, वेब मैप सर्विस (WMS) के बाउंडिंग बॉक्स की जानकारी से मेल खाती है.

अगर आप खाली <viewFormat> टैग के बारे में बताते हैं, तो क्वेरी स्ट्रिंग में कोई जानकारी नहीं जोड़ी जाती है.

क्वेरी स्ट्रिंग में जोड़ने के लिए, वीडियो देखने के पैरामीटर का कस्टम सेट भी तय किया जा सकता है. अगर आप फ़ॉर्मैट स्ट्रिंग उपलब्ध कराते हैं, तो BBOX जानकारी के बजाय इसका इस्तेमाल किया जाता है. अगर आपको BBOX की जानकारी भी चाहिए, तो आपको कस्टम पैरामीटर के साथ-साथ उन पैरामीटर को भी जोड़ना होगा.

फ़ॉर्मैट स्ट्रिंग में, इनमें से किसी भी पैरामीटर का इस्तेमाल किया जा सकता है. साथ ही, क्वेरी स्ट्रिंग बनाते समय, Google Earth सही वैल्यू को बदल देगा:

• [lookatLon], [lookatLat] - जिस बिंदु को <LookAt> देख रहा है उसका देशांतर और अक्षांश
• [lookatRange], [lookattil], [lookatheading] - <LookAt> एलिमेंट का इस्तेमाल की गई वैल्यू, <LookAt> में <range>, <tilt>, और <heading> की जानकारी देखें
• [lookat खूबसूरतLon], [lookatTerritoryLat], [lookatइलाकाAlt] - डिग्री/मीटर में उस इलाके की तरफ़ पॉइंट करें, जिसे <LookAt> देख रहा है
• [cameraLon], [cameraLat], [cameraAlt] - कैमरे के लिए आई-पॉइंट की डिग्री/मीटर
• [horizFov], [verFov] - कैमरे के लिए हॉरिज़ॉन्टल, वर्टिकल फ़ील्ड ऑफ़ व्यू (कैमरे से दिख रहा फ़ील्ड)
• [horizPixels], [verPixels] - 3D व्यूअर के पिक्सल में साइज़
• [terrainEnabled] - बताता है कि 3D व्यूअर इलाका दिखा रहा है या नहीं

<httpQuery>

बताए गए पैरामीटर के आधार पर, क्वेरी स्ट्रिंग में जानकारी जोड़ता है. (Google Earth, क्वेरी स्ट्रिंग बनाते समय सही मौजूदा वैल्यू को बदलता है.) ये पैरामीटर काम करते हैं:

• [clientVersion]
• [KMLVersion]
• [clientName]
• [भाषा]

उदाहरण

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

विस्तृत

• <ऑब्जेक्ट>

कॉन्टेंट का मालिक

• <मॉडल>
• <NetworkLink>

यह भी देखें

• <NetworkLinkControl>
• <क्षेत्र>

<ListStyle>

सिंटैक्स

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

जानकारी

इससे पता चलता है कि सूची के व्यू में कोई सुविधा कैसे दिखाई जाती है. सूची की तरह देखें कंटेनर और बच्चों का क्रम होता है; Google Earth में, यह 'जगहें' पैनल है.

ListStyle के लिए खास एलिमेंट

<listItemType>

तय करता है कि सूची के हिसाब से सुविधा कैसे दिखेगी. ये वैल्यू हो सकती हैं:

• check (डिफ़ॉल्ट) - सुविधा के दिखने की सुविधा, उसके आइटम के चेकबॉक्स से जुड़ी होती है.
• रेडियोफ़ोल्डर - कंटेनर के लिए तय किए जाने पर, एक बार में कंटेनर का सिर्फ़ एक आइटम दिखाई देता है
• checkOfOnly - कंटेनर या नेटवर्क लिंक के लिए तय किए जाने पर, सभी आइटम को एक साथ दिखने से रोकता है—इसका मतलब है कि उपयोगकर्ता कंटेनर या नेटवर्क लिंक में मौजूद सभी सामानों को बंद कर सकते हैं, लेकिन एक ही समय पर सब कुछ चालू नहीं कर सकते. यह सेटिंग कंटेनर या नेटवर्क लिंक के लिए बहुत ज़्यादा डेटा वाली होती है.
• checkhidechildren - 'देखें' के लिए सामान्य चेकबॉक्स का इस्तेमाल करें, लेकिन कंटेनर या नेटवर्क लिंक के 'सूची' व्यू में बच्चे नहीं दिखाएं. चेकबॉक्स से उपयोगकर्ता को यह कंट्रोल करने की सुविधा मिलती है कि वह आइटम में मौजूद चाइल्ड ऑब्जेक्ट को देख पाए.

<bgरंग>

स्निपेट का बैकग्राउंड रंग. रंग और अपारदर्शिता के मानों को हेक्साडेसिमल नोटेशन में दिखाया जाता है. किसी भी एक रंग के लिए मानों की श्रेणी 0 से 255 (00 से ff) होती है. ऐल्फ़ा के लिए, 00 पूरी तरह से पारदर्शी है और ff पूरी तरह से अपारदर्शी है. एक्सप्रेशन का क्रम abggrr है, जहां aa=alpha (00 से ff); bb=blue (00 से ff); gg=green (00 to ff); rr=red (00 से ff) है. उदाहरण के लिए, अगर आपको किसी ओवरले पर 50 प्रतिशत पारदर्शिता के साथ नीला रंग लागू करना है, तो आप यह जानकारी देंगे: ऐल्फ़ा=0x7f, नीला=0xff, हरा=0x00, और लाल=0x00.

<आइटम आइकॉन>

लिस्ट व्यू में इस्तेमाल किया गया आइकॉन, जो फ़ोल्डर या लिंक फ़ेच करने की स्थिति बताता है. खोलें और बंद मोड से जुड़े आइकॉन, फ़ोल्डर और नेटवर्क लिंक के लिए इस्तेमाल किए जाते हैं. गड़बड़ी और fetching0, fetching1, और fetching2 मोड से जुड़े आइकॉन, नेटवर्क लिंक के लिए इस्तेमाल किए जाते हैं. नीचे दिया गया स्क्रीन कैप्चर इन स्थितियों के लिए Google Earth के आइकॉन दिखाता है:

<राज्य>

NetworkLink या फ़ोल्डर की मौजूदा स्थिति के बारे में बताता है. संभावित मान open, Closed, error, fetching0, fetching1, और fetching2 हैं. दो वैल्यू के बीच स्पेस डालकर, इन वैल्यू को जोड़ा जा सकता है (कॉमा नहीं).

<href>

इस सुविधा के लिए, 'सूची की तरह देखें' सुविधा में इस्तेमाल की गई इमेज का यूआरआई बताता है.

उदाहरण

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

विस्तृत

• <ऑब्जेक्ट>

कॉन्टेंट का मालिक

• <स्टाइल>

<LookAt>

सिंटैक्स

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

जानकारी

एक वर्चुअल कैमरा बताता है, जो फ़ीचर से मिले किसी भी एलिमेंट से जुड़ा होता है. LookAt एलिमेंट, देखे जा रहे ऑब्जेक्ट के आधार पर "कैमरा" की जगह तय करता है. Google Earth में, यह व्यू इस व्यूपॉइंट पर "उड़ता है". ऐसा तब होता है, जब उपयोगकर्ता 'जगहें' पैनल में किसी आइटम पर दो बार क्लिक करता है या 3D व्यूअर में आइकॉन पर दो बार क्लिक करता है.

LookAt खास आइटम

<देशांतर>

कैमरे में दिख रहा पॉइंट का देशांतर. प्राइम मेरिडियन के मुकाबले, डिग्री में ऐंगुलर दूरी. मेरिडियन के पश्चिमी इलाकों की वैल्यू -180 से 0 डिग्री के बीच है. मेरीडियन के पूर्व में 0 से 180 डिग्री के बीच श्रेणी हैं.

<अक्षांश>

कैमरे के ज़रिए जिस बिंदु को देखा जा रहा है उसका अक्षांश. भूमध्य रेखा के उत्तर या दक्षिण में डिग्री. वैल्यू -90 डिग्री से लेकर 90 डिग्री तक होती हैं.

<ऊंचाई>

पृथ्वी की सतह से दूरी, मीटर में. LookAt के ऊंचाई मोड के हिसाब से मतलब का मतलब.

<शीर्षक>

दिशा (यानी, उत्तर, दक्षिण, पूर्व, पश्चिम), डिग्री में. डिफ़ॉल्ट=0 (उत्तरी). (नीचे दिया गया डायग्राम देखें.) वैल्यू की सीमा 0 से 360 डिग्री तक है.

<टिल्ट>

LookAt की स्थिति और सामान्य की दिशा के बीच कोण. (नीचे दिया गया डायग्राम देखें.) वैल्यू की सीमा 0 से 90 डिग्री है. <tilt> की वैल्यू नेगेटिव नहीं हो सकतीं. 0 डिग्री का एक मान, सीधे ऊपर से देखने का संकेत देता है. 90 डिग्री का टिल्ट> मान क्षितिज के साथ देखने का संकेत देता है.

<range>(ज़रूरी)

<देशांतर>, <अक्षांश>, और <ऊंचाई> से तय की गई दूरी को LookAt पोज़िशन से मीटर में दूरी. (नीचे दिया गया डायग्राम देखें.)

<heightMode>

यह बताता है कि LookAt पॉइंट के लिए तय <height> का क्या मतलब होता है. ये वैल्यू हो सकती हैं:

• clampToGround - (डिफ़ॉल्ट) यह दिखाता है कि <ऊंचाई> स्पेसिफ़िकेशन को अनदेखा करना है और LookAt पोज़िशन को ज़मीन पर रखना है.
• relativeToGround - <ऊंचाई> को ज़मीन से ऊपर के मीटर में मान के रूप में देखता है.
• संपूर्ण - <ऊंचाई> को समुद्र तल से मीटर में मान के रूप में देखता है.

<gx:heightMode>

Google एक्सटेंशन नेमस्पेस में KML एक्सटेंशन, जो समुद्र तल से ऊंचाई को अनुमति देता है. वैल्यू ये हैं:

• relativeToSeaFloor - समुद्र तल के ऊपर मीटर में मान के रूप में <height> की व्याख्या करता है. अगर बिंदु समुद्र के बजाय ज़मीन से ऊपर है, तो <ऊंचाई> को ज़मीन से ऊपर होने के तौर पर समझा जाएगा.
• clampToSeaFloor - <ऊंचाई> की खास बातों को अनदेखा कर दिया जाता है और LookAt को समुद्र के तल पर रखा जाता है. अगर बिंदु समुद्र के बजाय ज़मीन पर है, तो LookAt ज़मीन पर रखा जाएगा.

यह डायग्राम <range>, <tilt>, और <height> एलिमेंट को दिखाता है:

 

यह डायग्राम <heading> एलिमेंट दिखाता है:

 

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

विस्तृत

• <AbstractView>

कॉन्टेंट का मालिक

• <Feature> से मिला कोई भी एलिमेंट
• <NetworkLinkControl>

<मॉडल>

सिंटैक्स

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

जानकारी

सुधारी गई फ़ाइल में बताया गया 3D ऑब्जेक्ट (<Link> टैग में बताया गया है). CSV फ़ाइल में .dae फ़ाइल एक्सटेंशन होता है. मॉडल अपने खुद के निर्देशांक स्पेस में बनाए जाते हैं और फिर Google Earth में उन्हें रखा जाता है, तैनात किया जाता है, और स्केल किया जाता है. ज़्यादा जानकारी के लिए, मॉडल के "KML पर विषय" पेज देखें.

Google Earth, LINKसामान्य प्रोफ़ाइल के साथ काम करता है. इसमें ये अपवाद शामिल हैं:

• Google Earth शुरुआती तरह के सिर्फ़ त्रिभुजों और लाइनों की सुविधा देता है. ज़्यादा से ज़्यादा 21845 त्रिभुजों की अनुमति है.
• Google Earth ऐनिमेशन या स्किनिंग का समर्थन नहीं करता.
• Google Earth बाहरी ज्यामिति संदर्भ का समर्थन नहीं करता है.

खास तौर पर मॉडल के लिए एलिमेंट

<heightMode>

यह बताता है कि <Location> में <height> के बारे में कैसे बताया गया है. ये वैल्यू हो सकती हैं:

• clampToGround - (डिफ़ॉल्ट) यह दिखाता है कि <ऊंचाई> स्पेसिफ़िकेशन को अनदेखा करना है और मॉडल को ज़मीन पर रखना है.
• relativeToGround - <ऊंचाई> को ज़मीन से ऊपर के मीटर में मान के रूप में देखता है.
• संपूर्ण - <ऊंचाई> को समुद्र तल से मीटर में मान के रूप में देखता है.

<gx:heightMode>

Google एक्सटेंशन नेमस्पेस में KML एक्सटेंशन, जो समुद्र तल से ऊंचाई को अनुमति देता है. वैल्यू ये हैं:

• relativeToSeaFloor - समुद्र तल के ऊपर मीटर में मान के रूप में <height> की व्याख्या करता है. अगर बिंदु समुद्र के बजाय ज़मीन से ऊपर है, तो <ऊंचाई> को ज़मीन से ऊपर होने के तौर पर समझा जाएगा.
• clampToSeaFloor - <height> की खास जानकारी को अनदेखा कर दिया जाता है और मॉडल को समुद्र के तल पर रखा जाएगा. अगर बिंदु समुद्र के बजाय ज़मीन पर है, तो मॉडल ज़मीन पर रखा जाएगा.

<जगह>

अक्षांश, देशांतर और ऊंचाई में मॉडल की शुरुआत की जगह के सटीक निर्देशांक तय करता है. अक्षांश और देशांतर मेज़रमेंट WGS84 डाटुम के साथ स्टैंडर्ड अक्षांश-देशांतर प्रोजेक्शन हैं. ऊंचाई, पृथ्वी की सतह से मीटर में दूरी है और इसकी गिनती <heightMode> या <gx:heightMode> के हिसाब से की जाती है.

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

<ओरिएंटेशन>

Google Earth में ऑब्जेक्ट की स्थिति पता करने के लिए, 3D मॉडल के निर्देशांक सिस्टम के घुमाव का विवरण देता है. यहां डायग्राम देखें.

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

किसी मॉडल पर घुमाव इस क्रम में लागू किए जाते हैं:

1. <रोल>
2. <टिल्ट>
3. <शीर्षक>

<शीर्षक>

z ऐक्सिस के बारे में घुमाव (पृथ्वी की सतह के लिए सामान्य). 0 की वैल्यू (डिफ़ॉल्ट) उत्तर के बराबर होती है. पॉज़िटिव घुमाव घड़ी की दिशा में z अक्ष के आस-पास है और डिग्री में 0 से 360 तक बताया गया है.

<टिल्ट>

x ऐक्सिस के बारे में घुमाव. पॉज़िटिव रोटेशन घड़ी की दिशा में x ऐक्सिस पर होता है और उसे 0 से 180 के बीच डिग्री में रखा जाता है.

<रोल>

y ऐक्सिस के बारे में घुमाव. पॉज़िटिव घुमाव, जिसे घड़ी की दिशा में y ऐक्सिस पर घुमाया जाता है और जिसे 0 से 180 के बीच डिग्री में रखा जाता है.

इस डायग्राम में मॉडल के ऐक्सिस पर ओरिएंटेशन की जानकारी दी गई है:

<स्केल>

मॉडल के निर्देशांक के स्पेस में, x, y, और z ऐक्सिस के साथ मॉडल को स्केल करता है.

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

<लिंक>

फ़ाइल लोड करने और रीफ़्रेश पैरामीटर की जानकारी देता है. <Link> देखें.

<ResourceMap>

0 या उससे ज़्यादा <Alias> एलिमेंट के बारे में बताता है, जिनमें से हर एक मूल कोलाडा फ़ाइल से KML या KMZ फ़ाइल में बनावट वाले फ़ाइल पाथ के लिए मैपिंग होता है जिसमें मॉडल होता है. इस एलिमेंट से ओरिजनल फ़ाइलों को अपडेट किए बिना, टेक्सचर फ़ाइलों को दूसरी जगह ले जाया जा सकता है और उनका नाम बदला जा सकता है. एक <ResourceMap> एलिमेंट में, अलग-अलग (सोर्स) कोलाडा फ़ाइलों से एक ही टारगेट फ़ाइल में, एक से ज़्यादा मैपिंग हो सकती हैं.

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

<Alias> में <sourceHref> से <targetHref> तक की मैपिंग शामिल है:

<targetHref>

Google Earth में फ़ेच की जाने वाली टेक्सचर फ़ाइल के बारे में बताता है. यह पहचान .KMZ संग्रह में शामिल किसी इमेज फ़ाइल से मिलती-जुलती पहचान के रूप में हो सकती है. इसके अलावा, यह फ़ाइल (उदाहरण के लिए, यूआरएल) का निरपेक्ष संदर्भ भी हो सकता है.

<स्रोतHref>

कोलाडा .dae फ़ाइल में टेक्सचर फ़ाइल के लिए दिया गया पाथ होता है.

Google Earth में, अगर मैपिंग नहीं की जाती है, तो कोलाडा (.dae) फ़ाइल में टेक्सचरों का पता लगाने के लिए इन नियमों का इस्तेमाल किया जाता है:

• कोई पाथ नहीं: अगर टेक्सचर के नाम में कोई पाथ शामिल नहीं है, तो Google Earth उसी डायरेक्ट्री में टेक्सचर को खोजता है जो .dae फ़ाइल का रेफ़रंस देता है.
• रिलेटिव पाथ: अगर बनावट के नाम में रिलेटिव पाथ शामिल हो (उदाहरण के लिए, ../images/mytexture.jpg), तो Google Earth इस पाथ को .dae फ़ाइल के हिसाब से समझता है.
• निरपेक्ष पाथ: अगर बनावट का नाम एक निरपेक्ष पाथ (c:\mytexture.jpg) या कोई नेटवर्क पाथ (उदाहरण के लिए, http://myserver.com/mytexture.jpg) है, तो Google Earth फ़ाइल को किसी खास जगह पर खोजता है, चाहे .dae फ़ाइल कहीं भी मौजूद हो.

उदाहरण

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

विस्तृत

• <Geometry>

कॉन्टेंट का मालिक

• <मल्टीजियोमेट्री>
• <प्लेसमार्क>

<मल्टीजियोमेट्री>

सिंटैक्स

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

जानकारी

एक ही सुविधा से जुड़े, ज़ीरो या उससे ज़्यादा प्रिमिटिव जानकारी वाला कंटेनर.

ध्यान दें: <GeometryCollection> टैग अब काम नहीं करता. इसके बजाय, <MultiGeometry> का इस्तेमाल करें.

मल्टी ज्यॉमेट्री के लिए खास एलिमेंट

• 0 या ज़्यादा <Geometry> एलिमेंट

उदाहरण

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

विस्तृत

• <Geometry>

कॉन्टेंट का मालिक

• <मल्टीजियोमेट्री>
• <प्लेसमार्क>

<gx:मल्टीट्रैक>

यह एलिमेंट, OGC KML 2.2 स्टैंडर्ड का एक्सटेंशन है. यह Google Earth 5.2 और इसके बाद के वर्शन में काम करता है. ज़्यादा जानें

सिंटैक्स

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

जानकारी

मल्टी-ट्रैक एलिमेंट का इस्तेमाल कई ट्रैकिंग एलिमेंट को एक कॉन्सेप्ट यूनिट में जोड़ने के लिए किया जाता है. उदाहरण के लिए, मान लें कि आपको किसी दिन की बाइक राइड के लिए जीपीएस डेटा इकट्ठा करना है, जिसमें कई आराम की जगहों और दोपहर के खाने के लिए एक स्टॉप शामिल है. बीच में हुई रुकावट की वजह से, समय और पोज़िशन प्लॉट किए जाने पर, साइकल चलाने की एक सुविधा चार अलग-अलग ट्रैक के तौर पर दिख सकती है. इन <gx:Track> एलिमेंट को एक <gx:MultiTrack> कंटेनर में ग्रुप करने से, ये Google Earth में एक पाथ के सेक्शन के रूप में दिखते हैं. जब आइकॉन एक सेगमेंट के आखिर में पहुंच जाता है, तब यह अगले सेगमेंट की शुरुआत में चला जाता है. <gx:interpolate> एलिमेंट से पता चलता है कि किसी एक ट्रैक के आखिर में रुकना है और अगले ट्रैक की शुरुआत में तुरंत जाना है. इसके अलावा, दो ट्रैक के बीच जो वैल्यू मौजूद नहीं है उसे इंटरपोलेट किया जा सकता है.

gx:मल्टीट्रैक के लिए खास एलिमेंट

<heightMode>

तय करता है कि <निर्देशांक> एलिमेंट में ऊंचाई कॉम्पोनेंट को कैसे समझा जाता है. वैल्यू

• clampToGround - (डिफ़ॉल्ट) यह बताता है कि ऊंचाई से जुड़ी खास बातों को अनदेखा करना है (उदाहरण के लिए, <gx:coord> एलिमेंट में).
• reliveToGround - किसी खास जगह की वास्तविक ऊंचाई के मुकाबले एलिमेंट की ऊंचाई सेट करता है. उदाहरण के लिए, अगर किसी जगह की ज़मीन पर ऊंचाई बिलकुल समुद्र के स्तर पर है और किसी बिंदु के लिए ऊंचाई 9 मीटर पर सेट है, तो पॉइंट प्लेसमार्क की ऊंचाई के आइकॉन की ऊंचाई 9 मीटर होती है. हालांकि, अगर निर्देशांक उस जगह पर सेट है जहां ज़मीन की ऊंचाई समुद्र तल से 10 मीटर ऊपर है, तो निर्देशांक की ऊंचाई 19 मीटर होगी.
• संपूर्ण - तत्व के नीचे के भू-भाग की वास्तविक ऊंचाई पर ध्यान दिए बिना, समुद्र स्तर से संबंधित निर्देशांक की ऊंचाई सेट करता है. उदाहरण के लिए, अगर किसी निर्देशांक की ऊंचाई को संपूर्ण ऊंचाई मोड के साथ 10 मीटर पर सेट किया जाता है, तो नीचे की जगह समुद्र तल से 10 मीटर ऊपर है, तो बिंदु प्लेसमार्क का आइकॉन ग्राउंड लेवल पर दिखेगा. अगर इलाका, समुद्र तल से 3 मीटर ऊपर है, तो इलाका, ऊपर की ओर 7 मीटर से ऊंचा दिखता है.

<gx:heightMode>

Google एक्सटेंशन नेमस्पेस में KML एक्सटेंशन, जो समुद्र तल से ऊंचाई की जानकारी देता है. वैल्यू ये हैं:

• relativeToSeaFloor - समुद्र तल से ऊंचाई को मीटर में मापता है. अगर बिंदु समुद्र के बजाय ज़मीन से ऊपर की ओर दिखता है, तो ऊंचाई को ज़मीन से ऊपर माना जाएगा.
• clampToSeaFloor - ऊंचाई की खासियत को अनदेखा कर दिया जाता है और बिंदु को समुद्र के तल पर रखा जाएगा. अगर बिंदु समुद्र के बजाय ज़मीन पर है, तो बिंदु ज़मीन पर लगा दिया जाएगा.

<gx:इंटरपोलेट>

बूलियन मान. अगर मल्टी-ट्रैक में एक से ज़्यादा <gx:Track> एलिमेंट हैं, तो यह तय किया जा सकता है कि पहले ट्रैक के आखिर से लेकर अगले ट्रैक की शुरुआत के बीच के मान को इंटरपोलेट करें. जब डिफ़ॉल्ट वैल्यू (0) का इस्तेमाल किया जाता है, तो आइकॉन या मॉडल एक ट्रैक के आखिर में रुक जाता है और अगले ट्रैक की शुरुआत में जाता है.

इसमें ये शामिल हैं

• <gx:ट्रैक>

<NetworkLink>

सिंटैक्स

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

जानकारी

इससे, लोकल या रिमोट नेटवर्क पर KML फ़ाइल या KML संग्रह का संदर्भ मिलता है. KML फ़ाइल की जगह बताने के लिए <Link> एलिमेंट का इस्तेमाल करें. एलिमेंट में, समय और कैमरे के बदलाव के आधार पर, फ़ाइल को अपडेट करने के रीफ़्रेश विकल्प तय किए जा सकते हैं. बहुत बड़े डेटासेट को बेहतर तरीके से मैनेज करने के लिए, NetworkLinks को क्षेत्रों के साथ इस्तेमाल किया जा सकता है.

NetworkLink के लिए खास एलिमेंट

<रीफ़्रेश करें>

बूलियन मान. इस नीति की वैल्यू 0 होती है. इससे Google Earth उपयोगकर्ता को मिलने वाली सुविधाओं के बारे में पता चलता है. जब भी NetworkLink रीफ़्रेश होता है, तो 'किसको दिखे' सेटिंग को रीसेट करने के लिए, वैल्यू को 1 पर सेट करें. उदाहरण के लिए, मान लें कि लिंक की गई KML फ़ाइल में मौजूद प्लेसमार्क को 1 'किसको दिखे' पर सेट किया गया है और NetworkLink को 1 'रीफ़्रेश' < जब फ़ाइल को पहली बार Google Earth में लोड किया जाता है, तो उपयोगकर्ता 3D व्यूअर में डिसप्ले बंद करने के लिए आइटम के बगल में बने चेक बॉक्स को मिटा सकता है. हालांकि, जब NetworkLink रीफ़्रेश होती है, तब प्लेसमार्क फिर से दिखाई देने लगेगा, क्योंकि उसकी मूल दृश्यता स्थिति TRUE थी.

<flyToView>

बूलियन मान. एक वैल्यू की वजह से, Google Earth, NetworkLinkControl में LookAt या कैमरा के व्यू पर ले जाता है (अगर यह मौजूद है). अगर NetworkLinkControl में कोई AbstractView एलिमेंट नहीं है, तो Google Earth, रीफ़्रेश की गई फ़ाइल में <lm> एलिमेंट के अंदर मौजूद FeatureAt या LookAt या कैमरा एलिमेंट पर उड़ान भरता है. अगर <KML> एलिमेंट में LookAt या कैमरा नहीं है, तो व्यू में कोई बदलाव नहीं होता. उदाहरण के लिए, Google Earth, पैरंट दस्तावेज़ में मौजूद <LookAt> व्यू पर जाएगा, न कि दस्तावेज़ में मौजूद प्लेसमार्क के <LookAt> व्यू पर.

<Link>(ज़रूरी)

सलाह: सूची व्यू में, किसी नेटवर्क लिंक में टॉप लेवल फ़ोल्डर या दस्तावेज़ दिखाने के लिए, फ़ोल्डर या दस्तावेज़ में कोई आईडी असाइन करें. इस आईडी के बिना, सूची में सिर्फ़ चाइल्ड ऑब्जेक्ट के नाम दिखाए जाते हैं.

उदाहरण

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

विस्तृत

• <सुविधा>

कॉन्टेंट का मालिक

• <कंटेनर> से मिला कोई भी एलिमेंट

<NetworkLinkControl>

सिंटैक्स

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

जानकारी

इससे <NetworkLink> से फ़ेच की गई फ़ाइलों का व्यवहार कंट्रोल होता है.

NetworkLinkControl के लिए विशिष्ट तत्व

<min RefreshPeriod>

सेकंड में बताया गया है, <min RefreshPeriod>, फ़ाइल मिलने के बीच लगने वाला कम से कम समय होता है. यह पैरामीटर, सर्वर को किसी खास फ़ाइल को फ़ेच करने की अनुमति देता है. साथ ही, रीफ़्रेश करने की दर को डेटा में होने वाले बदलावों के मुताबिक बदलने की अनुमति देता है. उदाहरण के लिए, कोई उपयोगकर्ता लिंक रीफ़्रेश को 5 सेकंड पर सेट कर सकता है, लेकिन रीफ़्रेश अपडेट को हर घंटे में एक बार सीमित करने के लिए, आप कम से कम रीफ़्रेश अवधि को 3600 पर सेट कर सकते हैं.

<maxSessionLength>

सेकंड में तय किया गया <maxSessionLength>, वह ज़्यादा से ज़्यादा समय है, जिसके लिए क्लाइंट Networkलिंक कनेक्ट रह सकता है. -1 की डिफ़ॉल्ट वैल्यू से यह पता चलता है कि सेशन को खत्म नहीं करना है.

<कुकी>

नेटवर्क लिंक को अगली बार रीफ़्रेश करने पर, यूआरएल क्वेरी में स्ट्रिंग जोड़ने के लिए, इस एलिमेंट का इस्तेमाल करें. स्क्रिप्ट और स्ट्रक्चर्ड डेटा डिलीवरी के साथ ही, सर्वर क्वेरी के हिसाब से हैंडलिंग के लिए, इस स्क्रिप्ट का इस्तेमाल किया जा सकता है.

<message>

आप एक पॉप-अप मैसेज भेज सकते हैं, जैसे कि आपके नेटवर्क लिंक के इस्तेमाल से जुड़े दिशा-निर्देश. यह मैसेज तब दिखता है, जब नेटवर्क लिंक को पहली बार Google Earth में लोड किया जाता है या जब उसे नेटवर्क लिंक कंट्रोल में बदल दिया जाता है.

<linkName>

आपके पास सर्वर से नेटवर्क लिंक का नाम कंट्रोल करने का विकल्प होता है, ताकि क्लाइंट साइड पर दिए गए नाम में किए गए बदलावों को सर्वर बदल दे.

<linkDescription>

आपके पास सर्वर से नेटवर्क लिंक की जानकारी को कंट्रोल करने का विकल्प होता है, ताकि क्लाइंट साइड पर जानकारी में किए गए बदलाव सर्वर पर बदल जाएं.

<linksnippet maxLines="2" >

आपके पास सर्वर से नेटवर्क लिंक के लिए स्निपेट कंट्रोल करने का विकल्प होता है, ताकि क्लाइंट साइड वाले स्निपेट में किए गए बदलाव, सर्वर पर बदल जाएं. <linksnippet> में maxLines एट्रिब्यूट होता है. यह एक पूर्णांक होता है, जिसकी मदद से ज़्यादा से ज़्यादा लाइनें दिखाई जा सकती हैं.

<समयसीमा खत्म>

आप उस तारीख/समय को तय कर सकते हैं जब लिंक को रीफ़्रेश किया जाना चाहिए. यह निर्देश सिर्फ़ तब लागू होता है, जब <Link> में <रीफ़्रेश मोड> की वैल्यू onExpire होती है. <रीफ़्रेश मोड>

देखें

<अपडेट करें>

<Update> के साथ, आप .KML फ़ाइल या .KMZ संग्रह के लिए कितने भी परिवर्तन, बना और हटा सकते हैं जो पहले किसी नेटवर्क लिंक के साथ लोड किए जा चुके हैं. <Update> देखें.

AbstractView>

उदाहरण

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

विस्तृत

• यह <lm> एलिमेंट का डायरेक्ट चाइल्ड है.

कॉन्टेंट का मालिक

• <KML>

यह भी देखें

• <अपडेट करें>
• <NetworkLink>

<ऑब्जेक्ट>

सिंटैक्स

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

जानकारी

यह सिर्फ़ एक ऐब्सट्रैक्ट बेस क्लास है. इसे सीधे KML फ़ाइल में इस्तेमाल नहीं किया जा सकता. इससे, आईडी एट्रिब्यूट मिलता है, जिससे KML एलिमेंट की यूनीक पहचान की जा सकती है. साथ ही, इसमें targetId एट्रिब्यूट होता है, जिसका इस्तेमाल उन ऑब्जेक्ट के रेफ़रंस के लिए किया जाता है जो पहले से Google Earth में लोड किए हुए हैं. अगर <Update> तकनीक का इस्तेमाल किया जाना है, तो id विशेषता असाइन की जानी चाहिए.

<ओवरले>

सिंटैक्स

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

जानकारी

यह एक ऐब्स्ट्रैक्ट एलिमेंट है और इसे सीधे KML फ़ाइल में इस्तेमाल नहीं किया जा सकता. <ओवरले> पृथ्वी की सतह पर या स्क्रीन पर बनाए गए इमेज ओवरले का बेस टाइप है. <Icon> इस्तेमाल करने के लिए इमेज के बारे में बताता है. साथ ही, इसे टाइमर के हिसाब से या कैमरे की सेटिंग में बदलाव करके, इमेज को फिर से लोड करने के लिए कॉन्फ़िगर किया जा सकता है. इस एलिमेंट में कई ओवरले को क्रम में लगाने और बुनियादी इमेज में रंग और पारदर्शिता के मान जोड़ने के निर्देश भी शामिल हैं.

एलिमेंट खास तौर पर ओवरले के लिए

<रंग>

अपारदर्शिता को हेक्साडेसिमल नोटेशन में दिखाया जाता है. इसमें ओपैसिटी (ऐल्फ़ा) वैल्यू भी शामिल हैं. एक्सप्रेशन का क्रम ऐल्फ़ा, नीला, हरा, लाल (aabbggrr होता है). किसी भी एक रंग के लिए मानों की श्रेणी 0 से 255 है (00 से ff). पारदर्शिता के लिए, 00 पूरी तरह से पारदर्शी है और ff पूरी तरह से अपारदर्शी है. उदाहरण के लिए, किसी ओवरले पर 50 प्रतिशत पारदर्शिता वाला नीला रंग लागू करने के लिए, आपको यह जानकारी देनी होगी: <color>7fff0000</color>

ध्यान दें: <geomColor> एलिमेंट पर रोक लगा दी गई है. इसके बजाय, <color> का इस्तेमाल करें.

<drawOrder>

यह एलिमेंट, ओवरलैप होने वाली ओवरले इमेज की स्टैकिंग का क्रम तय करता है. ज़्यादा <drawOrder> वैल्यू वाले ओवरले, कम ओवरले वाली <drawOrder> वैल्यू के ऊपर बनाए जाते हैं.

<आइकॉन>

ओवरले से जुड़ी इमेज के बारे में बताता है. <href> तत्व, ओवरले के रूप में इस्तेमाल की जाने वाली इमेज की जगह तय करता है. यह स्थान या तो किसी स्थानीय फ़ाइल सिस्टम या किसी वेब सर्वर पर हो सकता है. अगर यह एलिमेंट छोड़ दिया जाता है या इसमें कोई <href> मौजूद नहीं है, तो ग्राउंड या स्क्रीन ओवरले के मुताबिक रंग और साइज़ का इस्तेमाल करके, आयत बनाया जाता है.

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

विस्तृत

• <सुविधा>

इस तारीख तक बढ़ाया गया

• <GroundOverlay>
• <फ़ोटो ओवरले>
• <स्क्रीन ओवरले>

<फ़ोटो ओवरले>

सिंटैक्स

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

जानकारी

< PhotoOverlay> एलिमेंट से आपको पृथ्वी पर भौगोलिक रूप से फ़ोटो ढूंढने और इस PhotoOverlay के लिए देखने के पैरामीटर तय करने की सुविधा मिलती है. फ़ोटो ओवरले एक सरल 2D आयत, आंशिक या पूर्ण सिलेंडर या गोला (गोलाकार पैनोरामा के लिए) हो सकता है. ओवरले को बताए गए स्थान पर रखा जाता है और उसे व्यूपॉइंट की ओर ओरिएंटेशन में रखा जाता है.

<ImageOverlay> <Feature> से मिला है, इसलिए इसमें <AbstractView> से मिले दो एलिमेंट में से एक हो सकता है—या तो <Camera> या <LookAt>. कैमरा (या LookAt) व्यूपॉइंट और व्यूइंग डायरेक्शन बताता है (इसे व्यू वेक्टर भी कहा जाता है). फ़ोटो ओवरले को व्यूपॉइंट से जोड़ा जाता है. विशेष रूप से, 2D आयताकार चित्र का विमान समकोणीय (दाएं कोण पर) दृश्य वेक्टर है. इस प्लेन का सामान्य हिस्सा—यानी इसका सामने का हिस्सा, जो फ़ोटो का हिस्सा है—प्वाइंट व्यू की ओर रहता है.

PhotoOverlay इमेज के लिए यूआरएल, <Icon> टैग में बताया गया है, जो <Overlay> से मिलता है. <Icon> टैग में एक <href> एलिमेंट होना चाहिए जो PhotoOverlay के लिए इस्तेमाल की जाने वाली इमेज फ़ाइल के बारे में बताता हो. बहुत बड़ी इमेज के मामले में, <href> एक विशेष यूआरएल है जो अलग-अलग रिज़ॉल्यूशन की इमेज के पिरामिड में इंडेक्स होता है (ImagePyramid देखें).

ज़्यादा जानकारी के लिए, photoOverlay पर "KML में विषय" पेज देखें.

PhotoOverlay के लिए खास एलिमेंट

<रोटेट करें>

एडजस्ट करता है कि फ़ोटो को व्यू के फ़ील्ड में कैसे रखा जाता है. अगर आपकी फ़ोटो को रोटेट किया गया है और हॉरिज़ॉन्टल व्यू से थोड़ा अलग किया गया है, तो यह एलिमेंट काम का होता है.

<Viewvolume>

तय करता है कि मौजूदा सीन का कितना हिस्सा दिखेगा. फ़ील्ड ऑफ़ व्यू के बारे में बताना, कैमरे के शुरुआती कैमरे में खुलने वाले लेंस के समान है. टेलीफ़ोटो लेंस की तरह दिखने वाला एक छोटा फ़ील्ड, सीन के एक छोटे हिस्से पर फ़ोकस करता है. व्यू का बड़ा फ़ील्ड, जैसे कि वाइड-ऐंगल लेंस, सीन के बड़े हिस्से पर फ़ोकस करता है.

<बाएंFov>

कैमरे में, देखे जाने की संख्या और वीडियो को देखने की आवाज़ के बाईं ओर मौजूद ऐंगल में डिग्री.

<rightFov>

कैमरे में, देखे जाने के वॉल्यूम और वीडियो के वॉल्यूम के दाईं ओर मौजूद ऐंगल में डिग्री.

<bottomFov>

कैमरे को देखने की दिशा और व्यू की आवाज़ के निचले हिस्से के बीच, कोण में डिग्री.

<topFov>

कैमरे को देखने की दिशा और व्यू की आवाज़ के ऊपरी हिस्से के बीच, कोण में डिग्री.

<नियर>

कैमरे के व्यूपॉइंट से फ़ोटो ओवरले के आकार तक देखने की दिशा के साथ मीटर में माप.

ImageOverlay के लिए फ़ील्ड को चार विमानों से दिखाया जाता है और हर फ़ील्ड को व्यू वेक्टर के रिलेटिव ऐंगल से तय किया जाता है. ये चार हवाई जहाज़, व्यू के फ़ील्ड के सबसे ऊपर, नीचे, बाएं, और दाएं हिस्से के बारे में बताते हैं. इसका आकार छोटा किया गया होता है, जैसा कि यहां दिखाया गया है:

नीचे दिए गए डायग्राम में, इस पिरामिड के अंदर फ़ील्ड के व्यू से जुड़े चार ऐंगल दिखाए गए हैं:

<ImagePyramid>

बहुत बड़ी इमेज के लिए, आपको इमेज का पिरामिड बनाना होगा. यह तस्वीरों का क्रम है, जिसमें से हर एक का रिज़ॉल्यूशन कम होता है. पिरामिड की हर इमेज को टाइल में अलग-अलग हिस्सों में बांटा जाता है, ताकि सिर्फ़ दिख रहे हिस्से लोड हो सकें. Google Earth वर्तमान व्यूपॉइंट की गणना करता है और उन टाइलों को लोड करता है जो चित्र से उपयोगकर्ता की दूरी के लिए उपयुक्त होती हैं. जैसे ही व्यूअप ऊपर की ओर फ़ोटो ओवरले के पास जाता है, Google Earth हाई रिज़ॉल्यूशन टाइल को लोड करता है. मूल इमेज के सभी पिक्सल, स्क्रीन पर एक साथ नहीं देखे जा सकते. इसलिए, इस प्रोसेसिंग से Google Earth को सबसे अच्छी परफ़ॉर्मेंस मिलती है, क्योंकि यह इमेज के सिर्फ़ उन हिस्सों को लोड करता है जो व्यू में हैं. साथ ही, सिर्फ़ पिक्सल की जानकारी भी दिखती है, जिसे उपयोगकर्ता मौजूदा व्यू पॉइंट पर देख सकता है.

जब आप इमेज पिरामिड के बारे में बताते हैं, तो आप <Icon> एलिमेंट में <href> को भी बदल देते हैं. इससे यह तय होता है कि किन टाइल को लोड किया जाए.

<टाइल>

टाइलों का साइज़, पिक्सल में. टाइलें वर्गाकार होनी चाहिए और <tilSize> में 2 की घात होनी चाहिए. टाइल का साइज़ 256 (डिफ़ॉल्ट) या 512 होना चाहिए. मूल इमेज को इस साइज़ की टाइल में, अलग-अलग रिज़ॉल्यूशन में बांटा गया है.

<ज़्यादा चौड़ाई>

मूल इमेज की चौड़ाई पिक्सल में है.

<maxHeight>

मूल इमेज की ऊंचाई पिक्सल में है.

<gridOrigin>

बताता है कि पिरामिड के हर लेयर में टाइल को कहां से नंबर करना है. lowerLeft की वैल्यू यह बताती है कि हर लेयर की पहली लाइन, कॉलम 1, ग्रिड के सबसे नीचे बाएं कोने में मौजूद है.

<पॉइंट>

<Point> एलिमेंट, <प्लेसमार्क>> एलिमेंट में <Point> के तौर पर काम करता है. यह फ़ोटो ओवरले की स्थिति को चिह्नित करने के लिए आइकॉन बनाता है. <styleUrl> और <StyleSelector> फ़ील्ड से ड्रॉ किए गए आइकॉन की जानकारी मिलती है, ठीक उसी तरह जैसे <प्लेसमार्क> के लिए होती है.

<आकार>

फ़ोटो ओवरले को <आकार> पर प्रजेंट किया जाता है. <आकार> इनमें से कोई एक हो सकता है:

आयत (डिफ़ॉल्ट) - सामान्य फ़ोटो के लिए

सिलेंडर - पैनोरामा के लिए, जो आंशिक या पूरे सिलेंडर हो सकते हैं

गोल - गोलाकार पैनोरामा के लिए

उदाहरण

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

विस्तृत

• <ओवरले>

कॉन्टेंट का मालिक

• <फ़ोल्डर>, <दस्तावेज़> या <KML>

<प्लेसमार्क>

सिंटैक्स

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

जानकारी

प्लेसमार्क, ज्यामिति के साथ जुड़ी सुविधा है. Google Earth में, प्लेसमार्क, पैनल में सूची आइटम के तौर पर दिखता है. प्लेसमार्क के साथ कोई आइकॉन जुड़ा होता है, जो पृथ्वी पर किसी बिंदु को 3D व्यूअर में मार्क करता है. (Google Earth 3D दर्शक में, बिंदु स्थान-निर्धारण एकमात्र ऑब्जेक्ट है जिसे आप क्लिक या रोल ओवर कर सकते हैं. अन्य ज्यामिति ऑब्जेक्ट में 3D व्यूअर में आइकन नहीं है. उपयोगकर्ता को 3D व्यूअर में क्लिक करने के लिए कुछ देने के लिए, आपको ऐसा मल्टी ज्यॉमेट्री ऑब्जेक्ट बनाना होगा जिसमें पॉइंट और दूसरी ज्यामिति ऑब्जेक्ट, दोनों शामिल हों.

प्लेसमार्क के लिए खास एलिमेंट

• 0 या एक <Geometry> एलिमेंट

उदाहरण

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

विस्तृत

• <सुविधा>

कॉन्टेंट का मालिक

• <दस्तावेज़>
• <फ़ोल्डर>

यह भी देखें

• <आइकॉन>

<पॉइंट>

सिंटैक्स

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

जानकारी

देशांतर, अक्षांश, और (ज़रूरी नहीं) ऊंचाई वाली भौगोलिक जगह. जब कोई प्लेसमार्क शामिल करता है, तो यह पॉइंट ही प्लेसमार्क के नाम और आइकॉन की जगह तय करता है. जब कोई बिंदु हटाया जाता है, तो वह लाइन से ज़मीन से जुड़ जाता है. यह "टेदर" वर्तमान LineStyle का उपयोग करता है.

खास तौर पर पॉइंट के लिए एलिमेंट

<extrude>

बूलियन मान. यह तय करता है कि पॉइंट को मैदान से लाइन से जोड़ना है या नहीं. किसी पॉइंट को हटाने के लिए, <heightMode> का मान relativeToGround, relativeToSeaFloor या absolute होना चाहिए. इस बिंदु को बाहर निकालकर पृथ्वी के केंद्र में ले जाया जाता है.

<heightMode>

तय करता है कि <निर्देशांक> एलिमेंट में ऊंचाई कॉम्पोनेंट को कैसे समझा जाता है. वैल्यू

• clampToGround - (डिफ़ॉल्ट) यह बताता है कि ऊंचाई के स्पेसिफ़िकेशन को अनदेखा करना है (उदाहरण के लिए, <निर्देशक> टैग में).
• reliveToGround - किसी खास जगह की वास्तविक ऊंचाई के मुकाबले एलिमेंट की ऊंचाई सेट करता है. उदाहरण के लिए, अगर किसी जगह की ज़मीन पर ऊंचाई बिलकुल समुद्र के स्तर पर है और किसी बिंदु के लिए ऊंचाई 9 मीटर पर सेट है, तो पॉइंट प्लेसमार्क की ऊंचाई के आइकॉन की ऊंचाई 9 मीटर होती है. हालांकि, अगर निर्देशांक उस जगह पर सेट है जहां ज़मीन की ऊंचाई समुद्र तल से 10 मीटर ऊपर है, तो निर्देशांक की ऊंचाई 19 मीटर होगी. इस मोड का इस्तेमाल आम तौर पर, टेलीफ़ोन पोल या स्की लिफ़्ट लगाने के लिए किया जाता है.
• संपूर्ण - तत्व के नीचे के भू-भाग की वास्तविक ऊंचाई पर ध्यान दिए बिना, समुद्र स्तर से संबंधित निर्देशांक की ऊंचाई सेट करता है. उदाहरण के लिए, अगर किसी निर्देशांक की ऊंचाई को संपूर्ण ऊंचाई मोड के साथ 10 मीटर पर सेट किया जाता है, तो नीचे की जगह समुद्र तल से 10 मीटर ऊपर है, तो बिंदु प्लेसमार्क का आइकॉन ग्राउंड लेवल पर दिखेगा. अगर इलाका, समुद्र तल से 3 मीटर ऊपर है, तो इलाका, ऊपर की ओर 7 मीटर से ऊंचा दिखता है. इस मोड का इस्तेमाल आम तौर पर, हवाई जहाज़ में रखकर किया जाता है.

<gx:heightMode>

Google एक्सटेंशन नेमस्पेस में KML एक्सटेंशन, जो समुद्र तल से ऊंचाई को अनुमति देता है. वैल्यू ये हैं:

• relativeToSeaFloor - समुद्र तल से ऊंचाई को मीटर में मापता है. अगर बिंदु समुद्र के बजाय ज़मीन से ऊपर की ओर दिखता है, तो ऊंचाई को ज़मीन से ऊपर माना जाएगा.
• clampToSeaFloor - ऊंचाई की खासियत को अनदेखा कर दिया जाता है और बिंदु को समुद्र के तल पर रखा जाएगा. अगर बिंदु समुद्र के बजाय ज़मीन पर है, तो बिंदु ज़मीन पर लगा दिया जाएगा.

<निर्देशांक>(ज़रूरी)

एक सीधी रेखा जिसमें देशांतर, अक्षांश और ऊंचाई के लिए फ़्लोटिंग पॉइंट मान होते हैं (इस क्रम में). देशांतर और अक्षांश की वैल्यू, डिग्री में हैं, जहां

• देशांतर ≥180 और <= 180
• अक्षांश ≥90 और ≤ 90
• ऊंचाई वैल्यू (ज़रूरी नहीं) समुद्र तल से मीटर में हैं

निर्देशांक के बारे में बताने वाली तीन वैल्यू के बीच स्पेस न डालें.

उदाहरण

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

विस्तृत

• <ज्यामिति>

कॉन्टेंट का मालिक

• <मल्टीजियोमेट्री>
• <प्लेसमार्क>

<पॉलीगॉन>

सिंटैक्स

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

जानकारी

बहुभुज को बाहरी सीमा और 0 या इससे ज़्यादा आंतरिक सीमाओं से परिभाषित किया जाता है. साथ ही, इन सीमाओं को LinearRings से तय किया जाता है. जब कोई पॉलीगॉन निकाला जाता है, तो इसकी सीमाएं ज़मीन से जुड़ी होती हैं, ताकि अतिरिक्त पॉलीगॉन बनाए जा सकें. ये पॉलीगॉन, किसी इमारत या बॉक्स की तरह दिखते हैं. निकाले गए पॉलीगॉन अपने रंग, रंग मोड, और भरने के लिए <PolyStyle> का इस्तेमाल करते हैं.

पॉलीगॉन के लिए <निर्देशांक> को घड़ी की उलटी दिशा में डालना ज़रूरी है. बहुभुज "दाएं हाथ के नियम" का पालन करते हैं, जो बताता है कि अगर आप अपने दाएँ हाथ की ऊंगलियां उस दिशा में रखते हैं जिस पर निर्देशांक दिया गया है, तो आपका अंगूठा पॉलीगॉन के लिए सामान्य ज्यामितीय दिशा में सामान्य दिशा में संकेत करता है. (3D ग्राफ़िक में, ज्यामितीय सामान्य रोशनी का इस्तेमाल, पॉलीगॉन के सामने वाले हिस्से से दूर करके किया जाता है.) क्योंकि Google Earth पॉलीगॉन का सिर्फ़ सामने वाला हिस्सा भरता है, इसलिए आपको मनचाहे नतीजे सिर्फ़ तब मिलेंगे, जब निर्देशांकों को सही क्रम में रखा गया हो. नहीं तो, पॉलीगॉन स्लेटी रंग का हो जाएगा.

ध्यान दें: Google Earth में, clampToGround की <heightMode> वाली पॉलीगॉन, लगातार बने रहने वाली लाइनों की लाइन पर काम करती है. हालांकि, clampToGround के <लीनियर मोड> के साथ एक लीनियर रिंग, बढ़िया सर्कल लाइनों को फ़ॉलो करती है.

पॉलीगॉन के लिए खास एलिमेंट

<extrude>

बूलियन मान. तय करें कि पॉलीगॉन को ज़मीन से कनेक्ट करना है या नहीं. किसी पॉलीगॉन को निकालने के लिए, ऊंचाई मोड relativeToGround, relativeToSeaFloor या absolute होना चाहिए. सिर्फ़ वर्टेक्स को हटाया जाता है, न कि ज्यामिति (उदाहरण के लिए, आयत के आकार पांच बॉक्स वाला बॉक्स होता है). पॉलीगॉन के वर्टेक्स को धरती के गोले के केंद्र की ओर निकाला जाता है.

<tessella>

इस फ़ील्ड का इस्तेमाल पॉलीगॉन में नहीं किया जाता है. पॉलीगॉन को इलाके का पालन करने की अनुमति देने के लिए (यानी, टेस्सेल की सुविधा चालू करने के लिए) clampToGround या clampToSeaFloor की ऊंचाई मोड तय करें.

<heightMode>

तय करता है कि <निर्देशांक> एलिमेंट में ऊंचाई कॉम्पोनेंट को कैसे समझा जाता है. वैल्यू

• clampToGround - (डिफ़ॉल्ट) यह बताता है कि ऊंचाई के स्पेसिफ़िकेशन को अनदेखा करना है (उदाहरण के लिए, <निर्देशक> टैग में).
• reliveToGround - किसी खास जगह की वास्तविक ऊंचाई के मुकाबले एलिमेंट की ऊंचाई सेट करता है. उदाहरण के लिए, अगर किसी जगह की ज़मीन पर ऊंचाई बिलकुल समुद्र के स्तर पर है और किसी बिंदु के लिए ऊंचाई 9 मीटर पर सेट है, तो पॉइंट प्लेसमार्क की ऊंचाई के आइकॉन की ऊंचाई 9 मीटर होती है. हालांकि, अगर निर्देशांक उस जगह पर सेट है जहां ज़मीन की ऊंचाई समुद्र तल से 10 मीटर ऊपर है, तो निर्देशांक की ऊंचाई 19 मीटर होगी. इस मोड का इस्तेमाल आम तौर पर, टेलीफ़ोन पोल या स्की लिफ़्ट लगाने के लिए किया जाता है.
• संपूर्ण - तत्व के नीचे के भू-भाग की वास्तविक ऊंचाई पर ध्यान दिए बिना, समुद्र स्तर से संबंधित निर्देशांक की ऊंचाई सेट करता है. उदाहरण के लिए, अगर किसी निर्देशांक की ऊंचाई को संपूर्ण ऊंचाई मोड के साथ 10 मीटर पर सेट किया जाता है, तो नीचे की जगह समुद्र तल से 10 मीटर ऊपर है, तो बिंदु प्लेसमार्क का आइकॉन ग्राउंड लेवल पर दिखेगा. अगर इलाका, समुद्र तल से 3 मीटर ऊपर है, तो इलाका, ऊपर की ओर 7 मीटर से ऊंचा दिखता है. इस मोड का इस्तेमाल आम तौर पर, हवाई जहाज़ में रखकर किया जाता है.

<gx:heightMode>

Google एक्सटेंशन नेमस्पेस में KML एक्सटेंशन, जो समुद्र तल से ऊंचाई को अनुमति देता है. वैल्यू ये हैं:

• relativeToSeaFloor - समुद्र तल के ऊपर मीटर में मान के रूप में <height> की व्याख्या करता है. अगर बिंदु समुद्र के बजाय ज़मीन से ऊपर की ओर दिखता है, तो ऊंचाई को ज़मीन से ऊपर माना जाएगा.
• clampToSeaFloor - ऊंचाई की खासियत को अनदेखा कर दिया जाता है और बिंदु को समुद्र के तल पर रखा जाएगा. अगर बिंदु समुद्र के बजाय ज़मीन पर है, तो बिंदु ज़मीन पर लगा दिया जाएगा.

<outerBoundaryIs>(ज़रूरी है)

में एक <LinearRing> एलिमेंट शामिल है.

<innerBoundaryIs>

में एक <LinearRing> एलिमेंट शामिल है. पॉलीगॉन में कई <innerBoundaryIs> एलिमेंट शामिल हो सकते हैं, जो पॉलीगॉन में कई कट-आउट बनाते हैं.

उदाहरण

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

विस्तृत

• <ज्यामिति>

कॉन्टेंट का मालिक

• <मल्टीजियोमेट्री>
• <प्लेसमार्क>

<PolyStyle>

सिंटैक्स

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

विवरण

इस नीति से, सभी पॉलीगॉन के लिए ड्रॉइंग की स्टाइल तय की जाती है. इनमें पॉलीगॉन एक्सट्रुशन (जो इमारतों की दीवार की तरह दिखते हैं) और लाइन एक्सट्रुशन (जो सॉलिड फ़ेंस जैसे दिखते हैं) शामिल होता है.

PolyStyle के लिए खास एलिमेंट

<फ़िल>

बूलियन मान. तय करें कि पॉलीगॉन भरना है या नहीं.

<outline>

बूलियन मान. तय करें कि पॉलीगॉन की आउटलाइन बनानी है या नहीं. पॉलीगॉन आउटलाइन मौजूदा LineStyle का इस्तेमाल करती हैं.

उदाहरण

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

विस्तृत

• <ColorStyle>

कॉन्टेंट का मालिक

• <स्टाइल>

<क्षेत्र>

सिंटैक्स

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

जानकारी

किसी इलाके में एक बाउंडिंग बॉक्स (<LatLonAltBox>) होता है, जो भौगोलिक निर्देशांक और ऊंचाई के आधार पर पसंदीदा इलाके की जानकारी देता है. इसके अलावा, किसी क्षेत्र में LOD (विवरण का स्तर) सीमा (<Lod>) होती है. यह अनुमानित स्क्रीन आकार के रूप में संबद्ध क्षेत्र की वैधता श्रेणी परिभाषित करती है. किसी इलाके को "चालू" तब कहा जाता है, जब बाउंडिंग बॉक्स उपयोगकर्ता के व्यू के अंदर हो और एलओडी की ज़रूरी शर्तें पूरी हो रही हों. किसी क्षेत्र से जुड़े ऑब्जेक्ट सिर्फ़ तब दिखाए जाते हैं, जब क्षेत्र चालू होता है. जब <viewरीफ़्रेशMode> onregion होता है, तो लिंक या आइकॉन सिर्फ़ तभी लोड होता है, जब क्षेत्र चालू होता है. ज़्यादा जानकारी के लिए, क्षेत्रों में "KML पर विषय" पेज देखें. कंटेनर या NetworkLink पदानुक्रम में, यह गणना उस क्षेत्र का उपयोग करती है जो पदानुक्रम का निकटतम पूर्वज है.

खास इलाके के लिए एलिमेंट

<LatLonAltBox>(ज़रूरी)

बाउंडिंग बॉक्स, जो भौगोलिक निर्देशांक और ऊंचाई के हिसाब से, दिलचस्पी के इलाके की जानकारी देता है. डिफ़ॉल्ट वैल्यू और ज़रूरी फ़ील्ड इस तरह हैं:

<heightMode> या <gx:heightMode>

<heightMode> के लिए ये वैल्यू हो सकती हैं, clampToGround, relativeToGround, और absolute. <gx:heightMode> के लिए संभावित वैल्यू clampToSeaFloor और relativeToSeaFloor हैं. <LatLonBox> भी देखें.

<minAltitude>

मीटर में बताया गया है (और 'ऊंचाई मोड' निर्देश से प्रभावित है).

<ज़्यादा से ज़्यादा Altitit>

मीटर में बताया गया है (और 'ऊंचाई मोड' निर्देश से प्रभावित है).

<north> (ज़रूरी)

बाउंडिंग बॉक्स के उत्तरी किनारे का अक्षांश, 0 से ±90 के बीच दशमलव डिग्री में तय करता है.

<south> (ज़रूरी)

बाउंडिंग बॉक्स के दक्षिणी किनारे का अक्षांश, 0 से ±90 के बीच दशमलव डिग्री में तय करता है.

<east> (ज़रूरी)

बाउंडिंग बॉक्स के पूर्वी किनारे का देशांतर, 0 से ±180 तक दशमलव डिग्री में तय करता है.

<west> (ज़रूरी)

बाउंडिंग बॉक्स के पश्चिमी किनारे का देशांतर, 0 से ±180 तक दशमलव डिग्री में तय करता है.

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

<लॉड>

लॉड जानकारी का स्तर का छोटा रूप है. <Lod>, स्क्रीन पर दिए गए अनुमानित इलाके का साइज़ बताता है, ताकि क्षेत्र को "चालू" माना जा सके. इसके अलावा, फ़ेड करने के लिए इस्तेमाल किए जाने वाले पिक्सल रैंप (पारदर्शी से पारदर्शी) और उसके रंग को पारदर्शी बनाने के लिए भी इस्तेमाल किया जाता है. इन पैरामीटर को दिखाने के लिए, नीचे दिया गया डायग्राम देखें.

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

<minLodPixels> (ज़रूरी)

स्क्रीन की जगह में एक स्क्वेयर के बारे में बताता है, जहां पिक्सल में बताई गई वैल्यू के किनारे होते हैं. उदाहरण के लिए, 128 एक स्क्वेयर है, जिसमें 128 x 128 पिक्सल होते हैं. क्षेत्र को चालू करने के लिए, बाउंडिंग बॉक्स, इस स्क्वेयर (और maxLodPixels स्क्वेयर से कम) से बड़ा होना चाहिए.

ज़्यादा जानकारी के लिए, डेवलपर गाइड के क्षेत्र के साथ काम करना चैप्टर में जाएं. साथ ही, Google Earth आउटरीच के दस्तावेज़ क्षेत्र के साथ ओवरलोड से बचना के ट्यूटोरियल को भी उपलब्ध कराया गया है.

<maxLodPixels>

स्क्रीन पिक्सल में मेज़रमेंट, जो किसी इलाके के लिए, दिखने की सीमा की ज़्यादा से ज़्यादा सीमा को दिखाता है. डिफ़ॉल्ट रूप से 1 या 1 तक की वैल्यू से यह पता चलता है कि "{2/} तक मौजूद नहीं है".

<minFadeExtent>

वह जगह जिस पर ज्यामिति फ़ेड होती है, पूरी तरह से अपारदर्शी से पूरी तरह से पारदर्शी तक. इस रैंप वैल्यू को स्क्रीन पिक्सल में दिखाया जाता है. इसे एलओडी (वीडियो दिखने की संख्या) की सीमाओं के आखिर में लागू किया जाता है.

<maxFadeExtent>

दूरी, जिस पर ज्यामिति फ़ेड होती है, पूरी तरह से पारदर्शी से पूरी तरह से अपारदर्शी. इस रैंप वैल्यू को स्क्रीन पिक्सल में दिखाया जाता है. इसे एलओडी (वीडियो दिखने की संख्या) की सीमाओं के सबसे आखिर में लागू किया जाता है.

नीचे दिए गए डायग्राम में, अगर P=आपके दिए गए फ़ॉर्मूला के आधार पर तैयार किया गया पिक्सल साइज़ है, तो गोल किए गए नंबर से यह जानकारी मिलती है:

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

<region> का उदाहरण

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

विस्तृत

• <ऑब्जेक्ट>

कॉन्टेंट का मालिक

• <Feature> से मिला कोई भी एलिमेंट

<स्कीमा>

सिंटैक्स

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

जानकारी

यह कस्टम KML स्कीमा तय करता है. इसका इस्तेमाल KML सुविधाओं में कस्टम डेटा जोड़ने के लिए किया जाता है. "आईडी" विशेषता ज़रूरी है और KML फ़ाइल में अलग होनी चाहिए. <Schema> हमेशा <Document> का चाइल्ड होता है.

स्कीमा के लिए खास एलिमेंट

स्कीमा के एक एलिमेंट में एक या एक से ज़्यादा SimpleField एलिमेंट शामिल हैं. SimpleField में, स्कीमा कस्टम फ़ील्ड के टाइप और नाम के बारे में जानकारी देता है. यह इस कस्टम फ़ील्ड के लिए displayName (यह उपयोगकर्ता के लिए आसान फ़ॉर्म है जिसमें Google Earth में खाली जगह और सही विराम चिह्न होते हैं) को तय करता है.

<SimpleField type="स्ट्रिंग" name="स्ट्रिंग">

कस्टम फ़ील्ड का एलान, जिसके लिए इस फ़ील्ड के टाइप और नाम, दोनों की जानकारी दी जानी चाहिए. अगर type या name को छोड़ा जाता है, तो फ़ील्ड को अनदेखा कर दिया जाता है. टाइप इनमें से कोई एक हो सकता है:

• स्ट्रिंग
• int
• Uint
• छोटा
• Ushort
• फ़्लोट
• दोगुनी
• बूल

<displayName>

नाम, अगर कोई है, तो Google Earth उपयोगकर्ता को फ़ील्ड का नाम दिखाए जाने के समय इस्तेमाल किया जाना. स्टैंडर्ड एचटीएमएल मार्कअप से बचने के लिए, [CDATA] एलिमेंट का इस्तेमाल करें.

उदाहरण

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

विस्तृत

यह एक रूट एलिमेंट है.

कॉन्टेंट का मालिक

• <दस्तावेज़>

यह भी देखें

• <SchemaData>

<स्क्रीन ओवरले>

सिंटैक्स

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

जानकारी

यह एलिमेंट, स्क्रीन पर लगा हुआ इमेज ओवरले बनाता है. ScreenOverlays के लिए सैंपल में कंपास, लोगो, और हेड्स-अप डिसप्ले शामिल हैं. स्क्रीन ओवरले का साइज़, <size> एलिमेंट से तय किया जाता है. ओवरले की जगह को, < ओवरलेXY> के ज़रिए तय की गई इमेज के किसी बिंदु को <screenXY> की ओर से स्क्रीन पर दिखाए गए बिंदु पर मैप करके प्रबंधित किया जाता है. इसके बाद इमेज को <रोटेटेशन XY> पर तय की गई स्क्रीन के संबंधित बिंदु के बारे में <रोटेट करें> डिग्री से घुमाया जाता है.

<Icon> का चाइल्ड, <href> चाइल्ड, ओवरले के रूप में इस्तेमाल की जाने वाली इमेज के बारे में बताता है. यह फ़ाइल किसी लोकल फ़ाइल सिस्टम या वेब सर्वर पर मौजूद हो सकती है. अगर इस एलिमेंट को छोड़ दिया जाता है या इसमें कोई <href> मौजूद नहीं है, तो स्क्रीन ओवरले से तय किए गए रंग और साइज़ का इस्तेमाल करके, आयत बनाया जाता है.

ScreenOverlay के लिए खास एलिमेंट

< ओवरलेXY>

ओवरले इमेज (या स्क्रीन के निर्देशांक) को मैप की गई ओवरले इमेज पर एक पॉइंट (या बाहर) दिखाता है (<screenXY>). इसके लिए x और y वैल्यू और उन वैल्यू के लिए यूनिट की ज़रूरत होती है.

x और y वैल्यू को तीन अलग-अलग तरीकों से दिखाया जा सकता है: पिक्सल ("pixels"), इमेज के फ़्रेक्शन ("fraction") या इनसेट पिक्सल ("insetPixels") के तौर पर. इमेज के ऊपर दाएं कोने से, यह पिक्सल में ऑफ़सेट होता है. x और y स्थितियों को अलग-अलग तरीकों से तय किया जा सकता है—उदाहरण के लिए, x को पिक्सल में दिखाया जा सकता है और y को कुछ दिखाया जा सकता है. निर्देशांक सिस्टम का शुरुआती बिंदु इमेज के सबसे नीचे बाएं कोने में है.

• x - इमेज की संख्या या पिक्सल इंसेट या पिक्सल इनसेट, जो ओवरले इमेज पर किसी बिंदु के x कॉम्पोनेंट को दिखाता है.
• y - पिक्सल की संख्या, इमेज का फ़्रैक्शन या पिक्सल इनसेट, जो ओवरले इमेज के किसी बिंदु के y कॉम्पोनेंट को दिखाता है.
• xunits - ऐसी यूनिट जिनमें x वैल्यू की जानकारी दी गई है. "fraction" की वैल्यू से पता चलता है कि x वैल्यू, इमेज का एक हिस्सा है. "pixels" की वैल्यू से पता चलता है कि पिक्सल में x वैल्यू है. "insetPixels" की वैल्यू से पता चलता है कि इमेज के दाएं किनारे से इंडेंट कैसा है.
• yunits - यूनिट जिनमें y की वैल्यू बताई गई है. "fraction" की वैल्यू यह दिखाती है कि y वैल्यू, इमेज का एक हिस्सा है. "pixels" की वैल्यू से पता चलता है कि पिक्सल में y वैल्यू है. "insetPixels" की वैल्यू से पता चलता है कि इमेज, पेज के ऊपरी किनारे पर मौजूद इंडेंट से मेल खाती है.

<स्क्रीनXY>

स्क्रीन के ऑरिजिन से जुड़ा एक पॉइंट तय करता है, जिस पर ओवरले इमेज को मैप किया गया हो. x और y वैल्यू को तीन अलग-अलग तरीकों से बताया जा सकता है: पिक्सल ("pixels"), स्क्रीन के फ़्रेक्शन ("fraction"), या इनसेट पिक्सल ("insetPixels") के तौर पर. स्क्रीन के ऊपरी दाएं कोने से पिक्सल में ऑफ़सेट होता है. x और y स्थितियों को अलग-अलग तरीकों से तय किया जा सकता है—उदाहरण के लिए, x को पिक्सल में दिखाया जा सकता है और y को कुछ दिखाया जा सकता है. निर्देशांक सिस्टम का शुरुआती बिंदु, स्क्रीन के सबसे नीचे बाएं कोने में है.

• x - पिक्सल की संख्या, स्क्रीन का कोई फ़्रैक्शनल कॉम्पोनेंट या पिक्सल इनसेट, जो स्क्रीन पर किसी पॉइंट के x कॉम्पोनेंट को दिखाता है.
• y - पिक्सल की संख्या, स्क्रीन का कोई फ़्रैक्शनल कॉम्पोनेंट या पिक्सल इनसेट, जो स्क्रीन पर मौजूद किसी पॉइंट के y कॉम्पोनेंट को दिखाता है.
• xunits - ऐसी यूनिट जिनमें x वैल्यू की जानकारी दी गई है. "fraction" की वैल्यू यह दिखाती है कि x वैल्यू, स्क्रीन का एक हिस्सा है. "pixels" की वैल्यू से पता चलता है कि पिक्सल में x वैल्यू है. "insetPixels" की वैल्यू से पता चलता है कि स्क्रीन के दाएं किनारे से इंडेंट कितना है.
• yunits - यूनिट जिनमें y की वैल्यू बताई गई है. fraction की वैल्यू यह दिखाती है कि स्क्रीन का कोई हिस्सा y है. "pixels" की वैल्यू से पता चलता है कि पिक्सल में y वैल्यू है. "insetPixels" की वैल्यू से पता चलता है कि स्क्रीन के ऊपरी किनारे पर मौजूद इंडेंट कितना है.

उदाहरण के लिए, <screenXY x=".5" y=".5" xunits="fraction" yunits="fraction /> स्क्रीन के बीच में एक पॉइंट दिखाता है.

यहां कुछ उदाहरण दिए गए हैं:

इमेज को बीच में लाएं:

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

इमेज को सबसे ऊपर बाईं ओर रखें:

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

इस इमेज को स्क्रीन के दाईं ओर रखें:

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

<रोटेटेशनXY>

स्क्रीन के बारे में वह पॉइंट जिस पर स्क्रीन ओवरले को घुमाया गया हो.

<साइज़>

स्क्रीन ओवरले के लिए इमेज का साइज़ इस तरह बताता है:

• −1 का मान, नेटिव डाइमेंशन का इस्तेमाल करने का संकेत देता है
• 0 वैल्यू, आसपेक्ट रेशियो या चौड़ाई-ऊंचाई का अनुपात बनाए रखने का संकेत देती है
• n की वैल्यू, डाइमेंशन की वैल्यू सेट करती है

उदाहरण के लिए:

इमेज को उसके मूल x और y डाइमेंशन को बनाए रखने के लिए, मानों को −1 पर सेट करें:

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

इमेज का हॉरिज़ॉन्टल डाइमेंशन हर हाल में बनाए रखना, लेकिन वर्टिकल स्क्रीन की 20 प्रतिशत जगह लेने के लिए:

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

इमेज को 100 पिक्सल गुणा 500 पिक्सल में बदलने के लिए:

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

<रोटेट करें>

यह बताता है कि पैरंट ऑब्जेक्ट किस ऐंगल से घूमा जा रहा है. 0 वैल्यू का मतलब है कि कोई रोटेशन नहीं है. मान उत्तर की दिशा से डिग्री घड़ी की उल्टी दिशा में है. पैरंट ऑब्जेक्ट को 0 से घुमाने के बारे में बताने के लिए ±180 का इस्तेमाल करें. अगर <rotation> का सेंटर नहीं है, तो <rotation> का सेंटर (.5.5) तय किया गया है.

उदाहरण

नीचे दिए गए उदाहरण में, इमेज की मूल चौड़ाई, ऊंचाई, और आसपेक्ट रेशियो (लंबाई-चौड़ाई का अनुपात) का इस्तेमाल करके, किसी इमेज को स्क्रीन के ठीक बीच में रखा गया है.

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

विस्तृत

• <सुविधा>
• <ओवरले>

कॉन्टेंट का मालिक

• <दस्तावेज़>
• <फ़ोल्डर>

<स्टाइल>

सिंटैक्स

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

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

जानकारी

शैली ऐसे पते समूह को परिभाषित करती है जिसे स्टाइलमैप और सुविधाओं से पहचाना जा सकता है. शैलियां 3D व्यूअर में ज्यॉमेट्री को प्रस्तुत करने के तरीके और लिस्ट व्यू के स्थान पैनल में फ़ीचर के दिखने के तरीके को प्रभावित करती हैं. शेयर की गई शैलियां एक <दस्तावेज़> में इकट्ठा की जाती हैं और उनके लिए एक id तय होनी चाहिए, ताकि उनका इस्तेमाल करने वाली अलग-अलग सुविधाओं से उनका संदर्भ लिया जा सके.

किसी <styleUrl> से शैली को रेफ़र करने के लिए id का उपयोग करें.

उदाहरण

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

विस्तृत

• <StyleSelector>

कॉन्टेंट का मालिक

• कोई भी <Feature>

स्टाइल के लिए खास एलिमेंट

• <BaloonStyle>
• <IconStyle>
• <LabelStyle>
• <LineStyle>
• <ListStyle>
• <PolyStyle>

<स्टाइलमैप>

सिंटैक्स

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

जानकारी

<StyleMap> दो अलग-अलग स्टाइल के बीच मैप होता है. आम तौर पर, किसी प्लेसमार्क के लिए अलग-अलग सामान्य और हाइलाइट की गई शैलियां देने के लिए एक <StyleMap> एलिमेंट का इस्तेमाल किया जाता है. ऐसा इसलिए है, ताकि जब उपयोगकर्ता Google Earth में आइकॉन पर माउस ले जाए, तब उसे हाइलाइट किया गया वर्शन दिखे.

StyleMap के लिए खास एलिमेंट

<पेयर>(ज़रूरी)

कुंजी/वैल्यू पेयर को तय करती है, जो पहले से तय <styleUrl> पर किसी मोड (सामान्य या highlight) को मैप करता है. <पेयर> में दो एलिमेंट होते हैं (दोनों ज़रूरी हैं):

• <key>, यह कुंजी की पहचान करती है
• <styleUrl> या <Style>, जो शैली का संदर्भ देता है. <styleUrl> में, KML दस्तावेज़ के लिए स्थानीय रूप से तय किए गए स्टाइल के लिए, सरल # संदर्भ का इस्तेमाल किया जाता है. बाहरी फ़ाइलों में मौजूद स्टाइल के लिए, # यूआरएल के साथ पूरे यूआरएल का इस्तेमाल करें. उदाहरण के लिए :

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

उदाहरण

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

विस्तृत

• <StyleSelector>

कॉन्टेंट का मालिक

• कोई भी <Feature>

<StyleSelector>

सिंटैक्स

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

जानकारी

यह एक ऐब्स्ट्रैक्ट एलिमेंट है और इसे सीधे KML फ़ाइल में इस्तेमाल नहीं किया जा सकता. यह <Style> और <StyleMap> एलिमेंट का बेस टाइप है. StyleMap एलिमेंट प्लेसमार्क के मौजूदा मोड के आधार पर कोई शैली चुनता है. StyleSELECTor से मिलने वाले एलिमेंट की पहचान उसके id और उसके यूआरएल से की जाती है.

StyleSelector के लिए खास एलिमेंट

इस ऐब्स्ट्रैक्ट एलिमेंट में कोई चाइल्ड एलिमेंट नहीं है.

विस्तृत

• <Object>

इस तारीख तक बढ़ाया गया

• <स्टाइल>
• <StyleMap>

<समयावधि>>

सिंटैक्स

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

जानकारी

यह एक ऐब्स्ट्रैक्ट एलिमेंट है और इसे सीधे KML फ़ाइल में इस्तेमाल नहीं किया जा सकता. इस एलिमेंट को <TimeSpan> और <TimeStamp> एलिमेंट से बढ़ाया गया है.

विस्तृत

• <ऑब्जेक्ट>

इस तारीख तक बढ़ाया गया

• <समयस्पैन>
• <टाइमस्टैंप>

<समयस्पैन>

सिंटैक्स

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

जानकारी

यह dateTimes से शुरू और खत्म होने वाले समय की सीमा को दिखाता है.

अगर <begin> या <end> मौजूद नहीं है, तो पीरियड का अंत खत्म नहीं होता है (नीचे दिया गया उदाहरण देखें).

dateTime को एक्सएमएल स्कीमा समय के मुताबिक तय किया जाता है (एक्सएमएल स्कीमा भाग 2: डेटाटाइप सेकंड वर्शन देखें). वैल्यू को yyyy-mm-ddThh:mm:ss.ssszzzzzz के तौर पर दिखाया जा सकता है, जहां तारीख और समय के बीच T विभाजक है और समय क्षेत्र या तो Z (यूटीसी के लिए) या zzzzzz है, जो यूटीसी के हिसाब से ±hh:mm को दिखाता है. इसके अलावा, वैल्यू को सिर्फ़ तारीख के तौर पर ही दिखाया जा सकता है. उदाहरण के लिए <TimeStamp> देखें.

TimeSpan के लिए खास एलिमेंट

<शुरू करें>

किसी समयावधि के शुरू होने के इंस्टैंट ऑफ़र के बारे में बताता है. अगर मौजूद नहीं है, तो पीरियड की शुरुआत नहीं की जाती.

<end>

किसी समयावधि के तुरंत खत्म होने के बारे में बताता है. अगर मौजूद नहीं है, तो पीरियड खत्म होने के लिए अनबाउंड किया जाता है.

उदाहरण

इस उदाहरण में वह समयावधि दिखाई गई है जो कोलोराडो के राज्य का प्रतिनिधित्व करती है. इसमें सिर्फ़ <begin> टैग शामिल है, क्योंकि कोलोराडो 1 अगस्त, 1876 को बन गया था. यह अब भी राज्य है:

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

विस्तृत

• <टाइम प्रिमिटिव>

कॉन्टेंट का मालिक

• <Feature> से मिला कोई भी एलिमेंट

<टाइमस्टैंप>

सिंटैक्स

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

जानकारी

इसमें, वीडियो के किसी खास पल की जानकारी मिलती है. यह एक आसान एलिमेंट है और इसमें कोई बच्चा नहीं है. इसकी वैल्यू, dateTime होती है. यह एक्सएमएल के समय में दी गई होती है. एक्सएमएल स्कीमा का दूसरा भाग: डेटाटाइप के दूसरे वर्शन को देखें. टाइम स्टैंप की सटीक जानकारी, <when> एलिमेंट में dateTime वैल्यू के आधार पर तय की जाती है.

टाइमस्टैंप के लिए खास एलिमेंट

<कब>

किसी खास समय के बारे में जानकारी देता है. वैल्यू एक dateTime है जो इनमें से कोई एक हो सकती है:

• dateTime में दूसरा रिज़ॉल्यूशन मिलता है
• date, दिन का रिज़ॉल्यूशन देता है
• gYearMonth, महीना का रिज़ॉल्यूशन देता है
• gYear का साल का रिज़ॉल्यूशन यह होता है

<when> मान के लिए नीचे दिए गए उदाहरण अलग-अलग रिज़ॉल्यूशन दिखाते हैं:

• gYear (YYYY)

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

• gYearMonth (YYYY-MM)

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

• date (YYYY-MM-DD)

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

• dateTime (YYYY-MM-DDThh:mm:ssZ)
  यहां, T, कैलेंडर और हर घंटे के नोटेशन के बीच के सेपरेटर है और Z, यूटीसी को दिखाता है. (सेकंड ज़रूरी है.)

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

• dateTime (YYYY-MM-DDThh:mm:sszzzzzz)
  इस उदाहरण में, स्थानीय समय के बारे में जानकारी दी गई है और फिर ± कन्वर्ज़न यूटीसी में बदला गया है.

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

विस्तृत

• <टाइम प्रिमिटिव>

कॉन्टेंट का मालिक

• ऐसा कोई भी एलिमेंट जो <Feature> को बढ़ाता है

<gx:TimeSpan> और <gx:TimeStamp>

यह एलिमेंट, OGC KML 2.2 स्टैंडर्ड का एक्सटेंशन है. इसे Google Earth 5.0 और इसके बाद के वर्शन में इस्तेमाल किया जा सकता है. ज़्यादा जानें

एक्सटेंशन नेमस्पेस में, <TimeSpan> और <TimeStamp> एलिमेंट की कॉपी. ऐसा करने से, ऐब्सट्रैक्ट व्यू (<Camera> और <LookAt>) में समय की वैल्यू शामिल कर दी जाती हैं. समय की वैल्यू का इस्तेमाल, ऐतिहासिक तस्वीरों के संग्रह, सूरज की रोशनी, और समय स्टैंपड सुविधाओं के दिखने की सेटिंग को कंट्रोल करने के लिए किया जाता है.

उदाहरण

<?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:टूर>

यह एलिमेंट, OGC KML 2.2 स्टैंडर्ड का एक्सटेंशन है. इसे Google Earth 5.0 और इसके बाद के वर्शन में इस्तेमाल किया जा सकता है. ज़्यादा जानें

सिंटैक्स

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

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

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

जानकारी

<gx:Tour> में एक ही <gx:Playlist> एलिमेंट हो सकता है. इस एलिमेंट में, gx:TourPrimitive एलिमेंट की क्रम वाली सूची होती है. इससे, किसी भी KML ब्राउज़र पर टूर की जानकारी मिलती है. यात्राओं के बारे में ज़्यादा जानें.

उदाहरण

KML डेवलपर की गाइड के ट्यूरिंग चैप्टर में, यात्रा के कई उदाहरण उपलब्ध हैं.

इसमें ये शामिल हैं

• gx:प्लेलिस्ट - में gx:TourPrimitive एलिमेंट शामिल हैं. <gx:Tour> एलिमेंट में शून्य या एक <gx:Playlist> एलिमेंट हो सकता है.

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

<gx:TourPrimitive>

यह एलिमेंट, OGC KML 2.2 स्टैंडर्ड का एक्सटेंशन है. इसे Google Earth 5.0 और इसके बाद के वर्शन में इस्तेमाल किया जा सकता है. ज़्यादा जानें

सिंटैक्स

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

जानकारी

यह एक ऐब्स्ट्रैक्ट एलिमेंट है और इसे सीधे KML फ़ाइल में इस्तेमाल नहीं किया जा सकता. इस एलिमेंट को <gx:FlyTo>, <gx:AnimatedUpdate>, <gx:TourControl>, <gx:Wait>, और <gx:SoundCue> एलिमेंट से बढ़ाया गया है.

gx:TourPrimitive के एलिमेंट में, टूर के दौरान KML ब्राउज़र को निर्देश दिए जाते हैं. जैसे, उड़ान के समय, उन फ़्लाइटों के रुकने, रुकने, KML सुविधाओं के अपडेट, और चलाई जाने वाली साउंड फ़ाइलें.

ये एलिमेंट <gx:Playlist> एलिमेंट में शामिल होने चाहिए. इन एलिमेंट को <gx:Tour> एलिमेंट में शामिल किया जाता है.

उदाहरण

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

शामिल है

• <gx:प्लेलिस्ट>

इस तारीख तक बढ़ाया गया

• <gx:AnimatedUpdate>
• <gx:FlyTo>
• <gx:SoundCue>

  <gx:SoundCue id="ID">
    <href>http://www.example.com/audio/trumpets.mp3</href>   <!-- any URI -->
    <gx:delayedStart>0</gx:delayedStart>                     <!-- double -->
  </gx:SoundCue>

  MP3, M4A या AAC फ़ॉर्मैट में चलने वाली साउंड फ़ाइल के बारे में बताने वाला एक <href> एलिमेंट होता है. इसमें कोई अवधि नहीं है. ध्वनि फ़ाइल शेष यात्रा के साथ चलती है, जिसका मतलब है कि अगला यात्रा प्रिमिटिव <gx:SoundCue> यात्रा प्राचीन होने के तुरंत बाद होता है. अगर कोई दूसरी साउंड फ़ाइल पहली बार चलाए जाने से पहले ठीक हो जाती है, तो फ़ाइलें मिक्स हो जाती हैं. <gx:delayedStart> एलिमेंट, यह तय करता है कि फ़ाइल चलाने से पहले, तय संख्या में आवाज़ कैसे शुरू हो सकती है.
• <gx:TourControl>

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

  सिर्फ़ एक <gx:playMode> एलिमेंट शामिल होता है. इस तरह, टूर को तब तक रोका जा सकता है, जब तक उपयोगकर्ता, टूर जारी रखने के लिए कोई कार्रवाई नहीं करता.
• <gx:Wait>

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

  अगला gx:TourPrimitive gx:AbstractView पर कैमरा अगले gx:TourPrimitive को चलाने से पहले, सेकंड में तय संख्या पर बना रहता है. ध्यान दें कि इंतज़ार करने से यात्रा की टाइमलाइन नहीं रुकती है. फ़िलहाल, चल रही आवाज़ की फ़ाइलें और ऐनिमेशन वाले अपडेट, कैमरे के इंतज़ार करने के दौरान लगातार चलते रहेंगे.

विस्तृत

• <ऑब्जेक्ट>

<gx:ट्रैक>

यह एलिमेंट, OGC KML 2.2 स्टैंडर्ड का एक्सटेंशन है. यह Google Earth 5.2 और इसके बाद के वर्शन में काम करता है. ज़्यादा जानें

सिंटैक्स

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

जानकारी

ट्रैक से पता चलता है कि कोई ऑब्जेक्ट किसी तय समयावधि में, दुनिया में कैसे घूमता है. इस सुविधा से Google Earth में, दिखने वाला एक ऑब्जेक्ट (पॉइंट आइकॉन या मॉडल) बनाया जा सकता है. इस ऑब्जेक्ट को एक ही ऑब्जेक्ट के लिए, एक से ज़्यादा बार पिन किया जा सकता है. Google Earth में, समय स्लाइडर, उपयोगकर्ता को समय के साथ-साथ व्यू को मूव करने देता है, जिससे ऑब्जेक्ट की स्थिति को ऐनिमेट किया जा सकता है.

gx:मल्टीट्रैक एलिमेंट का इस्तेमाल, एक कॉन्सेप्टिव यूनिट में एक से ज़्यादा ट्रैक को इकट्ठा करने के लिए किया जाता है. इसमें, एक आइकॉन (या मॉडल) होता है जो ट्रैक के साथ-साथ चलता है. यह सुविधा तब काम आती है, जब आपके पास एक ही आइटम के लिए कई ट्रैक हों. <gx:interTracklate> <gx:MultiTrack> का बूलियन एलिमेंट, यह बताता है कि मल्टी-ट्रैक में ट्रैक के बीच इंटरपोलेट करना है या नहीं. अगर यह मान 0 है, तो पॉइंट या मॉडल एक ट्रैक के आखिर में रुक जाता है और अगले ट्रैक के शुरू में चला जाता है. (उदाहरण के लिए, अगर आपको दो दिनों में अपनी यात्राओं को दिखाने के लिए एक प्लेसमार्क चाहिए और इस अवधि के दौरान आपकी जीपीएस यूनिट को चार घंटे के लिए बंद कर दिया गया था, तो आपको उन पॉइंट के बीच एक अंतर दिखाना चाहिए जहां यूनिट को बंद किया गया था और फिर से चालू किया गया था.) अगर <gx:interpolate> की वैल्यू 1 है, तो पहले ट्रैक के आखिरी और अगले ट्रैक के शुरू होने के बीच की वैल्यू को इंटरपोलेट किया जाता है, ताकि ट्रैक एक लगातार पाथ के तौर पर दिखे.

Google Earth में जीपीएस डेटा इंपोर्ट करने के तरीके के बारे में जानने के लिए, Google Earth की उपयोगकर्ता गाइड देखें.

ट्रैक उपयोगी क्यों हैं?

KML के पुराने वर्शन (प्री-Google Earth 5.2) में आपको किसी भी फ़ीचर (प्लेसमार्क, ग्राउंड ओवरले वगैरह) के साथ टाइम एलिमेंट जोड़ने की सुविधा मिलती है. हालांकि, किसी सुविधा के साथ एक बार एलिमेंट जोड़ा जा सकता है. ट्रैक, दिखाई देने वाली सुविधाओं के साथ समय के डेटा को जोड़ने का ज़्यादा असरदार तरीका है. ऐसा इसलिए, क्योंकि आप सिर्फ़ एक सुविधा बनाते हैं, जिसे समय के साथ कई चीज़ों से जोड़ा जा सकता है.

साथ ही, ट्रैक एलिमेंट पहले वाले मैकेनिज़्म (KML डेवलपर की गाइड के समय और ऐनिमेशन चैप्टर में बताया गया) की तुलना में ज़्यादा असरदार होता है, क्योंकि <Track> किसी ट्रैक के साथ किसी भी समय ऑब्जेक्ट की पोज़िशन को इंटरपोलेट करने का तरीका बताता है. इस नई सुविधा के साथ, Google Earth समय के साथ-साथ ऑब्जेक्ट के लिए ऊंचाई और गति प्रोफ़ाइल का ग्राफ़ दिखाता है (और अगर कस्टम डेटा मौजूद है, तो).

"Sparse" डेटा

जब ट्रैक पर स्थितियों के लिए कुछ डेटा मान अनुपलब्ध हों, तो श्रेणियों को संतुलित करने के लिए खाली <coord/> (<coord></coord>) या <angles/> (<angles></angles>) टैग दिए जा सकते हैं. किसी खाली <coord/> या <angles/> टैग से पता चलता है कि किसी डेटा पॉइंट के लिए ऐसा कोई डेटा मौजूद नहीं है. साथ ही, वैल्यू को पास के दो डेटा पॉइंट के बीच इंटरपोलेट किया जाना चाहिए. यह तरीका, किसी ट्रैक के सुझाव दिए गए डेटा पर भी लागू होता है. <when> को छोड़कर कोई भी एलिमेंट खाली हो सकता है. साथ ही, यह एलिमेंट दो नज़दीकी एलिमेंट के बीच ही दिखाया जाएगा.

ट्रैक करने के लिए खास एलिमेंट

<heightMode>

तय करता है कि <निर्देशांक> एलिमेंट में ऊंचाई कॉम्पोनेंट को कैसे समझा जाता है. वैल्यू

• clampToGround - (डिफ़ॉल्ट) यह बताता है कि ऊंचाई की जानकारी को अनदेखा किया जा रहा है (उदाहरण के लिए, <gx:coord> टैग में).
• reliveToGround - किसी खास जगह की वास्तविक ऊंचाई के मुकाबले एलिमेंट की ऊंचाई सेट करता है. उदाहरण के लिए, अगर किसी जगह की ज़मीन पर ऊंचाई बिलकुल समुद्र के स्तर पर है और किसी बिंदु के लिए ऊंचाई 9 मीटर पर सेट है, तो पॉइंट प्लेसमार्क की ऊंचाई के आइकॉन की ऊंचाई 9 मीटर होती है. हालांकि, अगर निर्देशांक उस जगह पर सेट है जहां ज़मीन की ऊंचाई समुद्र तल से 10 मीटर ऊपर है, तो निर्देशांक की ऊंचाई 19 मीटर होगी.
• संपूर्ण - तत्व के नीचे के भू-भाग की वास्तविक ऊंचाई पर ध्यान दिए बिना, समुद्र स्तर से संबंधित निर्देशांक की ऊंचाई सेट करता है. उदाहरण के लिए, अगर किसी निर्देशांक की ऊंचाई को संपूर्ण ऊंचाई मोड के साथ 10 मीटर पर सेट किया जाता है, तो नीचे की जगह समुद्र तल से 10 मीटर ऊपर है, तो बिंदु प्लेसमार्क का आइकॉन ग्राउंड लेवल पर दिखेगा. अगर इलाका, समुद्र तल से 3 मीटर ऊपर है, तो इलाका, ऊपर की ओर 7 मीटर से ऊंचा दिखता है.

<gx:heightMode>

Google एक्सटेंशन नेमस्पेस में KML एक्सटेंशन, जो समुद्र तल से ऊंचाई को अनुमति देता है. वैल्यू ये हैं:

• relativeToSeaFloor - समुद्र तल से ऊंचाई को मीटर में मापता है. अगर बिंदु समुद्र के बजाय ज़मीन से ऊपर की ओर दिखता है, तो ऊंचाई को ज़मीन से ऊपर माना जाएगा.
• clampToSeaFloor - ऊंचाई की खासियत को अनदेखा कर दिया जाता है और बिंदु को समुद्र के तल पर रखा जाएगा. अगर बिंदु समुद्र के बजाय ज़मीन पर है, तो बिंदु ज़मीन पर लगा दिया जाएगा.

कब>

ऐसी समय वैल्यू जो किसी पोज़िशन से जुड़ी हो (<gx:coord> एलिमेंट में हो). <ट्रैक> में मौजूद <when> एलिमेंट की संख्या, <gx:coord> एलिमेंट (और अगर शामिल हो, तो <gx:angles> एलिमेंट) के बराबर होनी चाहिए.

<gx:coord>

निर्देशांक एक ऐसा मान होता है जिसमें देशांतर, अक्षांश, और ऊंचाई के तीन मान होते हैं. इसमें कॉमा सेपरेटर का इस्तेमाल नहीं किया जाता. उदाहरण के लिए:

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

ध्यान दें कि <gx:coord> एलिमेंट के लिए सिंटैक्स, <निर्देशांक> एलिमेंट के सिंटैक्स से अलग होता है, जो देशांतर, अक्षांश, और ऊंचाई के कॉम्पोनेंट को अलग करने के लिए कॉमा का इस्तेमाल करता है. तय किए गए एलिमेंट की संख्या, समय की संख्या () और पोज़िशन () के बराबर होनी चाहिए. अगर ज़रूरी हो, तो आप मान मौजूद नहीं होने पर, खाली <gx:coord> एलिमेंट के बारे में बताएं.

<gx:angles>

इस मान का इस्तेमाल ट्रैक में हर बार/स्थिति के लिए आइकॉन या मॉडल को अतिरिक्त हेडिंग, टिल्ट, और रोल मान बताने के लिए किया जाता है. तीन फ़्लोटिंग पॉइंट वैल्यू को कॉमा सेपरेटर के बिना सूची में रखा जाता है. साथ ही, वे घुमाव की डिग्री दिखाते हैं. अगर <gx:angles> बताया नहीं गया है, तो Google Earth अपने ट्रैक से ऑब्जेक्ट का शीर्षक, झुकाव, और रोल का अनुमान लगाता है. तय किए गए <gx:angles> एलिमेंट की संख्या, समय (<when>) और पोज़िशन (<gx:coord>) एलिमेंट की संख्या के बराबर होनी चाहिए. ज़रूरत पड़ने पर, <gx:angles> एलिमेंट की वैल्यू को खाली छोड़ा जा सकता है.

फ़िलहाल, आइकॉन सिर्फ़ शीर्षक के साथ काम करते हैं, लेकिन मॉडल तीनों वैल्यू पर काम करते हैं.

इस वैल्यू को सेट करने का एक उदाहरण:

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

<Model>

अगर बताया गया हो, तो मॉडल ट्रैक पर मौजूदा स्थिति को दिखाने के लिए इस्तेमाल होने वाले पॉइंट के आइकॉन को बदल देता है. जब किसी <Model> को <gx:Track> में बताया जाता है, तो यहां <Model> फ़ंक्शन के चाइल्ड एलिमेंट के बारे में बताया गया है:

• <Location> एलिमेंट को अनदेखा किया जाता है.
• <heightMode> एलिमेंट को अनदेखा कर दिया जाता है.
• <orientation> वैल्यू को ट्रैक के ओरिएंटेशन के साथ इस तरह से जोड़ा जाता है. पहला, <orientation> रोटेशन लागू किया जाता है, जो मॉडल को उसके स्थानीय (x, y, z) निर्देशांक सिस्टम से दाईं ओर, उत्तर दिशा की तरफ़ वाले ओरिएंटेशन में लाता है. इसके बाद, एक रोटेशन लागू किया जाता है, जो <gx:angles> मानों के इंटरपोलेटेशन से संबंधित होता है, जो ट्रैक के साथ-साथ मॉडल के शीर्षक, झुकाव और रोल को प्रभावित करता है. अगर कोई कोण तय नहीं किया गया है, तो शीर्षक और झुकाव का अनुमान मॉडल की गति से लगाया जाता है.

  सलाह: अगर आप ओरिएंटेशन तय करने के तरीके के बारे में तय नहीं कर पा रहे हैं, तो <Model> से <Orientation> एलिमेंट को छोड़ दें. साथ ही, देखें कि Google Earth, मॉडल को ट्रैक के साथ कैसे करता है. अगर आपको पता चलता है कि मॉडल का सामने का हिस्सा अगल-बगल है, तो मॉडल को घुमाने के लिए <Orientation> में <heading> एलिमेंट में बदलाव करें, ताकि यह सामने की तरफ़ रहे. अगर मॉडल सही नहीं है, तो <tilt> या <role> एलिमेंट में बदलाव करके देखें.

एक्सटेंडेड डेटा>

KML फ़ाइल में पहले <Schema> में तय किए गए कस्टम डेटा एलिमेंट.

किसी ट्रैक पर हर बार/रैंक से जुड़ा एक्सटेंडेड डेटा जोड़ना अक्सर कारगर होता है. उदाहरण के लिए, साइकल की सवारी में धड़कन की दर, आवाज़ की लय, और पावर से जुड़ा डेटा शामिल हो सकता है. यह ज़्यादा डेटा वाले ट्रैक के उदाहरण में दिखाया गया है. <स्कीमा> में, आप हर कस्टम डेटा प्रकार के लिए एक <gx:SimpleArrayField> तय करते हैं. इसके बाद, हर तरह के डेटा के लिए <gx:SimpleArrayData> एलिमेंट शामिल करें, जिसमें ट्रैक पर हर बार/रैंक से जुड़े <gx:value> एलिमेंट होते हैं. नए डेटा फ़ील्ड जोड़ने के बारे में ज़्यादा जानकारी के लिए, KML डेवलपर की गाइड का कस्टम डेटा जोड़ना चैप्टर देखें. Google Earth में, कस्टम डेटा को ट्रैक के लिए ऊंचाई प्रोफ़ाइल में दिखाया जाता है.

सरल उदाहरण

इस बुनियादी उदाहरण से पता चलता है कि <when> और <gx:coord> के लिए वैल्यू के साथ-साथ "array" कैसे बनाया जा सकता है. समय और रैंक की वैल्यू की संख्या एक जैसी होनी चाहिए.

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

ज़्यादा डेटा वाले ट्रैक का उदाहरण

इस उदाहरण में बोल्डफ़ेस का टाइप, बाइक राइड के लिए कस्टम डेटा को तय करने और उसे तय करने में इस्तेमाल होने वाली चीज़ों को हाइलाइट करता है. अंदरूनी तौर पर, कस्टम डेटा फ़ील्ड का नाम "हार्टरेट", "कैडेंस", और "पावर" होता है. <Schema> एलिमेंट, वैल्यू के हर सेट (हार्ट रेट, केडेंस, और पावर) के लिए दिखाए जाने वाले नाम के बारे में बताता है. साथ ही, हर नए फ़ील्ड के लिए डेटा का टाइप बताता है (दिल की धड़कन और उतार-चढ़ाव का टाइप int है, और पावर float टाइप का है). Google Earth में, कस्टम डेटा को ट्रैक की ऊंचाई प्रोफ़ाइल के साथ दिखाया जाता है.

यह उदाहरण, ट्रैक का ज़्यादा असली जैसा प्रज़ेंटेशन देता है. इसमें, कस्टम आइकॉन, हाइलाइट और सामान्य मोड के लिए, आइकॉन और लाइन के अलग-अलग स्टाइल शामिल हैं. हालांकि, ध्यान दें कि उदाहरण में डेटा वैल्यू के सिर्फ़ सात सेट शामिल हैं. असल उदाहरण में हज़ारों वैल्यू शामिल हैं. (शॉन ब्रोडर के सौजन्य से डेटा. यह डेटा Garmin Edge 705 से इकट्ठा किया गया है. इसमें, धड़कन की दर का पता लगाने वाला मॉनिटर और पावर मीटर लगा है.)

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

विस्तृत

• <Geometry>

कॉन्टेंट का मालिक

• <मल्टीजियोमेट्री>
• <gx:मल्टीट्रैक>
• <प्लेसमार्क>

<अपडेट करें>

सिंटैक्स

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

जानकारी

इस नीति से, तय किए गए यूआरएल का इस्तेमाल करके पहले से लोड किए गए KML डेटा को जोड़ने, बदलने या मिटाने के बारे में जानकारी मिलती है. <targetHref> .KML या .KMZ फ़ाइल के बारे में बताता है, जिसके डेटा में (Google Earth में) बदलाव किया जाना है. <Update> हमेशा किसी NetworkLinkControl में होता है. इसके अलावा, NetworkLinkControl वाली फ़ाइल किसी NetworkLink से लोड होनी चाहिए. अपडेट कैसे काम करता है, इसका विस्तृत उदाहरण देखने के लिए अपडेट पर "KML पर विषय" पेज देखें.

अपडेट करने के लिए खास एलिमेंट

इसमें किसी भी संख्या में <Change>, <Create>, और <Delete> एलिमेंट शामिल हो सकते हैं, जिन्हें क्रम से प्रोसेस किया जाएगा.

<targetHref>(ज़रूरी)

.KML या .KMZ फ़ाइल के बारे में बताने वाला यूआरएल, जिसके डेटा में (Google Earth में) <Update> एलिमेंट से बदलाव किया जाना है. यह KML फ़ाइल पहले से ही किसी <NetworkLink> के ज़रिए लोड की गई होनी चाहिए. उस फ़ाइल में, बदलाव किए जाने वाले एलिमेंट में पहले से ही एक साफ़ id विशेषता होनी चाहिए.

<बदलें>

एलिमेंट के उन वैल्यू में बदलाव करता है जो <NetworkLink> में पहले से लोड हैं. 'बदलाव करें' एलिमेंट में, उस एलिमेंट में targetId एट्रिब्यूट शामिल होना चाहिए जिसमें मूल एलिमेंट के id का रेफ़रंस हो.

इस अपडेट को "स्पार्स अपडेट" के तौर पर देखा जा सकता है: बदले गए एलिमेंट में, सिर्फ़ <Change> में दी गई वैल्यू बदली जाती हैं. इसके अलावा, दूसरी सभी वैल्यू में कोई बदलाव नहीं किया जाता. जब <Change> निर्देशांकों के एक सेट पर लागू किया जाता है, तो नए निर्देशांक वर्तमान निर्देशांकों को बदल देते हैं.

इस एलिमेंट में मौजूद चिल्ड्रन, एलिमेंट में बदलाव किए जाते हैं. इन एलिमेंट की पहचान targetId एट्रिब्यूट से की जाती है.

<बनाएं>

किसी फ़ोल्डर या दस्तावेज़ में नए एलिमेंट जोड़ता है जो पहले से ही किसी <NetworkLink> के ज़रिए लोड किए जा चुके हैं. <Update> में <targetHref> एलिमेंट से .KML या .KMZ फ़ाइल का यूआरएल मिलता है, जिसमें मूल फ़ोल्डर या दस्तावेज़ शामिल है. उस फ़ाइल में, नए डेटा वाले फ़ोल्डर या दस्तावेज़ में पहले से ही साफ़ तौर पर एक id मौजूद होना चाहिए. id को <बनाएं> में फ़ोल्डर या दस्तावेज़ की targetId विशेषता के रूप में जाना जाता है, जिसमें जोड़ा जाने वाला तत्व होता है.

ऑब्जेक्ट बनने और Google Earth में लोड होने के बाद, वह उस फ़ोल्डर के ओरिजनल दस्तावेज़ के यूआरएल से जुड़ जाता है. इस अपडेट/बनाएं की सुविधा का इस्तेमाल करके जोड़े गए ऑब्जेक्ट को बाद में अपडेट करने के लिए, <targetHref> को मूल दस्तावेज़ या फ़ोल्डर के यूआरएल पर सेट करें, न कि उस फ़ाइल के यूआरएल को जिस पर अपडेट लागू किए गए हैं.

<मिटाएं>

एक ऐसे कॉम्प्लेक्स एलिमेंट से सुविधाओं को मिटाता है जिसे <NetworkLink> के ज़रिए पहले से लोड किया गया है. <Update> में मौजूद <targetHref> एलिमेंट से .KML या .KMZ फ़ाइल के बारे में पता चलता है, जिसमें मिटाया जाने वाला डेटा मौजूद है. उस फ़ाइल में, जिस एलिमेंट को मिटाना है उसके लिए, साफ़ तौर पर एक id देना ज़रूरी है. <Delete> एलिमेंट, targetId एट्रिब्यूट में इस id का रेफ़रंस देता है.

<Delete> के लिए चाइल्ड एलिमेंट, सिर्फ़ ऐसे एलिमेंट हैं जिन्हें मिटाया जा सकता है, जैसे कि दस्तावेज़, फ़ोल्डर, GroundOverlay, प्लेसमार्क, और ScreenOverlay.

<Change> का उदाहरण

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

<बनाएं> का उदाहरण

इस उदाहरण से, पहले से बनाए गए दस्तावेज़ में नया प्लेसमार्क बनता है, जिसमें "region24" का id होता है. ध्यान दें कि अगर आप "placemark891" में और अपडेट करना चाहते हैं, तो आप <targetHref> के तौर पर http://myserver.com/Point.KML का इस्तेमाल करेंगे.

<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> का उदाहरण

यह उदाहरण Google Earth में पहले से लोड किए गए प्लेसमार्क को मिटा देता है. (ऐसा हो सकता है कि यह प्लेसमार्क, दिए गए यूआरएल के साथ सीधे तौर पर किसी NetworkLink से लोड किया गया हो या उसे मूल दस्तावेज़ में बाद में अपडेट के ज़रिए लोड किया गया हो.)

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

कॉन्टेंट का मालिक

• <NetworkLinkControl>

<यूआरएल>

ध्यान दें: इसे KML रिलीज़ 2.1 में बहिष्कृत किया गया था और इसकी जगह <Link>, का इस्तेमाल किया गया है, जिससे क्षेत्र की अतिरिक्त सुविधाएं मिलती हैं. <Url> टैग अब भी Google Earth में काम करेगा, लेकिन नए <Link> टैग के इस्तेमाल को बढ़ावा दिया जाता है.

इस एलिमेंट का इस्तेमाल, लिंक की जगह को KML फ़ाइल के लिए सेट करने, सर्वर और दर्शक के लिए रीफ़्रेश करने के विकल्पों को तय करने, और वैरिएबल में डालने के लिए करें, ताकि सर्वर को काम की क्लाइंट जानकारी दी जा सके.

पेज पर सबसे ऊपर जाएं