ข้อมูลอ้างอิง KML

ส่วนนี้ประกอบด้วยการอ้างอิงตามตัวอักษรสําหรับองค์ประกอบ KML ทั้งหมดที่กําหนดไว้ใน KML เวอร์ชัน 2.2 และองค์ประกอบในเนมสเปซของส่วนขยาย Google แผนผังชั้นเรียนสําหรับองค์ประกอบ KML จะแสดงอยู่ด้านล่าง ในแผนภาพนี้ องค์ประกอบทางด้านขวาในสาขาที่เฉพาะเจาะจงในโครงสร้างจะเป็นส่วนขยายขององค์ประกอบทางซ้าย ตัวอย่างเช่น หมุดเป็นฟีเจอร์พิเศษ ซึ่งประกอบด้วยองค์ประกอบทั้งหมดที่เป็นของฟีเจอร์ และเพิ่มองค์ประกอบที่เฉพาะเจาะจงสําหรับองค์ประกอบหมุดโดยเฉพาะ

KML เป็นมาตรฐานแบบเปิดอย่างเป็นทางการชื่อว่ามาตรฐานการเข้ารหัส KML OpenGIS® (OGC KML) และได้รับการดูแลโดย Open Geospatial Consortium, Inc. (OGC) ดูข้อกําหนดทั้งหมดสําหรับ OGC KML ได้ที่ http://www.opengeospatial.org/standards/KML/

สคีมา XML ที่สมบูรณ์สําหรับ KML อยู่ที่ http://schemas.opengis.net/ KML/

หมายเหตุ: คลิกชื่อองค์ประกอบในแผนภาพนี้เพื่อข้ามไปยังรายการในส่วนอ้างอิง

แผนภาพแผนผังชั้นเรียน องค์ประกอบออบเจ็กต์ (หลัก) gx:องค์ประกอบการเข้าชม องค์ประกอบย่อยของฟีเจอร์ องค์ประกอบ NetworkLink, องค์ประกอบย่อยของฟีเจอร์ องค์ประกอบหมุด องค์ประกอบย่อยของฟีเจอร์ องค์ประกอบการวางซ้อน องค์ประกอบย่อยของฟีเจอร์ องค์ประกอบคอนเทนเนอร์ ย่อยของฟีเจอร์ องค์ประกอบฟีเจอร์ องค์ประกอบเรขาคณิต ออบเจ็กต์ย่อยของออบเจ็กต์ องค์ประกอบ Photoการวางซ้อน, องค์ประกอบย่อยของการวางซ้อน การวางซ้อนหน้าจอ, องค์ประกอบย่อยของการวางซ้อน องค์ประกอบ Groundโฆษณาซ้อนทับ, องค์ประกอบย่อยของโฆษณาซ้อนทับ องค์ประกอบโฟลเดอร์ ; คอนเทนเนอร์ย่อย องค์ประกอบเอกสาร ส่วนย่อยของคอนเทนเนอร์ องค์ประกอบจุด องค์ประกอบย่อยของเรขาคณิต องค์ประกอบ LineString ; องค์ประกอบย่อยของเรขาคณิต องค์ประกอบ เชิงเส้นใน ; องค์ประกอบย่อยของเรขาคณิต องค์ประกอบลิงก์: องค์ประกอบย่อยของออบเจ็กต์ องค์ประกอบไอคอน ย่อยของลิงก์ องค์ประกอบการวางแนว องค์ประกอบย่อยของออบเจ็กต์ องค์ประกอบตําแหน่ง ออบเจ็กต์ย่อยของออบเจ็กต์ สเกลองค์ประกอบ ออบเจ็กต์ย่อยของออบเจ็กต์ องค์ประกอบหลายเหลี่ยม องค์ประกอบย่อยของเรขาคณิต องค์ประกอบเรขาคณิตหลายรูป องค์ประกอบย่อยของเรขาคณิต องค์ประกอบโมเดล องค์ประกอบย่อยของเรขาคณิตหลายรูป gx:องค์ประกอบการติดตาม; องค์ประกอบย่อยของเรขาคณิต องค์ประกอบรูปแบบ องค์ประกอบย่อยของ StyleSelector gx:องค์ประกอบหลายแทร็ก, องค์ประกอบย่อยของเรขาคณิต องค์ประกอบ StyleSelector เป็นออบเจ็กต์ย่อยของออบเจ็กต์ องค์ประกอบ StyleMaps องค์ประกอบย่อยของตัวเลือกรูปแบบ องค์ประกอบ TimePrimitive ย่อยของออบเจ็กต์ องค์ประกอบ TimeSpan ย่อยของ TimePrimitive gx:เวลาสแตมป์ องค์ประกอบ AbstractView ออบเจ็กต์ย่อยของออบเจ็กต์ องค์ประกอบกล้อง องค์ประกอบย่อยของ AbstractView องค์ประกอบ LookAt; องค์ประกอบย่อยของ AbstractView องค์ประกอบภูมิภาค ออบเจ็กต์ย่อยของออบเจ็กต์ องค์ประกอบ Lod, ออบเจ็กต์ย่อยของ Object องค์ประกอบ LatLonBox และออบเจ็กต์ย่อยของ Object องค์ประกอบ LatLonAltBox และออบเจ็กต์ย่อยของ Object องค์ประกอบ gx:LatLonQuad; chid of Object องค์ประกอบ SubStyle ส่วนชิปของออบเจ็กต์ องค์ประกอบ BalloonStyle ระดับย่อยของ SubStyle องค์ประกอบ ColorStyle, องค์ประกอบย่อยของ SubStyle องค์ประกอบ ListStyle, องค์ประกอบย่อยของ SubStyle gx:องค์ประกอบ Span เวลาของ TimeSpan องค์ประกอบ TimeStamp, องค์ประกอบย่อยของ TimePrimitive องค์ประกอบ LineStyle องค์ประกอบย่อยของ ColorStyle องค์ประกอบ PolyStyle องค์ประกอบย่อยของ ColorStyle องค์ประกอบไอคอนลักษณะ; องค์ประกอบย่อยของ ColorStyle องค์ประกอบ LabelStyle ระดับย่อยของ ColorStyle gx:TourPrimitiveElement; Child of Object gx:แอนิเมชันอัปเดต องค์ประกอบ gx:FlyTo; องค์ประกอบย่อยของ TourPrimitive องค์ประกอบ gx:SoundCue, องค์ประกอบย่อยของ TourPrimitive องค์ประกอบ gx:TourControl; องค์ประกอบย่อยของ gx:TourPrimitive gx:รอองค์ประกอบ ย่อยของ gx:TourPrimitive องค์ประกอบ gx:PlayList และออบเจ็กต์ย่อยของ Object

โปรดทราบว่าระบบจะไม่นําองค์ประกอบที่เป็นนามธรรม (แสดงในกล่องในแผนภาพ) ไปใช้ในไฟล์ KML องค์ประกอบนี้มีประโยชน์สําหรับองค์ประกอบเดียวในการทําหน้าที่เป็นรากฐานแบบเป็นโปรแกรมสําหรับองค์ประกอบที่ได้รับมาหลายรายการ (แต่แตกต่างกัน) การทําความเข้าใจลําดับชั้นตามออบเจ็กต์นี้ยังเป็นวิธีที่ดีในการเรียนรู้ KML เนื่องจากคุณจะเห็นการจัดกลุ่มองค์ประกอบที่เกี่ยวข้องได้โดยง่าย

องค์ประกอบทั้งหมดที่มาจาก Object สามารถมอบหมาย id ได้ รหัสนี้ใช้โดยกลไกการอัปเดต KML (ดู <Update>) สําหรับไฟล์ที่โหลดด้วย NetworkLink และใช้โดยรูปแบบที่แชร์ด้วย (ดู <Style>) id คือ รหัส XML มาตรฐาน

เนื่องจาก KML เป็นไวยากรณ์และรูปแบบไฟล์ XML ชื่อแท็กจะต้องคํานึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่ และต้องปรากฏตรงตามที่แสดงที่นี่ หากคุณคุ้นเคยกับ XML คุณจะเห็นสคีมา KML 2.2 ด้วย เมื่อคุณแก้ไขไฟล์ข้อความ KML คุณสามารถโหลดสคีมานี้ลงในเครื่องมือแก้ไข XML ใดก็ได้ และตรวจสอบโค้ด KML ร่วมกับไฟล์นั้น

เคล็ดลับ: การดู KML สําหรับฟีเจอร์ของ Google Earth

ฟีเจอร์ที่มีประโยชน์ของ Google Earth ช่วยให้ดูไฟล์ KML ของฟีเจอร์ได้อย่างง่ายดาย ใน Google Earth คุณสามารถคลิกขวาที่ฟีเจอร์ในแผงสถานที่แล้วคัดลอกฟีเจอร์ได้ หากต้องการดู KML ที่เกี่ยวข้องสําหรับออบเจ็กต์ที่คัดลอก ให้เปิดเครื่องมือแก้ไขข้อความที่ต้องการและวางตัวเลือกนั้น

ความเข้ากันได้

เวอร์ชัน KML มีระบบลําดับเลขคู่: majorVersion.minorVersion ทุกรุ่นที่มี majorVersion เดียวกันใช้งานร่วมกันได้ ดังนั้น หากคุณเปลี่ยนเนมสเปซเป็น "2.2" (ซึ่งก็คือ xmlns="http://www.opengis.net/kml/2.2") ไฟล์ KML 2.1 ทั้งหมดจะตรวจสอบความถูกต้องในสคีมา KML 2.2

เกี่ยวกับข้อมูลอ้างอิงนี้

ข้อมูลอ้างอิงแต่ละรายการประกอบด้วยส่วน "ไวยากรณ์" ที่แสดงองค์ประกอบที่อยู่ในองค์ประกอบหลัก ส่วนไวยากรณ์นี้เป็นข้อมูลที่ไม่เป็นทางการและใช้คําอธิบายสั้นๆ เพื่อสรุปองค์ประกอบ ส่วนนี้ยังประกอบด้วยข้อมูลต่อไปนี้

  • ค่าเริ่มต้นสําหรับแต่ละองค์ประกอบ (หรือจุดไข่ปลาหากเป็นองค์ประกอบที่ซับซ้อนหรือหากไม่มีค่าเริ่มต้น)
  • ประเภทของค่า (ดูช่อง KML)

คุณคัดลอกส่วนไวยากรณ์และใช้เป็นเทมเพลตสําหรับองค์ประกอบที่ไม่ใช่นามธรรมในไฟล์ KML ได้

เนมสเปซของส่วนขยาย KML และคํานําหน้า gx

มาตรฐาน KML ของ OGC มีกลไกสําหรับส่วนขยาย ซึ่งเป็นองค์ประกอบเพิ่มเติมที่มีข้อมูลนอกเหนือจากที่มีอยู่ในมาตรฐาน (ดูข้อมูลเพิ่มเติมเกี่ยวกับเนมสเปซ XML ที่ w3.org) ด้วยการเปิดตัว Google Earth 5.0 Google ได้ให้บริการส่วนขยายแก่ KML เพื่อรองรับฟีเจอร์ใหม่จํานวนมาก ส่วนขยายเหล่านี้ใช้คํานําหน้า gx และ URI ของเนมสเปซต่อไปนี้

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

ต้องเพิ่ม URI ของเนมสเปซนี้ลงในองค์ประกอบ <kml> ในไฟล์ KML ที่ใช้องค์ประกอบคํานําหน้า gx- ดังนี้

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

เบราว์เซอร์บางประเภทอาจไม่รองรับส่วนขยายไปยัง KML ในเบราว์เซอร์ทั้งหมด หากเบราว์เซอร์ไม่รองรับส่วนขยายบางรายการ ข้อมูลในส่วนขยายดังกล่าวควรจะถูกนําไปใช้อย่างเงียบๆ และไฟล์ KML ที่เหลือควรโหลดโดยไม่มีข้อผิดพลาด

องค์ประกอบที่ใช้คํานําหน้า gx มีดังนี้

สคีมา XML ที่สมบูรณ์สําหรับองค์ประกอบในเนมสเปซของส่วนขยายนี้มีอยู่ที่ http://developers.google.com/ KML/schema/chromebook22gx.xsd

ช่อง KML

KML ใช้ XML ประเภททั่วไป เช่น บูลีน สตริง คู่ ลอย และ int และยังกําหนดประเภทขององค์ประกอบฟิลด์ ตารางต่อไปนี้แสดงรายการประเภทที่ใช้กันโดยทั่วไปบางส่วนที่กําหนดไว้ใน KML และลิงก์ไปยังตัวอย่างองค์ประกอบที่ใช้

ประเภทช่อง ค่า ตัวอย่างการใช้งาน
ระดับความสูงในโหมด clampToGround, สัมพัทธ์กับพื้น, ค่าสัมบูรณ์ โปรดดู <LookAt> และ <Region>
มุม90 ค่า ≥≥90 และ ≤90 ดู<ละติจูด>ใน<โมเดล>
anglepos90 ค่า ≥0 และ ≤90 ดู <tilt> ใน <LookAt>
มุม 180 ค่า ≥≥180 และ ≤180 ดู<longitude>ใน<strong>
มุม 360 ค่า ≥≥360 และ ≤360 ดู <heading> ใน <Orientation>
สี ค่าเลขฐานสิบหก: aabbggrr ดูองค์ประกอบที่ขยาย <ColorStyle>
colorModeEnum ปกติ, สุ่ม ดูองค์ประกอบที่ขยาย <ColorStyle>
วันที่และเวลา dateTime, date, gYearMonth, gYear โปรดดู <TimeSpan> และ <TimeStamp>
รูปแบบโหมดดิสเพลย์ ค่าเริ่มต้น ซ่อน ดู <BalloonStyle>
gridOrigin ที่ด้านล่างซ้าย ด้านซ้ายบน ดู <PhotoOverlay>
RefreshModeEnum onChange, onInterval, onExpire ดู <Link>
รูปร่างของรูปร่าง สี่เหลี่ยมผืนผ้า ทรงกลม ทรงกลม ดู <PhotoOverlay>
styleStateEnum ปกติ ไฮไลต์ ดู <StyleMap>
unitsEnum เศษส่วน, พิกเซล, insetPixels ดู <hotSpot> ใน <IconStyle>, <ScreenOverlay>
vec2 x=double xunits=chromebook:unitsEnum
y=double yunits=chromebook:unitsEnum
ดู <hotSpot> ใน <IconStyle>,
<ScreenOverlay>
viewRefreshEnum ไม่เคย, 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:ตัวเลือกผู้ดู>
องค์ประกอบนี้จะเปิดใช้โหมดการดูพิเศษใน Google Earth 6.0 ขึ้นไป มีองค์ประกอบย่อย <gx:option> รายการอย่างน้อย 1 รายการ องค์ประกอบ <gx:option> มีแอตทริบิวต์ name และแอตทริบิวต์ enabled name ระบุข้อมูลใดรูปภาพหนึ่งต่อไปนี้ ได้แก่ ภาพ Street View ("Street View") ภาพในอดีต ("ข้อมูลย้อนหลัง") และเอฟเฟกต์แสงแดดในช่วงเวลาหนึ่งๆ ("แสงแดด") ระบบใช้แอตทริบิวต์ enabled เพื่อเปิดหรือปิดโหมดการดูที่ต้องการ
<gx:horizFov>
กําหนดช่องแนวนอนของมุมมอง AbstractView ระหว่างทัวร์ชม องค์ประกอบนี้ไม่มีผลต่อ AbstractViews นอกทัวร์ชม ไคลเอ็นต์ Google Earth (แทรกเวอร์ชัน 6.1 ขึ้นไป) จะแทรก <gx:horizFov> โดยอัตโนมัติระหว่างการบันทึกทัวร์ชม AbstractViews ปกติจะมีค่าเป็น 60 ส่วนมุมมองใน Street View จะมีค่า 85 เพื่อให้ตรงกับช่อง Street View มาตรฐานใน Google Earth เมื่อตั้งค่าแล้ว ระบบจะใช้ค่ากับข้อมูลพร็อพเพอร์ตี้ที่ตามมา จนกว่าจะมีการระบุค่าใหม่

ขยายโดย

<gx:a ในส่วนโหมด>

องค์ประกอบนี้เป็นส่วนขยายของมาตรฐาน OGC KML 2.2 และได้รับการรองรับใน Google Earth 5.0 ขึ้นไป ดูข้อมูลเพิ่มเติม

ไวยากรณ์

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

คำอธิบาย

สามารถใช้แทนองค์ประกอบ <altitudeMode> มาตรฐาน OGC KML และยอมรับค่าต่อไปนี้นอกเหนือจากค่า aheightMode มาตรฐาน:

  • relativeToSeaFloor - ตีความระดับความสูงเป็นค่าในหน่วยเมตรเหนือก้นทะเล หากฟีเจอร์ KML อยู่เหนือพื้นดินมากกว่าทะเล ระดับความสูงจะได้รับการตีความว่าอยู่เหนือพื้น
  • clampToSeaFloor - ระบบจะละเว้นข้อกําหนดระดับความสูง และฟีเจอร์ KML จะอยู่ในตําแหน่งพื้นทะเล หากฟีเจอร์ KML อยู่ที่พื้นดิน ไม่ใช่ทะเล clampToSeaFloor จะบีบกับพื้นแทน

เช่นเดียวกับ <altitudeMode>, <gx:altitudeMode> จะส่งผลต่อสิ่งต่อไปนี้

  • พิกัดระดับความสูงภายในองค์ประกอบ <coordinates>
  • <minAltitude> และ <maxAltitude> ภายใน <LatLonAltBox>
  • <altitude> ใน <Location>, <GroundOverlay> และ AbstractView (<LookAt> และ <Camera>)

ดูข้อมูลเพิ่มเติมเกี่ยวกับโหมดระดับความสูงได้ในบทโหมดระดับความสูงของคู่มือสําหรับนักพัฒนาซอฟต์แวร์ KML

ตัวอย่าง

a ในส่วนmode_reference.src

<?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> จะควบคุมการเปลี่ยนแปลงระหว่างการทัวร์ชมฟีเจอร์ KML โดยใช้ <Update> การเปลี่ยนแปลงเกี่ยวกับฟีเจอร์ KML จะไม่แก้ไข DOM กล่าวคือ การเปลี่ยนแปลงใดๆ จะถูกเปลี่ยนกลับเมื่อทัวร์ชมสิ้นสุดลง และไม่บันทึกลงใน KML เมื่อใดก็ได้

<gx:AnimatedUpdate> ควรมีค่า <gx:duration> เพื่อระบุระยะเวลาเป็นวินาทีในการอัปเดต ช่องจํานวนเต็ม แบบลอย และสีจะแสดงภาพเคลื่อนไหวจากค่าเดิมไปจนถึงค่าใหม่ได้อย่างราบรื่นตลอดระยะเวลา บูลีน สตริง และค่าอื่นๆ ที่ไม่ได้ให้ยืมไปยังการประมาณค่าจะอัปเดตเมื่อสิ้นสุดระยะเวลาสิ้นสุดลง

ดูข้อมูลเกี่ยวกับไทม์ไลน์ในทัวร์ในบททัวร์ของคู่มือสําหรับนักพัฒนาซอฟต์แวร์ KML เพื่อดูข้อมูลเกี่ยวกับ <gx:AnimatedUpdate> และลําดับเวลาทัวร์ชม

<gx:ระยะเวลา>
ระบุระยะเวลาเป็นวินาทีที่การอัปเดตเกิดขึ้น
<gx:delayedStart>
ระบุจํานวนวินาทีที่จะรอ (หลังจากตําแหน่งเริ่มต้นในหน้า) ก่อนเริ่มการอัปเดต

ตัวอย่าง

ตัวอย่างด้านล่างแสดงการเปลี่ยนแปลงของขนาดไอคอน การเปลี่ยนแปลงนี้จะเคลื่อนไหวเกิน 5 วินาที

ภาพเคลื่อนไหวการอัปเดต_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>

ขยาย

ประกอบด้วย

<บอลลูนสไตล์>

ไวยากรณ์

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

คำอธิบาย

ระบุวิธีวาดบอลลูนคําอธิบายสําหรับหมุด <bgColor> หากระบุ ระบบจะใช้เป็นสีพื้นหลังของบอลลูน ดู<ฟีเจอร์>สําหรับแผนภาพที่แสดงให้เห็นว่าบอลลูนคําอธิบายเริ่มต้นจะปรากฏใน Google Earth อย่างไร

องค์ประกอบเฉพาะสําหรับบอลลูนรูปแบบ

<bgColor>
สีพื้นหลังของบอลลูน (ไม่บังคับ) ค่าสีและความทึบแสง (อัลฟ่า) จะแสดงเป็นค่าฐานสิบหก ช่วงของค่าสีเดียวคือ 0 ถึง 255 (00 ถึง ff) ลําดับของนิพจน์คือ aabbggrr โดยที่ aa=alpha (00 ff) bb=blue (00 ff ); gg=green (00 ถึง ff); rr=red (00 ถึง ff) สําหรับอัลฟ่า 00 จะมีความโปร่งใสทั้งหมดและ ff จะทึบแสงทั้งหมด เช่น หากต้องการใช้สีน้ําเงินที่ความทึบแสง 50 เปอร์เซ็นต์กับการวางซ้อน ให้ระบุดังนี้ โดย <bgColor>7fff0000</bgColor> โดยที่ alpha=0x7f, blue=0xff, green=0x00 และ red=0x00 โดยค่าเริ่มต้นจะเป็นสีขาวทึบ (หรือ Transcribeff)

หมายเหตุ: เราเลิกใช้งานองค์ประกอบ <color> ภายใน <BalloonStyle> แล้ว ใช้ <bgColor> แทน

<ข้อความสี>
สีเบื้องหน้าสําหรับข้อความ ค่าเริ่มต้นคือสีดํา (ff000000)
<ข้อความ>
ข้อความที่แสดงในบอลลูน หากไม่ได้ระบุข้อความ Google Earth จะวาดบอลลูนเริ่มต้น (ที่มีฟีเจอร์ <name> เป็นตัวหนา ฟีเจอร์ <description> ลิงก์สําหรับเส้นทางการขับขี่ พื้นหลังสีขาว และหางที่แนบไปกับพิกัดของฟีเจอร์หากระบุ)
คุณเพิ่มเอนทิตีในแท็ก <text> ได้โดยใช้รูปแบบต่อไปนี้เพื่ออ้างถึงองค์ประกอบย่อยของฟีเจอร์: $[name], $[description], $[address], $[id], $[snippet] Google Earth จะดูในฟีเจอร์ปัจจุบันสําหรับเอนทิตีของสตริงที่เกี่ยวข้องและใช้แทนข้อมูลในบอลลูน หากต้องการรวมถึงที่นี่ - จากที่นี่เส้นทางการขับขี่ไว้ในบอลลูน ให้ใช้แท็ก $[geDirections] เพื่อป้องกันไม่ให้ลิงก์เส้นทางการขับขี่ปรากฏในบอลลูน ให้ใส่องค์ประกอบ <text> ด้วยเนื้อหาบางอย่าง หรือใส่ $[description] เพื่อแทนที่ฟีเจอร์พื้นฐาน <description>
ตัวอย่างเช่น ในช่อง KML ที่ตัดมาต่อไปนี้ $[name] และ $[description] จะแทนที่ด้วยช่อง <name> และ <description:
รูปแบบที่พบในช่องนี้
<displayMode>
หาก <displayMode> เป็นค่าเริ่มต้น Google Earth จะใช้ข้อมูลที่ให้ไว้ใน <text> เพื่อสร้างบอลลูน หาก <displayMode> เป็นซ่อน 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>

ขยาย

มีอยู่โดย

กลับไปด้านบน

<gx:แล้วแตะระดับการเข้าถึง>

องค์ประกอบนี้เป็นส่วนขยายของมาตรฐาน OGC KML 2.2 และได้รับการรองรับใน Google Earth 5.0 ขึ้นไป ดูข้อมูลเพิ่มเติม

ไวยากรณ์

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

คำอธิบาย

สลับระดับการเข้าถึงบอลลูนคําอธิบาย บอลลูนที่จะอัปเดตต้องระบุรหัส XML ของออบเจ็กต์ (เช่น <Placemark targetId="xxx">)

ตัวอย่าง

ตัวอย่างแรกแสดง <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">

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

ตัวอย่างที่ 2 แสดงการใช้ <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> 

คำอธิบาย

กําหนดกล้องเสมือนจริงที่มองเห็นฉาก องค์ประกอบนี้จะกําหนดตําแหน่งของกล้องเมื่อเทียบกับพื้นผิวโลกและทิศทางการดูของกล้อง ตําแหน่งของกล้องจะกําหนดโดย <longitude>, <ละติจูด>, <aระดับความสูง> และ <a ในส่วนMode> หรือ <gx:aระดับความสูงMode> ทิศทางการดูของกล้องจะกําหนดโดย <head>, <tilt> และ <roll> < Camera> อาจเป็นองค์ประกอบย่อยของฟีเจอร์ใดก็ได้ หรือของ <NetworkLinkControl> องค์ประกอบหลักต้องเหมือนกับ <NetworkLinkControl> องค์ประกอบหลักเป็น<a

< Camera> มอบการควบคุมแบบอิสระ 6 องศาเหนือมุมมอง ดังนั้นคุณจึงสามารถจัดตําแหน่งกล้องในอวกาศแล้วหมุนรอบแกน X, Y และ Z สิ่งสําคัญที่สุดคือ คุณสามารถเอียงมุมมองกล้องเพื่อให้คุณมองออกไปเหนือเส้นขอบฟ้า

<กล้อง>อาจมี TimePrimitive (<gx:TimeSpan> หรือ <gx:TimeStamp>) ค่าเวลาในกล้องถ่ายรูปมีผลต่อภาพในอดีต แสงแดด และการแสดงฟีเจอร์ที่ประทับเวลา อ่านข้อมูลเพิ่มเติมได้ที่เวลาด้วย AbstractViews ในบทเวลาและภาพเคลื่อนไหวของคู่มือสําหรับนักพัฒนาซอฟต์แวร์

การกําหนดมุมมอง

ในฟีเจอร์หรือ <NetworkLinkControl> ให้ใช้ออบเจ็กต์ < Camera> หรือออบเจ็กต์ <LookAt> (แต่ไม่ใช่ทั้ง 2 อย่างในออบเจ็กต์เดียวกัน) ออบเจ็กต์ <กล้อง> จะกําหนดมุมมองในแง่ของตําแหน่งและการวางแนวของผู้ชม วัตถุ <กล้องถ่ายรูป> ช่วยให้คุณระบุมุมมองที่ไม่ได้อยู่บนพื้นผิวโลกได้ ออบเจ็กต์ <LookAt> จะกําหนดมุมมองในแง่ของสิ่งที่ดู ออบเจ็กต์ <LookAt> มีการจํากัดขอบเขตมากกว่า < Camera> และโดยทั่วไปแล้ว ทิศทางการดูจะตัดกับพื้นผิวโลก

แผนภาพต่อไปนี้แสดงแกน X, Y และ Z ซึ่งแนบอยู่กับกล้องเสมือน

  • แกน X หันไปทางขวาของกล้อง แล้วเรียกว่าเวกเตอร์ขวา
  • แกน Y กําหนดทิศทาง "ขึ้น" ที่สัมพันธ์กับหน้าจอและเรียกว่าเวกเตอร์เวกเตอร์
  • แกน Z ชี้ไปยังจากกึ่งกลางของหน้าจอไปยังจุดดวงตา กล้องจะพิจารณาแกน ⁄Z ซึ่งเรียกว่าเวกเตอร์มุมมอง

ลําดับการเปลี่ยนแปลง

ลําดับการหมุนเวียนเป็นสิ่งสําคัญ โดยค่าเริ่มต้น กล้องจะมองตรงไปที่แกน ⁄Z ของโลก ก่อนการหมุน กล้องจะแปลตามแกน Z เป็น <aระดับความสูง> ลําดับของการเปลี่ยนเป็นดังนี้

  1. <altitude> - แปลตามแกน Z เป็น <aระดับความสูง>
  2. <heading> - หมุนรอบแกน Z
  3. <tilt> - หมุนรอบแกน X
  4. <roll> - หมุนรอบแกน Z (อีกครั้ง)

โปรดทราบว่าทุกครั้งที่มีการหมุน แกนกล้อง 2 แกนจะเปลี่ยนการวางแนว

องค์ประกอบที่เฉพาะเจาะจงสําหรับกล้อง

<ลองจิจูด>
ลองจิจูดของกล้องเสมือน (ดวงตา) ระยะทางในหน่วยองศาที่สัมพันธ์กับเส้นเมริเดียนแรก ค่าทางตะวันตกของเมริเดียนอยู่ในช่วง ‐180 ถึง 0 องศา ค่าทิศตะวันออกของเมริเดียนอยู่ในช่วง 0 ถึง 180 องศา
<ละติจูด>
ละติจูดของกล้องเสมือน องศาเหนือหรือใต้ของเส้นศูนย์สูตร (0 องศา) ค่าอยู่ในช่วง ‐90 องศาถึง 90 องศา
<ระดับความสูง>
ระยะทางของกล้องจากพื้นผิวโลก หน่วยเป็นเมตร ตีความตาม <a ในส่วนMode> หรือ <gx:a ในส่วนMode> ของกล้อง
<ส่วนหัว>
ทิศทาง (เส้นทาง) ของกล้อง หน่วยเป็นองศา Default=0 (ทิศเหนือจริง) (ดูแผนภาพ) ค่าอยู่ในช่วง 0 ถึง 360 องศา
<เอียง>
การหมุนเป็นองศาของกล้องรอบแกน X ค่า 0 บ่งบอกว่ายอดดูพุ่งเป้าไปที่โลก (กรณีที่พบบ่อยที่สุด) ค่า 90 สําหรับ <tilt> ระบุว่าการดูได้รับการกําหนดเป้าหมายในแนวนอน ค่าที่มากกว่า 90 จะบ่งบอกว่ามุมมองชี้ขึ้นไปยังท้องฟ้า ค่า <tilt> จะถูกบีบที่ +180 องศา
<โฆษณาตอนต้น>
การหมุนของกล้องรอบแกน Z มีหน่วยเป็นองศา ค่าอยู่ในช่วง ‐180 ถึง +180 องศา
<a ในส่วนโหมด>
ระบุวิธีตีความ<aได้อย่างรวดเร็ว>สําหรับกล้อง โดยค่าที่เป็นไปได้มีดังนี้
  • relativeToGround - (ค่าเริ่มต้น) ตีความ<aระดับความสูง>เป็นค่าในหน่วยเมตรเหนือพื้นดิน หากจุดเหนือน้ํา ระบบจะตีความ <aระดับความสูง> เป็นค่าในหน่วยเมตรเหนือระดับน้ําทะเล โปรดดู <gx:a ในส่วนMode> ด้านล่างเพื่อระบุจุดที่เกี่ยวข้องกับก้นทะเล
  • clampToGround - สําหรับกล้อง การตั้งค่านี้จะวางกล้อง relativeToGround ไว้ด้วย เนื่องจากการตั้งค่ากล้องให้อยู่ที่ความสูงของภูมิประเทศทุกประการจะทําให้ดวงตาตัดกันระหว่างภูมิประเทศ (และมุมมองจะถูกบล็อก)
  • สัมบูรณ์ - ตีความ<a>>เป็นค่าในหน่วยเมตรเหนือระดับน้ําทะเล
<gx:a ในส่วนโหมด>
ส่วนขยาย KML ในเนมสเปซของส่วนขยาย Google ซึ่งช่วยให้ระดับความสูงที่เกี่ยวข้องกับก้นทะเล ค่าต่างๆ มีดังนี้
  • relativeToSeaFloor - ตีความ<aระดับความสูง>เป็นค่าในหน่วยเมตรเหนือก้นทะเล หากจุดเหนือพื้นดินแทนที่จะเป็นทะเล จะตีความค่า <aระดับความสูง> ว่าอยู่เหนือพื้น
  • clampToSeaFloor - ละเว้นข้อกําหนด <aระดับความสูง> และกล้องจะอยู่ในตําแหน่งพื้นทะเล หากตําแหน่งบนพื้นดินไม่ใช่ทางทะเล กล้องจะวางตําแหน่งบนพื้น

ขยาย

มีอยู่โดย

กลับไปด้านบน

<StyleStyle>

ไวยากรณ์

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

<color>
ค่าสีและความทึบแสง (อัลฟ่า) จะแสดงเป็นค่าฐานสิบหก ช่วงของค่าสีหนึ่งคือ 0 ถึง 255 (00 ถึง ff) สําหรับอัลฟ่า 00 จะมีความโปร่งใสทั้งหมดและ ff จะทึบแสงทั้งหมด ลําดับของนิพจน์คือ aabbggrr โดยที่ aa=alpha (00 ถึง ff); bb=blue (00 ถึง ff); gg=green (00 ถึง ff); rr=red (00 ถึง ff) เช่น หากต้องการใช้สีน้ําเงินที่ความทึบแสง 50 เปอร์เซ็นต์กับการวางซ้อน ให้ระบุสิ่งต่อไปนี้ โดย <color>7fff0000</color> โดย alpha=0x7f, blue=0xff, green=0x00 และ red=0x00
<colorMode>
ค่าสําหรับ <colorMode> เป็นปกติ (ไม่มีผล) และสุ่ม ค่าของ random จะใช้สเกลเชิงเส้นแบบสุ่มกับฐาน <color> ดังนี้
  • หากต้องการเติมสีแบบสุ่มจริงๆ ให้ระบุฐาน <color> เป็นสีขาว (dfff)
  • หากคุณระบุคอมโพเนนต์สีเดียว (เช่น ค่า ff0000ff สําหรับ red) ระบบจะเลือกค่าสีแบบสุ่มสําหรับคอมโพเนนต์นั้น (สีแดง) ในกรณีนี้ ค่าจะอยู่ระหว่าง 00 (สีดํา) ถึง ff (สีแดงเต็ม)
  • หากคุณระบุค่าสําหรับส่วนประกอบสี 2 ส่วนหรือทั้ง 3 องค์ประกอบ จะมีการใช้สเกลเชิงเส้นแบบสุ่มกับคอมโพเนนต์สีแต่ละรายการ โดยผลลัพธ์มีตั้งแต่สีดําไปจนถึงค่าสูงสุดที่ระบุไว้สําหรับแต่ละคอมโพเนนต์
  • ความทึบแสงของสีมาจากคอมโพเนนต์อัลฟ่าของ <color> และจะไม่มีการสุ่ม

ขยาย

ขยายโดย

กลับไปด้านบน

<คอนเทนเนอร์>

ไวยากรณ์

<!-- 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 ได้โดยตรง องค์ประกอบคอนเทนเนอร์จะมีฟีเจอร์อย่างน้อย 1 รายการ และอนุญาตให้สร้างลําดับชั้นที่ซ้อนกันอยู่

ขยาย

ขยายโดย

กลับไปด้านบน

<เอกสาร>

ไวยากรณ์

<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. ภายในฟีเจอร์หรือ StyleMaps ที่ระบุ ให้อ้างอิงรหัสของสไตล์โดยใช้องค์ประกอบ <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 ที่ได้มาจาก<ฟีเจอร์>
  • องค์ประกอบอย่างน้อย 0 ที่ได้มาจาก <StyleSelector>
  • องค์ประกอบอย่างน้อย 0 ที่มาจาก <Schema>

กลับไปด้านบน

<gx:duration>

องค์ประกอบนี้เป็นส่วนขยายของมาตรฐาน OGC KML 2.2 และได้รับการรองรับใน Google Earth 5.0 ขึ้นไป ดูข้อมูลเพิ่มเติม

ไวยากรณ์

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

คำอธิบาย

<gx:duration> ขยายเวลา gx:TourPrimitive ด้วยการระบุช่วงเวลาสําหรับกิจกรรม ระบบจะเขียนเวลาเป็นวินาทีโดยใช้ประเภทข้อมูลคู่ของ XML

ระยะเวลาและ <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>

คำอธิบาย

องค์ประกอบ ExtendedData มี 3 เทคนิคในการเพิ่มข้อมูลที่กําหนดเองไปยังฟีเจอร์ KML (NetworkLink, Placemark, GroundOverlay, PhotoOverlay, ScreenOverlay, Docs, Folder) เทคนิคเหล่านี้

  • การเพิ่มคู่ข้อมูล/ค่าที่ไม่ได้พิมพ์โดยใช้องค์ประกอบ <Data> (พื้นฐาน)
  • การประกาศช่องที่พิมพ์ใหม่โดยใช้องค์ประกอบ <Schema> แล้วแทนค่าโดยใช้องค์ประกอบ <SchemaData> (ขั้นสูง)
  • โปรดดูองค์ประกอบ XML ที่กําหนดไว้ในเนมสเปซอื่นๆ โดยการอ้างอิงเนมสเปซภายนอกในไฟล์ KML (พื้นฐาน)

คุณรวมเทคนิคเหล่านี้ไว้ในไฟล์ KML เดียวหรือฟีเจอร์สําหรับข้อมูลที่แตกต่างกันได้

ดูข้อมูลเพิ่มเติมได้ที่การเพิ่มข้อมูลที่กําหนดเองใน "หัวข้อใน KML"

องค์ประกอบที่เฉพาะเจาะจงสําหรับ ExtendedData

<ชื่อข้อมูล ="สตริง">
สร้างคู่ชื่อ/ค่าที่ไม่ได้พิมพ์ ชื่อมีได้ 2 เวอร์ชัน ได้แก่ name และ displayName แอตทริบิวต์ name ใช้เพื่อระบุคู่ข้อมูลภายในไฟล์ KML ระบบจะใช้องค์ประกอบ displayName เมื่อชื่อที่มีการจัดรูปแบบอย่างถูกต้อง โดยมีการเว้นวรรคและการจัดรูปแบบ HTML แสดงใน Google Earth ในองค์ประกอบ <text> ของ <BalloonStyle> เครื่องหมาย $[name/displayName] จะแทนที่ด้วย <displayName> หากคุณแทนค่าแอตทริบิวต์ name ขององค์ประกอบ <Data> ในรูปแบบนี้ (เช่น $[holeYardage] ค่าแอตทริบิวต์จะแทนที่ด้วย <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>
<SchemaDataSchemaUrl="anyURI">
องค์ประกอบนี้ใช้ร่วมกับ <Schema> เพื่อเพิ่มข้อมูลที่กําหนดเองซึ่งพิมพ์ไปยังฟีเจอร์ KML องค์ประกอบสคีมา (ระบุโดยแอตทริบิวต์ schemaUrl) ประกาศประเภทข้อมูลที่กําหนดเอง ออบเจ็กต์ข้อมูลจริง ("อินสแตนซ์" ของข้อมูลที่กําหนดเอง) กําหนดโดยใช้องค์ประกอบ SchemaData
<schemaURL> อาจเป็น URL แบบเต็ม การอ้างอิงไปยังรหัสสคีมาที่ระบุไว้ในไฟล์ KML ภายนอก หรือการอ้างอิงถึงรหัสสคีมาที่ระบุไว้ในไฟล์ KML เดียวกัน การใช้งานเป็นไปตามข้อกําหนดต่อไปนี้ทั้งหมด
schemaUrl="http://host.com/PlacesIHaveLived.kml#my-schema-id"
schemaUrl="AnotherFile.kml#my-schema-id"
schemaUrl="#schema-id"   <!-- same file -->
องค์ประกอบสคีมาเป็นองค์ประกอบย่อยของเอกสารเสมอ องค์ประกอบ ExtendedData เป็นองค์ประกอบย่อยของฟีเจอร์ที่มีข้อมูลที่กําหนดเอง
<SimpleData name="string">
องค์ประกอบนี้จะกําหนดค่าให้กับช่องข้อมูลที่กําหนดเองซึ่งแอตทริบิวต์ name ระบุไว้ ประเภทและชื่อของช่องข้อมูลที่กําหนดเองนี้จะประกาศในองค์ประกอบ <Schema>
ตัวอย่างการกําหนดองค์ประกอบข้อมูลที่กําหนดเอง 2 รายการมีดังนี้
<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> ของไฟล์ หรือเป็นแอตทริบิวต์ขององค์ประกอบ <ExtendedData> และใส่คํานําหน้าชื่อองค์ประกอบข้อมูลแต่ละรายการด้วยคํานําหน้าเนมสเปซ ระบบจะเก็บรักษาข้อมูลที่กําหนดเองในลักษณะนี้ไว้ในไฟล์ KML แต่ Google Earth จะไม่ใช้ข้อมูลดังกล่าวแต่อย่างใด ระบบจะบันทึกรหัสผ่านพร้อมกับไฟล์เสมอ
ตัวอย่างต่อไปนี้แสดงการใช้คํานําหน้าเนมสเปซ "ค่าย"
<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 อย่างไร

องค์ประกอบเฉพาะสําหรับฟีเจอร์

<ชื่อ>
ข้อความที่ผู้ใช้กําหนดในมุมมอง 3 มิติเป็นป้ายกํากับของออบเจ็กต์ (เช่น สําหรับหมุด โฟลเดอร์ หรือ NetworkLink)
<ระดับการเข้าถึง>
ค่าบูลีน ระบุว่าจะวาดฟีเจอร์ในมุมมอง 3 มิติหรือไม่เมื่อโหลดครั้งแรก หากต้องการให้แสดงฟีเจอร์ได้ จะต้องตั้งค่าแท็ก <visible> ของระดับบนทั้งหมด เป็น 1 ในมุมมองรายการของ Google Earth แต่ละฟีเจอร์จะมีช่องทําเครื่องหมายที่อนุญาตให้ผู้ใช้ควบคุมระดับการเข้าถึงฟีเจอร์
<เปิด>
ค่าบูลีน ระบุว่าเอกสารหรือโฟลเดอร์จะปรากฏว่าปิดหรือเปิดขึ้นเมื่อโหลดในแผงสถานที่เป็นครั้งแรกหรือไม่ 0=ยุบ (ค่าเริ่มต้น), 1=ขยาย นอกจากนี้ โปรดดู <ListStyle> องค์ประกอบนี้ใช้กับเอกสาร โฟลเดอร์ และ NetworkLink เท่านั้น
<atom:author>

KML 2.2 รองรับองค์ประกอบใหม่ๆ สําหรับการเพิ่มข้อมูลเกี่ยวกับผู้เขียนและเว็บไซต์ที่เกี่ยวข้องในไฟล์ KML ข้อมูลนี้จะปรากฏในผลการค้นหาทางภูมิศาสตร์ ทั้งในเบราว์เซอร์ Earth เช่น Google Earth และในแอปพลิเคชันอื่นๆ เช่น Google Maps องค์ประกอบสคริปต์ที่ใช้ใน KML มีดังนี้

  • องค์ประกอบ atom:author - องค์ประกอบระดับบนสําหรับ atom:name
  • atom:name - ชื่อผู้เขียน
  • องค์ประกอบ atom:link - มีแอตทริบิวต์ href
  • แอตทริบิวต์ href - URL ของหน้าเว็บที่มีไฟล์ KML/KMZ

องค์ประกอบเหล่านี้อยู่ในรูปแบบ Atom Syndication ดูข้อกําหนดที่สมบูรณ์ได้ที่ http://atompub.org (ดูตัวอย่างที่ตามมา)

องค์ประกอบ <atom:author> เป็นองค์ประกอบหลักของ <atom:name> ซึ่งระบุผู้เขียนฟีเจอร์ KML

<atom:link href="..." >
ระบุ URL ของเว็บไซต์ที่มีไฟล์ KML หรือ KMZ นี้ อย่าลืมใส่เนมสเปซสําหรับองค์ประกอบนี้ในไฟล์ KML ใดๆ ที่ใช้องค์ประกอบดังกล่าว xmlns:atom="http://www.w3.org/2005/Atom" (ดูตัวอย่างที่ตามมา)
<ที่อยู่>
ค่าสตริงซึ่งแสดงที่อยู่ที่ไม่มีโครงสร้างซึ่งเขียนเป็นถนนมาตรฐาน เมือง ที่อยู่รัฐ และ/หรือรหัสไปรษณีย์ คุณใช้แท็ก <address> เพื่อระบุตําแหน่งของจุดแทนการใช้พิกัดละติจูดและลองจิจูดได้ (อย่างไรก็ตาม หากระบุ <Point> ลําดับความสําคัญจะอยู่เหนือ <address>) หากต้องการดูภาษาที่รองรับแท็กนี้ใน Google Earth โปรดไปที่ความช่วยเหลือของ Google Maps
<xal:AddressDetails>
ที่อยู่ที่มีโครงสร้างซึ่งจัดรูปแบบเป็น xAL หรือภาษาที่อยู่แบบ eXtensible ซึ่งเป็นมาตรฐานสากลสําหรับการจัดรูปแบบที่อยู่ KML จะใช้ <xal:AddressDetails> สําหรับการเข้ารหัสภูมิศาสตร์ใน 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 คําอธิบายนี้จะแสดงในแผงสถานที่ใต้ชื่อสถานที่ หากไม่ได้ระบุข้อมูลโค้ด ระบบจะใช้ 2 บรรทัดแรกของ <description> ใน Google Earth หากหมุดมีทั้งคําอธิบายและตัวอย่าง <ตัวอย่างข้อมูล>จะปรากฏใต้หมุดในแผงสถานที่ และ <description> จะปรากฏในบอลลูนคําอธิบายของหมุด แท็กนี้ไม่รองรับมาร์กอัป HTML <snippet> มีแอตทริบิวต์ maxLines จํานวนเต็มที่ระบุจํานวนบรรทัดสูงสุดที่จะแสดง
คําอธิบาย

เนื้อหาที่ผู้ใช้สร้างขึ้นที่ปรากฏในบอลลูนคําอธิบาย

เนื้อหาที่รองรับสําหรับองค์ประกอบ <description> เปลี่ยนจาก Google Earth 4.3 เป็น 5.0 ข้อมูลที่เฉพาะเจาะจงของแต่ละเวอร์ชันจะแสดงอยู่ด้านล่าง ตามด้วยข้อมูลทั่วไปสําหรับทั้ง 2 รูปแบบ

Google Earth 5.0

Google Earth 5.0 (และใหม่กว่า) รองรับเนื้อหาข้อความธรรมดา รวมถึง HTML และ JavaScript แบบเต็มภายในบอลลูนคําอธิบาย เนื้อหาแท็กคําอธิบายจะแสดงผลโดยเครื่องมือเว็บเบราว์เซอร์โอเพนซอร์ส WebKit และแสดงผลตามที่ควรจะเป็นในเบราว์เซอร์ที่ใช้ WebKit

ข้อจํากัดทั่วไป

โดยทั่วไป ไม่อนุญาตให้มีลิงก์ไปยังไฟล์ในเครื่อง วิธีนี้จะช่วยป้องกันไม่ให้โค้ดที่เป็นอันตรายสร้างความเสียหายให้กับระบบหรือเข้าถึงข้อมูลของคุณ หากต้องการอนุญาตให้เข้าถึงระบบไฟล์ในเครื่อง ให้เลือกค่ากําหนด > อนุญาตให้เข้าถึงไฟล์ในเครื่องและข้อมูลส่วนตัว ระบบจะอนุญาตลิงก์ไปยังไฟล์ภาพในระบบไฟล์ในเครื่องเสมอ หากอยู่ในแท็ก <img>

เนื้อหาที่บีบอัดเป็นไฟล์ KMZ ได้แม้ว่าจะอยู่ในระบบไฟล์ในเครื่องก็ตาม

เปิดใช้คุกกี้ แต่สําหรับวัตถุประสงค์ของนโยบายต้นทางเดียวกัน เนื้อหาในเครื่องจะไม่แชร์โดเมนกับเนื้อหาอื่นใด (รวมถึงเนื้อหาอื่นในเครื่อง)

HTML

HTML จะแสดงผลเป็นส่วนใหญ่เหมือนกับในเบราว์เซอร์ WebKit ใดก็ได้

ระบบจะไม่สนใจเป้าหมายเมื่อรวมอยู่ใน HTML ที่เขียนไว้ใน KML โดยตรง ส่วนลิงก์ดังกล่าวทั้งหมดจะเปิดขึ้นเสมือนว่ากําหนดเป้าหมายเป็น _blank ระบบจะไม่สนใจเป้าหมายที่ระบุ

อย่างไรก็ตาม HTML ที่อยู่ใน iframe หรือสร้างขึ้นแบบไดนามิกด้วย JavaScript หรือ DHTML จะใช้ target="_self" เป็นค่าเริ่มต้น ระบุเป้าหมายอื่นๆ ได้และรองรับ

เนื้อหาของไฟล์ KMZ, ลิงก์ Anchor ในเครื่อง และวิธี ;flyto จะไม่สามารถกําหนดเป้าหมายจาก HTML ที่อยู่ใน iframe ได้

หากผู้ใช้ระบุ width="100%" สําหรับความกว้างของ iframe ความกว้างของ iframe จะขึ้นอยู่กับเนื้อหาอื่นๆ ทั้งหมดในบอลลูน ซึ่งโดยหลักแล้วควรจะละเว้นขณะคํานวณขนาดเลย์เอาต์ กฎนี้ยังใช้กับองค์ประกอบบล็อกอื่นๆ ภายในบอลลูนด้วยเช่นกัน

JavaScript

ไม่รองรับ JavaScript ส่วนใหญ่ สร้างกล่องโต้ตอบไม่ได้ - ฟังก์ชันต่างๆ เช่น Alert() และ Prompt() จะไม่แสดง แต่จะเขียนในคอนโซลระบบ เช่นเดียวกับข้อผิดพลาดและข้อยกเว้นอื่นๆ

CSS

CSS ได้รับอนุญาต CSS สามารถใช้ CSS เพื่อจัดรูปแบบข้อความ องค์ประกอบของหน้า และควบคุมขนาดและลักษณะที่ปรากฏของบอลลูนคําอธิบายได้เช่นเดียวกับ CSS ในเว็บเบราว์เซอร์ปกติ

Google Earth 4.3

องค์ประกอบ <description> รองรับข้อความธรรมดาและองค์ประกอบของการจัดรูปแบบ HTML ชุดย่อย ซึ่งรวมถึงตาราง (ดูตัวอย่าง KML ด้านล่าง) ไม่รองรับเทคโนโลยีบนเว็บอื่นๆ เช่น มาร์กอัปหน้าเว็บแบบไดนามิก (PHP, JSP, ASP), ภาษาสคริปต์ (VBScript, JavaScript) หรือภาษาของแอปพลิเคชัน (Java, Python) ใน Google Earth รุ่น 4.2 รองรับวิดีโอ (ดูตัวอย่างด้านล่าง)

ข้อมูลทั่วไป

หากคําอธิบายของคุณไม่มีมาร์กอัป HTML Google Earth จะพยายามจัดรูปแบบลิงก์ใหม่โดยแทนที่บรรทัดใหม่ด้วย <br> และรวม URL ด้วยแท็ก Anchor สตริง URL ที่ถูกต้องของ World Wide Web จะได้รับการแปลงเป็นไฮเปอร์ลิงก์ไปยัง URL นั้นโดยอัตโนมัติ (เช่น http://www.google.com) ดังนั้นคุณไม่จําเป็นต้องใส่ URL ล้อมรอบด้วยแท็ก <a href="http://.."></a> เพื่อให้ได้ลิงก์อย่างง่าย

เมื่อใช้ HTML เพื่อสร้างไฮเปอร์ลิงก์รอบๆ คําที่ระบุ หรือเมื่อรวมรูปภาพไว้ใน HTML คุณต้องใช้การอ้างอิงเอนทิตี HTML หรือองค์ประกอบ CDATA เพื่อซ่อนวงเล็บมุม เครื่องหมายอะพอสทรอ และสัญลักษณ์พิเศษอื่นๆ องค์ประกอบ CDATA จะบอกโปรแกรมแยกวิเคราะห์ XML ให้ละเว้นสัญลักษณ์พิเศษที่ใช้ในวงเล็บ องค์ประกอบนี้อยู่ในรูปแบบ

<![CDATA[
  special characters here
]]> 

หากไม่ต้องการใช้องค์ประกอบ CDATA คุณสามารถใช้การอ้างอิงเอนทิตีเพื่อแทนที่สัญลักษณ์พิเศษทั้งหมด

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

พฤติกรรมอื่นๆ ที่ระบุผ่านการใช้องค์ประกอบ <a>

KML รองรับการใช้แอตทริบิวต์ 2 รายการภายในองค์ประกอบ <a> ได้แก่ href และ type

องค์ประกอบ Anchor <a> มีแอตทริบิวต์ href ที่ระบุ URL

หาก href เป็นไฟล์ KML และมีนามสกุลไฟล์ . KML หรือ .kmz Google Earth จะโหลดไฟล์นั้นโดยตรงเมื่อผู้ใช้คลิกไฟล์นั้น หาก URL ลงท้ายด้วยส่วนขยายที่ Google Earth ไม่รู้จัก (เช่น .html) ระบบจะส่ง URL ไปยังเบราว์เซอร์

href อาจเป็น URL ส่วนย่อยได้ (เช่น URL ที่มีเครื่องหมาย # แล้วตามด้วยตัวระบุ KML) เมื่อผู้ใช้คลิกลิงก์ที่มี URL ส่วนย่อย โดยค่าเริ่มต้น เบราว์เซอร์จะไปที่ฟีเจอร์ซึ่งมีรหัสตรงกับส่วนย่อย หากฟีเจอร์มีองค์ประกอบ LookAt หรือกล้อง จะมีการดูฟีเจอร์จากมุมมองที่ระบุไว้

คุณระบุพฤติกรรมเพิ่มเติมได้โดยการต่อท้ายสตริง 1 ใน 3 สตริงต่อไปนี้

  • ;flyto (ค่าเริ่มต้น) - บินไปยังฟีเจอร์
  • ;บอลลูน - เปิดบอลลูนของฟีเจอร์แต่ไม่ได้บินไปยังฟีเจอร์ดังกล่าว
  • ;carouselFlyto - เปิดบอลลูนของฟีเจอร์และบินไปยังฟีเจอร์ดังกล่าว

ตัวอย่างเช่น โค้ดต่อไปนี้บ่งชี้ให้เปิดไฟล์ CraftsFairs.src บินไปที่หมุดซึ่งมีรหัสเป็น "Albuquerque" แล้วเปิดบอลลูน

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

ตัวอย่างเช่น URL ต่อไปนี้ใช้แอตทริบิวต์ 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>
URL ของ <Style> หรือ <StyleMap> ที่กําหนดไว้ในเอกสาร หากรูปแบบอยู่ในไฟล์เดียวกัน ให้ใช้การอ้างอิง # หากมีการกําหนดรูปแบบในไฟล์ภายนอก ให้ใช้ URL แบบเต็มพร้อมข้อมูลอ้างอิง # รายการ ตัวอย่าง
<styleUrl>#myIconStyleID</styleUrl>
<styleUrl>http://someserver.com/somestylefile.xml#restaurant</styleUrl>
<styleUrl>eateries.kml#my-lunch-spot</styleUrl>
<StyleSelector>
คุณกําหนดรูปแบบและ StyleMaps ได้อย่างน้อย 1 รายการเพื่อปรับแต่งลักษณะขององค์ประกอบที่มาจากฟีเจอร์หรือเรขาคณิตในหมุด (ดู <BalloonStyle>, <ListStyle>, <StyleSelector>, และสไตล์ที่มาจาก <ColorStyle>) รูปแบบที่กําหนดในฟีเจอร์เรียกว่า "รูปแบบอินไลน์" และใช้ได้กับฟีเจอร์ที่มีเท่านั้น รูปแบบที่กําหนดเป็นองค์ประกอบย่อยของ <Document> เรียกว่า "รูปแบบที่แชร์" สไตล์ที่แชร์จะต้องกําหนดรหัสไว้ รหัสนี้อ้างอิงโดยฟีเจอร์อย่างน้อย 1 รายการใน <เอกสาร> ในกรณีที่มีการกําหนดองค์ประกอบสไตล์ทั้งในรูปแบบที่ใช้ร่วมกันและในรูปแบบอินไลน์สําหรับฟีเจอร์ ซึ่งก็คือ โฟลเดอร์, GroundOverlay, NetworkLink, Placemark หรือ ScreenOverlay ซึ่งเป็นค่าของรูปแบบอินไลน์ของฟีเจอร์จะมีผลเหนือกว่าค่าของรูปแบบที่แชร์
<ภูมิภาค>
ฟีเจอร์และเรขาคณิตที่เชื่อมโยงกับภูมิภาคจะถูกวาดเฉพาะเมื่อภูมิภาคนั้นทํางานอยู่ โปรดดู<ภูมิภาค>
<ข้อมูลเมตา>
<ขยายข้อมูล>
ช่วยให้คุณเพิ่มข้อมูลที่กําหนดเองลงในไฟล์ KML ได้ ข้อมูลนี้อาจเป็น (1) ข้อมูลที่อ้างถึงสคีมา XML ภายนอก (2) คู่ข้อมูล/ค่าที่ไม่ได้พิมพ์ หรือ (3) ข้อมูลที่พิมพ์ ฟีเจอร์ KML หนึ่งๆ อาจมีข้อมูลที่กําหนดเองเหล่านี้ผสมกัน

ตัวอย่างการใช้องค์ประกอบ HTML ภายในคําอธิบาย

ตัวอย่างนี้แสดงชุดองค์ประกอบ HTML ทั้งหมดที่องค์ประกอบ <description> รองรับ ใน Google Earth 4.3 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> จากเนมสเปซ Atom โปรดทราบว่าคุณต้องอ้างอิงเนมสเปซนี้ภายในองค์ประกอบ < KML>

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

วิดีโอตัวอย่าง

ตัวอย่างนี้แสดงวิธีฝังวิดีโอ 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>

ขยาย

ขยายโดย

<gx:บิน>

องค์ประกอบนี้เป็นส่วนขยายของมาตรฐาน 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 1 รายการ และควรมีองค์ประกอบ <gx:duration> และ <gx:flyToMode> ซึ่งระบุเวลาที่ใช้บินไปยังจุดที่กําหนดจากจุดปัจจุบัน และวิธีบินตามลําดับ

<gx:flyToMode>

ค่าที่อนุญาตสําหรับ <gx:flyToMode> คือ smooth และ ตีกลับ

  • การไหลลื่น FlyTos ช่วยให้เที่ยวบินเสียจากจุดหนึ่งไปยังอีกจุดหนึ่งได้ (และเปิด) ชุด FlyTos ที่ราบรื่นและไม่เริ่มต้นจะเริ่มที่อัตราความเร็วเป็น 0 และจะไม่ช้าลงที่แต่ละจุด ชุด FlyTos ที่ราบรื่นจะแบ่งออกเป็นองค์ประกอบต่อไปนี้
    • <gx:flyToMode>bounce</gx:flyToMode>
    • <gx:Wait>
    ซึ่งหมายความว่าอัตราความเร็วจะอยู่ที่ 0 ที่ FlyTo ได้อย่างราบรื่นก่อนองค์ประกอบข้างต้น ชุด FlyTos ที่ราบรื่นไม่แบ่งด้วยองค์ประกอบ <gx:AnimatedUpdate>

  • ตีกลับ FlyTos แต่ละรายการเริ่มต้นและสิ้นสุดที่อัตราความเร็ว 0

ตัวอย่าง

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

ขยาย

ประกอบด้วย

<โฟลเดอร์>

ไวยากรณ์

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

คำอธิบาย

โฟลเดอร์ใช้ในการจัดเรียงฟีเจอร์อื่นๆ ตามลําดับชั้น (โฟลเดอร์ หมุด เครือข่ายลิงก์ หรือการวางซ้อน) ฟีเจอร์นี้จะปรากฏก็ต่อเมื่อปรากฏและบรรพบุรุษทั้งหมด

ตัวอย่าง

<?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 ได้โดยตรง ซึ่งจะมีออบเจ็กต์ตัวยึดตําแหน่งสําหรับออบเจ็กต์เรขาคณิตที่ได้รับทั้งหมด

ขยาย

ขยายโดย

<Groundโฆษณาซ้อนทับ>

ไวยากรณ์

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

คำอธิบาย

องค์ประกอบนี้วาดการวางซ้อนภาพที่จะตกลงบนภูมิประเทศ แท็กย่อย <href> ของ <Icon> จะระบุรูปภาพที่จะใช้เป็นการวางซ้อน ไฟล์นี้อาจเป็นได้ทั้งระบบไฟล์ในเครื่องหรือเว็บเซิร์ฟเวอร์ หากละเว้นองค์ประกอบนี้หรือมี <href> อยู่ สี่เหลี่ยมผืนผ้าจะถูกวาดโดยใช้สีและขอบเขต LatLonBox ที่กําหนดโดยการวางซ้อนพื้น

องค์ประกอบเฉพาะสําหรับ Groundโฆษณาซ้อนทับ

<ระดับความสูง>
ระบุระยะทางเหนือพื้นผิวโลก หน่วยเป็นเมตร และตีความตามโหมดระดับความสูง
<a ในส่วนโหมด>
ระบุวิธีตีความ<a ในส่วน> โดยค่าที่เป็นไปได้มีดังนี้
  • clampToGround - (ค่าเริ่มต้น) ระบุให้ละเว้นข้อกําหนดในการระดับความสูง และลากการวางซ้อนเหนือภูมิประเทศ
  • ค่าสัมบูรณ์ - ตั้งค่าระดับความสูงของส่วนที่ซ้อนทับกับระดับน้ําทะเล โดยไม่คํานึงถึงระดับความสูงจริงของภูมิประเทศที่อยู่ใต้องค์ประกอบ ตัวอย่างเช่น หากคุณตั้งระดับความสูงของการวางซ้อนเป็น 10 เมตรด้วยโหมดระดับความสูงสัมบูรณ์ โฆษณาซ้อนทับจะอยู่ที่ระดับพื้นดิน หากภูมิประเทศด้านล่างมีความสูงเหนือระดับน้ําทะเล 10 เมตรด้วย หากภูมิประเทศสูงกว่าระดับน้ําทะเล 3 เมตร โฆษณาซ้อนทับจะปรากฏเหนือภูมิประเทศสูงขึ้น 7 เมตร
<gx:a ในส่วนโหมด>
ส่วนขยาย KML ในเนมสเปซของส่วนขยาย Google ซึ่งช่วยให้ระดับความสูงที่เกี่ยวข้องกับก้นทะเล ค่าต่างๆ มีดังนี้
  • relativeToSeaFloor - ตีความ<aระดับความสูง>เป็นค่าในหน่วยเมตรเหนือก้นทะเล หากจุดเหนือพื้นดินแทนที่จะเป็นทะเล จะตีความค่า <aระดับความสูง> ว่าอยู่เหนือพื้น
  • clampToSeaFloor - ระบบไม่สนใจข้อกําหนด <aระดับความสูง> และการซ้อนทับจะถูกวางเหนือพื้นทะเล หากตําแหน่งบนพื้นดิน ไม่ใช่ทะเล จะมีการวางซ้อนบนพื้น
<LTLonBox>
ระบุจุดที่อยู่ด้านบนสุด ด้านล่าง ขวา และซ้ายของกรอบที่วางซ้อนสําหรับการวางซ้อนบนพื้น
  • <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>
ที่อยู่ HTTP หรือข้อกําหนดไฟล์ในเครื่องที่ใช้เพื่อโหลดไอคอน
<gx:x>
และ
<gx:y>
หาก <href> ระบุชุดไอคอน องค์ประกอบเหล่านี้จะระบุออฟเซ็ตเป็นพิกเซลจากมุมซ้ายล่างของชุดไอคอน หากไม่ได้ระบุค่าไว้สําหรับ x และ y ระบบจะถือว่ามุมซ้ายของชุดไอคอนเป็นมุมซ้ายล่างของไอคอนที่จะใช้
<gx:w>
และ
<gx:h>
หาก <href> ระบุชุดไอคอน องค์ประกอบเหล่านี้จะระบุความกว้าง (<gx:w>) และความสูง (<gx:h>) เป็นพิกเซลของไอคอนที่จะใช้
<refreshMode>
สําหรับคําอธิบายของ <RefreshMode> และองค์ประกอบอื่นๆ ที่แสดงด้านล่าง โปรดดู <Link>
<refreshInterval>
<viewRefreshMode>
<viewRefreshTime>
<viewBoundScale>
<viewFormat>
<httpQuery>

มีอยู่โดย

<ไอคอน>

ไวยากรณ์

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

คำอธิบาย

ระบุวิธีวาดไอคอนสําหรับหมุดตําแหน่ง ทั้งในแผงสถานที่และในมุมมอง 3 มิติของ Google Earth องค์ประกอบ <Icon> ระบุรูปภาพไอคอน องค์ประกอบ <scale> ระบุการปรับขนาด x, y ของไอคอน สีที่ระบุในองค์ประกอบ <color> ของ <IconStyle> กลมกลืนไปกับสีของ <Icon>

องค์ประกอบที่เฉพาะเจาะจงสําหรับไอคอนลักษณะ

<สเกล>
ปรับขนาดไอคอน

หมายเหตุ: เราเลิกใช้งานแท็ก <geomScale> แล้ว ใช้ <scale> แทน

<ส่วนหัว>
ทิศทาง (ซึ่งก็คือ ทิศเหนือ ทิศใต้ ทิศตะวันออก ทิศตะวันตก) ในหน่วยองศา ค่าเริ่มต้น=0 (เหนือ) (ดูแผนภาพ) ค่าอยู่ในช่วง 0 ถึง 360 องศา
<ไอคอน>
ไอคอนที่กําหนดเอง ใน <IconStyle> องค์ประกอบย่อยของ <Icon> เพียงองค์ประกอบเดียวคือ <href>
  • <href>: ที่อยู่ HTTP หรือข้อกําหนดไฟล์ในเครื่องที่ใช้ในการโหลดไอคอน
<hotSpot x="0.5" y="0.5" xunits="fraction" yunits="fraction">
ระบุตําแหน่งภายในไอคอนที่ "ตรึงไว้" บน <Point> ที่ระบุในหมุด ค่า x และ y สามารถระบุได้ 3 วิธีดังนี้ พิกเซล ("pixels") เป็นเศษส่วนของไอคอน ("fraction") หรือเป็น Inset Pixel ("insetPixels") ซึ่งเป็นออฟเซ็ตของพิกเซลจากมุมขวาบนของไอคอน ตําแหน่ง x และ y สามารถระบุได้หลายวิธี เช่น x อาจเป็นพิกเซล และ y อาจเป็นเศษส่วน ต้นทางของระบบพิกัดจะอยู่ที่มุมล่างซ้ายของไอคอน
  • x - จํานวนพิกเซล คอมโพเนนต์ที่เป็นเศษส่วนของไอคอน หรือพิกเซลที่แทรกเข้ามา ซึ่งแสดงคอมโพเนนต์ x ของจุดบนไอคอน
  • y - จํานวนพิกเซล ส่วนประกอบที่เป็นเศษส่วนของไอคอน หรือหน่วยแทรกพิกเซลที่ระบุคอมโพเนนต์ y ของจุดบนไอคอน
  • xunits - หน่วยที่ระบุค่า x ค่าของ fraction บ่งชี้ว่าค่า x เป็นส่วนของไอคอน ค่า pixel ระบุค่า 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>

ขยาย

มีอยู่โดย

ประกอบด้วย

  • <href> ในฐานะบุตรหลานของ <Icon>

< KML>

ไวยากรณ์

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

คำอธิบาย

องค์ประกอบรูทของไฟล์ KML ต้องมีองค์ประกอบนี้ ซึ่งเป็นไปตามการประกาศ XML ที่ตอนต้นของไฟล์ แอตทริบิวต์คําสัญญาณจะใช้เป็นสัญญาณให้ Google Earth แสดงไฟล์เป็นข้อมูลท้องฟ้า

องค์ประกอบ <chromebook> อาจมีเนมสเปซสําหรับสคีมา XML ภายนอกที่อ้างอิงภายในไฟล์ด้วย

องค์ประกอบ < 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>

คำอธิบาย

ระบุวิธีวาด <name> ของฟีเจอร์ในมุมมอง 3 มิติ คุณระบุสี โหมดสี และการปรับขนาดที่กําหนดเองสําหรับป้ายกํากับ (ชื่อ) ได้

หมายเหตุ: แท็ก <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>

ขยาย

มีอยู่โดย

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

คำอธิบาย

อนุญาตการวางซ้อนพื้นรูปสี่เหลี่ยมผืนผ้าสี่เหลี่ยมผืนผ้า

ระบุพิกัดของมุมทั้ง 4 จุดของรูปสี่เหลี่ยมที่กําหนดพื้นที่ซ้อนทับ ต้องระบุพิกัด 4 รายการเท่านั้น โดยแต่ละรายการจะมีค่าทศนิยมสําหรับละติจูดและลองจิจูด แทรกช่องว่างระหว่างเครื่องหมายคู่ อย่าเว้นวรรคระหว่างบุคคล ต้องระบุพิกัดทวนเข็มนาฬิกา โดยพิกัดแรกจะสอดคล้องกับมุมซ้ายล่างของรูปภาพวางซ้อน รูปร่างที่อธิบายที่มุมเหล่านี้ต้องเป็นรูป Conv.

หากแทรกค่าที่ 3 ลงใน Tuple (แสดงถึงระดับความสูง) ระบบจะไม่สนใจค่านั้น ตั้งค่าระดับความสูงโดยใช้ <altitude> และ <altitudeMode> (หรือ <gx:altitudeMode>) ซึ่งขยาย <GroundOverlay> โหมดระดับความสูงที่อนุญาตคือ Absolute, 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>

ขยาย

มีอยู่

<เชิงเส้น>

ไวยากรณ์

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

คำอธิบาย

กําหนดสตริงเส้นปิด ซึ่งโดยปกติจะเป็นขอบเขตภายนอกของรูปหลายเหลี่ยม นอกจากนี้ คุณยังใช้เชิงเส้นเชิงเส้นเป็นขอบเขตภายในของรูปหลายเหลี่ยมเพื่อสร้างหลุมในรูปหลายเหลี่ยมได้ รูปหลายเหลี่ยมอาจมีองค์ประกอบ <เชิงเส้นRing> จํานวนมากที่ใช้เป็นขอบเขตภายใน

หมายเหตุ: ใน Google Earth รูป Polygon ที่มี <aระดับความสูงMode> เป็น clampToGround จะไปตามเส้นที่มีค่าคงที่อย่างต่อเนื่อง อย่างไรก็ตาม การเชิงเส้น (โดยใช้ตัวระบบเอง) ที่มี <aระดับความสูงMode> เป็น clampToGround จะไปตามเส้นวงกลมขนาดใหญ่

องค์ประกอบที่เฉพาะเจาะจงสําหรับเชิงเส้น

<gx:a ในส่วนออฟเซ็ต>
ส่วนขยาย KML ในเนมสเปซของส่วนขยาย Google ที่แก้ไขวิธีแสดงผลค่าระดับความสูง ออฟเซ็ตนี้ช่วยให้คุณย้ายการเชิงเส้นเชิงเส้นทั้งหมดขึ้นหรือลงเป็นหน่วยได้โดยไม่ต้องแก้ไขค่าพิกัดทีละรายการที่ประกอบขึ้นเป็นเชิงเส้น (แม้ว่าข้อความเชิงเส้นจะแสดงโดยใช้ค่าออฟเซ็ตที่ระดับความสูง แต่ค่าระดับความสูงเดิมจะยังคงอยู่ในไฟล์ KML) หน่วยเป็นเมตร
<ยกเว้น>
ค่าบูลีน ระบุว่าจะเชื่อมต่อเชิงเส้นเชิงเส้นกับพื้นหรือไม่ หากต้องการยกเว้นเรขาคณิตนี้ โหมดระดับความสูงต้องเป็น relativeToGround, relativeToSeaFloor หรือค่าสัมบูรณ์ เฉพาะจุดยอดของ เชิงเส้นRing จะถูกตัดออก ไม่ใช่จุดศูนย์กลางของเรขาคณิต จุดยอดมุมจะเกี่ยวโยงกับกึ่งกลางของลูกโลก
<tessellate>
ค่าบูลีน ระบุว่าจะอนุญาตการทําให้เชิงเส้นเป็นไปตามภูมิประเทศหรือไม่ หากต้องการเปิดใช้การเพิ่มยอดขาย ค่าของ <aระดับความสูงMode> ต้องเป็น clampToGround หรือ clampToSeaFloor VirtualRings ที่มีขนาดใหญ่มากควรทําให้พื้นที่การขายดีขึ้นได้เพื่อให้ติดตามความโค้งของโลกได้ (มิฉะนั้นอาจใต้ดินและซ่อนอยู่)
<a ในส่วนโหมด>
ระบุวิธีการตีความคอมโพเนนต์ระดับความสูงในองค์ประกอบ <พิกัด> โดยค่าที่เป็นไปได้มีดังนี้
  • clampToGround - (ค่าเริ่มต้น) ระบุว่าไม่สนใจข้อกําหนดระดับความสูง (เช่น ในแท็ก <พิกัด>)
  • relativeToGround - ตั้งค่าระดับความสูงขององค์ประกอบให้สัมพันธ์กับระดับความสูงของพื้นดินจริงของสถานที่หนึ่ง เช่น หากระดับความสูงของพื้นของสถานที่หนึ่งตรงกับระดับน้ําทะเลทุกประการ และระดับความสูงสําหรับจุดหนึ่งถูกตั้งไว้ที่ 9 เมตร ระดับความสูงของไอคอนระดับความสูงของหมุดจะอยู่ที่ 9 เมตรในโหมดนี้ แต่หากพิกัดเดียวกันรวมอยู่ในตําแหน่งที่มีระดับความสูงเหนือระดับน้ําทะเล 10 เมตร ระดับความสูงของพิกัดจะเท่ากับ 19 เมตร โหมดนี้มักจะใช้สําหรับวางเสาโทรศัพท์หรือลิฟต์สกี
  • ค่าสัมบูรณ์ - ตั้งค่าระดับความสูงของพิกัดที่สัมพันธ์กับระดับน้ําทะเล โดยไม่คํานึงถึงระดับความสูงจริงของภูมิประเทศใต้องค์ประกอบ เช่น หากตั้งค่าระดับความสูงของพิกัดเป็น 10 เมตรด้วยโหมดระดับความสูงสัมบูรณ์ ไอคอนของหมุดจุดจะอยู่ที่ระดับพื้นดิน หากภูมิประเทศด้านล่างมีความสูงเกิน 10 เมตรเหนือระดับน้ําทะเลด้วย หากภูมิประเทศสูงกว่าระดับน้ําทะเล 3 เมตร หมุดจะปรากฏขึ้นบนพื้นสูง 7 เมตร การใช้งานโหมดนี้โดยทั่วไปมีไว้สําหรับการแสดงเครื่องบิน
<gx:a ในส่วนโหมด>
ส่วนขยาย KML ในเนมสเปซของส่วนขยาย Google ซึ่งช่วยให้ระดับความสูงที่เกี่ยวข้องกับก้นทะเล ค่าต่างๆ มีดังนี้
  • relativeToSeaFloor - ตีความ<aระดับความสูง>เป็นค่าในหน่วยเมตรเหนือก้นทะเล หากจุดเหนือพื้นดินแทนที่จะเป็นทะเล จะตีความค่า <aระดับความสูง> ว่าอยู่เหนือพื้น
  • clampToSeaFloor - ละเว้นข้อกําหนด <aระดับความสูง> และจุดจะอยู่ในพื้นทะเล หากจุดบนพื้นดินไม่ใช่ทะเล จะมีจุดวางบนพื้น
<พิกัด>(ต้องระบุ)
4 ลูกหรือมากกว่า โดยแต่ละค่าประกอบด้วยค่าลอยตัวสําหรับลองจิจูด ละติจูด และระดับความสูง คอมโพเนนต์ระดับความสูงเป็นตัวเลือกที่ไม่บังคับ อย่าเว้นวรรคระหว่างบุคคล พิกัดสุดท้ายต้องเหมือนกับพิกัดแรก พิกัดจะแสดงเป็นองศาทศนิยมเท่านั้น

ตัวอย่าง

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

ขยาย

มีอยู่โดย

<บรรทัด>

ไวยากรณ์

<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> เพื่อระบุสี โหมดสี และความกว้างของเส้น เมื่อเส้นตรงถูกยกสูง เส้นนั้นจะขยายไปถึงพื้น ทําให้เกิดรูปหลายเหลี่ยมที่ดูเหมือนผนังหรือรั้ว สําหรับ LineStrings ที่ยื่นเข้ามา เส้นเองจะใช้ LineStyle ปัจจุบัน และการผลักใช้ PolyStyle ปัจจุบัน ดูบทแนะนํา KML เพื่อดูตัวอย่าง LineString (หรือเส้นทาง)

องค์ประกอบที่เฉพาะเจาะจงสําหรับ LineString

<gx:a ในส่วนออฟเซ็ต>
ส่วนขยาย KML ในเนมสเปซของส่วนขยาย Google ที่แก้ไขวิธีแสดงผลค่าระดับความสูง ออฟเซ็ตนี้ช่วยให้คุณย้าย LineString ทั้งหมดขึ้นหรือลงเป็นหน่วยได้โดยไม่ต้องแก้ไขค่าพิกัดส่วนที่รวมกันเป็น LineString ทั้งหมด (แม้ว่าบรรทัดจะแสดงโดยใช้ค่าออฟเซ็ตระดับความสูง แต่ค่าระดับความสูงเดิมจะยังคงอยู่ในไฟล์ KML) หน่วยเป็นเมตร
<ยกเว้น>
ค่าบูลีน ระบุว่าจะเชื่อมต่อ LineString กับพื้นหรือไม่ หากต้องการยกเว้น LineString โหมดระดับความสูงต้องเป็น relativeToGround, relativeToSeaFloor หรือค่าสัมบูรณ์ ส่วนยอดมุมใน LineString จะขุดออกตรงกลางของลูกโลก
<tessellate>
ค่าบูลีน ระบุว่าจะอนุญาตให้ LineString ติดตามภูมิประเทศหรือไม่ หากต้องการเปิดใช้การเพิ่มยอดขาย โหมดระดับความสูงต้องเป็น clampToGround หรือ clampToSeaFloor LineStrings ขนาดใหญ่มากควรทําให้เป็นที่ยอมรับเพื่อให้เป็นไปตามความโค้งของโลก (มิฉะนั้นอาจใต้ดินและซ่อนไป)
<a ในส่วนโหมด>
ระบุวิธีการตีความคอมโพเนนต์ระดับความสูงในองค์ประกอบ <พิกัด> โดยค่าที่เป็นไปได้มีดังนี้
  • clampToGround - (ค่าเริ่มต้น) ระบุว่าไม่สนใจข้อกําหนดระดับความสูง (เช่น ในแท็ก <พิกัด>)
  • relativeToGround - ตั้งค่าระดับความสูงขององค์ประกอบให้สัมพันธ์กับระดับความสูงของพื้นดินจริงของสถานที่หนึ่ง เช่น หากระดับความสูงของพื้นของสถานที่หนึ่งตรงกับระดับน้ําทะเลทุกประการ และระดับความสูงสําหรับจุดหนึ่งถูกตั้งไว้ที่ 9 เมตร ระดับความสูงของไอคอนระดับความสูงของหมุดจะอยู่ที่ 9 เมตรในโหมดนี้ แต่หากพิกัดเดียวกันรวมอยู่ในตําแหน่งที่มีระดับความสูงเหนือระดับน้ําทะเล 10 เมตร ระดับความสูงของพิกัดจะเท่ากับ 19 เมตร โหมดนี้มักจะใช้สําหรับวางเสาโทรศัพท์หรือลิฟต์สกี
  • ค่าสัมบูรณ์ - ตั้งค่าระดับความสูงของพิกัดที่สัมพันธ์กับระดับน้ําทะเล โดยไม่คํานึงถึงระดับความสูงจริงของภูมิประเทศใต้องค์ประกอบ เช่น หากตั้งค่าระดับความสูงของพิกัดเป็น 10 เมตรด้วยโหมดระดับความสูงสัมบูรณ์ ไอคอนของหมุดจุดจะอยู่ที่ระดับพื้นดิน หากภูมิประเทศด้านล่างมีความสูงเกิน 10 เมตรเหนือระดับน้ําทะเลด้วย หากภูมิประเทศสูงกว่าระดับน้ําทะเล 3 เมตร หมุดจะปรากฏขึ้นบนพื้นสูง 7 เมตร การใช้งานโหมดนี้โดยทั่วไปมีไว้สําหรับการแสดงเครื่องบิน
<gx:a ในส่วนโหมด>
ส่วนขยาย KML ในเนมสเปซของส่วนขยาย Google ซึ่งอนุญาตระดับความสูงที่เกี่ยวข้องกับก้นทะเล ค่าต่างๆ มีดังนี้
  • relativeToSeaFloor - ตีความ<aระดับความสูง>เป็นค่าในหน่วยเมตรเหนือก้นทะเล หากจุดเหนือพื้นดินแทนที่จะเป็นทะเล จะตีความค่า <aระดับความสูง> ว่าอยู่เหนือพื้น
  • clampToSeaFloor - ละเว้นข้อกําหนด <aระดับความสูง> และจุดจะอยู่ในพื้นทะเล หากจุดบนพื้นดินไม่ใช่ทะเล จะมีจุดวางบนพื้น
<gx:DrawOrder>
ค่าจํานวนเต็มที่ระบุลําดับการวาดสตริงหลายบรรทัด LineStrings ที่วาดก่อนอาจถูกบดบังบางส่วนหรือทั้งหมดโดย LineStrings ที่มีลําดับการวาดภายหลัง องค์ประกอบนี้อาจต้องใช้ร่วมกับองค์ประกอบ <gx:outerColor> และ <gx:outerWidth> ใน <LineStyle> เมื่อเส้นสีคู่ตัดกัน
<พิกัด>(ต้องระบุ)
พิกัด 2 รายการขึ้นไป แต่ละค่าประกอบด้วยจุดลอยตัวสําหรับลองจิจูด ละติจูด และระดับความสูง คอมโพเนนต์ระดับความสูงเป็นตัวเลือกที่ไม่บังคับ แทรกช่องว่างระหว่างเครื่องหมายคู่ อย่าเว้นวรรคระหว่างบุคคล

ตัวอย่าง

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

<width>
ความกว้างของเส้น หน่วยเป็นพิกเซล
<gx:outerColor>
สีของส่วนเส้นที่กําหนดโดย <gx:outerWidth> โปรดทราบว่าระบบจะไม่สนใจองค์ประกอบ <gx:outerColor> และ <gx:outerWidth> เมื่อใช้ <LineStyle> กับ <Polygon> และ <เชิงเส้นRing>
<gx:outerWidth>
ค่าระหว่าง 0.0 ถึง 1.0 ที่ระบุอัตราส่วนของบรรทัดที่ใช้ <gx:outerColor> ใช้ได้เฉพาะกับความกว้างของการตั้งค่าบรรทัดที่ใช้ <gx:physicalWidth> แต่ไม่ใช้กับบรรทัดที่ใช้ <width> ดู <gx:drawOrder> เพิ่มเติมใน <LineString> ค่าลําดับการวาดอาจจําเป็นหากเส้นแบบคู่สีข้ามกัน เช่น เพื่อแสดงการเปลี่ยนฟรีเวย์
<gx:PhysicalalWidth>
ความกว้างทางกายภาพของเส้น หน่วยเป็นเมตร
<gx:labelVisibility>
บูลีนกําหนดว่าจะให้แสดงป้ายกํากับข้อความใน LineString หรือไม่ ป้ายกํากับของ LineString อยู่ในองค์ประกอบ <name> ซึ่งเป็นระดับข้างเคียงของ <LineString> (กล่าวคือ อยู่ในองค์ประกอบ <Placemark> เดียวกัน)

Google Earth เวอร์ชัน 6.1 ขึ้นไปจะไม่แสดงป้ายกํากับโดยค่าเริ่มต้น คุณต้องเปิดใช้สําหรับสตริงแต่ละรายการโดยตั้งค่า <gx:labelVisibility> เป็น 1

ปัญหาที่ทราบของ Google Earth 6.1: LineStrings ที่ไม่มีองค์ประกอบ <gx:physicalWidth> จะแสดงป้ายกํากับเฉพาะในกรณีที่ความยาวของบรรทัดมากกว่า 100m * จํานวนอักขระในป้ายกํากับ เช่น ป้ายกํากับที่มีอักขระ 7 ตัว ("ตัวอย่าง") จะแสดงก็ต่อเมื่อบรรทัดมากกว่า 700 ม. การดําเนินการนี้จะไม่ส่งผลต่อ LineStrings ที่มีค่า <gx:physicalWidth>

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงเส้นสีแดงทึบ 50 เปอร์เซ็นต์ที่มีความกว้าง 4 พิกเซล

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

ขยาย

มีอยู่โดย

ไวยากรณ์

<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> มีช่องเดียวกับ <Link>)
  • ไฟล์โมเดลที่ใช้ในองค์ประกอบ <Model>

ไฟล์มีการโหลดและรีเฟรชแบบมีเงื่อนไข ขึ้นอยู่กับพารามิเตอร์การรีเฟรชที่ระบุที่นี่ สามารถระบุพารามิเตอร์การรีเฟรชได้ 2 ชุด ได้แก่ ชุดหนึ่งจะขึ้นอยู่กับ time (<RefreshMode> และ <RefreshInterval>) และอีกชุดหนึ่งอิงตามข้อมูลพร็อพเพอร์ตี้ "กล้องถ่ายรูป" (<viewRefreshMode> และ <viewRefreshTime>) นอกจากนี้ Link ยังระบุว่าจะปรับขนาดพารามิเตอร์ขอบเขตของกรอบที่ส่งไปยังเซิร์ฟเวอร์ (<viewBoundScale> หรือไม่ และนําเสนอชุดพารามิเตอร์ภาษาที่ไม่บังคับซึ่งมีชุดพารามิเตอร์ที่สามารถส่งไปยังชุดพารามิเตอร์ของภาษาที่ไม่บังคับซึ่งมีชุดพารามิเตอร์ที่สามารถส่งไปยังชุดพารามิเตอร์ของภาษาที่ไม่บังคับซึ่งมีชุดพารามิเตอร์ที่สามารถส่งไปยังชุดพารามิเตอร์ของภาษาที่ระบุซึ่งมีชุดพารามิเตอร์ที่ต้องส่ง

เมื่อมีการดึงข้อมูลไฟล์ URL ที่ส่งไปยังเซิร์ฟเวอร์จะประกอบไปด้วยข้อมูล 3 ส่วน ดังนี้

  • href (Hypertext Reference) ที่ระบุไฟล์สําหรับโหลด
  • สตริงรูปแบบที่กําหนดเองที่สร้างขึ้นจาก (ก) พารามิเตอร์ที่คุณระบุในองค์ประกอบ <viewformat> หรือ (ข) พารามิเตอร์กรอบล้อมรอบ (นี่คือค่าเริ่มต้น และจะใช้หากไม่มีองค์ประกอบ <viewFormat> ในไฟล์)
  • สตริงรูปแบบที่ 2 ที่ระบุในองค์ประกอบ <httpQuery>

หากไฟล์ที่ระบุใน <href> เป็นไฟล์ในระบบ ระบบจะไม่ใช้องค์ประกอบ <viewFormat> และ <httpQuery>

องค์ประกอบ <Link> จะแทนที่องค์ประกอบ <Url> ของ <NetworkLink> ที่มีอยู่ในรุ่น KML ก่อนหน้านี้และเพิ่มฟังก์ชันสําหรับองค์ประกอบ <Region> (เปิดตัวใน KML 2.1) ใน Google Earth ได้เปิดตัว 3.0 และเวอร์ชันก่อนหน้า ระบบจะไม่สนใจองค์ประกอบ <Link>

<href>
URL (ที่อยู่ HTTP หรือข้อกําหนดไฟล์ในเครื่อง) เมื่อระดับบนสุดของ <Link> เป็น NetworkLink, <href> เป็นไฟล์ KML เมื่อระดับบนสุดของ <Link> เป็นโมเดล <href> คือไฟล์ ACCOUNTADA เมื่อ <Icon> (ช่องเดียวกับ <Link>) เป็นโฆษณาซ้อนทับ <href> คือรูปภาพ URL สัมพัทธ์นี้จะใช้ในแท็กนี้ได้และจะประเมินโดยสัมพันธ์กับไฟล์ KML ที่ล้อมรอบอยู่ ดูรายละเอียดการสร้างข้อมูลอ้างอิงที่เกี่ยวข้องในไฟล์ KML และ KMZ ได้ในไฟล์ KMZ
<RefreshMode>
ระบุโหมดรีเฟรชตามเวลา ซึ่งอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้
  • onChange - รีเฟรชเมื่อโหลดไฟล์และเมื่อพารามิเตอร์ลิงก์เปลี่ยนแปลง (ค่าเริ่มต้น)
  • onInterval - รีเฟรชทุก n วินาที (ระบุไว้ใน <RefreshInterval>)
  • onExpire - รีเฟรชไฟล์เมื่อหมดเวลา หากไฟล์ที่ดึงข้อมูลมี NetworkLinkControl เวลา <expires> จะมีความสําคัญเหนือกว่าเวลาหมดอายุที่ระบุไว้ในส่วนหัว HTTP หากไม่ได้ระบุเวลา <expires> ไว้ ระบบจะใช้ส่วนหัว max-age ของ HTTP (หากมี) หากไม่มี max-age จะมีการใช้ส่วนหัว HTTP หมดอายุ (หากมี) (ดูส่วน RFC261b ของ Hypertext Transfer Protocol - HTTP 1.1 สําหรับรายละเอียดเกี่ยวกับช่องส่วนหัว HTTP)
<RefreshInterval>
ระบุเพื่อรีเฟรชไฟล์ทุก n วินาที
<viewRefreshMode>
ระบุวิธีการรีเฟรชลิงก์เมื่อ "กล้อง" มีการเปลี่ยนแปลง
อาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้
  • ไม่เลย (ค่าเริ่มต้น) - เพิกเฉยต่อการเปลี่ยนแปลงในมุมมอง ไม่ต้องสนใจพารามิเตอร์ <viewformat> (หากมี)
  • onStop - รีเฟรชไฟล์ n วินาทีหลังจากการเคลื่อนไหวหยุด โดยระบุ n ใน <viewRefreshTime>
  • onRequest - รีเฟรชไฟล์เฉพาะเมื่อผู้ใช้ขออย่างชัดแจ้งเท่านั้น (เช่น ใน Google Earth ผู้ใช้คลิกขวาและเลือก "รีเฟรช" ในเมนูบริบท)
  • onRegion - รีเฟรชไฟล์เมื่อภูมิภาคเริ่มทํางาน โปรดดู<ภูมิภาค>
<viewRefreshTime>
เมื่อการเคลื่อนไหวของกล้องหยุดแล้ว ให้ระบุจํานวนวินาทีที่จะรอก่อนที่จะรีเฟรชมุมมอง (ดู <viewRefreshMode> และ onStop ด้านบน)
<viewBoundScale>
ปรับขนาดพารามิเตอร์ BBOX ก่อนส่งไปยังเซิร์ฟเวอร์ ค่าที่น้อยกว่า 1 จะระบุเพื่อใช้น้อยกว่าทั้งมุมมอง (หน้าจอ) ค่าที่มากกว่า 1 จะระบุเพื่อดึงข้อมูลพื้นที่ซึ่งเกินขอบของมุมมองปัจจุบัน
<viewFormat>
ระบุรูปแบบของสตริงคําค้นหาที่ต่อท้าย <href> ของลิงก์ก่อนที่จะดึงไฟล์ (หาก <href> ระบุไฟล์ในเครื่อง ระบบจะไม่สนใจองค์ประกอบนี้)
หากระบุ <viewRefreshMode> ของ onStop และไม่ได้รวมแท็ก <viewFormat> ในไฟล์ ระบบจะเพิ่มข้อมูลต่อไปนี้ลงในสตริงการค้นหาโดยอัตโนมัติ

BBOX=[bboxWest],[bboxouthern],[bboxEast],[bboxNorth]

ข้อมูลนี้ตรงกับข้อกําหนดของกรอบบริการ Web Map (WMS)
หากคุณระบุแท็ก <viewFormat> ว่างเปล่า จะไม่มีข้อมูลใดต่อท้ายสตริงคําค้นหา
คุณยังระบุชุดพารามิเตอร์การดูที่กําหนดเองเพื่อเพิ่มลงในสตริงคําค้นหาได้ด้วย หากคุณระบุสตริงรูปแบบ ระบบจะใช้สตริงนี้แทนข้อมูล BBOX หากต้องการข้อมูล BBOX ด้วย คุณจะต้องเพิ่มพารามิเตอร์เหล่านั้นพร้อมด้วยพารามิเตอร์ที่กําหนดเอง
คุณสามารถใช้พารามิเตอร์ต่อไปนี้ในสตริงรูปแบบ (และ Google Earth จะแทนที่ค่าปัจจุบันที่เหมาะสมในขณะที่สร้างสตริงคําค้นหา)
  • [lookatLon], [lookatLat] - ลองจิจูดและละติจูดของจุดที่ <LookAt>
  • [lookatRange], [lookatTilt], [lookatHeading] - ค่าที่ใช้โดยองค์ประกอบ <LookAt> (ดูคําอธิบาย <range>, <tilt> และ <heading> ใน <LookAt>)
  • [lookatTerrainLon], [lookatTerrainLat], [lookatTerrainAlt] - ชี้ไปยังภูมิประเทศในหน่วยองศา/เมตรที่ <LookAt>> กําลังดู
  • [cameraLon], [cameraLat], [cameraAlt] - องศา/เมตรของดวงตาสําหรับกล้อง
  • [horizFov], [vertFov] - ขอบเขตการมองเห็นในแนวตั้งสําหรับกล้อง
  • [horizPixels], [vertPixels] - ขนาดเป็นพิกเซลของมุมมอง 3 มิติ
  • [terrainEnabled] - ระบุว่ามุมมอง 3 มิติแสดงภูมิประเทศหรือไม่
<httpข้อความค้นหา>
ต่อท้ายสตริงการค้นหาตามพารามิเตอร์ที่ระบุ (Google Earth จะแทนที่ค่าปัจจุบันที่เหมาะสมในขณะที่สร้างสตริงการค้นหา) ระบบรองรับพารามิเตอร์ต่อไปนี้
  • [เวอร์ชันไคลเอ็นต์]
  • [EFTVersion]
  • [ชื่อลูกค้า]
  • [ภาษา]

ตัวอย่าง

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

ขยาย

มีอยู่โดย

ดูเพิ่มเติม

<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 นี่คือแผง Places

องค์ประกอบเฉพาะสําหรับ ListStyle

<listItemType>
ระบุวิธีแสดงฟีเจอร์ในมุมมองรายการ โดยค่าที่เป็นไปได้มีดังนี้
  • check (ค่าเริ่มต้น) - ระดับการเข้าถึงของฟีเจอร์จะเชื่อมโยงกับช่องทําเครื่องหมายของรายการ
  • radioFolder - เมื่อระบุคอนเทนเนอร์แล้ว คุณจะเห็นรายการของคอนเทนเนอร์เพียงรายการเดียวเท่านั้น
  • checkOFFOnly - เมื่อระบุสําหรับคอนเทนเนอร์หรือลิงก์เครือข่ายจะป้องกันไม่ให้ระบบแสดงรายการทั้งหมดพร้อมกัน กล่าวคือ ผู้ใช้ปิดทุกอย่างในคอนเทนเนอร์หรือลิงก์เครือข่ายได้ แต่จะเปิดทุกอย่างพร้อมกันไม่ได้ การตั้งค่านี้มีประโยชน์สําหรับคอนเทนเนอร์หรือลิงก์เครือข่ายที่มีข้อมูลจํานวนมาก
  • checkHiddenChild - ใช้ช่องทําเครื่องหมายปกติเพื่อให้มองเห็นได้ แต่อย่าแสดงคอนเทนเนอร์ย่อยหรือลิงก์ของเครือข่ายในมุมมองรายการ ช่องทําเครื่องหมายเพื่ออนุญาตให้ผู้ใช้สลับการมองเห็นออบเจ็กต์ย่อยในโปรแกรมดู
<bgColor>
สีพื้นหลังสําหรับตัวอย่างข้อมูล ค่าสีและความทึบแสงจะแสดงเป็นค่าฐานสิบหก ช่วงของค่าสีหนึ่งคือ 0 ถึง 255 (00 ถึง ff) สําหรับอัลฟ่า 00 จะมีความโปร่งใสทั้งหมดและ ff จะทึบแสงทั้งหมด ลําดับของนิพจน์คือ aabbggrr โดยที่ aa=alpha (00 ถึง ff); bb=blue (00 ถึง ff); gg=green (00 ถึง ff); rr=red (00 ถึง ff) เช่น หากต้องการใช้สีน้ําเงินที่ความทึบแสง 50 เปอร์เซ็นต์กับการวางซ้อน ให้ระบุดังนี้ โดย <color>7fff0000</color> โดยที่ alpha=0x7f, blue=0xff, green=0x00 และ red=0x00
<ItemIcon>
ไอคอนที่ใช้ในมุมมองรายการที่แสดงถึงสถานะของการดึงข้อมูลโฟลเดอร์หรือลิงก์ ไอคอนที่เชื่อมโยงกับโหมดเปิดและปิดจะใช้กับโฟลเดอร์และลิงก์เครือข่าย ไอคอนที่เชื่อมโยงกับโหมดข้อผิดพลาดและการดึงข้อมูล 0 การดึงข้อมูล 1 และการดึงข้อมูล 2 จะใช้สําหรับลิงก์เครือข่าย ภาพหน้าจอต่อไปนี้แสดงไอคอน Google Earth สําหรับรัฐต่อไปนี้
<รัฐ>
ระบุสถานะปัจจุบันของ NetworkLink หรือ Folder ค่าที่เป็นไปได้คือ open, Closedd, error, fetching0, fetching1 และ fetching2 คุณรวมค่าเหล่านี้ได้โดยการแทรกช่องว่างระหว่าง 2 ค่า (ไม่มีคอมมา)
<href>
ระบุ URI ของรูปภาพที่ใช้ในมุมมองรายการของฟีเจอร์

ตัวอย่าง

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

ขยาย

มีอยู่โดย

<Look>

ไวยากรณ์

<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 มุมมอง "นําทางไปยัง" มุมมอง LookAt นี้เมื่อผู้ใช้ดับเบิลคลิกรายการในแผง สถานที่ หรือดับเบิลคลิกไอคอนในมุมมอง 3 มิติ

องค์ประกอบที่เฉพาะเจาะจงสําหรับ LookAt

<ลองจิจูด>
ลองจิจูดของจุดของกล้อง ระยะทางในหน่วยองศาที่สัมพันธ์กับเส้นเมริเดียนแรก ค่าทางตะวันตกของเมริเดียนอยู่ในช่วง ‐180 ถึง 0 องศา ค่าทิศตะวันออกของเมริเดียนอยู่ในช่วง 0 ถึง 180 องศา
<ละติจูด>
ระยะห่างของจุดที่มองเห็นกล้อง องศาเหนือหรือใต้ของเส้นศูนย์สูตร (0 องศา) ค่าอยู่ในช่วง ‐90 องศาถึง 90 องศา
<ระดับความสูง>
ระยะทางจากพื้นโลกในหน่วยเมตร ตีความตามโหมดระดับความสูงของ LookAt
<ส่วนหัว>
ทิศทาง (ซึ่งก็คือ ทิศเหนือ ทิศใต้ ทิศตะวันออก ทิศตะวันตก) ในหน่วยองศา ค่าเริ่มต้น=0 (เหนือ) (ดูแผนภาพด้านล่าง) ค่าอยู่ในช่วง 0 ถึง 360 องศา
<เอียง>
มุมระหว่างทิศทางของตําแหน่ง LookAt กับปกติเป็นปกติกับพื้นผิวโลก (ดูแผนภาพด้านล่าง) ค่าอยู่ในช่วง 0 ถึง 90 องศา ค่าของ <tilt> ต้องไม่เป็นค่าลบ ค่า <tilt> เป็น 0 องศาจะบ่งบอกว่าดูจากด้านบนโดยตรง ค่า <tilt> 90 องศาจะแสดงขอบฟ้าในแนวนอน
<range>(ต้องระบุ)
ระยะทางในหน่วยเมตรจากจุดที่ระบุโดย <longitude>, <ละติจูด> และ <aระดับความสูง> ไปยังตําแหน่ง LookAt (ดูแผนภาพด้านล่าง)
<a ในส่วนโหมด>
ระบุวิธีการตีความ <aระดับความสูง> สําหรับจุด LookAt โดยค่าที่เป็นไปได้มีดังนี้
  • clampToGround - (ค่าเริ่มต้น) ระบุว่าไม่สนใจข้อกําหนด <aระดับความสูง> และวางตําแหน่ง LookAt บนพื้น
  • relativeToGround - ตีความ<aระดับความสูง>เป็นค่าในหน่วยเมตรเหนือพื้นดิน
  • สัมบูรณ์ - ตีความ<a>>เป็นค่าในหน่วยเมตรเหนือระดับน้ําทะเล
<gx:a ในส่วนโหมด>
ส่วนขยาย KML ในเนมสเปซของส่วนขยาย Google ซึ่งช่วยให้ระดับความสูงที่เกี่ยวข้องกับก้นทะเล ค่าต่างๆ มีดังนี้
  • relativeToSeaFloor - ตีความ<aระดับความสูง>เป็นค่าในหน่วยเมตรเหนือก้นทะเล หากจุดเหนือพื้นดินแทนที่จะเป็นทะเล จะตีความค่า <aระดับความสูง> ว่าอยู่เหนือพื้น
  • clampToSeaFloor - ระบบไม่คํานึงถึงข้อกําหนด <aระดับความสูง> และ LookAt จะตั้งอยู่บนพื้นทะเล หากจุดบนพื้นดินไม่ใช่ทะเล จะมีตําแหน่งของ LookAt บนพื้นดิน

แผนภาพนี้แสดงองค์ประกอบ <range>, <tilt> และ <aระดับความสูง>

 

แผนภาพนี้แสดงองค์ประกอบ <header> ดังต่อไปนี้

 

ตะวันออก=90, ทิศใต้=180, ตะวันตก=270
<?xml version="1.0" encoding="UTF-8"?>
<kml xmlns="http://www.opengis.net/kml/2.2"
xmlns:gx="http://www.google.com/kml/ext/2.2">

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

ขยาย

มีอยู่โดย

<โมเดล>

ไวยากรณ์

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

คำอธิบาย

ออบเจ็กต์ 3 มิติที่อธิบายไว้ในไฟล์ เกิดความเชื่อมโยง (ที่อ้างอิงในแท็ก <Link>) ไฟล์ 3ADA มีนามสกุลไฟล์ .dae โมเดลจะสร้างขึ้นในพื้นที่พิกัดของตนเอง จากนั้นจะกําหนดตําแหน่ง จัดตําแหน่ง และปรับขนาดใน Google Earth ดูรายละเอียดเพิ่มเติมได้ในหน้า "หัวข้อใน KML" บนโมเดล

Google Earth รองรับโปรไฟล์ร่วมของ เกิดใน เกิดความดึกดําบรรพ์ โดยมีข้อยกเว้นต่อไปนี้

  • Google Earth รองรับเฉพาะรูปสามเหลี่ยมและเส้นเป็นประเภทพื้นฐาน จํานวนสามเหลี่ยมสูงสุดที่อนุญาตคือ 21845
  • Google Earth ไม่รองรับภาพเคลื่อนไหวหรือสกิน
  • Google Earth ไม่รองรับการอ้างอิงเรขาคณิตภายนอก

องค์ประกอบเฉพาะสําหรับโมเดล

<a ในส่วนโหมด>
ระบุวิธีการตีความ<a ในส่วน> ใน <Location> โดยค่าที่เป็นไปได้มีดังนี้
  • clampToGround - (ค่าเริ่มต้น) ระบุว่าไม่สนใจข้อกําหนด <aระดับความสูง> และวางโมเดลบนพื้น
  • relativeToGround - ตีความ<aระดับความสูง>เป็นค่าในหน่วยเมตรเหนือพื้นดิน
  • สัมบูรณ์ - ตีความ<a>>เป็นค่าในหน่วยเมตรเหนือระดับน้ําทะเล
<gx:a ในส่วนโหมด>
ส่วนขยาย KML ในเนมสเปซของส่วนขยาย Google ซึ่งช่วยให้ระดับความสูงที่เกี่ยวข้องกับก้นทะเล ค่าต่างๆ มีดังนี้
  • relativeToSeaFloor - ตีความ<aระดับความสูง>เป็นค่าในหน่วยเมตรเหนือก้นทะเล หากจุดเหนือพื้นดินแทนที่จะเป็นทะเล จะตีความค่า <aระดับความสูง> ว่าอยู่เหนือพื้น
  • clampToSeaFloor - ละเว้นข้อกําหนด <aระดับความสูง> และรูปแบบจะอยู่ในพื้นทะเล หากตําแหน่งบนพื้นดิน ไม่ใช่ทะเล โมเดลจะอยู่บนพื้นดิน
<สถานที่ตั้ง>
ระบุพิกัดที่แน่นอนของต้นทางของโมเดลในละติจูด ลองจิจูด และระดับความสูง การวัดละติจูดและลองจิจูดคือการคาดการณ์พื้นที่ละตินมาตรฐานด้วยชุดข้อมูล WGS84 ระดับความสูงคือระยะทางเหนือพื้นผิวโลก หน่วยเป็นเมตร และตีความตาม <a ในส่วนMode> หรือ <gx:aระดับความสูงMode>
<Location>
  <longitude>39.55375305703105</longitude>
  <latitude>-118.9813220168456</latitude>
  <altitude>1223</altitude>
</Location> 
<การวางแนว>
อธิบายการหมุนของระบบพิกัดของโมเดล 3 มิติเพื่อจัดตําแหน่งวัตถุใน Google Earth ดูแผนภาพด้านล่าง
<Orientation>
  <heading>45.0</heading>
  <tilt>10.0</tilt>
  <roll>0.0</roll>
</Orientation> 

การหมุนเวียนจะมีผลกับโมเดลตามลําดับต่อไปนี้

  1. <โฆษณาตอนต้น>
  2. <เอียง>
  3. <ส่วนหัว>
<ส่วนหัว>
การหมุนเกี่ยวกับแกน z (ปกติกับพื้นผิวโลก) ค่า 0 (ค่าเริ่มต้น) เท่ากับ North การหมุนเชิงบวกตามแกน z ตามเข็มนาฬิกาและระบุเป็นองศาตั้งแต่ 0 ถึง 360
<เอียง>
การหมุนเวียนเกี่ยวกับแกน x การหมุนเชิงบวกตามเข็มนาฬิการอบแกน x และระบุเป็นองศาตั้งแต่ 0 ถึง 180
<โฆษณาตอนต้น>
การหมุนเวียนเกี่ยวกับแกน y การหมุนเชิงบวกตามเข็มนาฬิการอบแกน Y และจะระบุเป็นองศาตั้งแต่ 0 ถึง 180
มีการระบุส่วนหัว การเอียง และม้วนตามเข็มนาฬิกาเมื่อมองแกนลงไปยังต้นทาง
แผนภาพนี้แสดงการวางแนวทั่วไปของแกนโมเดล
สําหรับรูปแบบทั่วไป +x จะอยู่ทางขวา +y จะอยู่ทางขวา + ทิศเหนือและทิศตะวันออก +z จะขึ้น
<Scale>
ปรับขนาดโมเดลตามแกน x, y และ z ในพื้นที่พิกัดของโมเดล
<Scale>
<x>2.5</x>
<y>2.5</y>
<z>3.5</z>
</Scale>
ระบุไฟล์สําหรับโหลดและพารามิเตอร์การรีเฟรชที่ไม่บังคับ ดู <Link>
<ResourceMap>
ระบุองค์ประกอบ <Alias> อย่างน้อย 0 รายการ โดยแต่ละรายการเป็นการแมปเส้นทางของไฟล์พื้นผิวจากไฟล์ Collada เดิมไปยังไฟล์ KML หรือ KMZ ที่มีโมเดล องค์ประกอบนี้ช่วยให้คุณย้ายและเปลี่ยนชื่อไฟล์พื้นผิวได้โดยไม่ต้องอัปเดตไฟล์ Collada ต้นฉบับที่อ้างอิงพื้นผิวเหล่านั้น องค์ประกอบ <ResourceMap> หนึ่งอาจมีการแมปหลายรายการจากไฟล์ Collada (แหล่งที่มา) ต่างๆ เป็นไฟล์ KMZ (เป้าหมาย) เดียวกัน
<Alias>
<targetHref>../images/foo.jpg</targetHref> <sourceHref>c:\mytextures\foo.jpg</sourceHref> </Alias>
<Alias> มีการแมปจาก <sourceHref> กับ <targetHref>:
<targetHref>
ระบุไฟล์พื้นผิวที่ Google Earth จะดึงข้อมูล ข้อมูลอ้างอิงนี้อาจเป็นการอ้างอิงที่สัมพันธ์กับไฟล์ภาพในที่เก็บถาวร .kmz หรืออาจเป็นการอ้างอิงสัมบูรณ์ไปยังไฟล์ (เช่น URL)
<sourceHref>
เป็นเส้นทางที่ระบุสําหรับไฟล์พื้นผิวในไฟล์ Collada .dae หรือไม่
ใน Google Earth หากไม่มีการแมปนี้ ระบบจะใช้กฎต่อไปนี้เพื่อหาพื้นผิวที่อ้างอิงในไฟล์ Collada (.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>

ขยาย

มีอยู่โดย

<เรขาคณิตหลายรูป>

ไวยากรณ์

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

คำอธิบาย

คอนเทนเนอร์สําหรับองค์ประกอบพื้นฐานเรขาคณิตอย่างน้อย 0 รายการที่เชื่อมโยงกับฟีเจอร์เดียวกัน

หมายเหตุ: เราเลิกใช้งานแท็ก <GeometryCollection> แล้ว โปรดใช้ <MultiGeometry> แทน

องค์ประกอบที่เฉพาะเจาะจงสําหรับเรขาคณิตหลายรูป

  • องค์ประกอบ <Geometry> 0 รายการขึ้นไป

ตัวอย่าง

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

ขยาย

มีอยู่โดย

<gx:MultiTrack>

องค์ประกอบนี้เป็นส่วนขยายของมาตรฐาน 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>

คำอธิบาย

องค์ประกอบแบบหลายแทร็กใช้เพื่อรวมองค์ประกอบแทร็กหลายรายการเข้าเป็นหน่วยแนวคิดเดียว ตัวอย่างเช่น สมมติว่าคุณรวบรวมข้อมูล GPS สําหรับการขี่จักรยานตลอดวัน ซึ่งมีจุดแวะพักหลายจุด และจุดแวะพักของมื้อกลางวัน เนื่องจากเวลาที่เกิดการหยุดชะงัก การขี่จักรยาน 1 รอบอาจปรากฏเป็นแทร็กที่ต่างกัน 4 แทร็กเมื่อมีการพล็อตเวลาและตําแหน่ง การจัดกลุ่มองค์ประกอบ <gx:Track> เหล่านี้ลงในคอนเทนเนอร์ <gx:MultiTrack> 1 รายการทําให้องค์ประกอบแสดงใน Google Earth เป็นส่วนหนึ่งของเส้นทางเดียว เมื่อไอคอนไปถึงจุดสิ้นสุดของกลุ่มหนึ่ง ไอคอนจะไปอยู่ที่จุดเริ่มต้นของส่วนถัดไป องค์ประกอบ <gx:interpolate> ระบุให้หยุดที่ส่วนท้ายของแทร็กใดแทร็กหนึ่งและข้ามไปยังจุดเริ่มต้นของแทร็กถัดไปทันที หรือประมาณค่าที่ขาดหายไประหว่างแทร็ก 2 แทร็ก

องค์ประกอบเฉพาะสําหรับ gx:MultiTrack

<a ในส่วนโหมด>
ระบุวิธีการตีความคอมโพเนนต์ระดับความสูงในองค์ประกอบ <พิกัด> โดยค่าที่เป็นไปได้มีดังนี้
  • clampToGround - (ค่าเริ่มต้น) ระบุว่าไม่สนใจข้อกําหนดระดับความสูง (เช่น ในองค์ประกอบ <gx:coord>)
  • relativeToGround - ตั้งค่าระดับความสูงขององค์ประกอบให้สัมพันธ์กับระดับความสูงของพื้นดินจริงของสถานที่หนึ่ง เช่น หากระดับความสูงของพื้นของสถานที่หนึ่งตรงกับระดับน้ําทะเลทุกประการ และระดับความสูงสําหรับจุดหนึ่งถูกตั้งไว้ที่ 9 เมตร ระดับความสูงของไอคอนระดับความสูงของหมุดจะอยู่ที่ 9 เมตรในโหมดนี้ แต่หากพิกัดเดียวกันรวมอยู่ในตําแหน่งที่มีระดับความสูงเหนือระดับน้ําทะเล 10 เมตร ระดับความสูงของพิกัดจะเท่ากับ 19 เมตร
  • ค่าสัมบูรณ์ - ตั้งค่าระดับความสูงของพิกัดที่สัมพันธ์กับระดับน้ําทะเล โดยไม่คํานึงถึงระดับความสูงจริงของภูมิประเทศใต้องค์ประกอบ เช่น หากตั้งค่าระดับความสูงของพิกัดเป็น 10 เมตรด้วยโหมดระดับความสูงสัมบูรณ์ ไอคอนของหมุดจุดจะอยู่ที่ระดับพื้นดิน หากภูมิประเทศด้านล่างมีความสูงเกิน 10 เมตรเหนือระดับน้ําทะเลด้วย หากภูมิประเทศสูงกว่าระดับน้ําทะเล 3 เมตร หมุดจะปรากฏขึ้นบนพื้นสูง 7 เมตร
<gx:a ในส่วนโหมด>
ส่วนขยาย KML ในเนมสเปซของส่วนขยาย Google ซึ่งอนุญาตระดับความสูงที่เกี่ยวข้องกับก้นทะเล ค่าต่างๆ มีดังนี้
  • relativeToSeaFloor - ตีความระดับความสูงเป็นค่าในหน่วยเมตรเหนือก้นทะเล หากจุดเหนือพื้นดินไม่ใช่ทะเล ระดับความสูงจะได้รับการตีความว่าสูงเหนือพื้นดิน
  • clampToSeaFloor - ละเว้นข้อกําหนดระดับความสูง และจุดวางบนพื้นทะเล หากจุดบนพื้นดินไม่ใช่ทะเล จะมีจุดวางบนพื้น
<gx:interpolate>
ค่าบูลีน หากหลายแทร็กมีองค์ประกอบ <gx:Track> หลายรายการ ให้ระบุว่าจะประมาณค่าที่ขาดหายไประหว่างจุดสิ้นสุดของแทร็กแรกกับจุดเริ่มต้นของแทร็กถัดไปหรือไม่ เมื่อใช้ค่าเริ่มต้น (0) ไอคอนหรือโมเดลจะหยุดที่ส่วนท้ายของแทร็กหนึ่ง จากนั้นจึงข้ามไปยังจุดเริ่มต้นของแทร็กถัดไป

ประกอบด้วย

ไวยากรณ์

<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 หรือที่เก็บถาวรของ KMZ ในเครือข่ายภายในหรือระยะไกล ใช้องค์ประกอบ <Link> เพื่อระบุตําแหน่งของไฟล์ KML ภายในองค์ประกอบดังกล่าว คุณสามารถกําหนดตัวเลือกการรีเฟรชสําหรับการอัปเดตไฟล์ตามเวลาและการเปลี่ยนแปลงของกล้อง คุณสามารถใช้ NetworkLinks ร่วมกับภูมิภาคต่างๆ เพื่อจัดการชุดข้อมูลขนาดใหญ่มากได้อย่างมีประสิทธิภาพ

<รีเฟรชระดับการเข้าถึง>
ค่าบูลีน ค่า 0 จะทําให้มีการเปิดเผยฟีเจอร์ในการควบคุมของผู้ใช้ Google Earth กําหนดค่าเป็น 1 เพื่อรีเซ็ตระดับการเข้าถึงของฟีเจอร์ทุกครั้งที่มีการรีเฟรช NetworkLink ตัวอย่างเช่น สมมติว่าหมุดในไฟล์ KML ที่ลิงก์มีการตั้งค่า <visible> เป็น 1 ส่วน NetworkLink ได้ตั้งค่า <RefreshViewable> เป็น 1 เมื่อโหลดไฟล์ลงใน Google Earth เป็นครั้งแรก ผู้ใช้จะล้างช่องทําเครื่องหมายข้างรายการเพื่อปิดจอแสดงผลในมุมมอง 3 มิติได้ อย่างไรก็ตาม เมื่อรีเฟรช NetworkLink แล้ว คุณจะเห็นหมุดอีกครั้ง เนื่องจากสถานะการมองเห็นเดิมเป็น TRUE
<flyToView>
ค่าบูลีน ค่า 1 จะทําให้ Google Earth บินไปที่มุมมองของ LookAt หรือกล้องใน NetworkLinkControl (หากมี) หาก NetworkLinkControl ไม่มีองค์ประกอบ AbstractView ระบบของ Google Earth จะข้ามไปที่องค์ประกอบ LookAt หรือกล้องในฟีเจอร์โฟนภายในองค์ประกอบ < KML> ในไฟล์รีเฟรช หากองค์ประกอบ <{0/}> ไม่ได้ระบุ LookAt หรือกล้องไว้ มุมมองจะไม่มีการเปลี่ยนแปลง เช่น Google Earth จะไปที่มุมมอง <LookAt> ของเอกสารหลัก ไม่ใช่ <LookAt> ของหมุดที่อยู่ในเอกสาร

เคล็ดลับ: หากต้องการแสดงโฟลเดอร์หรือเอกสารระดับบนสุดภายในลิงก์เครือข่ายในมุมมองรายการ ให้กําหนดรหัสให้กับโฟลเดอร์หรือเอกสาร หากไม่มีรหัสนี้ ระบบจะแสดงเฉพาะชื่อออบเจ็กต์ย่อยในมุมมองรายการ

ตัวอย่าง

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

ขยาย

มีอยู่โดย

  • องค์ประกอบที่มาจาก <Container>

<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

<minRefreshPeriod>
ระบุจํานวนวินาทีสําหรับ <minRefreshPeriod> เป็นเวลาขั้นต่ําที่อนุญาตระหว่างการดึงข้อมูลไฟล์ พารามิเตอร์นี้จะช่วยให้เซิร์ฟเวอร์ควบคุมการดึงข้อมูลไฟล์หนึ่งๆ และปรับแต่งอัตราการรีเฟรชให้สอดคล้องกับอัตราการเปลี่ยนแปลงข้อมูลที่คาดไว้ได้ ตัวอย่างเช่น ผู้ใช้อาจตั้งค่าการรีเฟรชลิงก์เป็น 5 วินาที แต่คุณสามารถตั้งช่วงเวลาการรีเฟรชขั้นต่ําเป็น 3600 เพื่อจํากัดการอัปเดตการรีเฟรชได้เพียงครั้งเดียวในทุกชั่วโมง
<maxSessionLength>
ระบุจํานวนวินาทีสําหรับ <maxSessionLength> คือระยะเวลาสูงสุดที่ไคลเอ็นต์ NetworkLink จะยังเชื่อมต่อได้เป็นวินาที ค่าเริ่มต้นของ -1 บ่งชี้ว่าจะไม่จบเซสชันอย่างชัดแจ้ง
ใช้เอลิเมนต์ นี้เพื่อต่อท้ายสตริงในการค้นหา URL ในการรีเฟรชลิงก์ถัดไป คุณใช้ข้อมูลนี้ในสคริปต์เพื่อเพิ่มความสามารถในการจัดการฝั่งเซิร์ฟเวอร์ได้อย่างชาญฉลาด รวมถึงการค้นหาเวอร์ชันและการนําส่งไฟล์ตามเงื่อนไข
<message>
คุณแสดงข้อความป๊อปอัป เช่น หลักเกณฑ์การใช้งานสําหรับลิงก์เครือข่ายได้ ข้อความจะปรากฏขึ้นเมื่อโหลดลิงก์เครือข่ายลงใน Google Earth เป็นครั้งแรก หรือเมื่อมีการเปลี่ยนแปลงในการควบคุมลิงก์เครือข่าย
<ลิงก์ชื่อ>
คุณควบคุมชื่อลิงก์เครือข่ายจากเซิร์ฟเวอร์ได้ เพื่อให้เซิร์ฟเวอร์ลบล้างการเปลี่ยนแปลงชื่อฝั่งไคลเอ็นต์
<linkDescription>
คุณควบคุมคําอธิบายลิงก์เครือข่ายจากเซิร์ฟเวอร์ได้ เพื่อให้เซิร์ฟเวอร์ลบล้างการเปลี่ยนแปลงคําอธิบายฝั่งไคลเอ็นต์
<linksnippet maxLines="2" >
คุณควบคุมข้อมูลโค้ดสําหรับลิงก์เครือข่ายจากเซิร์ฟเวอร์ได้เพื่อให้เซิร์ฟเวอร์เปลี่ยนการเปลี่ยนแปลงของข้อมูลโค้ดในฝั่งไคลเอ็นต์ <linksnippet> มีแอตทริบิวต์ maxLines จํานวนเต็มที่ระบุจํานวนบรรทัดสูงสุดที่จะแสดง
<หมดอายุ>
คุณระบุวันที่/เวลาที่ควรรีเฟรชลิงก์ได้ ข้อกําหนดนี้มีผลเฉพาะเมื่อ <RefreshMode> ใน <Link> มีค่าเป็น onExpire ดู <RefreshMode>
<อัปเดต>
เมื่อใช้ <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>

ขยาย

  • องค์ประกอบนี้เป็นองค์ประกอบย่อยขององค์ประกอบ < KML>

มีอยู่โดย

  • < KML>

ดูเพิ่มเติม

<ออบเจ็กต์>

ไวยากรณ์

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

คำอธิบาย

นี่คือคลาสฐานนามธรรมและนํามาใช้ในไฟล์ KML โดยตรงไม่ได้ โดยจะมีแอตทริบิวต์ id ที่อนุญาตให้ระบุองค์ประกอบ KML ที่ไม่ซ้ํา และแอตทริบิวต์ targetId ซึ่งใช้เพื่ออ้างอิงออบเจ็กต์ที่โหลดไว้ใน Google Earth แล้ว ต้องระบุแอตทริบิวต์ id หากต้องใช้กลไก <Update>

<การวางซ้อน>

ไวยากรณ์

<!-- 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> ระบุรูปภาพที่จะใช้และกําหนดค่าให้โหลดซ้ํารูปภาพตามตัวจับเวลาหรือตามการเปลี่ยนแปลงของกล้อง องค์ประกอบนี้ยังรวมถึงข้อมูลจําเพาะของการวางซ้อนแบบวางซ้อนหลายรายการ รวมถึงการเพิ่มค่าสีและความโปร่งใสให้กับรูปภาพฐาน

องค์ประกอบที่เฉพาะเจาะจงสําหรับโฆษณาซ้อนทับ

<color>
ค่าสีจะแสดงเป็นเลขฐานสิบหก รวมถึงค่าความทึบแสง (อัลฟ่า) ลําดับของนิพจน์เป็นอัลฟ่า น้ําเงิน เขียว แดง (aabbggrr) ช่วงของค่าสีหนึ่งคือ 0 ถึง 255 (00 ถึง ff). สําหรับความทึบแสง 00 จะมีความโปร่งใสทั้งหมดและ ff จะทึบแสงทั้งหมด เช่น หากต้องการใช้สีน้ําเงินที่มีความทึบแสง 50 เปอร์เซ็นต์กับการวางซ้อน ให้ระบุสิ่งต่อไปนี้ <color>7fff0000</color>

หมายเหตุ: เลิกใช้งานองค์ประกอบ <geomColor> แล้ว ใช้ <color> แทน

<DrawOrder>
องค์ประกอบนี้กําหนดลําดับการซ้อนสําหรับรูปภาพในการวางซ้อน โฆษณาซ้อนทับที่มีค่า <DrawOrder> สูงกว่าจะวาดบนการวางซ้อนที่มีค่า <DrawOrder> ต่ํากว่า
<ไอคอน>
กําหนดรูปภาพที่เกี่ยวข้องกับการวางซ้อน องค์ประกอบ <href> กําหนดตําแหน่งของรูปภาพที่จะใช้เป็นการวางซ้อน ตําแหน่งนี้อาจอยู่ในระบบไฟล์ในเครื่องหรือเว็บเซิร์ฟเวอร์ หากละเว้นองค์ประกอบนี้หรือมี <href> อยู่ สี่เหลี่ยมผืนผ้าจะถูกวาดโดยใช้สีและขนาดที่กําหนดโดยการวางซ้อนพื้นหรือหน้าจอ
<Icon>
   <href>icon.jpg</href>
</Icon>

ขยาย

ขยายโดย

<PhotoOverlay>

ไวยากรณ์

<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> จะช่วยให้คุณสามารถระบุตําแหน่งของภาพถ่ายทางภูมิศาสตร์บน Earth และระบุพารามิเตอร์การดูสําหรับ PhotoOverlay นี้ได้ การวางซ้อนภาพอาจเป็นสี่เหลี่ยมผืนผ้าง่ายๆ แบบ 2 มิติ ทรงกระบอกบางส่วนหรือทั้งหมด หรือทรงกลม (สําหรับพาโนรามาแบบ 360 องศา) การวางซ้อนจะอยู่ในตําแหน่งที่ระบุและอยู่ในมุมมอง

เนื่องจาก <PhotoOverlay> มาจาก <Feature> จึงอาจมีองค์ประกอบหนึ่งใน 2 อย่างที่ได้มาจาก <AbstractView> อาจเป็น < Camera> หรือ <LookAt> กล้อง (หรือ LookAt) จะระบุมุมมองและทิศทางการดู (หรือที่เรียกว่าเวกเตอร์มุมมอง) ส่วนการวางซ้อนรูปภาพจะอยู่ในตําแหน่งที่เกี่ยวข้องกับมุมมอง โดยเฉพาะอย่างยิ่งเครื่องบินที่เป็นสี่เหลี่ยมผืนผ้า 2 มิติจะเป็นเวกเตอร์ที่ใช้มุม (มุมฉาก) เวกเตอร์เวกเตอร์ ปกติเครื่องบินลํานี้คือด้านหน้าซึ่งเป็นส่วนหนึ่งของรูปภาพจะโฟกัสที่จุดชมวิว

URL ของรูปภาพการวางซ้อนอยู่ในแท็ก <Icon> ซึ่งรับค่าจาก <โฆษณาซ้อนทับ> แท็ก <Icon> ต้องมีองค์ประกอบ <href> ที่ระบุไฟล์รูปภาพที่จะใช้สําหรับ PhotoOverlay ในกรณีของรูปภาพที่มีขนาดใหญ่มาก <href> คือ URL พิเศษที่จัดทําดัชนีเป็นพีระมิดที่มีความละเอียดต่างกัน (ดู ImagePyramid)

ดูข้อมูลเพิ่มเติมได้ที่หน้า "หัวข้อใน KML" ที่การวางซ้อนรูปภาพ

องค์ประกอบที่เฉพาะเจาะจงสําหรับการวางซ้อนรูปภาพ

<การหมุนเวียน>
ปรับการแสดงรูปภาพภายในช่องมุมมอง องค์ประกอบนี้มีประโยชน์ในกรณีที่มีการหมุนรูปภาพและเบี่ยงเบนออกจากมุมมองแนวนอนที่ต้องการ
<ViewVolume>
เป็นตัวกําหนดระดับการมองเห็นฉากปัจจุบัน การระบุขอบเขตการมองเห็นคล้ายกับการระบุเลนส์ที่เปิดในกล้องจริง ขอบเขตการมองเห็นขนาดเล็ก เช่น เลนส์เทเลโฟโต้ จะโฟกัสที่ส่วนเล็กๆ ของฉาก ขอบเขตการมองเห็นขนาดใหญ่ เช่น เลนส์มุมกว้าง จะโฟกัสที่พื้นที่ขนาดใหญ่ในฉาก
<ซ้ายFov>
มุมองศาระหว่างทิศทางการดูของกล้องและทางด้านซ้ายของระดับเสียง
<rightFov>
มุมองศาระหว่างทิศทางการดูของกล้องและทางด้านขวาของระดับเสียง
<bottomFov>
มุมองศาระหว่างทิศทางการดูของกล้องกับด้านล่างของระดับเสียง
<topFov>
มุมองศาระหว่างทิศทางการดูของกล้องและมุมบนของระดับเสียง
<ใกล้>
การวัดเป็นเมตรตามทิศทางมุมมองจากมุมกล้องไปยังรูปร่างวางซ้อน
ขอบเขตการมองเห็นสําหรับการวางซ้อนโฆษณาซ้อนทับกําหนดโดยเครื่องบิน 4 ลํา โดยแต่ละมุมจะระบุด้วยมุมที่เกี่ยวข้องกับเวกเตอร์มุมมอง เครื่องบิน 4 ประเภทนี้จะกําหนดด้านข้าง ด้านล่าง ซ้าย และขวาของขอบเขตการมองเห็นที่มีรูปทรงเป็นพีระมิดที่ถูกตัด ดังที่แสดงที่นี่
แผนภาพต่อไปนี้แสดงมุมการมองเห็นทั้ง 4 ด้านในพีระมิดนี้
<รูปภาพพีระมิด>
สําหรับรูปภาพขนาดใหญ่มาก คุณจะต้องสร้างพีระมิดซึ่งเป็นชุดรูปภาพแบบลําดับชั้น ซึ่งแต่ละแบบจะใช้เวอร์ชันต้นฉบับที่มีความละเอียดต่ํากว่า รูปภาพแต่ละภาพในพีระมิดจะแยกย่อยออกเป็นชิ้นส่วนต่างๆ จึงต้องโหลดเฉพาะส่วนที่อยู่ในมุมมอง Google Earth จะคํานวณมุมมองปัจจุบันและโหลดชิ้นส่วนที่เหมาะสมกับระยะทางของผู้ใช้จากรูปภาพ เมื่อมุมมองย้ายเข้ามาใกล้การวางซ้อนภาพ Google Earth จะโหลดการ์ดความละเอียดสูงขึ้น เนื่องจากพิกเซลทั้งหมดในภาพต้นฉบับไม่สามารถดูบนหน้าจอพร้อมกันได้ การประมวลผลล่วงหน้านี้ช่วยให้ Google Earth บรรลุประสิทธิภาพสูงสุด เนื่องจากโหลดเฉพาะบางส่วนของภาพที่อยู่ในมุมมอง และเฉพาะรายละเอียดพิกเซลที่ผู้ใช้มองเห็นได้ที่มุมมองปัจจุบัน
เมื่อระบุพีระมิดแบบรูปภาพแล้ว คุณจะแก้ไข <href> ในองค์ประกอบ <Icon> เพื่อระบุข้อกําหนดเกี่ยวกับไทล์ที่จะโหลด
<ขนาดไทล์>
ขนาดของชิ้นส่วนเป็นพิกเซล ไทล์ต้องเป็นสี่เหลี่ยมจัตุรัส และ <tileSize> ต้องเป็นเลขยกกําลัง 2 ขอแนะนําให้ใช้ขนาดการ์ด 256 (ค่าเริ่มต้น) หรือ 512 รูปภาพต้นฉบับจะแบ่งออกเป็นไทล์ขนาดต่างๆ ตามความละเอียดต่างๆ
<maxWidth>
ความกว้างเป็นพิกเซลของรูปภาพต้นฉบับ
<maxHeight>
ความสูงเป็นพิกเซลของรูปภาพต้นฉบับ
<gridOrigin>
ระบุตําแหน่งที่จะเริ่มต้นเรียงลําดับเลขในแต่ละชั้นของพีระมิด ค่าของ lowerLeft ระบุว่าแถว 1 คอลัมน์ 1 ของแต่ละเลเยอร์จะอยู่ที่มุมซ้ายล่างของตารางกริด
<แต้ม>
องค์ประกอบ <Point> ทําหน้าที่เป็น <Point> ในองค์ประกอบ <Placemark> ซึ่งจะแสดงไอคอนเพื่อทําเครื่องหมายตําแหน่งของการวางซ้อนภาพ ไอคอน <styleUrl> และ <StyleSelector> จะระบุไอคอนที่วาดไว้ เช่นเดียวกับ <placemark>
<รูปร่าง>
ระบบจะคาดการณ์ PhotoOverlay ไปยัง <shape> <shape> อาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้

สี่เหลี่ยมผืนผ้า (ค่าเริ่มต้น) - สําหรับรูปภาพทั่วไป

ทรงกระบอก - สําหรับพาโนรามา ซึ่งอาจเป็นบางส่วนหรือทรงกระบอกก็ได้

ROUND - สําหรับพาโนรามา 360 องศา

ตัวอย่าง

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

ขยาย

มีอยู่โดย

<หมุด>

ไวยากรณ์

<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 หมุดจะปรากฏเป็นรายการในแผงสถานที่ หมุดที่มีจุดมีไอคอนที่เกี่ยวข้องกับเครื่องหมายนั้นบนโลกบนมุมมอง 3 มิติ (ในมุมมอง 3 มิติของ Google Earth หมุดตําแหน่งเป็นวัตถุเดียวที่คุณสามารถคลิกหรือเลื่อนดูได้ วัตถุเรขาคณิตอื่นๆ ไม่มีไอคอนในมุมมอง 3 มิติ หากต้องการให้ผู้ใช้คลิกในมุมมอง 3 มิติ คุณจะต้องสร้างออบเจ็กต์ MultiGeometry ที่มีทั้งออบเจ็กต์ Point และออบเจ็กต์เรขาคณิตอื่นๆ)

องค์ประกอบที่เฉพาะเจาะจงสําหรับหมุด

  • องค์ประกอบ <Geometry> 0 หรือ 1 รายการ

ตัวอย่าง

<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 ปัจจุบัน

องค์ประกอบที่เฉพาะเจาะจงสําหรับจุด

<ยกเว้น>
ค่าบูลีน ระบุว่าจะเชื่อมต่อจุดบนพื้นกับเส้นหรือไม่ หากต้องการดึงจุด ค่าของ <a ในส่วนMode> ต้องเป็น relativeToGround, relativeToSeaFloor หรือค่าสัมบูรณ์ จุดจะอยู่กลางศูนย์กลางของลูกโลก
<a ในส่วนโหมด>
ระบุวิธีการตีความคอมโพเนนต์ระดับความสูงในองค์ประกอบ <พิกัด> โดยค่าที่เป็นไปได้มีดังนี้
  • clampToGround - (ค่าเริ่มต้น) ระบุว่าไม่สนใจข้อกําหนดระดับความสูง (เช่น ในแท็ก <พิกัด>)
  • relativeToGround - ตั้งค่าระดับความสูงขององค์ประกอบให้สัมพันธ์กับระดับความสูงของพื้นดินจริงของสถานที่หนึ่ง เช่น หากระดับความสูงของพื้นของสถานที่หนึ่งตรงกับระดับน้ําทะเลทุกประการ และระดับความสูงสําหรับจุดหนึ่งถูกตั้งไว้ที่ 9 เมตร ระดับความสูงของไอคอนระดับความสูงของหมุดจะอยู่ที่ 9 เมตรในโหมดนี้ แต่หากพิกัดเดียวกันรวมอยู่ในตําแหน่งที่มีระดับความสูงเหนือระดับน้ําทะเล 10 เมตร ระดับความสูงของพิกัดจะเท่ากับ 19 เมตร โหมดนี้มักจะใช้สําหรับวางเสาโทรศัพท์หรือลิฟต์สกี
  • ค่าสัมบูรณ์ - ตั้งค่าระดับความสูงของพิกัดที่สัมพันธ์กับระดับน้ําทะเล โดยไม่คํานึงถึงระดับความสูงจริงของภูมิประเทศใต้องค์ประกอบ เช่น หากตั้งค่าระดับความสูงของพิกัดเป็น 10 เมตรด้วยโหมดระดับความสูงสัมบูรณ์ ไอคอนของหมุดจุดจะอยู่ที่ระดับพื้นดิน หากภูมิประเทศด้านล่างมีความสูงเกิน 10 เมตรเหนือระดับน้ําทะเลด้วย หากภูมิประเทศสูงกว่าระดับน้ําทะเล 3 เมตร หมุดจะปรากฏขึ้นบนพื้นสูง 7 เมตร การใช้งานโหมดนี้โดยทั่วไปมีไว้สําหรับการแสดงเครื่องบิน
<gx:a ในส่วนโหมด>
ส่วนขยาย KML ในเนมสเปซของส่วนขยาย Google ซึ่งช่วยให้ระดับความสูงที่เกี่ยวข้องกับก้นทะเล ค่าต่างๆ มีดังนี้
  • relativeToSeaFloor - ตีความระดับความสูงเป็นค่าในหน่วยเมตรเหนือก้นทะเล หากจุดเหนือพื้นดินไม่ใช่ทะเล ระดับความสูงจะได้รับการตีความว่าสูงเหนือพื้นดิน
  • clampToSeaFloor - ละเว้นข้อกําหนดระดับความสูง และจุดวางบนพื้นทะเล หากจุดบนพื้นดินไม่ใช่ทะเล จะมีจุดวางบนพื้น
<พิกัด>(ต้องระบุ)
ค่าเดี่ยวประกอบด้วยค่าแบบลอยสําหรับลองจิจูด ละติจูด และระดับความสูง (ตามลําดับ) ค่าลองจิจูดและละติจูดเป็นองศา โดยที่
  • ลองจิจูด ≥ ‐180 และ <= 180
  • ละติจูด ≥ ‐90 และ ≤ 90
  • ค่าระดับความสูง (ไม่บังคับ) เป็นเมตรเหนือระดับน้ําทะเล
อย่าใส่เว้นวรรคระหว่างค่า 3 ค่าที่อธิบายพิกัด

ตัวอย่าง

<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 ขึ้นไป และขอบเขตนี้จะกําหนดโดย VirtualRings เมื่อวาดรูปหลายเหลี่ยมแล้ว ขอบเขตจะเชื่อมต่อกับพื้นดินเพื่อสร้างรูปหลายเหลี่ยมเพิ่มเติม ซึ่งทําให้เห็นอาคารหรือกล่อง รูปหลายเหลี่ยมที่ตัดแล้วใช้ <PolyStyle> สําหรับสี โหมดสี และสีเติม

ต้องระบุ <พิกัด> สําหรับรูปหลายเหลี่ยมตามลําดับทวนเข็มนาฬิกา รูปหลายเหลี่ยมตาม "กฎด้านขวา" ซึ่งระบุว่าหากคุณวางนิ้วมือขวาไปในทิศทางที่ระบุพิกัด นิ้วโป้งจะชี้ไปในทิศทางทั่วไปของรูปเรขาคณิตปกติสําหรับรูปหลายเหลี่ยม (ในกราฟิก 3 มิติ ระบบจะใช้เครื่องหมายเรขาคณิตปกติสําหรับการจัดแสงและหันออกจากด้านหน้าของรูปหลายเหลี่ยม) เนื่องจาก Google Earth จะเติมเฉพาะด้านหน้าของรูปหลายเหลี่ยมเท่านั้น คุณจะได้รับผลลัพธ์ที่ต้องการเฉพาะเมื่อมีการระบุพิกัดตามลําดับที่เหมาะสมเท่านั้น มิฉะนั้น รูปหลายเหลี่ยมจะเป็นสีเทา

หมายเหตุ: ใน Google Earth รูป Polygon ที่มี <aระดับความสูงMode> เป็น clampToGround จะไปตามเส้นที่มีค่าคงที่อย่างต่อเนื่อง อย่างไรก็ตาม การเชิงเส้น (โดยใช้ตัวระบบเอง) ที่มี <aระดับความสูงMode> เป็น clampToGround จะไปตามเส้นวงกลมขนาดใหญ่

องค์ประกอบที่เฉพาะเจาะจงสําหรับรูปหลายเหลี่ยม

<ยกเว้น>
ค่าบูลีน ระบุว่าจะเชื่อมต่อรูปหลายเหลี่ยมกับพื้นหรือไม่ หากต้องการยกเว้นรูปหลายเหลี่ยม โหมดระดับความสูงต้องเป็น relativeToGround, relativeToSeaFloor หรือค่าสัมบูรณ์ เฉพาะจุดยอดมุมจะถูกตัดออก ไม่ใช่เรขาคณิต (เช่น สี่เหลี่ยมผืนผ้าจะเปลี่ยนเป็นกล่องที่มีใบหน้า 5 ใบหน้า จุดยอดมุมของรูปหลายเหลี่ยมถูกขุดออกมาตรงกลางของลูกโลก
<tessellate>
Polygon ไม่ได้ใช้ช่องนี้ หากต้องการอนุญาตให้ Polygon ติดตามภูมิประเทศ (กล่าวคือ เพื่อเปิดใช้การขายต่อยอด) ให้ระบุโหมดระดับความสูงของ clampToGround หรือ clampToSeaFloor
<a ในส่วนโหมด>
ระบุวิธีการตีความคอมโพเนนต์ระดับความสูงในองค์ประกอบ <พิกัด> โดยค่าที่เป็นไปได้มีดังนี้
  • clampToGround - (ค่าเริ่มต้น) ระบุว่าไม่สนใจข้อกําหนดระดับความสูง (เช่น ในแท็ก <พิกัด>)
  • relativeToGround - ตั้งค่าระดับความสูงขององค์ประกอบให้สัมพันธ์กับระดับความสูงของพื้นดินจริงของสถานที่หนึ่ง เช่น หากระดับความสูงของพื้นของสถานที่หนึ่งตรงกับระดับน้ําทะเลทุกประการ และระดับความสูงสําหรับจุดหนึ่งถูกตั้งไว้ที่ 9 เมตร ระดับความสูงของไอคอนระดับความสูงของหมุดจะอยู่ที่ 9 เมตรในโหมดนี้ แต่หากพิกัดเดียวกันรวมอยู่ในตําแหน่งที่มีระดับความสูงเหนือระดับน้ําทะเล 10 เมตร ระดับความสูงของพิกัดจะเท่ากับ 19 เมตร โหมดนี้มักจะใช้สําหรับวางเสาโทรศัพท์หรือลิฟต์สกี
  • ค่าสัมบูรณ์ - ตั้งค่าระดับความสูงของพิกัดที่สัมพันธ์กับระดับน้ําทะเล โดยไม่คํานึงถึงระดับความสูงจริงของภูมิประเทศใต้องค์ประกอบ เช่น หากตั้งค่าระดับความสูงของพิกัดเป็น 10 เมตรด้วยโหมดระดับความสูงสัมบูรณ์ ไอคอนของหมุดจุดจะอยู่ที่ระดับพื้นดิน หากภูมิประเทศด้านล่างมีความสูงเกิน 10 เมตรเหนือระดับน้ําทะเลด้วย หากภูมิประเทศสูงกว่าระดับน้ําทะเล 3 เมตร หมุดจะปรากฏขึ้นบนพื้นสูง 7 เมตร การใช้งานโหมดนี้โดยทั่วไปมีไว้สําหรับการแสดงเครื่องบิน
<gx:a ในส่วนโหมด>
ส่วนขยาย KML ในเนมสเปซของส่วนขยาย Google ซึ่งช่วยให้ระดับความสูงที่เกี่ยวข้องกับก้นทะเล ค่าต่างๆ มีดังนี้
  • relativeToSeaFloor - ตีความ<aระดับความสูง>เป็นค่าในหน่วยเมตรเหนือก้นทะเล หากจุดเหนือพื้นดินไม่ใช่ทะเล ระดับความสูงจะได้รับการตีความว่าสูงเหนือพื้นดิน
  • clampToSeaFloor - ละเว้นข้อกําหนดระดับความสูง และจุดวางบนพื้นทะเล หากจุดบนพื้นดินไม่ใช่ทะเล จะมีจุดวางบนพื้น
<outerBoundaryIs>(ต้องระบุ)
มีองค์ประกอบ <เชิงเส้นRing>
<inner BoundaryIs>
มีองค์ประกอบ <เชิงเส้นRing> รูปหลายเหลี่ยมประกอบด้วยองค์ประกอบ <internalBoundaryIs> หลายรายการที่สร้างการถูกตัดออกหลายรูปภายใน Polygon

ตัวอย่าง

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

ขยาย

มีอยู่โดย

<ภูมิภาค>

ไวยากรณ์

<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 ออบเจ็กต์ที่เชื่อมโยงกับภูมิภาคจะวาดเฉพาะเมื่อภูมิภาคนั้นทํางานอยู่ เมื่อ <viewRefreshMode> เป็น onRegion ระบบจะโหลดลิงก์หรือไอคอนเมื่อภูมิภาคทํางานอยู่เท่านั้น ดูรายละเอียดเพิ่มเติมได้ในหน้า "หัวข้อใน KML" ของภูมิภาค ในลําดับชั้นของคอนเทนเนอร์หรือ NetworkLink การคํานวณนี้ใช้ภูมิภาคซึ่งเป็นระดับบนระดับบนในลําดับชั้นมากที่สุด

องค์ประกอบที่เฉพาะเจาะจงสําหรับภูมิภาค

<LatLonAltBox>(ต้องระบุ)
กรอบล้อมรอบที่อธิบายพื้นที่ที่สนใจซึ่งอิงตามพิกัดทางภูมิศาสตร์และระดับความสูง ค่าเริ่มต้นและช่องที่ต้องกรอกมีดังนี้
<a ในส่วนMode> หรือ <gx:aระดับความสูงMode>
ค่าที่เป็นไปได้สําหรับ <aระดับความสูงMode> คือ clampToGround, relativeToGround และ Absolute ค่าที่เป็นไปได้สําหรับ <gx:a ในส่วนMode> คือ clampToSeaFloor และ relativeToSeaFloor ดู <LatLonBox>
<นาทีความสูง>
ระบุหน่วยเป็นเมตร (และได้รับผลกระทบจากข้อกําหนดของโหมดระดับความสูง)
<maxAระดับความสูง>
ระบุหน่วยเป็นเมตร (และได้รับผลกระทบจากข้อกําหนดของโหมดระดับความสูง)
<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> จะอธิบายขนาดของภูมิภาคที่คาดการณ์ไว้บนหน้าจอที่จําเป็นสําหรับภูมิภาคหนึ่งๆ เพื่อได้รับการพิจารณาว่า "ใช้งานอยู่" นอกจากนี้ ยังระบุขนาดของทางลาดพิกเซลที่ใช้สําหรับการจางลง (จากโปร่งใสไปจนถึงทึบ) และค่อยๆ จางลง (จากทึบแสงเป็นโปร่งใส) โปรดดูแผนภาพด้านล่างเพื่อแสดงภาพพารามิเตอร์เหล่านี้
<Lod>
<minLodPixels>256</minLodPixels>
<maxLodPixels>-1</maxLodPixels>
<minFadeExtent>0</minFadeExtent>
<maxFadeExtent>0</maxFadeExtent>
</Lod>
<minLodPixels> (ต้องระบุ)

กําหนดสี่เหลี่ยมจัตุรัสในพื้นที่หน้าจอโดยใช้ด้านข้างของค่าที่ระบุเป็นพิกเซล เช่น 128 กําหนดสี่เหลี่ยมจัตุรัสขนาด 128 x 128 พิกเซล กรอบล้อมรอบของภูมิภาคต้องใหญ่กว่าสี่เหลี่ยมจัตุรัสนี้ (และเล็กกว่า maxLodPixels สี่เหลี่ยมจัตุรัส) เพื่อให้ภูมิภาคทํางานอยู่

ดูรายละเอียดเพิ่มเติมได้ในบทการทํางานกับภูมิภาคของคู่มือสําหรับนักพัฒนาซอฟต์แวร์ รวมถึงบทแนะนําเกี่ยวกับเอกสารเกี่ยวกับการเข้าถึงของ Google Earth การหลีกเลี่ยงไม่ให้ใช้งานภูมิภาคมากเกินไป

<maxLodPixels>
การวัดเป็นพิกเซลบนหน้าจอที่แสดงขีดจํากัดสูงสุดสําหรับช่วงการมองเห็นของภูมิภาคนั้นๆ ค่าเริ่มต้นของ ‐1 จะบ่งชี้ว่า "ใช้งานอยู่เป็นขนาดที่ไม่มีที่สิ้นสุด"
<minFadeExtent>
ระยะทางที่เรขาคณิตจางลง ตั้งแต่ทึบแสงไปจนถึงโปร่งใสโดยสมบูรณ์ ค่าทางลาดนี้ซึ่งแสดงในหน่วยพิกเซลหน้าจอจะใช้ที่ส่วนท้ายของขีดจํากัด LOD (ระดับการเข้าถึง) ขั้นต่ํา
<maxFadeExtent>
ระยะทางที่เรขาคณิตจางลง ตั้งแต่ความโปร่งใสเต็มรูปแบบไปจนถึงความทึบแสงโดยสมบูรณ์ ค่าทางลาดนี้ซึ่งแสดงในหน่วยพิกเซลหน้าจอจะใช้ที่ค่าสูงสุดของขีดจํากัด LOD (ระดับการเข้าถึง)
ในแผนภาพต่อไปนี้ หาก 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 ต้องระบุแอตทริบิวต์ "id" และต้องไม่ซ้ํากันในไฟล์ KML <Schema> เป็นส่วนย่อยของ <เอกสาร> เสมอ

องค์ประกอบเฉพาะสําหรับสคีมา

องค์ประกอบของสคีมามีองค์ประกอบ SimpleField อย่างน้อย 1 รายการ ใน SimpleField สคีมาจะประกาศ type และ name ของช่องที่กําหนดเอง (ไม่บังคับ) ระบุ displayName (แบบฟอร์มที่ใช้ง่ายซึ่งมีการเว้นวรรคและเครื่องหมายวรรคตอนที่เหมาะสมสําหรับแสดงใน Google Earth) สําหรับช่องที่กําหนดเองนี้

<SimpleField type="string" name="string">
การประกาศช่องที่กําหนดเอง ซึ่งต้องระบุทั้งประเภทและชื่อของช่องนี้ หากไม่ได้ระบุ type หรือ name ระบบจะไม่สนใจช่องนี้ ประเภทอาจมีรูปแบบดังนี้
  • สตริง
  • int
  • Uint
  • วิดีโอสั้น
  • Ushort
  • จำนวนลอยตัว
  • คู่
  • บูลีน
<displayName>
หากมีชื่อที่จะแสดงให้ผู้ใช้เห็น Google Earth ถ้ามี ใช้องค์ประกอบ [CDATA] เพื่อออกจากมาร์กอัป HTML มาตรฐาน

ตัวอย่าง

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

ขยาย

นี่คือองค์ประกอบราก

มีอยู่โดย

ดูเพิ่มเติม

<ScreenScreen>

ไวยากรณ์

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

คำอธิบาย

องค์ประกอบนี้จะวาดการวางซ้อนภาพที่สอดคล้องกับหน้าจอ ตัวอย่างการใช้งานการวางซ้อนหน้าจอ ได้แก่ เข็มทิศ โลโก้ และจอแสดงผลแจ้งเตือน การปรับขนาดหน้าจอวางซ้อนจะกําหนดโดยองค์ประกอบ <size> ตําแหน่งของการวางซ้อนจะจัดการโดยการแมปจุดในรูปภาพที่ระบุโดย <โฆษณาซ้อนทับXY> กับจุดบนหน้าจอที่ระบุโดย <screenXY> จากนั้นจะหมุนรูปภาพตาม <rotation> องศาเกี่ยวกับจุดที่เกี่ยวข้องกับหน้าจอที่ระบุโดย <rotationXY>

แท็กย่อย <href> ของ <Icon> จะระบุรูปภาพที่จะใช้เป็นการวางซ้อน ไฟล์นี้อาจเป็นได้ทั้งระบบไฟล์ในเครื่องหรือเว็บเซิร์ฟเวอร์ หากละเว้นองค์ประกอบนี้หรือมี <href> อยู่ สี่เหลี่ยมผืนผ้าจะถูกวาดโดยใช้สีและขนาดที่กําหนดโดยการวางซ้อนหน้าจอ

องค์ประกอบที่เฉพาะเจาะจงสําหรับการวางซ้อนหน้าจอ

<โฆษณาซ้อนทับ XY>
ระบุจุดบน (หรือภายนอก) โฆษณาซ้อนทับที่แมปกับพิกัดหน้าจอ (<screenXY>) ค่านี้ต้องมีค่า x และ y และหน่วยสําหรับค่าเหล่านั้น
ค่า x และ y สามารถระบุได้ 3 วิธี คือ พิกเซล ("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 สามารถระบุได้ 3 วิธีดังนี้ พิกเซล ("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 x 500 พิกเซล ให้ทําดังนี้

<size x="100" y="500" xunits="pixels" yunits="pixels"/> 
<การหมุนเวียน>
ระบุมุมของการหมุนออบเจ็กต์หลัก ค่า 0 หมายความว่าไม่มีการหมุนเวียน ค่านี้คือมุมที่ทวนเข็มนาฬิกาเริ่มจากทิศเหนือ ใช้ ±180 เพื่อระบุการหมุนของออบเจ็กต์หลักจาก 0 ตรงกลางของ <rotation> หากไม่ใช่ (.5,.5) จะระบุไว้ใน <rotationXY>

ตัวอย่าง

ตัวอย่างต่อไปนี้จะวางรูปภาพที่กึ่งกลางที่แน่นอนของหน้าจอ โดยใช้ความกว้าง ความสูง และสัดส่วนภาพเดิมของรูปภาพ

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

ไวยากรณ์

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

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

คำอธิบาย

รูปแบบจะกําหนดกลุ่มรูปแบบที่ที่อยู่ได้ ซึ่งใช้อ้างอิงโดย StyleMaps และฟีเจอร์ สไตล์จะมีผลกับการแสดงเรขาคณิตในมุมมอง 3 มิติและลักษณะที่ฟีเจอร์จะปรากฏในแผงสถานที่ของมุมมองรายการ ระบบจะรวบรวมรูปแบบที่แชร์ไว้ใน<เอกสาร>และต้องระบุรหัสไว้เพื่อให้แต่ละฟีเจอร์อ้างอิงได้

ใช้ id เพื่ออ้างถึงสไตล์จาก <styleUrl>

ตัวอย่าง

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

ขยาย

มีอยู่โดย

องค์ประกอบเฉพาะสําหรับสไตล์

<StyleMap>

ไวยากรณ์

<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> จะแมประหว่างรูปแบบต่างๆ 2 รูปแบบ โดยปกติแล้วจะใช้องค์ประกอบ <StyleMap> เพื่อระบุรูปแบบปกติและไฮไลต์ที่แยกกันสําหรับหมุด เพื่อให้เวอร์ชันที่ไฮไลต์ปรากฏเมื่อผู้ใช้วางเมาส์เหนือไอคอนใน Google Earth

องค์ประกอบที่เฉพาะเจาะจงสําหรับ StyleMap

<จับคู่>(ต้องระบุ)
กําหนดคู่คีย์/ค่าที่จับคู่โหมด (ปกติหรือไฮไลต์) กับ <styleUrl> ที่กําหนดไว้ล่วงหน้า <จับคู่> มีองค์ประกอบ 2 อย่าง (ต้องระบุทั้งคู่)
  • <key> ซึ่งระบุคีย์
  • <styleUrl> หรือ <Style> ที่อ้างอิงสไตล์ ใน <styleUrl> สําหรับองค์ประกอบรูปแบบที่อ้างอิงที่อยู่เฉพาะในเอกสาร KML ระบบจะใช้การอ้างอิง # แบบง่าย สําหรับรูปแบบที่อยู่ในไฟล์ภายนอก ให้ใช้ URL แบบเต็มพร้อมข้อมูลอ้างอิง # รายการ เช่น
<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>

ไวยากรณ์

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

คำอธิบาย

นี่คือองค์ประกอบนามธรรมและไม่สามารถใช้ในไฟล์ KML ได้โดยตรง เป็นประเภทฐานสําหรับองค์ประกอบ <Style> และ <StyleMap> องค์ประกอบ StyleMaps จะเลือกสไตล์โดยอิงตามโหมดปัจจุบันของหมุด องค์ประกอบที่มาจาก StyleSelector ได้รับการระบุที่ไม่ซ้ําด้วย id และ URL ขององค์ประกอบดังกล่าว

องค์ประกอบที่เฉพาะเจาะจงสําหรับ StyleSelector

องค์ประกอบนามธรรมนี้ไม่มีองค์ประกอบย่อย

ขยาย

ขยายโดย

<เวลาพื้นฐาน>

ไวยากรณ์

<!-- 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 จะกําหนดตามเวลาของสคีมา XML (ดูสคีมา XML ส่วนที่ 2: Datatypes Second Edition) ค่าอาจแสดงเป็น yyyy-mm-ddThh:mm:ss.ssszzzzzz โดย T เป็นตัวคั่นระหว่างวันที่และเวลา และเขตเวลาจะเป็น Z (สําหรับ UTC) หรือ zzzzzz ซึ่งแสดง ±hh:mm เมื่อเทียบกับ UTC นอกจากนี้ ค่าจะแสดงเป็นวันที่เท่านั้นได้ ดูตัวอย่างได้ที่ <TimeStamp>

องค์ประกอบเฉพาะสําหรับ TimeSpan

<เริ่มต้น>
อธิบายเงื่อนไขเริ่มต้นของระยะเวลา หากไม่มีส่วนนี้ จุดเริ่มต้นของช่วงเวลาจะไม่มีขอบเขต
<สิ้นสุด>
อธิบายการสิ้นสุดทันทีของช่วงเวลา หากไม่มีส่วนนี้ จุดสิ้นสุดของช่วงเวลาจะไม่มีขอบเขต

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงระยะเวลาที่แสดงสถานะรัฐโคโลราโด โดยมีเพียงแท็ก <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 ที่ระบุในเวลา XML (ดูสคีมา XML ส่วนที่ 2: Datatypes Second Edition) ระบบจะกําหนดความแม่นยําของ TimeStamp ด้วยค่า dateTime ในองค์ประกอบ <when>

องค์ประกอบที่เฉพาะเจาะจงสําหรับการประทับเวลา

<เมื่อ>
ระบุช่วงเวลาสั้นๆ ที่เกิดขึ้น ค่าจะเป็น dateTime ซึ่งอาจเป็นอย่างใดอย่างหนึ่งต่อไปนี้
  • dateTime ให้ความละเอียดที่ 2
  • date ระบุวัน
  • gYearMonth ให้การแก้ปัญหาในเดือน
  • gYear แสดงถึงความละเอียดปี

ตัวอย่างต่อไปนี้แสดงความละเอียดแบบต่างๆ สําหรับค่า <when>

  • gYear (ปปปป)
<TimeStamp>
  <when>1997</when>
</TimeStamp>
  • gYearMonth (ปปปป-ดด)
<TimeStamp>
  <when>1997-07</when>
</TimeStamp> 
  • วันที่ (ปปปป-ดด-วว)
<TimeStamp>
  <when>1997-07-16</when>
</TimeStamp> 
  • dateTime (YYYY-MM-DDThh:mm:ssZ)
    T เป็นตัวคั่นระหว่างปฏิทินกับชั่วโมงรายชั่วโมง และ Z จะระบุ UTC (ต้องระบุวินาที)
<TimeStamp>
  <when>1997-07-16T07:30:15Z</when>
</TimeStamp>
  • dateTime (YYYY-MM-DDThh:mm:sszzzzzz)
    ตัวอย่างนี้ให้เวลาท้องถิ่นแล้วแปลง ± เป็น UTC
<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> ในเนมสเปซส่วนขยาย วิธีนี้จะช่วยให้รวมค่าเวลาใน AbstractViews (<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:Playlist - มีองค์ประกอบ gx:TourPrimitive จํานวนเท่าใดก็ได้ อาจมีองค์ประกอบ <gx:Playlist> จํานวน 1 หรือ 1 รายการที่อยู่ภายในองค์ประกอบ <gx:Tour>
    <gx:Tour>
      <gx:Playlist>
        <!-- gx:TourPrimitive -->
          ...
        <!-- /gx:TourPrimitive -->
    
        <!--- Any number of gx:TourPrimitive elements can be included --->
      </gx:Playlist>
    </gx:Tour>

<gx:TourPrimitive>

องค์ประกอบนี้เป็นส่วนขยายของมาตรฐาน 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:บิน>
  • <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>
    มีองค์ประกอบ <href> ที่ระบุไฟล์เสียงที่จะเล่นในรูปแบบ MP3, M4A หรือ AAC ไม่มีระยะเวลา ไฟล์เสียงจะเล่นควบคู่ไปกับทัวร์ที่เหลือ ซึ่งหมายความว่าทัวร์ต้นแบบถัดไปจะเกิดขึ้นทันทีหลังจากทัวร์ชมคอนเสิร์ต <gx:SoundCue> ระบบจะแยกไฟล์เสียงอื่นออกก่อนที่จะเล่นไฟล์แรกเสร็จ องค์ประกอบ <gx:delayedStart> จะระบุการหน่วงเวลาของการเริ่มเสียงของวินาทีที่ระบุก่อนเล่นไฟล์
  • <gx:TourControl>
    <gx:TourControl id="ID">
      <gx:playMode>pause</gx:playMode>    <!-- gx:playModeEnum: pause -->
    </gx:TourControl>
    มีองค์ประกอบ <gx:playMode> รายการเดียว ทําให้ทัวร์ชมหยุดชั่วคราวได้จนกว่าผู้ใช้จะดําเนินการทัวร์ชมต่อ
  • <gx:รอ>
    <gx:Wait id="ID">
      <gx:duration>0.0</gx:duration>    <!-- double -->
    </gx:Wait>
    กล้องจะยังอยู่ที่ 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>

คำอธิบาย

แทร็กอธิบายวิธีที่วัตถุเคลื่อนที่ผ่านโลกในช่วงเวลาที่กําหนด ฟีเจอร์นี้ช่วยให้คุณสร้างออบเจ็กต์ที่มองเห็นได้ 1 รายการใน Google Earth (ไอคอนจุดหรือโมเดล) ที่เข้ารหัสหลายตําแหน่งสําหรับออบเจ็กต์เดียวกันหลายครั้ง ใน Google Earth แถบเลื่อนเวลาช่วยให้ผู้ใช้สามารถย้ายมุมมองผ่านเวลา ซึ่งทําให้ตําแหน่งของวัตถุเคลื่อนไหวได้

องค์ประกอบ gx:MultiTrack ใช้สําหรับรวบรวมหลายแทร็กเป็นหน่วยแนวคิดเดียว พร้อมไอคอนที่เกี่ยวข้อง (หรือโมเดล) 1 รายการที่มีการเคลื่อนไหวไปตามแทร็ก ฟีเจอร์นี้มีประโยชน์หากคุณมีหลายแทร็กสําหรับออบเจ็กต์ในโลกจริง องค์ประกอบ <gx:interpolate> บูลีนของ <gx:MultiTrack> ระบุว่าจะแทรกระหว่างแทร็กในแทร็กหลายรายการหรือไม่ หากค่านี้เป็น 0 จุดหรือโมเดลจะหยุดที่ส่วนท้ายของแทร็กหนึ่งและข้ามไปยังจุดเริ่มต้นของแทร็กถัดไป (ตัวอย่างเช่น หากต้องการให้หมุดเดียวแสดงการเดินทางของคุณเป็นเวลา 2 วัน และหน่วย GPS ของคุณปิดเป็นเวลา 4 ชั่วโมงภายในช่วงเวลานี้ คุณอาจต้องการแสดงความไม่ต่อเนื่องระหว่างจุดที่เคยปิดหน่วยแล้วเปิดอีกครั้ง) หากค่าสําหรับ <gx:interpolate> คือ 1 ค่าระหว่างจุดสิ้นสุดของแทร็กแรกกับจุดเริ่มต้นของแทร็กถัดไปจะถูกแทรกเข้าไปเพื่อให้แทร็กเป็นเส้นทางเดียว

ดูข้อมูลเกี่ยวกับวิธีนําเข้าข้อมูล GPS ลงใน Google Earth ได้ที่คู่มือผู้ใช้ Google Earth

เหตุใดแทร็กจึงมีประโยชน์

KML เวอร์ชันก่อนหน้า (ก่อน Google Earth 5.2) ช่วยให้คุณเชื่อมโยงองค์ประกอบเวลากับฟีเจอร์ใดก็ได้ (หมุด การวางซ้อนพื้น ฯลฯ) อย่างไรก็ตาม คุณจะเชื่อมโยงองค์ประกอบเวลาได้เพียง 1 รายการกับฟีเจอร์ที่ระบุ การติดตามเป็นกลไกที่มีประสิทธิภาพมากขึ้นสําหรับการเชื่อมโยงข้อมูลเวลากับฟีเจอร์ที่มองเห็นได้ เนื่องจากคุณสร้างฟีเจอร์เพียงรายการเดียวเท่านั้น ซึ่งสามารถเชื่อมโยงกับองค์ประกอบเวลาหลายรายการเมื่อออบเจ็กต์เคลื่อนที่ผ่านอวกาศ

นอกจากนี้ องค์ประกอบการติดตามมีประสิทธิภาพมากกว่ากลไกก่อนหน้า (ดังที่อธิบายไว้ในส่วนเวลาและภาพเคลื่อนไหวของคู่มือนักพัฒนาซอฟต์แวร์ KML) เนื่องจาก <track> มีกลไกสําหรับตรวจสอบตําแหน่งของออบเจ็กต์ได้ทุกเมื่อขณะติดตาม ฟีเจอร์ใหม่นี้ทําให้ Google Earth แสดงกราฟของระดับความสูงและโปรไฟล์ความเร็ว (รวมถึงข้อมูลที่กําหนดเอง (หากมี)) เมื่อเวลาผ่านไป

ข้อมูล "เบาบาง"

เมื่อค่าข้อมูลบางค่าหายไปสําหรับตําแหน่งในแทร็ก คุณสามารถระบุแท็ก <coord/> (<coord></coord>) หรือ <angles/> (<angles></angles>) ว่างเปล่าเพื่อสร้างความสมดุลให้กับอาร์เรย์ แท็ก <coord/> หรือ <angles/> ว่างเปล่าบ่งบอกว่าไม่มีข้อมูลดังกล่าวสําหรับจุดข้อมูลที่ระบุ และค่าควรอยู่ระหว่างจุดข้อมูลสองจุดที่ใกล้เคียงที่สุด ลักษณะการทํางานนี้ยังใช้กับ ExtendedData สําหรับแทร็กอีกด้วย องค์ประกอบใดๆ ยกเว้น <when> เว้นว่างไว้ได้ และจะนําไปใช้ระหว่างองค์ประกอบ 2 อย่างที่ระบุได้ดีที่สุด

องค์ประกอบที่เฉพาะเจาะจงสําหรับการติดตาม

<a ในส่วนโหมด>
ระบุวิธีการตีความคอมโพเนนต์ระดับความสูงในองค์ประกอบ <พิกัด> โดยค่าที่เป็นไปได้มีดังนี้
  • clampToGround - (ค่าเริ่มต้น) ระบุว่าไม่สนใจข้อกําหนดระดับความสูง (เช่น ในแท็ก <gx:coord>)
  • relativeToGround - ตั้งค่าระดับความสูงขององค์ประกอบให้สัมพันธ์กับระดับความสูงของพื้นดินจริงของสถานที่หนึ่ง เช่น หากระดับความสูงของพื้นของสถานที่หนึ่งตรงกับระดับน้ําทะเลทุกประการ และระดับความสูงสําหรับจุดหนึ่งถูกตั้งไว้ที่ 9 เมตร ระดับความสูงของไอคอนระดับความสูงของหมุดจะอยู่ที่ 9 เมตรในโหมดนี้ แต่หากพิกัดเดียวกันรวมอยู่ในตําแหน่งที่มีระดับความสูงเหนือระดับน้ําทะเล 10 เมตร ระดับความสูงของพิกัดจะเท่ากับ 19 เมตร
  • ค่าสัมบูรณ์ - ตั้งค่าระดับความสูงของพิกัดที่สัมพันธ์กับระดับน้ําทะเล โดยไม่คํานึงถึงระดับความสูงจริงของภูมิประเทศใต้องค์ประกอบ เช่น หากตั้งค่าระดับความสูงของพิกัดเป็น 10 เมตรด้วยโหมดระดับความสูงสัมบูรณ์ ไอคอนของหมุดจุดจะอยู่ที่ระดับพื้นดิน หากภูมิประเทศด้านล่างมีความสูงเกิน 10 เมตรเหนือระดับน้ําทะเลด้วย หากภูมิประเทศสูงกว่าระดับน้ําทะเล 3 เมตร หมุดจะปรากฏขึ้นบนพื้นสูง 7 เมตร
<gx:a ในส่วนโหมด>
ส่วนขยาย KML ในเนมสเปซของส่วนขยาย Google ซึ่งช่วยให้ระดับความสูงที่เกี่ยวข้องกับก้นทะเล ค่าต่างๆ มีดังนี้
  • relativeToSeaFloor - ตีความระดับความสูงเป็นค่าในหน่วยเมตรเหนือก้นทะเล หากจุดเหนือพื้นดินไม่ใช่ทะเล ระดับความสูงจะได้รับการตีความว่าสูงเหนือพื้นดิน
  • clampToSeaFloor - ละเว้นข้อกําหนดระดับความสูง และจุดวางบนพื้นทะเล หากจุดบนพื้นดินไม่ใช่ทะเล จะมีจุดวางบนพื้น
<เมื่อ>
ค่า time ที่ตรงกับ position (ระบุไว้ในองค์ประกอบ <gx:coord>) จํานวนองค์ประกอบ <when> ใน <Track> ต้องเท่ากับจํานวนองค์ประกอบ <gx:coord> (และองค์ประกอบ <gx:angles> หากมี)
<gx:coord>
ค่าพิกัดประกอบด้วย 3 ค่าสําหรับลองจิจูด ละติจูด และระดับความสูง โดยไม่มีตัวคั่นคอมมา เช่น
<gx:coord>-122.207881 37.371915 156.000000</gx:coord>

โปรดทราบว่าไวยากรณ์สําหรับองค์ประกอบ <gx:coord> แตกต่างจากไวยากรณ์สําหรับองค์ประกอบ <พิกัด> ซึ่งใช้คอมมาเพื่อคั่นลองจิจูด ละติจูด และระดับความสูง จํานวนองค์ประกอบ ที่ระบุควรเท่ากับจํานวนเวลา () และองค์ประกอบตําแหน่ง () นอกจากนี้ ยังระบุองค์ประกอบ <gx:coord> ว่างเปล่าสําหรับค่าที่ขาดหายไปได้ด้วย หากจําเป็น

<gx:angles>
ค่านี้ใช้เพื่อระบุค่าส่วนหัว การเอียง และค่าภาพรวมเพิ่มเติมให้กับไอคอนหรือโมเดลสําหรับแต่ละเวลา/ตําแหน่งภายในแทร็ก ค่าคะแนนแบบลอย 3 ค่าจะแสดงโดยไม่มีตัวคั่นคอมมาและแสดงถึงระดับการหมุนเวียน หากไม่ได้ระบุ <gx:angles> Google Earth จะอนุมานส่วนหัว เอียง และม้วนวัตถุจากแทร็ก จํานวนองค์ประกอบ <gx:angles> ที่ระบุควรเท่ากับจํานวนเวลา (<when>) และองค์ประกอบตําแหน่ง (<gx:coord>) นอกจากนี้ คุณยังระบุองค์ประกอบ <gx:angles> ที่ว่างเปล่าสําหรับค่าที่ขาดหายไปได้ด้วย หากจําเป็น

ปัจจุบันไอคอนรองรับเฉพาะส่วนหัว แต่โมเดลรองรับทั้ง 3 ค่า

ตัวอย่างการตั้งค่านี้

<gx:angles>45.54676 66.2342 77.0</gx:angles>
<รุ่น>
หากระบุ รูปแบบจะแทนที่ไอคอนจุดเพื่อระบุตําแหน่งปัจจุบันในแทร็ก เมื่อระบุ <Model> ภายใน <gx:Track> องค์ประกอบย่อยของฟังก์ชัน <Model> มีดังนี้
  • ระบบจะไม่สนใจองค์ประกอบ <Location>
  • ระบบจะไม่สนใจองค์ประกอบ <a ในส่วนMode>
  • ค่า <Orientation> จะรวมกับการวางแนวของแทร็กดังนี้ ก่อนอื่นให้ใช้การหมุน <Orientation> ซึ่งทําให้โมเดลจากระบบพิกัดในเครื่อง (x, y, z) ไปเป็นการวางแนวที่หันไปทางด้านขวาและทิศเหนือ จากนั้น จะมีการใช้การหมุนที่ตรงกับการประมาณค่า <gx:angles> ที่ส่งผลต่อส่วนหัว การเอียง และท่าโมเดลเมื่อเคลื่อนที่ไปตามแทร็ก หากไม่มีการระบุมุม ส่วนหัวและเอียงจะอนุมานจากการเคลื่อนไหวของโมเดล

    เคล็ดลับ: หากไม่แน่ใจเกี่ยวกับวิธีระบุการวางแนว ให้ละเว้นองค์ประกอบ <Orientation> จาก <Model> แล้วดูว่า Google Earth วางตําแหน่งโมเดลขณะที่เคลื่อนที่ไปตามแทร็กอย่างไร หากคุณสังเกตเห็นว่าด้านหน้าของโมเดลหันไปด้านข้าง ให้แก้ไของค์ประกอบ <heading> ใน <Orientation> เพื่อหมุนโมเดลเพื่อให้หันไปด้านหน้า หากโมเดลไม่ถูกต้อง ให้ลองแก้ไของค์ประกอบ <tilt> หรือ <roll>

<ขยายข้อมูล>

องค์ประกอบข้อมูลที่กําหนดเองที่กําหนดไว้ใน <สคีมา> ก่อนหน้านี้ในไฟล์ KML

การเพิ่มข้อมูลขยายที่เชื่อมโยงกับเวลา/ตําแหน่งแต่ละแทร็กในแทร็กมักจะมีประโยชน์ ตัวอย่างเช่น การขี่จักรยานอาจมีข้อมูลอัตราการเต้นของหัวใจ จังหวะ และพลังงาน ดังที่แสดงในตัวอย่างแทร็กที่มีข้อมูลแบบขยาย ใน <สคีมา> คุณกําหนด <gx:SimpleArrayField> สําหรับข้อมูลที่กําหนดเองแต่ละประเภท จากนั้น สําหรับข้อมูลแต่ละประเภท ให้ใส่องค์ประกอบ <gx:SimpleArrayData> ที่มีองค์ประกอบ <gx:value> ที่ตรงกับเวลา/ตําแหน่งทั้งหมดในแทร็ก โปรดดูส่วนการเพิ่มข้อมูลที่กําหนดเองในคู่มือสําหรับนักพัฒนาซอฟต์แวร์ KML เพื่อดูข้อมูลเพิ่มเติมเกี่ยวกับการเพิ่มช่องข้อมูลใหม่ ใน Google Earth ข้อมูลที่กําหนดเองจะแสดงในโปรไฟล์ระดับความสูงสําหรับแทร็กนั้น

ตัวอย่างง่ายๆ

ตัวอย่างพื้นฐานนี้แสดงวิธีสร้าง "อาร์เรย์" ค่าพร้อมกันสําหรับ <when> และ <gx:coord> จํานวนเวลาและค่าตําแหน่งต้องเท่ากัน

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

ตัวอย่างแทร็กที่มีข้อมูลแบบขยาย

ประเภทตัวหนาในตัวอย่างนี้ไฮไลต์องค์ประกอบที่ใช้ในการกําหนดและระบุข้อมูลที่กําหนดเองสําหรับการขี่จักรยาน ช่องข้อมูลที่กําหนดเองมีชื่อว่า "หัวใจ" "จังหวะ" และ "กําลัง" องค์ประกอบ <สคีมา> กําหนดชื่อที่จะแสดงสําหรับค่าแต่ละชุด (อัตราการเต้นของหัวใจ, แผน และอํานาจ) และระบุประเภทข้อมูลสําหรับช่องใหม่แต่ละรายการ (อัตราการเต้นและจังหวะเป็นประเภท int และกําลังอยู่ในประเภท float) ใน Google Earth ข้อมูลที่กําหนดเองนี้จะแสดงพร้อมโปรไฟล์ระดับความสูงสําหรับแทร็ก

ตัวอย่างนี้เป็นการนําเสนอแทร็กที่สมจริงมากขึ้น มาพร้อมไอคอนที่กําหนดเอง ไอคอนและเส้นที่แยกจากกัน สําหรับไฮไลต์และโหมดปกติ อย่างไรก็ตาม โปรดทราบว่าตัวอย่างนี้มีค่าข้อมูลแค่ 7 ชุด ตัวอย่างจริงประกอบด้วยค่าหลายหมื่นค่า (เอื้อเฟื้อข้อมูลจาก Sean Broeder ข้อมูลนี้ได้รับการรวบรวมด้วย 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>

ขยาย

มีอยู่โดย

  • <เรขาคณิตหลายรูป>
  • <gx:MultiTrack>
  • <หมุด>

<อัปเดต>

ไวยากรณ์

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

คำอธิบาย

ระบุการเพิ่ม การเปลี่ยนแปลง หรือลบข้อมูล KML ที่โหลดแล้วโดยใช้ URL ที่ระบุ <targetHref> จะระบุไฟล์ .NFC หรือ .kmz ที่จะแก้ไขข้อมูล (ภายใน Google Earth) <Update> จะอยู่ใน NetworkLinkControl เสมอ นอกจากนี้ ไฟล์ที่มี NetworkLinkControl จะต้องโหลดโดย NetworkLink ดูตัวอย่าง "วิธีการทํางานของการอัปเดต" ได้ในหน้า "หัวข้อใน KML" ในการอัปเดต

องค์ประกอบสําหรับการอัปเดตโดยเฉพาะ

อาจมีองค์ประกอบ <Change>, <Create> และ <Delete> มากมาย ซึ่งจะได้รับการประมวลผลตามลําดับ

<targetHref>(ต้องระบุ)
URL ที่ระบุไฟล์ . KML หรือ .kmz ที่มีการแก้ไของค์ประกอบ <Update> ภายในข้อมูล (ภายใน Google Earth) ไฟล์ KML นี้เคยต้องโหลดผ่าน <NetworkLink> แล้ว ในไฟล์ที่จะแก้ไข ต้องมีการกําหนดแอตทริบิวต์ id ที่ชัดเจนสําหรับไฟล์นั้น
<เปลี่ยน>
แก้ไขค่าในองค์ประกอบที่โหลดด้วย <NetworkLink> แล้ว ในองค์ประกอบการเปลี่ยนแปลง องค์ประกอบย่อยที่แก้ไขต้องมีแอตทริบิวต์ targetId ที่อ้างอิงถึง id ขององค์ประกอบเดิม
การอัปเดตนี้ถือว่าเป็น "การอัปเดตที่น้อย": ในองค์ประกอบที่แก้ไข ระบบจะแทนที่เฉพาะค่าที่ระบุใน <Change> เท่านั้น โดยค่าอื่นๆ ทั้งหมดจะยังคงเหมือนเดิม เมื่อใช้ <Change> กับชุดพิกัด พิกัดใหม่จะแทนที่พิกัดปัจจุบัน
องค์ประกอบนี้ขององค์ประกอบคือองค์ประกอบที่ต้องแก้ไขซึ่งระบุโดยแอตทริบิวต์ targetId
<สร้าง>
เพิ่มองค์ประกอบใหม่ไปยังโฟลเดอร์หรือเอกสารที่โหลดผ่าน <NetworkLink> องค์ประกอบ <targetHref> ใน <Update> ระบุ URL ของไฟล์ .src หรือ .kmz ที่มีโฟลเดอร์หรือเอกสารต้นฉบับ ภายในไฟล์นั้น โฟลเดอร์หรือเอกสารที่มีข้อมูลใหม่จะต้องมีการกําหนด id ที่ชัดเจนไว้อยู่แล้ว id นี้ถือว่าเป็นแอตทริบิวต์ targetId ของโฟลเดอร์หรือเอกสารภายใน <Create> ที่มีองค์ประกอบที่จะเพิ่ม
เมื่อสร้างและโหลดออบเจ็กต์ไปยัง Google Earth แล้ว ออบเจ็กต์ดังกล่าวจะใช้ URL ของเอกสารโฟลเดอร์ระดับบนสุด หากต้องการทําการอัปเดตออบเจ็กต์ที่เกิดขึ้นภายหลังด้วยกลไกการอัปเดต/สร้างนี้ ให้ตั้งค่า <targetHref> เป็น URL ของเอกสารหรือโฟลเดอร์ต้นฉบับ (ไม่ใช่ URL ของไฟล์ที่โหลดการอัปเดตที่แทรกแซง)
<ลบ>
ลบฟีเจอร์จากองค์ประกอบที่ซับซ้อนซึ่งโหลดผ่าน <NetworkLink> แล้ว องค์ประกอบ <targetHref> ใน <Update> ระบุไฟล์ . KML หรือ .kmz ที่มีข้อมูลที่จะลบ ในไฟล์นั้น องค์ประกอบที่จะลบต้องมี id ที่ชัดเจนอยู่แล้ว องค์ประกอบ <Delete> อ้างอิง id นี้ในแอตทริบิวต์ targetId
องค์ประกอบย่อยของ <Delete> ซึ่งเป็นองค์ประกอบเดียวที่ลบได้ ได้แก่ เอกสาร โฟลเดอร์ GroundGround หมุด และ Screenโฆษณาซ้อนทับ

ตัวอย่างของ <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> 

ตัวอย่างของ <Create>

ตัวอย่างนี้สร้างหมุดใหม่ในเอกสารที่สร้างขึ้นก่อนหน้านี้ซึ่งมี id เป็น "region24" โปรดทราบว่าหากคุณต้องการอัปเดต "placemark891" ต่อไป คุณจะยังใช้ http://myserver.com/Point.src เป็น <targetHref>

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

ตัวอย่างของ <Delete>

ตัวอย่างนี้ลบหมุดที่โหลดไว้ก่อนหน้านี้ใน Google Earth (หมุดนี้อาจโหลดโดยตรงโดย NetworkLink ที่มี URL ที่ระบุ หรืออาจโหลดโดยการอัปเดตเอกสารต้นฉบับที่ตามมา)

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

มีอยู่โดย

<Url>

หมายเหตุ: องค์ประกอบนี้เลิกใช้งานแล้วใน KML รุ่น 2.1 และแทนที่ด้วย <Link> ซึ่งมีฟังก์ชันการทํางานเพิ่มเติมจาก ภูมิภาค แท็ก <Url> จะยังคงทํางานอยู่ใน Google Earth แต่เราขอแนะนําให้ใช้แท็ก <Link> ที่ใหม่กว่า

ใช้องค์ประกอบนี้เพื่อตั้งค่าตําแหน่งของลิงก์ไปยังไฟล์ KML เพื่อกําหนดตัวเลือกการรีเฟรชสําหรับเซิร์ฟเวอร์และผู้ดูการเปลี่ยนแปลง และป้อนข้อมูลตัวแปรเพื่อแสดงข้อมูลไคลเอ็นต์ที่เป็นประโยชน์ไปยังเซิร์ฟเวอร์

กลับไปด้านบน