مرجع KML

يحتوي هذا القسم على مرجع أبجدي لجميع عناصر KML المحددة في الإصدار 2.2 من KML، بالإضافة إلى العناصر في مساحة اسم إضافة Google. يتم عرض شجرة فئات عناصر KML أدناه. في هذا الرسم البياني، تكون العناصر الموجودة على اليمين بفرع معين في الشجرة عبارة عن إضافات للعناصر على يسارها. على سبيل المثال، تُعد العلامة الموضعية نوعًا خاصًا من الميزات. وهو يحتوي على جميع العناصر التي تنتمي إلى العنصر، ويضيف بعض العناصر الخاصة بعنصر العلامة الموضعية.

KML هو معيار مفتوح رسميًا يسمى OpenGIS® KML Encoding Standard (OGC KML). تتم صيانتها بواسطة Open Geospatial Consortium, Inc. (OGC). يمكن العثور على المواصفات الكاملة لملف KML OGC على http://www.opengeospatial.org/standards/kml/.

مخطط XML الكامل لملف KML موجود على http://schemas.opengis.net/kml/.

ملاحظة: انقر على اسم أحد العناصر في هذا الرسم التخطيطي للانتقال بسرعة إلى إدخال العنصر في القسم المرجعي.

رسم بياني تدرّجي للصف عنصر الكائن (الأصل) عنصر gx:Tour، عنصر فرعي للميزة عنصر NetworkLink، عنصر فرعي للميزة عنصر علامة موضعية؛ عنصر فرعي للعنصر عنصر التراكب؛ عنصر ثانوي للميزة عنصر الحاوية؛ عنصر فرعي للميزة عنصر الميزة عنصر هندسي؛ عنصر ثانوي للكائن عنصر تراكب الصور؛ عنصر ثانوي للتراكب تراكب الشاشة؛ عنصر ثانوي للتراكب عنصر GroundOverlay، عنصر ثانوي للتراكب عنصر المجلد؛ عنصر فرعي للحاوية عنصر المستند، عنصر فرعي للحاوية عنصر النقطة؛ عنصر هندسي عنصر LineString؛ عنصر هندسي عنصر linearRing، عنصر هندسي فرعي عنصر الرابط: عنصر ثانوي عنصر الرمز؛ عنصر فرعي للرابط عنصر اتجاه؛ عنصر ثانوي للعنصر عنصر الموقع، عنصر ثانوي للعنصر عنصر التدرج؛ عنصر ثانوي للكائن عنصر مضلع؛ عنصر فرعي للهندسة عنصر متعدد الأبعاد؛ عنصر فرعي للهندسة عنصر نموذج، عنصر فرعي للهندسة المتعددة عنصر التتبع:عنصر تعقب؛ عنصر هندسي عنصر النمط، عنصر فرعي لـ StyleSelector gx:عنصر متعدد المسارات؛ عنصر هندسي فرعي عنصر StyleSelector؛ عنصر ثانوي للكائن عنصر StyleMap، عنصر فرعي لمحدد النمط عنصر TimePrimitive، عنصر ثانوي للكائن عنصر TimeSpan؛ عنصر الثانوي لـ TimePrimitive xx:الطابع الزمني عنصر AbstractView، عنصر ثانوي للكائن عنصر الكاميرا، عنصر ثانوي من AbstractView عنصر LookAt؛ عنصر ثانوي من AbstractView عنصر المنطقة؛ عنصر ثانوي للكائن عنصر لود؛ عنصر ثانوي للكائن LatLonBox العنصر؛ عنصر ثانوي من Object LatLonAltBox العنصر؛ عنصر ثانوي للكائن عنصر Gat:LatLonQuad؛ رأس الكائن عنصر النمط الفرعي؛ عنوان كائن عنصر BalloonStyle؛ عنصر فرعي لـ SubStyle عنصر ColorStyle؛ عنصر فرعي للنمط الفرعي عنصر ListStyle؛ عنصر فرعي للنمط الفرعي عنصر xx:TimeSpan؛ عنصر فرعي لـ TimeSpan عنصر الطابع الزمني؛ عنصر ثانوي في TimePrimitive عنصر styleStyle؛ عنصر فرعي لـ ColorStyle عنصر نمط النمط؛ عنصر فرعي لـ ColorStyle عنصر نمط النمط؛ عنصر فرعي لـ ColorStyle عنصر LabelStyle؛ النمط الفرعي لـ ColorStyle xx:عنصر TourPrimitive؛ عنصر ثانوي تحديث:AnimatedUpdate عنصر gx:FlyTo؛ عنصر فرعي لـ TourPrimitive عنصر xx:SoundCue ؛ عنصر من نوع TourPrimitive xx:عنصر TourControl؛ عنصر gx:TourPrimitive عنصر x:الانتظار؛ العنصر الثانوي لـ gx:TourPrimitive gx:PlayList عنصر؛ عنصر ثانوي للعنصر

لاحظ أن العناصر المجرّدة (التي تظهر في المربعات في الرسم البياني) لا تُستخدم فعليًا في ملفات KML. وتُعد طريقة مفيدة لعنصر واحد ليكون أساسًا آليًا لعناصر مشتقة مشابهة (ولكن مختلفة). ويُعد فهم هذا العرض الهرمي الموجّه للكائنات طريقة جيدة بالنسبة إليك لتعلم KML، حيث يمكنك مشاهدة مجموعات من العناصر ذات الصلة بسهولة.

يمكن تعيين id (المعرّف) لجميع العناصر المستمدة من Object. يتم استخدام id هذا من خلال آلية تحديث KML (راجع <تحديث>) للملفات التي تم تحميلها باستخدام 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

يوفّر معيار OGC KML آلية للإضافات - وهي عناصر إضافية تحتوي على معلومات تتجاوز ما هو متوفّر في المعيار (تعرَّف على مزيد من المعلومات عن مساحات أسماء 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/kml22gx.xsd.

حقول KML

يستخدم KML أنواع XML شائعة مثل منطقية وسلسلة ومزدوجة وعائمة وint. بالإضافة إلى ذلك، فإنه يحدد عددًا من أنواع عناصر الحقول. يسرد الجدول التالي بعض الأنواع الأكثر شيوعًا التي تم تعريفها في KML وروابط إلى نماذج من العناصر التي تستخدمها:

نوع الحقل القيمة مثال للاستخدام
altitudeModeEnum clampToGround، نسبي إلى TOGround، مطلق راجع <LookAt> و<Region>
angle90 قيمة ≥90 و≤90 راجع <latitude> في <Model>
anglepos90 القيمة ≥0 و≤90 راجع <tilt> في <LookAt>
angle180 القيمة ≥180 و≤180 شاهد <longitude> في <Model>
angle360 القيمة ≥360 و≤360 الاطّلاع على العنوان <heading> باللغة <Orientation>
color (اللون) السداسي الثنائي: aabbggrr عرض أي عنصر يمتد <ColorStyle>
colorModeEnum عادي، عشوائي عرض أي عنصر يمتد <ColorStyle>
التاريخ والوقت dateTime، التاريخ، gYearMonth، gYear راجع <TimeSpan> و<TimeStamp>
displayModeEnum تلقائي، إخفاء الاطّلاع على <BalloonStyle>
gridOrigin lowerLeft، في الجانب العلوي الأيسر الاطّلاع على <PhotoOverlay>
refreshModeEnum onChange وonInterval وonExpire راجع <Link>
shapeEnum مستطيل، أسطوانة، كرة الاطّلاع على <PhotoOverlay>
styleStateEnum عادي، تمييز راجع <StyleMap>
unitsEnum الكسر، وحدات البكسل، insetPixels راجع <hotSpot> في <IconStyle>، <ScreenOverlay>
vec2 ==double <units=kml:unitsEnum
y=double yunits=kml: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>.

لتوسيع

العناصر الخاصة بـ AbstractView

<gx:ViewerOptions>
يتيح هذا العنصر أوضاع عرض خاصة في Google Earth 6.0 والإصدارات الأحدث. تتضمن عنصر <gx:option> واحدًا أو أكثر. يحتوي العنصر <gx:option> على سمة name وسمة enabled. تحدد name أحد العناصر التالية: صور التجوّل الافتراضي ("التجوّل الافتراضي")، والصور التاريخية ("الصور التاريخية")، وتأثيرات ضوء الشمس لفترة معينة من اليوم ("ضوء الشمس"). تُستخدَم السمة enabled لتفعيل وضع عرض معيّن أو إيقافه.
<gx:horizFov>
يحدد حقل العرض الأفقي لـ AbstractView أثناء جولة. ليس لهذا العنصر أي تأثير في AbstractViews خارج الجولة. يتم إدراج <gx:horizFov> تلقائيًا بواسطة عميل Google Earth (الإصدار 6.1 والإصدارات الأحدث) أثناء تسجيل الجولة. يتم تعيين قيم AbstractView العادية على 60، في حين يتم تعيين قيم 85 للمشاهدات في التجوّل الافتراضي لمطابقة حقل التجوّل الافتراضي القياسي في Google Earth. وبعد الضبط، سيتم تطبيق القيمة على الملفات الشخصية اللاحقة حتى يتم تحديد قيمة جديدة.

تمديد بمقدار

<gx:altitudeMode>

هذا العنصر هو امتداد لمعيار OGC KML 2.2 ويتم دعمه في Google Earth 5.0 والإصدارات الأحدث. مزيد من المعلومات

البنية

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

الوصف

يمكن استخدامها بدلاً من عنصر OGC KML القياسي <altitudeMode>، وتقبل القيم التالية بالإضافة إلى قيم altitudeMode القياسية:

  • relativeToSeaFloor - تفسير الارتفاع على أنه قيمة بالأمتار فوق قاع البحر. إذا كانت ميزة KML فوق الأرض بدلاً من سطح البحر، فسيتم تفسير الارتفاع على أنه فوق سطح الأرض.
  • clampToSeaFloor - يتم تجاهل مواصفات الارتفاع، وسيتم وضع عنصر KML في قاع البحر. إذا كانت ميزة KML على الأرض وليس في البحر، سيتم تثبيت clampToSeaFloor على الأرض بدلاً من ذلك.

على غرار <altitudeMode>، يؤثر <gx:altitudeMode> في:

  • إحداثي الارتفاع داخل عنصر <coordinates>
  • <minAltitude> و<maxAltitude> ضمن <LatLonAltBox>
  • <altitude> داخل <Location> و<GroundOverlay> وAbstractView (<LookAt> و<Camera>).

يتوفر المزيد من المعلومات حول أوضاع الارتفاع في فصل أوضاع الارتفاع من دليل مطوري KML.

مثال

altitudemode_reference.kml

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

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

</kml>

 

<gx:AnimatedUpdate>

هذا العنصر هو امتداد لمعيار 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:duration>
يحدد هذا الإعداد الفترة الزمنية بالثواني التي يتم خلالها التحديث.
<gx:delayedStart>
يحدد هذا الإعداد عدد الثواني المطلوب انتظارها (بعد موضع البدء المضمّن) قبل بدء التحديث.

مثال

يوضح المثال أدناه تغييرًا في حجم الرمز. ستتم إضافة هذا التغيير إلى الحركة لمدة 5 ثوانٍ.

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

البنية

<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>، في حالة تحديده، كلون خلفية للبالون. راجع <Feature> للحصول على رسم بياني يوضح كيفية ظهور بالون الوصف الافتراضي في Google Earth.

عناصر خاصة بالبالون

<bgColor>
لون خلفية البالون (اختياري). يتم التعبير عن قيم اللون والتعتيم (ألفا) في تدوين سداسي عشري. نطاق القيم لأي لون هو 0 إلى 255 (00 إلى ff). ويكون ترتيب التعبير aabbggrr، حيث aa=alpha (00 إلى ff)؛ bb=blue (00 إلى ff)؛ gg=green (00 to ff)؛ rr=red (00 إلى ff). بالنسبة إلى ألفا، يكون 00 شفافًا تمامًا وff غير معتم بالكامل. على سبيل المثال، إذا كنت تريد تطبيق لون أزرق مع تعتيم بنسبة 50 في المائة على تراكب، فيمكنك تحديد ما يلي: <bgColor>7fff0000</bgColor>، حيث alpha=0x7f وblue=0xff وgreen=0x00 وred=0x00. الافتراضي هو اللون الأبيض المبهم (ffffffff).

ملاحظة: تم إيقاف استخدام العنصر <color> داخل <BalloonStyle>. استخدم <bgColor> بدلاً من ذلك.

<textColor>
لون المقدمة للنص. الافتراضي هو الأسود (ff000000).
<text>
النص المعروض في البالون. إذا لم يتم تحديد أي نص، فيعمل برنامج Google Earth على رسم البالون الافتراضي (وتكون الميزة <name> بالخط العريض، وميزة <description>، وروابط لاتجاهات القيادة، والخلفية البيضاء، والذيل الملحق بإحداثيات النقطة للعنصر، في حالة تحديده).
يمكنك إضافة كيانات إلى العلامة <text> باستخدام التنسيق التالي للإشارة إلى عنصر فرعي للعنصر: $[name] أو $[description] أو $[address] أو $[id] أو $[Snippet]. يبحث Google Earth في الميزة الحالية عن كيان السلسلة المقابل ويستبدل تلك المعلومات في البالون. لتضمين اتجاهات القيادة إلى هنا - من هنا في البالون، استخدم العلامة $[geDirections]. لمنع ظهور روابط اتجاهات القيادة في بالون، يمكنك تضمين عنصر <text> مع بعض المحتوى، أو باستخدام $[description] لاستبدال العنصر الأساسي <description>.
على سبيل المثال، في مقتطف KML التالي، سيتم استبدال حقلي $[name] و$[description] بالحقلَين <name> و<description> اللذَين يستخدمان نمط البالون: يستخدم هذا العنصر
<text>This is $[name], whose description is:<br/>$[description]</text>
هذا النمط للكرة:
<text>This is $[name], whose description is:<br/>$[description]</text>
<displayMode>
إذا كان <displayMode> هو default، فسيستخدم Google Earth المعلومات المقدمة في <text> لإنشاء بالون . إذا كان <displayMode> إخفاء، لن يعرض Google Earth البالون. في Google Earth، يؤدي النقر على رمز عرض القائمة لعلامة موضعية يكون <إخفاء> بالونها إلى جعل برنامج 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:balloonvisibility>

هذا العنصر هو امتداد لمعيار 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> مع علامة موضعية. عند تحميل العلامة الموضعية، يتم فتح بالون الوصف.
balloonvisibility_example.kml

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

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

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

يوضح المثال الثاني استخدام <gx:balloonVisibility> ضمن جولة. يتم فتح عدد من البالونات وإغلاقها خلال الجولة، مما يوفر معلومات للمشاهد.
balloonvisibility_tourexample.kml

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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


  </Document>
</kml>

لتوسيع

<الكاميرا>

البنية

<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> و<latitude> و<height> وإما <altitudeMode> أو <gx:altitudeMode>. يتم تحديد اتجاه العرض للكاميرا من خلال <heading> و<tilt> و<roll>. يمكن أن يكون <Camera> عنصرًا فرعيًا في أي ميزة أو في <NetworkLinkControl>. لا يمكن أن يحتوي العنصر الرئيسي <للعنصر < في الوقت نفسه على عنصر < في نفس الوقت وفي نفس الوقت.

توفر الكاميرا >تحكم كامل في ست درجات من الحرية في العرض، لذا يمكنك وضع الكاميرا في الفضاء ثم تدويرها حول المحاور X وY وZ. والأهم من ذلك أنه يمكنك إمالة عرض الكاميرا بحيث تنظر عبر الأفق إلى السماء.

يمكن أن تحتوي الكاميرا أيضًا على TimePrimitive (<gx:TimeSpan> أو <gx:TimeStamp>). تؤثر القيم الزمنية في "الكاميرا" في الصور السابقة وضوء الشمس وعرض الميزات ذات الطابع الزمني. للحصول على مزيد من المعلومات، يُرجى الاطلاع على Time with AbstractViews في الفصل Time and Animation من دليل المطوِّر.

تعريف ملف شخصي

داخل إحدى الميزات أو <NetworkLinkControl>، استخدم إما كائن <الكاميرا> أو كائن <LookAt> (ولكن ليس كليهما في الكائن نفسه). يحدد الكائن <Camera> نقطة العرض من حيث موضع العارض واتجاهه. يتيح لك الكائن <الكاميرا> تحديد عرض لا يكون على سطح الأرض. ويحدد الكائن <LookAt> نقطة العرض من حيث ما تتم مشاهدته. يكون الكائن <LookAt> أكثر تحديدًا في النطاق من <الكاميرا> ويتطلب بشكل عام أن يتقاطع اتجاه العرض مع سطح الأرض.

يوضّح الرسم البياني التالي المحاور X وY وZ المرتبطة بالكاميرا الافتراضية.

  • يشير المحور X نحو يمين الكاميرا ويُطلق عليه المتّجه الأيمن.
  • يحدّد المحور ص الاتجاه "لأعلى" بالنسبة إلى الشاشة ويُسمى المتجه لأعلى.
  • أما المحور Z فيشير من مركز الشاشة نحو نقطة العين. تفحص الكاميرا المحور -Z، والذي يُسمى موجّه العرض.

ترتيب التحويلات

ويعد ترتيب التدوير مهمًا. افتراضيًا، تنظر الكاميرا مباشرةً إلى أسفل محور -Z باتجاه الأرض. قبل تنفيذ عمليات التدوير، تتم ترجمة الكاميرا بطول المحور Z إلى <altitude>. ويكون ترتيب التحويلات على النحو التالي:

  1. <altitude> - ترجمة على طول محور Z إلى <height>
  2. <heading> - تدوير حول محور Z.
  3. <tilt> - تدوير حول محور X.
  4. <roll> - تدوير حول محور Z (مرة أخرى).

لاحظ أنه في كل مرة يتم فيها تطبيق دوران، يغير محوران الكاميرا اتجاههما.

العناصر المتعلقة بالكاميرا

<longitude>
خط الطول للكاميرا الافتراضية (نقطة العين). المسافة الزاوية بالدرجات، بالنسبة إلى خط الطول الرئيسي. تتراوح القيم الواقعة غرب خط الطول من -180 إلى 0 درجة. تتراوح القيم شرق خط الطول من 0 إلى 180 درجة.
<latitude>
خط العرض للكاميرا الافتراضية. درجات شمال خط الاستواء أو جنوبه (0 درجة). تتراوح القيم من -90 درجة إلى 90 درجة.
<height>
تبلغ المسافة التي تقطعها الكاميرا عن سطح الأرض بالأمتار. يتم تفسيرها بناءً على <altitudeMode> أو <gx:altitudeMode> للكاميرا.
<heading>
الاتجاه (السمت) للكاميرا، بالدرجات. Default=0 (true North). (راجع الرسم التخطيطي.) تتراوح القيم من 0 إلى 360 درجة.
الإمالة>
دوران الكاميرا بالدرجات حول المحور X بدرجات. وتشير القيمة 0 إلى أن العرض موجّه نحو الأرض مباشرة (أكثر الحالات شيوعًا). وتشير القيمة 90 للدالة <tilt> إلى أن العرض يهدف نحو الأفق. وتشير القيم الأكبر من 90 إلى أن العرض يشير إلى السماء. يتم تثبيت قيم <tilt> عند +180 درجة.
<roll>
دوران الكاميرا بالدرجات حول المحور Z بدرجات. تتراوح القيم من -180 درجة إلى +180 درجة.
<altitudeMode>
يحدد كيفية تفسير ارتفاع الارتفاع المحدد للكاميرا. في ما يلي القيم المحتملة:
  • relativeToGround - (افتراضي) يفسر <height> كقيمة بالأمتار فوق الأرض. إذا كانت النقطة فوق الماء، فسيتم تفسير الارتفاع كارتفاع بالأمتار فوق مستوى سطح البحر بالأمتار. راجع <gx:altitudeMode> أدناه لتحديد النقاط المرتبطة بقاع البحر.
  • clampToGround - بالنسبة إلى الكاميرا، هذا الإعداد يضع الكاميرا أيضًا relativeToGround، لأنّ وضع الكاميرا على ارتفاع التضاريس بالضبط يعني أن العين ستتقاطع مع التضاريس (وسيتم حظر العرض).
  • مطلق - يفسر <height> كقيمة بالأمتار فوق مستوى سطح البحر.
<gx:altitudeMode>
امتداد KML في مساحة اسم إضافة Google، يسمح بالارتفاعات المرتبطة بقاع البحر. القيم هي:
  • relativeToSeaFloor - لتفسير <height> كقيمة بالأمتار فوق قاع البحر. إذا كانت النقطة أعلى الأرض بدلاً من البحر، فسيتم تفسير <height> على أنها فوق سطح الأرض.
  • clampToSeaFloor - يتم تجاهل مواصفات <height> وسيتم وضع الكاميرا في قاع البحر. إذا كانت النقطة على الأرض وليس في البحر، فسيتم وضع الكاميرا على الأرض.

لتوسيع

تحتوي على

الرجوع إلى أعلى الصفحة

<ColorStyle>

البنية

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

الوصف

هذا عنصر مجرد ولا يمكن استخدامه مباشرة في ملف KML. ويوفر هذا العنصر عناصر لتحديد اللون ونمط الألوان لأنواع الأنماط الموسعة.

العناصر الخاصة بـ ColorStyle

<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> عادية (بدون تأثير) وعشوائية. تُطبّق القيمة عشوائية مقياسًا خطيًا عشوائيًا على <color> الأساسية كما يلي.
  • للحصول على مجموعة عشوائية من الألوان، حدد <color> اللون الأبيض (ffffffff).
  • إذا حددت مكوّن لون واحدًا (على سبيل المثال، قيمة ff0000ff للون الأحمر)، فسيتم تحديد قيم اللون العشوائية لذلك المكوّن الواحد (الأحمر). في هذه الحالة، ستتراوح القيم من 00 (أسود) إلى ff (كامل أحمر).
  • إذا حددت قيمًا لمكونين من مكونات اللون الثلاثة أو جميعها، فسيتم تطبيق تدرج خطي عشوائي على كل مكون لون، بحيث تتراوح النتائج من الأسود إلى الحد الأقصى للقيم المحددة لكل مكون لون.
  • يأتي تعتيم اللون من مكوّن ألفا من <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. يحتوي عنصر الحاوية على ميزة واحدة أو أكثر، كما يسمح بإنشاء تسلسلات هرمية متداخلة.

لتوسيع

تمديد بمقدار

الرجوع إلى أعلى الصفحة

<المستند>

البنية

<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. داخل ميزة معينة أو مخطط خريطة معين، يمكنك الرجوع إلى معرف النمط باستخدام عنصر <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>

لتوسيع

يحتوي على ما يلي

الرجوع إلى أعلى الصفحة

<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 ثلاثة أساليب لإضافة بيانات مخصصة إلى ميزة KML (NetworkLink، أو علامة موضعية، أو GroundOverlay، أو PhotoOverlay، أو ScreenOverlay، أو Document، Folder). وتفيد هذه الأساليب

  • إضافة أزواج البيانات/القيمة غير المكتوبة باستخدام عنصر <البيانات> (أساسي)
  • إعلان الحقول المكتوبة الجديدة باستخدام عنصر <Schema> ثم الحصول عليها بعد ذلك باستخدام عنصر <SchemaData> (متقدم)
  • الإشارة إلى عناصر XML المحددة في مساحات الأسماء الأخرى من خلال الإشارة إلى مساحة الاسم الخارجية داخل ملف KML (أساسية)

ويمكن دمج هذه الأساليب في ملف أو ميزة KML واحدة لأجزاء مختلفة من البيانات.

للحصول على مزيد من المعلومات، يمكنك الاطلاع على إضافة بيانات مخصصة في "المواضيع في KML".

العناصر المتعلقة بالبيانات الموسّعة

<Data name ="string">
ينشئ زوج name/value غير مكتوب. ويمكن أن يكون للاسم نُسختان: name وdisplayName. تُستخدَم السمة name لتحديد زوج البيانات ضمن ملف KML. يُستخدم العنصر displayName عندما يتم عرض اسم منسق بشكل صحيح، مع المسافات وتنسيق HTML، في Google Earth. في العنصر <text> من <BalloonStyle>، يتم استبدال العلامة $[name/displayName] بالعلامة <displayName>. إذا استبدلت قيمة السمة name للعنصر <Data> بهذا التنسيق (على سبيل المثال، $[holeYardage]، سيتم استبدال قيمة السمة بـ <value>. وبشكل تلقائي، يعرض بالون العلامة الموضعية أزواج الاسم/القيمة المرتبط بها.
<displayName>
نسخة اختيارية من الاسم name تُستخدم لأغراض العرض.
<value>
قيمة زوج البيانات
<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>
schemaUrl="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>.
في ما يلي مثال لتعريف عنصرين مخصّصين للبيانات:
<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 بأي شكل من الأشكال. يتم حفظه دائمًا مع الملف.
يوضح المثال التالي استخدام بادئة مساحة الاسم "camp":
<ExtendedData xmlns:prefix="camp">
<camp:number>14</camp:number>
<camp:parkingSpaces>2</camp:parkingSpaces>
<camp:tentSites>4</camp:tentSites>
</ExtendedData>

تحتوي على

انظر أيضًا

<الميزة>

البنية

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

العناصر الخاصة بالميزة

<name>
النص الذي يحدده المستخدم والمعروض في العارض الثلاثي الأبعاد كتسمية للعنصر (على سبيل المثال، لعلامة موضعية أو مجلد أو NetworkLink).
<visibility>
قيمة منطقية لتحديد ما إذا كان العنصر مرسومًا في العارض ثلاثي الأبعاد عند تحميله أول مرة. لكي تكون الميزة مرئية، يجب أيضًا تعيين العلامة <visibility> لجميع أسلافها على 1. في عرض القائمة لبرنامج Google Earth، يكون لكل ميزة مربع اختيار يسمح للمستخدم بالتحكم في مستوى رؤية العنصر.
<فتح>
قيمة منطقية لتحديد ما إذا كان أحد المستندات أو المجلدات يظهر مغلقًا أو مفتوحًا عند تحميله لأول مرة في لوحة الأماكن. 0=collapsed (تلقائي)، 1=expanded. يمكنك الاطّلاع أيضًا على <ListStyle>. وينطبق هذا العنصر فقط على "مستند" و"مجلد" و"رابط شبكة".
<atom:author>

يدعم KML 2.2 عناصر جديدة لتضمين بيانات عن المؤلف وموقع الويب ذي الصلة في ملف KML. يتم عرض هذه المعلومات في نتائج البحث الجغرافي، في كل من متصفحات Earth، مثل Google Earth، وفي تطبيقات أخرى مثل خرائط Google. في ما يلي عناصر الإحالة المستخدمة في ملف KML:

  • atom:author - العنصر الرئيسي لـ atom:name
  • atom:name - اسم المؤلف
  • العنصر atom:link يحتوي على السمة href
  • href - عنوان URL لصفحة الويب التي تحتوي على ملف KML/KMZ

يتم تحديد هذه العناصر في تنسيق مشاركة Atom. يمكن الاطلاع على المواصفات الكاملة على http://atompub.org. (راجع النموذج التالي).

العنصر <atom:author> هو العنصر الرئيسي في <atom:name>، الذي يحدد مؤلف ميزة KML.

<atom:link href="..." >
يحدد عنوان URL لموقع الويب الذي يحتوي على ملف KML أو KMZ هذا. تأكد من تضمين مساحة الاسم لهذا العنصر في أي ملف KML يستخدمه: xmlns:atom="http://www.w3.org/2005/Atom" (راجع النموذج التالي).
<address>
قيمة سلسلة تمثّل عنوانًا غير منظّم تمّت كتابته كشارع عادي و/أو مدينة و/أو عنوان ولاية و/أو كرمز بريدي يمكنك استخدام علامة <address> لتحديد موقع نقطة بدلاً من استخدام إحداثيات خطوط الطول والعرض. (ولكن، إذا تم توفير <نقطة>، فإنها تحظى بالأولوية على العنوان >). للاطلاع على اللغات المعتمدة لهذه العلامة في Google Earth، انتقل إلى مساعدة خرائط Google.
<xal:AddressDetails>
عنوان منظم، بتنسيق xAL، أو لغة عنوان eXtensible، معيار دولي لتنسيق العنوان. يتم استخدام <xal:AddressDetails> بواسطة KML للترميز الجغرافي في "خرائط Google" فقط. للحصول على تفاصيل، راجع وثائق واجهة برمجة التطبيقات لخرائط Google . في الوقت الحالي، لا يستخدم Google Earth هذا العنصر، استخدم <address> بدلاً منه. تأكد من تضمين مساحة الاسم لهذا العنصر في أي ملف KML يستخدمه: xmlns:xal="urn:oasis:names:tc:ciq:xsdschema:xAL:2.0"
<phoneNumber>
قيمة سلسلة تمثل رقم هاتف يتم استخدام هذا العنصر بواسطة خرائط Google للجوال فقط. المعيار القياسي في المجال للهواتف الخلوية المزوّدة بلغة جافا هو RFC2806.
لمزيد من المعلومات، يُرجى الاطّلاع على http://www.ietf.org/rfc /rfc2806.txt
<Snippet maxLines="2" >
وصف قصير للميزة. في برنامج Google Earth، يتم عرض هذا الوصف في لوحة الأماكن تحت اسم العنصر. إذا لم يتم توفير مقتطف، فسيتم استخدام أول سطرين من <description>. في برنامج Google Earth، إذا كانت العلامة الموضعية تحتوي على وصف ومقتطف معًا، فستظهر العلامة <Snippet> أسفل العلامة الموضعية في لوحة الأماكن، وتظهر العلامة <description> في بالون وصف العلامة الموضعية. هذه العلامة لا تتوافق مع ترميز HTML. يتضمن <Snippet> سمة maxLines، وهي عدد صحيح يحدد الحد الأقصى لعدد السطور المراد عرضها.
<description>

المحتوى الذي يقدمه المستخدم والذي يظهر في بالون الوصف.

تم تغيير المحتوى المعتمد للعنصر <description> من Google Earth 4.3 إلى 5.0. في ما يلي معلومات محدّدة لكل إصدار، متبوعة بمعلومات مشتركة في كلا الإصدارين.

Google Earth 5.0

يدعم Google Earth 5.0 (والإصدارات الأحدث) محتوى النص العادي، بالإضافة إلى HTML وجافا سكريبت كامل داخل بالونات الوصف. ويتم عرض محتويات علامة الوصف من خلال محرك متصفح الويب مفتوح المصدر WebKit، ويتم عرضها كما لو كانت في أي متصفح يستند إلى WebKit.

القيود العامة

بشكل عام، لا يُسمح بالروابط إلى الملفات المحلية. ويؤدي هذا إلى منع الشفرة الضارة من إلحاق الضرر بالنظام أو الدخول إلى بياناتك. إذا كنت ترغب في السماح بالوصول إلى نظام الملفات المحلي، حدد تفضيلات > السماح بالدخول إلى الملفات المحلية والبيانات الشخصية. يُسمح دائمًا بالروابط إلى ملفات الصور على نظام الملفات المحلي، إذا كانت متضمّنة في علامة <img>.

يمكن الوصول إلى المحتوى الذي تم ضغطه داخل ملف KMZ، حتى إذا كان في نظام الملفات المحلي.

تم تفعيل ملفات تعريف الارتباط، ولكن لأغراض السياسة ذات المصدر نفسه، لا يشارك المحتوى المحلي نطاقًا مع أي محتوى آخر (بما في ذلك المحتوى المحلي الآخر).

HTML

يتم عرض HTML في الغالب كما هو الحال في أي متصفح WebKit.

ويتم تجاهل الأهداف عند تضمينها في ملف HTML مكتوب مباشرةً في ملف KML، ويتم فتح جميع هذه الروابط كما لو تم ضبط الهدف على _blank. ويتم تجاهل أي استهدافات محدّدة.

ومع ذلك، فإن HTML المضمن في iFrame، أو الذي يتم إنشاؤه ديناميكيًا باستخدام جافا سكريبت أو DHTML، سيستخدم target="_self" كإعداد افتراضي. يمكن تحديد استهدافات أخرى وهي معتمدة.

لا يمكن استهداف محتوى ملفات KMZ وروابط الارتساء المحلية وطرق ;flyto من HTML المضمّن في iFrame.

إذا حدد المستخدم width="100%" لعرض iFrame، فسيعتمد عرض iFrame على كل المحتوى الآخر في البالون، وينبغي تجاهله بشكل أساسي أثناء حساب حجم التنسيق. وتنطبق هذه القاعدة على أي عنصر حظر آخر داخل البالون أيضًا.

JavaScript

ويتوافق معظم JavaScript. لا يمكن إنشاء مربعات الحوار - لن يتم عرض دوال مثل التنبيه() و المطالبات(). ومع ذلك، ستتم كتابتها على وحدة تحكم النظام، وكذلك مع الأخطاء والاستثناءات الأخرى.

خدمة مقارنة الأسعار (CSS)

ويُسمح باستخدام CSS. كما هو الحال مع CSS في متصفح الويب العادي، يمكن استخدام CSS لوضع نمط للنص وعناصر الصفحة وللتحكم في حجم بالون الوصف ومظهره.

الإصدار 4.3 من Google Earth

يدعم العنصر <description> النص العادي بالإضافة إلى مجموعة فرعية من عناصر تنسيق HTML، بما في ذلك الجداول (انظر مثال KML أدناه). ولا تدعم التقنية الأخرى المستندة إلى الويب، مثل الترميز الديناميكي للصفحة (PHP أو JSP أو ASP) أو لغات البرمجة النصية (VBScript أو JavaScript) أو لغات التطبيق (Java وPython). في الإصدار 4.2 من Google Earth، يتم دعم الفيديو. (اطّلِع على المثال أدناه.)

معلومات شائعة

إذا كان الوصف لا يحتوي على ترميز HTML، يحاول Google Earth تنسيقه، مع استبدال الأسطر الجديدة بـ <br> والتفاف عناوين URL بعلامات ارتساء. يتم تحويل سلسلة عنوان URL صالحة لشبكة الويب العالمية تلقائيًا إلى رابط تشعبي إلى عنوان 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 استخدام سمتَين ضمن العنصر <a>، وهما: href وtype.

يحتوي عنصر الارتساء <a> على سمة href تحدد عنوان URL.

إذا كان href عبارة عن ملف KML ويتضمن امتداد الملف .kml أو .kmz، فإن Google Earth يحمِّل هذا الملف مباشرة عندما ينقر المستخدم عليه. وإذا كان عنوان URL ينتهي بامتداد غير معروف لـ Google Earth (على سبيل المثال، .html)، فسيتم إرسال عنوان URL إلى المتصفح.

يمكن أن يكون href عنوان URL مجزأً (أي عنوان URL بعلامة # يتبعه معرّف KML). عندما ينقر المستخدم على رابط يتضمن عنوان URL مجزأً، ينتقل المتصفح افتراضيًا إلى الميزة التي تطابق رقم تعريفها الجزء. إذا كانت الميزة تحتوي على عنصر LookAt أو عنصر Camera ، يتم عرض الميزة من نقطة العرض المحددة.

يمكن تحديد السلوك أيضًا من خلال إلحاق إحدى السلاسل الثلاث التالية بعنوان URL للجزء:

  • ;flyto (تلقائي) - الانتقال إلى الميزة
  • ;البالون - فتح بالون الميزة ولكن لا تنتقل إلى الميزة
  • ;balloonFlyto - فتح بالون الميزة والانتقال إلى الميزة

على سبيل المثال، تشير الشفرة التالية إلى فتح الملف CraftsFairs.kml، ثم الانتقال إلى العلامة الموضعية التي يكون معرفها "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>
يمكن تحديد نمط أو أكثر من الأنماط وأنماط الخرائط لتخصيص مظهر أي عنصر مشتق من عنصر أو عنصر هندسي في علامة موضعية. (راجع <BalloonStyle> و<ListStyle> و<StyleSelector> ووالأنماط المستمدة من <ColorStyle>). ويُطلق على النمط المحدَّد في العنصر اسم "النمط المضمَّن" وينطبق على العنصر الذي يحتوي عليه فقط. النمط الذي يتم تعريفه كعنصر ثانوي في <Document> يسمى "النمط المشترك". يجب أن يكون للنمط المشترك معرِّف محدد له. تتم الإشارة إلى هذا المعرّف من خلال ميزة واحدة أو أكثر ضمن <Document>. في الحالات التي يتم فيها تحديد عنصر نمط في نمط مشترك وفي نمط مضمَّن لعنصر ما، أي مجلد أو GroundOverlay أو NetworkLink أو علامة موضعية أو تراكب شاشة، تكون الأولوية لنمط العنصر المضمّن على قيمة النمط المشترَك.
<المنطقة>
يتم رسم العناصر والهندسة المرتبطة بمنطقة فقط عندما تكون المنطقة نشطة. يُرجى مراجعة <Region>.
<البيانات الوصفية>
<ExtendedData>
يتيح لك إضافة بيانات مخصصة إلى ملف KML. يمكن أن تكون هذه البيانات (1) بيانات تشير إلى مخطط XML خارجي أو (2) أزواج بيانات/قيمة غير مكتوبة أو (3) بيانات مكتوبة. يمكن أن تحتوي إحدى ميزات KML على مزيج من هذه الأنواع من البيانات المخصصة.

نموذج استخدام عناصر HTML داخل وصف

يوضح هذا المثال مجموعة كاملة من عناصر HTML التي يدعمها العنصر <description> في Google Earth 4.3. يدعم Google Earth الإصدار 5.0 والإصدارات الأحدث كل من HTML وجافا سكريبت.

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

نموذج فيديو

يوضح هذا المثال كيفية تضمين فيديو فلاش داخل البالون.

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

هذا العنصر هو امتداد لمعيار OGC KML 2.2 ويتم دعمه في Google Earth 5.0 والإصدارات الأحدث. مزيد من المعلومات

البنية

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

الوصف

يحدد <gx:FlyTo> نقطة في الفضاء سينتقل إليها المتصفح أثناء إحدى الجولات. ويجب أن يحتوي العنصر على عنصر AbstractView واحد وأن يحتوي على العنصرين <gx:duration> و<gx:flyToMode> اللذَين يحددان الوقت الذي يستغرقه الانتقال إلى النقطة المحدّدة من النقطة الحالية وطريقة الرحلة على التوالي.

<gx:flyToMode>

هناك قيمتان مسموح بهما للسمة <gx:flyToMode>: smooth وounces.

  • سلسة تسمح رحلات الطيران FlyTos برحلة جوية غير مقسمة من نقطة إلى نقطة (وما إلى ذلك). ستبدأ سلسلة غير منقطعة من FlyTos بسلاسة وتنتهي بسرعة 0، ولن تبطئ عند كل نقطة. تتعطّل سلسلة من FlyTos بسلاسة من خلال أي من العناصر التالية:
    • <gx:flyToMode>bounce</gx:flyToMode>
    • <gx:Wait>
    يعني ذلك أن السرعة ستكون صفرًا عند الانتقال السلس إلى العنصر السابق مباشرةً لأي من العناصر أعلاه. لا تتعطل سلسلة من عناصر FlyTos السلسة بواسطة عناصر <gx:AnimatedUpdate>.

  • الارتداد تبدأ كل FlyTos وتنتهي بسرعة صفرية.

مثال

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

لتوسيع

يحتوي على ما يلي

>مجلد>

البنية

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

لتوسيع

يحتوي على ما يلي

<الشكل الهندسي>

البنية

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

الوصف

هذا عنصر مجرد ولا يمكن استخدامه مباشرة في ملف KML. ويوفر كائن عنصر نائب لجميع كائنات الهندسة المشتقة.

لتوسيع

تمديد بمقدار

تراكب الأرض>

البنية

<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 المحددة بواسطة تراكب الأرض.

العناصر المتعلقة بطبقة الأرضية

<height>
تحدد المسافة فوق سطح الأرض بالمتر، ويتم تفسيرها وفقًا لوضع الارتفاع.
<altitudeMode>
تحدد
كيفية تفسير <height>. القيم المحتملة هي
  • clampToGround - (افتراضي) تشير إلى تجاهل مواصفات الارتفاع وإسقاط التراكب فوق التضاريس.
  • مطلق - لتعيين ارتفاع التراكب بالنسبة إلى مستوى سطح البحر، بغض النظر عن الارتفاع الفعلي للتضاريس أسفل العنصر. فعلى سبيل المثال، إذا قمت بتعيين ارتفاع تراكب إلى 10 أمتار مع وضع الارتفاع المطلق، فسوف يظهر هذا التراكب على مستوى الأرض إذا كانت التضاريس تحتها هي أيضا 10 أمتار فوق مستوى سطح البحر. وإذا كانت التضاريس على ارتفاع 3 أمتار فوق مستوى سطح البحر، فسيظهر التراكب مرتفعًا فوق التضاريس بمقدار 7 أمتار.
<gx:altitudeMode>
امتداد KML في مساحة اسم إضافة Google، يسمح بالارتفاعات المرتبطة بقاع البحر. القيم هي:
  • relativeToSeaFloor - لتفسير <height> كقيمة بالأمتار فوق قاع البحر. إذا كانت النقطة أعلى الأرض بدلاً من البحر، فسيتم تفسير <height> على أنها فوق سطح الأرض.
  • clampToSeaFloor - يتم تجاهل مواصفات <height> وسيتم وضع تراكب فوق قاع البحر. إذا كانت النقطة على الأرض وليس في البحر، فسيتم وضع التراكب على الأرض.
<LatLonBox>
يحدد هذا الإعداد أماكن محاذاة الجانبين العلوي والسفلي والأيمن والأيسر من مربع الإحاطة لتراكب الأرض.
  • <north> تحدد خط العرض للحافة الشمالية لمربع الإحاطة، بدرجات عشرية من 0 إلى ±90.
  • تحدد <south> خط العرض للحافة الجنوبية لمربع الإحاطة، بدرجات عشرية من 0 إلى ±90.
  • <east> تحدد خط الطول للحافة الشرقية لمربع الإحاطة، بدرجات عشرية من 0 إلى ±180. (بالنسبة إلى التراكبات التي تتداخل مع خط الطول 180 درجة، يمكن أن تمتد القيم إلى ما بعد ذلك النطاق.)
  • <west> لتحديد خط الطول للحافة الغربية لمربع الإحاطة، بدرجات عشرية من 0 إلى ±180. (بالنسبة إلى التراكبات التي تتداخل مع خط الطول 180 درجة، يمكن أن تمتد القيم إلى ما بعد ذلك النطاق.)
  • تحدد <rotation> تدوير التراكب حول مركزها بالدرجات. يمكن أن تكون القيم ±180. والقيمة التلقائية هي 0 (شمال). يتم تحديد عمليات التدوير في اتجاه عكس اتجاه عقارب الساعة.
<LatLonBox>
   <north>48.25475939255556</north>
   <south>48.25207367852141</south>
   <east>-90.86591508839973</east>
   <west>-90.8714285289695</west>
   <rotation>39.37878630116985</rotation>
</LatLonBox> 
<gx:LatLonQuad>
تُستخدم في التراكبات الأرضية غير الرباعية الشكل.

مثال

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

لتوسيع

تحتوي على

<الرمز>

البنية

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

الوصف

لتحديد صورة مرتبطة بنمط أو رمز مركّب. يحدد العنصر الفرعي <href> المطلوب موقع الصورة التي سيتم استخدامها كتراكب أو كرمز للعلامة الموضعية. يمكن أن يكون هذا الموقع على نظام ملفات محلي أو خادم ويب بعيد. يتم استخدام العناصر <gx:x> و<gx:y> و<gx:w> و<gx:h> لتحديد رمز واحد من الصورة التي تحتوي على رموز متعددة (والتي يشار إليها غالبًا باسم لوحة الرموز).

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

عناصر خاصة بالرمز

<href>
عنوان HTTP أو مواصفات ملف محلي يتم استخدامها لتحميل رمز.
<gx:x>
و
<gx:y>
إذا حدد <href> لوحة الرموز، فستحدد هذه العناصر الإزاحة، بالبكسل، من الجانب السفلي الأيمن من لوحة الرموز.وفي حالة عدم تحديد أي قيم للرمزين "س" و"ص"، فمن المفترض أن يمثل الجانب السفلي الأيمن من لوحة الرموز الركن السفلي الأيمن من الرمز للاستخدام.
<gx:w>
و
<gx:h>
إذا حدد <href> لوحة الرموز، فستحدد هذه العناصر العرض (<gx:w>) والارتفاع (<gx:h>)، بالبكسل، من الرمز المراد استخدامه.
<refreshMode>
للتعرّف على وصف للعنصر <refreshMode> والعناصر الأخرى المُدرَجة أدناه، يُرجى الاطّلاع على <الرابط>.
<refreshInterval>
<viewRefreshMode>
<viewRefreshTime>
<viewBoundScale>
<viewFormat>
<httpQuery>

تحتوي على

<IconStyle>

البنية

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

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

الوصف

لتحديد كيفية رسم رموز العلامات الموضعية للنقاط في لوحة الأماكن وفي العارض ثلاثي الأبعاد لبرنامج Google Earth. يحدد العنصر <Icon> صورة الرمز. يحدد العنصر <scale> مقياس x, y للرمز. يتم مزج اللون المحدّد في عنصر <color> في <IconStyle> بلون <Icon>.

العناصر الخاصة بـ IconStyle

<scale>
تغيير حجم الرمز.

ملاحظة: تم إيقاف العلامة <geomScale>. استخدم مقياس <scale> بدلاً من ذلك.

<heading>
الاتجاه (أي الشمال والجنوب والشرق والغرب)، بالدرجات. Default=0 (شمال). (راجع الرسم التخطيطي.) تتراوح القيم من 0 إلى 360 درجة.
<الرمز>
رمز مخصص. في <IconStyle>، العنصر الوحيد في <Icon> هو <href>:
  • <href>: عنوان HTTP أو مواصفات الملفات المحلية المستخدمة لتحميل رمز.
<hotSpot x="0.5" y="0.5" xunits="fraction" yunits="fraction">
يحدد هذا الإعداد الموضع داخل الرمز "المرسِل" بالنسبة إلى "النقطة" المحددة في العلامة الموضعية. يمكن تحديد القيم x وy بثلاث طرق مختلفة: كـ بكسل ("pixels")، أو كسور للرمز ("fraction")، أو كـ بكسل مضمن ("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>

لتوسيع

تحتوي على

يحتوي على ما يلي

<kml>

البنية

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

الوصف

العنصر الجذر لملف KML. هذا العنصر مطلوب. وهي تتبع إعلان xml في بداية الملف. يتم استخدام السمة hint كإشارة إلى Google Earth لعرض الملف كبيانات سماوية.

قد يتضمن العنصر <kml> أيضًا مساحة الاسم لأي مخططات 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>

الوصف

لتحديد كيفية رسم اسم الموضع في العارض ثلاثي الأبعاد. يمكن تحديد لون مخصص ووضع اللون ومقياس للتصنيف (الاسم).

ملاحظة: تم إيقاف العلامة <labelColor>. استخدم <LabelStyle> بدلاً من ذلك.

خاص بـ <LabelStyle>

<scale>
تغيير حجم التصنيف.

مثال

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

الوصف

يسمح بتراكبات الأرض غير الرباعية الشكل.

لتحديد إحداثيات النقاط الأربعة في الزاوية الرباعية التي تحدد منطقة التراكب. يجب توفير أربع أدراج تناظرية بالضبط، يتكون كل منها من قيم نقاط عائمة لخط الطول وخط العرض. أدخل مسافة بين التلاميذ. لا تضمِّن مسافات داخل الوحدة. يجب تحديد الإحداثيات بترتيب عكس اتجاه عقارب الساعة مع أول إحداثيات يتوافق مع الجانب السفلي الأيمن من الصورة التي تظهر على سطح الفيديو. يجب أن يكون الشكل الموضح بهذه الزوايا محدبًا.

إذا تم إدراج قيمة ثالثة في أي توبل (تمثل ارتفاعًا)، فسيتم تجاهلها. يتم ضبط الارتفاع باستخدام <altitude> و<altitudeMode> (أو <gx:altitudeMode>) على مسافة <GroundOverlay>. أوضاع الارتفاع المسموح بها هي مطلق وclampToGround وclampToSeaFloor.

مثال

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

لتوسيع

تحتوي على

<الخط الخطي>

البنية

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

الوصف

لتحديد سلسلة خط مغلق، وعادةً ما تكون الحد الخارجي للمضلع. اختياريًا، يمكن أيضًا استخدام linearRing كحدود داخلية لمضلع لإنشاء ثقوب في المضلّع. يمكن أن يحتوي المضلّع على عناصر <linearRing> متعددة تُستخدم كحدود داخلية.

ملاحظة: في Google Earth، يتبع المضلع مع ارتفاع [altitudeMode> من clampToGround خطوطًا ذات اتجاه ثابت، ولكن يتبع linearRing (بنفسه) مع وضع <altitudeMode> من clampToGround خطوطًا دائرية رائعة.

العناصر المتعلقة بـ linearRing

<gx:altitudeOffset>
إضافة KML، في مساحة اسم إضافة Google، تعدّل كيفية عرض قيم الارتفاع. تتيح لك هذه الإزاحة نقل linearRing بالكامل لأعلى أو لأسفل كوحدة بدون تعديل جميع قيم الإحداثيات الفردية التي تشكّل linearRing. (على الرغم من عرض linearRing باستخدام قيمة إزاحة الارتفاع، يتم الاحتفاظ بقيم الارتفاع الأصلية في ملف KML). الوحدات بالأمتار.
بثق>
قيمة منطقية لتحديد ما إذا كان سيتم توصيل linearRing بالأرض. لإنتاج هذا الشكل الهندسي، يجب أن يكون وضع الارتفاع إما relativeToGround أو relativeToSeaFloor أو مطلق. لا تنبثق إلا رؤوس خط الطول الخطي وليس مركز الهندسة. تنبثق الرؤوس نحو مركز الكرة الأرضية.
<tessellate>
قيمة منطقية لتحديد ما إذا كان سيتم السماح لسلسلة linearRing باتباع التضاريس. لتفعيل عملية التوزيع، يجب أن تكون قيمة <altitudeMode> هي clampToGround أو clampToSeaFloor. يجب أن تؤدي مجموعات linearRing الكبيرة جدًا إلى تفعيل التوليف بحيث تتبع انحناء الأرض (وإلا، فقد تمر تحت الأرض وقد تكون مخفية).
<altitudeMode>
يحدد كيفية تفسير مكونات الارتفاع في العنصر <الإحداثيات>. القيم المحتملة هي
  • clampToGround - (تلقائي) تشير إلى تجاهل مواصفات الارتفاع (على سبيل المثال، في العلامة <الإحداثيات>).
  • relativeToGround - لتعيين ارتفاع العنصر بالنسبة إلى ارتفاع الأرض الفعلي لموقع معين. على سبيل المثال، إذا كان ارتفاع الأرض لموقع ما في مستوى سطح البحر تمامًا، وتم ضبط ارتفاع نقطة ما على 9 أمتار، فسيكون ارتفاع رمز ارتفاع العلامة الموضعية للنقطة هو 9 أمتار باستخدام هذا الوضع. ومع ذلك، إذا تم تعيين الإحداثي نفسه فوق موقع حيث يكون ارتفاع الأرض 10 أمتار فوق مستوى سطح البحر، فإن ارتفاع الإحداثي يبلغ 19 مترًا. الاستخدام المعتاد لهذا الوضع هو وضع أعمدة الهاتف أو مصعد التزلج.
  • مطلق - تعيين ارتفاع الإحداثي بالنسبة إلى مستوى سطح البحر، بغض النظر عن الارتفاع الفعلي للتضاريس أسفل العنصر. فعلى سبيل المثال، إذا عينت ارتفاع إحداثيات إلى 10 أمتار باستخدام وضع الارتفاع المطلق، فسيظهر رمز العلامة الموضعية على مستوى الأرض إذا كانت التضاريس تحتها هي أيضًا 10 أمتار فوق مستوى سطح البحر. وإذا كانت التضاريس ترتفع عن مستوى سطح البحر بمسافة 3 أمتار، فستظهر العلامة الموضعية مرتفعة فوق التضاريس بمقدار 7 أمتار. الاستخدام العادي لهذا الوضع مخصص لوضع الطائرة.
<gx:altitudeMode>
امتداد KML في مساحة اسم إضافة Google، يسمح بالارتفاعات المرتبطة بقاع البحر. القيم هي:
  • relativeToSeaFloor - لتفسير <height> كقيمة بالأمتار فوق قاع البحر. إذا كانت النقطة أعلى الأرض بدلاً من البحر، فسيتم تفسير <height> على أنها فوق سطح الأرض.
  • clampToSeaFloor - يتم تجاهل مواصفات <height> وسيتم وضع النقطة في قاع البحر. إذا كانت النقطة على الأرض وليس في البحر، فسيتم وضع النقطة على الأرض.
<الإحداثيات>(مطلوبة)
أربع وحدات صغيرة أو أكثر، تتكون كل منها من قيم نقاط عائمة لـ خط الطول وخط العرض والارتفاع. مكوّن height اختياري. لا تضمِّن مسافات داخل الوحدة. يجب أن يكون الإحداثي الأخير هو نفسه الإحداثي الأول. يتم التعبير عن الإحداثيات بالدرجات العشرية فقط.

مثال

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

البنية

<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> لتحديد اللون ووضع الألوان وعرض الخط. عند انبثاق خط خطي، يمتد الخط إلى الأرض، مما يشكل مضلعًا يبدو إلى حد ما مثل جدار أو سياج. بالنسبة إلى خطوط السلاسل المبثودة، يستخدم الخط نفسه نمط السطر الحالي، ويستخدم البث عبر نمط النمط الحالي. يمكنك الاطّلاع على البرنامج التعليمي KML للحصول على أمثلة على سلاسل السلاسل (أو المسارات).

عناصر خاصة بـ LineString

<gx:altitudeOffset>
إضافة KML، في مساحة اسم إضافة Google، تعدّل كيفية عرض قيم الارتفاع. تتيح لك هذه الإزاحة نقل LineString بالكامل لأعلى أو لأسفل كوحدة بدون تعديل جميع قيم الإحداثيات الفردية التي تتألف منها LineString. (على الرغم من عرض LineString باستخدام قيمة إزاحة الارتفاع، يتم الاحتفاظ بقيم الارتفاع الأصلية في ملف KML). الوحدات بالأمتار.
بثق>
قيمة منطقية لتحديد ما إذا كان سيتم ربط LineString بالأرض. لإنتاج خط سلاسل، يجب أن يكون وضع الارتفاع إما relativeToGround أو relativeToSeaFloor أو مطلق. تنبثق الرؤوس في سلسلة السلاسل باتجاه مركز سطح الكرة الأرضية.
<tessellate>
قيمة منطقية لتحديد ما إذا كان سيتم السماح لسلسلة الخطوط باتباع التضاريس. لتفعيل فوضى الخيل، يجب أن يكون وضع الارتفاع هو clampToGround أو clampToSeaFloor. يجب أن تمكن السلاسل الخطية الكبيرة جدًا الزهرية لكي تتبع انحناء الأرض (وإلا، فقد تمر تحت الأرض وقد تكون مخفية).
<altitudeMode>
يحدد كيفية تفسير مكونات الارتفاع في العنصر <الإحداثيات>. القيم المحتملة هي
  • clampToGround - (افتراضي) تشير إلى تجاهل مواصفات الارتفاع (على سبيل المثال، في العلامة <الإحداثيات>).
  • relativeToGround - لتعيين ارتفاع العنصر بالنسبة إلى ارتفاع الأرض الفعلي لموقع معين. على سبيل المثال، إذا كان ارتفاع الأرض لموقع ما في مستوى سطح البحر تمامًا، وتم ضبط ارتفاع نقطة ما على 9 أمتار، فسيكون ارتفاع رمز ارتفاع العلامة الموضعية للنقطة هو 9 أمتار باستخدام هذا الوضع. ومع ذلك، إذا تم تعيين الإحداثي نفسه فوق موقع حيث يكون ارتفاع الأرض 10 أمتار فوق مستوى سطح البحر، فإن ارتفاع الإحداثي يبلغ 19 مترًا. الاستخدام المعتاد لهذا الوضع هو وضع أعمدة الهاتف أو مصعد التزلج.
  • مطلق - تعيين ارتفاع الإحداثي بالنسبة إلى مستوى سطح البحر، بغض النظر عن الارتفاع الفعلي للتضاريس أسفل العنصر. فعلى سبيل المثال، إذا عينت ارتفاع إحداثيات إلى 10 أمتار باستخدام وضع الارتفاع المطلق، فسيظهر رمز العلامة الموضعية على مستوى الأرض إذا كانت التضاريس تحتها هي أيضًا 10 أمتار فوق مستوى سطح البحر. وإذا كانت التضاريس ترتفع عن مستوى سطح البحر بمسافة 3 أمتار، فستظهر العلامة الموضعية مرتفعة فوق التضاريس بمقدار 7 أمتار. الاستخدام العادي لهذا الوضع مخصص لوضع الطائرة.
<gx:altitudeMode>
امتداد KML في مساحة اسم إضافة Google، يسمح بالارتفاعات المرتبطة بقاع البحر. القيم هي:
  • relativeToSeaFloor - لتفسير <height> كقيمة بالأمتار فوق قاع البحر. إذا كانت النقطة أعلى الأرض بدلاً من البحر، فسيتم تفسير <height> على أنها فوق سطح الأرض.
  • clampToSeaFloor - يتم تجاهل مواصفات <height> وسيتم وضع النقطة في قاع البحر. إذا كانت النقطة على الأرض وليس في البحر، فسيتم وضع النقطة على الأرض.
<gx:drawOrder>
قيمة عددية تحدد ترتيب رسم سلاسل أسطر متعددة. قد يتم إخفاء خطوط السلاسل المرسومة أولاً جزئيًا أو كليًا من خلال خطوط السلاسل مع طلب رسم لاحق. قد يكون هذا العنصر مطلوبًا بالاقتران مع العنصرين <gx:outerColor> و<gx:outerWidth> في <LineStyle> عندما تتقاطع الخطوط مزدوجة الألوان.
<الإحداثيات>(مطلوبة)
اثنتان أو أكثر من تلاقي الإحداثيات، يتكون كل منهما من قيم النقاط العائمة لـ خط الطول وخط العرض والارتفاع. مكوّن height اختياري. أدخل مسافة بين التلاميذ. لا تضمِّن مسافات داخل الوحدة.

مثال

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

لتوسيع

تحتوي على

<LineStyle>

البنية

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

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

الوصف

لتحديد نمط الرسم (اللون ووضع الألوان وعرض الخط) لجميع الأشكال الهندسية للخطوط. تشتمل الأشكال الهندسية للخطوط على مخططات المضلعات المحددة و"التوصيل" الذي ينبثق من رموز العلامة الموضعية (في حالة تمكين البث).

العناصر الخاصة بـ LineStyle

<width>
عرض الخط بالبكسل.
<gx:outerColor>
لون جزء الخط الذي تم تحديده بواسطة <gx:outerWidth>. لاحظ أنه يتم تجاهل العنصرين <gx:outerColor> و<gx:outerWidth> عند تطبيق <LineStyle> على <Polygon> و<linearRing>.
<gx:outerWidth>
قيمة بين 0.0 و1.0 تحدّد نسبة الخط التي تستخدم <gx:outerColor> لا ينطبق هذا الإعداد إلا على إعداد ضبط الأسطر باستخدام <gx:physicalWidth>، ولا ينطبق على الأسطر التي تستخدم <width>. يمكنك الاطّلاع أيضًا على <gx:drawOrder> في <LineString>. قد تكون قيمة ترتيب الرسم ضرورية إذا كانت الخطوط المزدوجة الألوان تتقاطع مع بعضها البعض، على سبيل المثال، لعرض تقاطعات الطرق السريعة.
<gx:physicalWidth>
العرض الفعلي للخط، بالمتر.
<gx:labelVisibility>
منطق منطقي يحدد ما إذا كان سيتم عرض تصنيف النص على LineString أم لا. يتم تضمين تصنيف LineString في العنصر <name> الذي يمثّل العنصر <LineString> (أي الوارد داخل العنصر <Placemark> نفسه).

لا يعرض الإصدار 6.1 من Google Earth أو الإصدارات الأحدث التصنيفات تلقائيًا، ولكن يجب تمكينها لكل سلسلة خط من خلال تعيين <gx:labelVisibility> إلى 1.

مشكلة معروفة في Google Earth 6.1: لن تعرض سلاسل الأسطر التي لا تحتوي على عنصر <gx:physicalWidth> التصنيف إلا إذا كان طول السطر أكبر من 100 متر * عدد الأحرف في التصنيف. على سبيل المثال، لن يتم عرض تصنيف يحتوي على سبعة أحرف ("example") إلا إذا كان السطر الذي يزيد عن 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>

يتم تحميل الملف وتحديثه بشروط، استنادًا إلى معلمات التحديث الواردة هنا. يمكن تحديد مجموعتين مختلفتين لمَعلمات التحديث: إحداهما تعتمد على time (<refreshMode> و<refreshInterval>) وإحدى المجموعات المُستنِدة إلى طريقة عرض "الكاميرا" الحالية (<viewRefreshMode> و<viewRefreshTime>)، بالإضافة إلى ذلك، يُحدِّد "الرابط" ما إذا كان يمكن قياس مَعلمات مربّع الإحاطة التي يتم إرسالها إلى الخادم (<viewBoundScale>) ويوفّر مجموعة من مَعلمات العرض الاختيارية التي يمكن إرسالها إلى معلَمة اختياريّة بالإضافة إلى مجموعة من مَعلمات العرض الاختيارية (التي يمكن إرسالها إلى معلَمة اختياريّة، بالإضافة إلى مجموعة من المَعلمات الاختيارية، حيث يمكن إرسال معلَمة اختياريّة إلى خادم يحتوى على مَعلمات اختيارية، حيث يمكن إرسال المَعلمتَين الاختياريتين إلى:

عندما يتم جلب ملف، يتكون عنوان URL الذي يتم إرساله إلى الخادم من ثلاث معلومات:

  • href (مرجع النص التشعبي) الذي يحدد الملف المراد تحميله.
  • سلسلة تنسيق عشوائية يتم إنشاؤها من (أ) المعلمات التي تحددها في العنصر <viewFormat> أو (ب) معلمات مربع الإحاطة (هذا هو الإعداد التلقائي ويتم استخدامه في حال عدم تضمين عنصر <viewFormat> في الملف).
  • سلسلة تنسيق محددة في عنصر <httpQuery>.

إذا كان الملف المحدد في <href> ملفًا محليًا، فلن يتم استخدام العناصر <viewFormat> و<httpQuery>.

يحل عنصر <الرابط> محل عنصر <Url> الموجود في <NetworkLink> المضمن في إصدارات KML السابقة ويضيف وظائف إلى العنصر <Region> (تم تقديمه في KML 2.1). في الإصدار Google Earth 3.0 والإصدارات السابقة، يتم تجاهل عنصر <الرابط>.

<href>
عنوان URL (سواء كان عنوان HTTP أو مواصفات ملف محلي). عندما يكون أصل <Link> هو NetworkLink، يكون <href> ملف KML. عندما يكون أصل <Link> هو نموذج، يكون <href> ملف COLLADA. عندما يكون العنصر الرئيسي لـ <Icon> (الحقول نفسها مثل <Link>) هو التراكب، تكون <href> صورة. يمكن استخدام عناوين URL النسبية في هذه العلامة ويتم تقييمها مقارنةً بملف KML المتضمن. راجع ملفات KMZ للحصول على تفاصيل حول إنشاء مراجع نسبية في ملفات KML وKMZ.
<refreshMode>
يحدد وضع التحديث المستند إلى الوقت، والذي يمكن أن يكون واحدًا مما يلي:
  • onChange (تغيير): يتم التحديث عند تحميل الملف وكلما تغيّرت معلمات الروابط (الإعداد التلقائي).
  • onInterval - يتم التحديث كل n ثانية (محدد في <refreshInterval>).
  • onExpire - يُرجى إعادة تحميل الملف عند الوصول إلى وقت انتهاء الصلاحية. إذا كان الملف الذي تم جلبه يحتوي على NetworkLinkControl، يكون لوقت <expires> الأولوية على أوقات انتهاء الصلاحية المحدّدة في رؤوس HTTP. في حال عدم تحديد وقت <expires>، يتم استخدام رأس max-age لبروتوكول HTTP (في حال توفّره). في حال عدم توفّر max-age، سيتم استخدام رأس HTTP Expires (في حال توفّره). (راجع القسم RFC261b من بروتوكول نقل النص التشعبي - HTTP 1.1 للحصول على تفاصيل حول حقول رأس HTTP.)
<refreshInterval>
يشير إلى تحديث الملف كل n ثانية.
<viewRefreshMode>
يحدد كيفية تحديث الرابط عند تغيير "الكاميرا".
يمكن أن يكون واحدًا مما يلي:
  • Never (افتراضي) - تجاهل التغييرات في العرض. تجاهل أيضًا معلمات <viewFormat>، إن وجدت.
  • onStop - يُرجى إعادة تحميل الملف بعد مرور n ثانية من توقّف الحركة، حيث يتم تحديد n في <viewRefreshTime>.
  • onRequest - يُرجى إعادة تحميل الملف فقط عندما يطلبه المستخدم بشكل صريح. (على سبيل المثال، في Google Earth، ينقر المستخدم بزر الماوس الأيمن ويختار "تحديث" في قائمة السياق.)
  • onRegion - حدّث الملف عندما تصبح المنطقة نشطة. راجع <Region>.
<viewRefreshTime>
بعد توقُّف حركة الكاميرا، يتم تحديد عدد الثواني التي يجب انتظارها قبل إعادة تحميل العرض. (راجع <viewRefreshMode> وonStop أعلاه).
<viewBoundScale>
يضبط معلمات BBOX قبل إرسالها إلى الخادم. تحدد القيمة الأقل من 1 استخدامًا أقل من العرض الكامل (الشاشة). تحدد القيمة الأكبر من 1 لجلب منطقة تمتد إلى خارج أطراف العرض الحالي.
<viewFormat>
يحدد تنسيق سلسلة طلب البحث التي يتم إلحاقها بالرابط <href> قبل جلب الملف.(إذا كان <href> يحدد ملفًا محليًا، فسيتم تجاهل هذا العنصر.)
في حال تحديد <viewRefreshMode> من onStop وعدم تضمين العلامة <viewFormat> في الملف، سيتم إلحاق المعلومات التالية تلقائيًا بسلسلة طلب البحث:

BBOX=[bboxWest],[bboxSouth],[bboxEast],[bbox North]

تتطابق هذه المعلومات مع مواصفات مربّع تحديد خدمة حدود خدمة الويب (WMS).
إذا حدّدت علامة <viewFormat> فارغة، لن تتم إضافة أي معلومات إلى سلسلة طلب البحث.
يمكنك أيضًا تحديد مجموعة مخصّصة من معلَمات العرض لإضافتها إلى سلسلة طلب البحث. في حال تقديم سلسلة تنسيق، سيتم استخدامها بدلاً من معلومات BBOX. إذا كنت ترغب أيضًا في الحصول على معلومات BBOX، فستحتاج إلى إضافة تلك المعلمات مع المعلمات المخصصة.
يمكنك استخدام أي من المعلّمات التالية في سلسلة التنسيق (وسيستبدل برنامج Google Earth القيمة الحالية المناسبة عند إنشاء سلسلة طلب البحث):
  • [lookatLon], [lookatLat] - خط الطول وخط العرض للنقطة التي يعرضها <LookAt>
  • [lookatRange] و[lookattilt] و[lookatHeader] - القيم التي يستخدمها العنصر <LookAt> (اطلع على أوصاف <range> و<tilt> و<heading> في <LookAt>)
  • [lookatTerrainLon] و[lookatTerrainLat] و[lookatTerrainAlt] - الإشارة إلى التضاريس بالدرجات والأمتار التي يعرضها <LookAt>
  • [cameraLon]، [cameraLat]، [cameraAlt] - درجات/أمتار من نقطة العين للكاميرا
  • [horizFov]، [vertFov] - مجال رؤية أفقي عمودي للكاميرا
  • [horizPixels]، [vertPixels] - الحجم بالبكسل للعارض ثلاثي الأبعاد
  • [terrainEnabled] - لتوضيح ما إذا كان العارض الثلاثي الأبعاد يعرض التضاريس
<httpطلب بحث>
إلحاق معلومات بسلسلة طلب البحث، استنادًا إلى المعلمات المحددة. (ويستبدل برنامج Google Earth القيمة الحالية المناسبة في وقت إنشاء سلسلة طلب البحث.) في ما يلي المعلَمات المتوافقة:
  • [clientVersion]
  • [kmlVersion]
  • [clientName]
  • [اللغة]

مثال

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

لتوسيع

تحتوي على

انظر أيضًا

<ListStyle>

البنية

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

الوصف

لتحديد كيفية عرض ميزة في عرض القائمة. يعد عرض القائمة عرضًا هرميًا للحاويات والعناصر الثانوية؛ أما في Google Earth، فهذه هي لوحة الأماكن.

عناصر خاصة بـ ListStyle

<listItemType>
يحدد كيفية عرض ميزة في عرض القائمة. القيم المحتملة هي:
  • check (افتراضي) - يتم ربط مستوى رؤية الميزة بمربع اختيار العنصر.
  • radioFolder - عند تحديده لحاوية، لن يظهر سوى عنصر واحد في الحاوية في كل مرة
  • checkOffOnly - عند تحديدها لحاوية أو لرابط شبكة، يتم منع عرض جميع العناصر في آنٍ واحد؛ وهذا يعني أنه يمكن للمستخدم إيقاف تشغيل كل شيء في الحاوية أو رابط الشبكة، ولكن لا يمكنه تشغيل كل شيء في الوقت نفسه. يُفيد هذا الإعداد في الحاويات أو روابط الشبكة التي تحتوي على كميات كبيرة من البيانات.
  • checkhideChild - استخدم مربع اختيار عادي لمستوى الرؤية ولكن لا تعرض العناصر الثانوية للحاوية أو Network Network في عرض القائمة. ويسمح مربّع الاختيار للمستخدم بتبديل مستوى رؤية العناصر الفرعية في العارض.
<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>
الرمز المُستخدَم في عرض القائمة الذي يعكس حالة جلب أو رابط المجلد. يتم استخدام الرموز المرتبطة بالوضعين فتح وإغلاق للمجلدات وروابط الشبكة. يتم استخدام الرموز المرتبطة بالأوضاع error وfetching0 وfetching1 وfetching2 لروابط الشبكة. توضح لقطة الشاشة التالية رموز Google Earth في الولايات التالية:
<state>
يحدد الحالة الحالية لرابط الشبكة أو المجلد. القيم المحتملة هي open وclosed وerror وfetching0 وfetching1 وfetching2. يمكن الجمع بين هذه القيم من خلال إدراج مسافة بين قيمتين (بدون فاصلة).
<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>

لتوسيع

تحتوي على

<انظر إلى>

البنية

<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

<longitude>
خط طول النقطة التي تنظر فيها الكاميرا. المسافة الزاوية بالدرجات، بالنسبة إلى خط الطول الرئيسي. تتراوح القيم الواقعة غرب خط الطول من -180 إلى 0 درجة. تتراوح القيم شرق خط الطول من 0 إلى 180 درجة.
<latitude>
خط عرض للنقطة التي تنظر فيها الكاميرا. درجات شمال خط الاستواء أو جنوبه (0 درجة). تتراوح القيم من -90 درجة إلى 90 درجة.
<height>
المسافة من سطح الأرض بالمتر. يتم تفسيرها وفقًا لوضع الارتفاع في LookAt.
<heading>
الاتجاه (أي الشمال والجنوب والشرق والغرب)، بالدرجات. Default=0 (شمال). (انظر الشكل التوضيحي التالي.) تتراوح القيم من 0 إلى 360 درجة.
الإمالة>
الزاوية بين اتجاه موضع LookAt وبين السطح الطبيعي لسطح الأرض. (انظر الشكل التوضيحي التالي.) تتراوح القيم من 0 إلى 90 درجة. لا يمكن أن تكون قيم <tilt> سالبة. وتشير القيمة <tilt> من 0 درجة إلى العرض من الأعلى مباشرةً. وتشير قيمة الإمالة> التي تبلغ 90 درجة إلى العرض على مستوى الأفق.
<range>(مطلوبة)
المسافة بالأمتار من النقطة المحدّدة بواسطة <longitude> و<latitude> و<height> إلى موضع LookAt. (انظر الشكل التوضيحي التالي.)
<altitudeMode>
يحدد كيفية تفسير الارتفاع <height> المحدد لنقطة LookAt. في ما يلي القيم المحتملة:
  • clampToGround - (افتراضي) تشير إلى تجاهل مواصفات <height> ووضع موضع LookAt على الأرض.
  • relativeToGround - يفسر <height> كقيمة بالأمتار فوق الأرض.
  • مطلق - يفسر <height> كقيمة بالأمتار فوق مستوى سطح البحر.
<gx:altitudeMode>
امتداد KML في مساحة اسم إضافة Google، يسمح بالارتفاعات المرتبطة بقاع البحر. القيم هي:
  • relativeToSeaFloor - لتفسير <height> كقيمة بالأمتار فوق قاع البحر. إذا كانت النقطة أعلى الأرض بدلاً من البحر، فسيتم تفسير <height> على أنها فوق سطح الأرض.
  • clampToSeaFloor - يتم تجاهل مواصفات <height> وسيتم وضع LookLook في قاع البحر. إذا كانت النقطة على الأرض وليس في البحر، فسيتم وضع LookAt على الأرض.

يوضح هذا الرسم البياني العناصر <range> و<tilt> و<altitude>:

 

يوضّح هذا الرسم البياني العنصر <heading>:

 

شرق=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>

الوصف

كائن ثلاثي الأبعاد موضح في ملف COLLADA (المشار إليه في علامة <Link>). ملفات COLLADA بامتداد الملف .dae. ويتم إنشاء النماذج في مساحة إحداثياتها الخاصة ثم تحديد موقعها وتحديد موقعها وتغيير حجمها في Google Earth. راجع صفحة "المواضيع في ملف KML" على النماذج لمزيد من التفاصيل.

يدعم Google Earth الملف الشخصي المشترك لـ COLLADA، مع وجود بعض الاستثناءات التالية:

  • لا يدعم برنامج Google Earth سوى المثلثات والخطوط كأنواع أساسية. الحد الأقصى لعدد المثلثات المسموح بها هو 21845.
  • لا يدعم برنامج Google Earth الصور المتحركة أو السلخ.
  • لا يدعم برنامج Google Earth مراجع هندسية خارجية.

العناصر الخاصة بالنموذج

<altitudeMode>
يحدد كيفية تفسير <height> المحدد في <Location>. في ما يلي القيم المحتملة:
  • clampToGround - (افتراضي) تشير إلى تجاهل مواصفات <height> ووضع النموذج على سطح الأرض.
  • relativeToGround - يفسر <height> كقيمة بالأمتار فوق الأرض.
  • مطلق - يفسر <height> كقيمة بالأمتار فوق مستوى سطح البحر.
<gx:altitudeMode>
امتداد KML في مساحة اسم إضافة Google، يسمح بالارتفاعات المرتبطة بقاع البحر. القيم هي:
  • relativeToSeaFloor - لتفسير <height> كقيمة بالأمتار فوق قاع البحر. إذا كانت النقطة أعلى الأرض بدلاً من البحر، فسيتم تفسير <height> على أنها فوق سطح الأرض.
  • clampToSeaFloor - يتم تجاهل مواصفات <height> وسيتم وضع النموذج في قاع البحر. إذا كانت النقطة على الأرض وليس في البحر، فسيتم وضع النموذج على الأرض.
<الموقع>
يحدد هذا الإعداد الإحداثيات الدقيقة لأصل النموذج في خط العرض وخط الطول والارتفاع. تُعد مقاييس Latitude وlongitude إسقاطًا قياسيًا لخط العرض مع مرجع WGS84. الارتفاع هو المسافة فوق سطح الأرض بالأمتار، ويتم تفسيره وفقًا لـ <altitudeMode> أو <gx:altitudeMode>.
<Location>
  <longitude>39.55375305703105</longitude>
  <latitude>-118.9813220168456</latitude>
  <altitude>1223</altitude>
</Location> 
الاتجاه>
يصف تدوير نظام إحداثيات نموذج ثلاثي الأبعاد لوضع الكائن في Google Earth. انظر الأشكال التوضيحية أدناه.
<Orientation>
  <heading>45.0</heading>
  <tilt>10.0</tilt>
  <roll>0.0</roll>
</Orientation> 

يتم تطبيق عمليات التدوير على نموذج بالترتيب التالي:

  1. <roll>
  2. الإمالة>
  3. <heading>
<heading>
التدوير حول المحور z (العادي لسطح الأرض). القيمة 0 (القيمة التلقائية) تساوي الشمال. يكون التدوير الموجب باتجاه عقارب الساعة حول المحور z ويتم تحديده بالدرجات من 0 إلى 360.
الإمالة>
تدوير حول المحور x. يكون التدوير الموجب باتجاه عقارب الساعة حول المحور x ويتم تحديده بالدرجات من 0 إلى 180.
<roll>
تدوير حول المحور ص. أما التدوير الموجب يكون في اتجاه عقارب الساعة حول المحور y ويتم تحديده بالدرجات من 0 إلى 180.
يتم تحديد العنوان والإمالة واللف في اتجاه عقارب الساعة عند النظر إلى أسفل المحور نحو الأصل
يوضح هذا الرسم البياني الاتجاه النموذجي لمحاور النموذج:
بالنسبة إلى النموذج النموذجي، يكون الحرف &quot;x&quot; على اليمين، و&quot;y&quot; في اتجاه الشمال ناحية الاتجاه، و&quot;z+&quot; لأعلى
تغيير الحجم>
تغير نموذجًا عبر المحاور x وy وz في مساحة إحداثي النموذج.
<Scale>
<x>2.5</x>
<y>2.5</y>
<z>3.5</z>
</Scale>
يحدد الملف للتحميل ومعلمات اختيارية لإعادة التحميل. يُرجى الاطّلاع على <Link>.
<ResourceMap>
يحدد 0 أو أكثر من عناصر <Alias>، كل منها عبارة عن تعيين لمسار ملف الزخرفة من ملف 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>

البنية

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

الوصف

حاوية للهندسة الأولية أو أكثر مرتبطة بالعنصر نفسه.

ملاحظة: تم إيقاف العلامة <GeometryCollection>. استخدم <MultiGeometry> بدلاً من ذلك.

العناصر المتعلقة بالهندسة المتعددة

مثال

<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) ليوم واحد لركوب الدراجة، ويشمل ذلك عدة محطات استراحة ومحطة للغداء. بسبب الانقطاعات في الوقت، قد تظهر جولة بالدراجة على شكل أربعة مسارات مختلفة عندما يتم رسم الأوقات والمواضع. يؤدي تجميع هذه العناصر <gx:Track> في حاوية واحدة <gx:MultiTrack> إلى عرضها في Google Earth كأقسام من مسار واحد. عندما يصل الرمز إلى نهاية جزء واحد، فإنه ينتقل إلى بداية الشريحة التالية. يحدد العنصر <gx:interpolate> ما إذا كان سيتم التوقف في نهاية المسار والانتقال السريع فورًا إلى بداية المسار التالي أو إدخال القيم المفقودة بين المسارين.

العناصر الخاصة بـ gx:MultiTrack

<altitudeMode>
يحدد كيفية تفسير مكونات الارتفاع في العنصر <الإحداثيات>. القيم المحتملة هي
  • clampToGround - (افتراضي) تشير إلى تجاهل مواصفات الارتفاع (على سبيل المثال، في العنصر <gx:coord> ).
  • relativeToGround - لتعيين ارتفاع العنصر بالنسبة إلى ارتفاع الأرض الفعلي لموقع معين. على سبيل المثال، إذا كان ارتفاع الأرض لموقع ما في مستوى سطح البحر تمامًا، وتم ضبط ارتفاع نقطة ما على 9 أمتار، فسيكون ارتفاع رمز ارتفاع العلامة الموضعية للنقطة هو 9 أمتار باستخدام هذا الوضع. ومع ذلك، إذا تم تعيين الإحداثي نفسه فوق موقع حيث يكون ارتفاع الأرض 10 أمتار فوق مستوى سطح البحر، فإن ارتفاع الإحداثي يبلغ 19 مترًا.
  • مطلق - تعيين ارتفاع الإحداثي بالنسبة إلى مستوى سطح البحر، بغض النظر عن الارتفاع الفعلي للتضاريس أسفل العنصر. فعلى سبيل المثال، إذا عينت ارتفاع إحداثيات إلى 10 أمتار باستخدام وضع الارتفاع المطلق، فسيظهر رمز العلامة الموضعية على مستوى الأرض إذا كانت التضاريس تحتها هي أيضًا 10 أمتار فوق مستوى سطح البحر. وإذا كانت التضاريس ترتفع عن مستوى سطح البحر بمسافة 3 أمتار، فستظهر العلامة الموضعية مرتفعة فوق التضاريس بمقدار 7 أمتار.
<gx:altitudeMode>
إضافة 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 مع المناطق للتعامل مع مجموعات البيانات الكبيرة جدًا بكفاءة.

<refreshمستوى الرؤية>
قيمة منطقية وتترك القيمة 0 مستوى رؤية الميزات التي يتحكم فيها مستخدم Google Earth. يمكنك تعيين القيمة على 1 لإعادة تعيين مستوى رؤية الميزات في كل مرة يتم فيها تحديث NetworkLink. على سبيل المثال، لنفترض أن علامة موضعية ضمن ملف KML المرتبط تم تعيين <visibility> على 1 وأن NetworkLink تم تعيين <refreshvisibility> على 1. عند تحميل الملف للمرة الأولى في برنامج Google Earth، يمكن للمستخدم إلغاء تحديد مربع الاختيار بجوار العنصر لإيقاف تشغيل العرض في العارض ثلاثي الأبعاد. ومع ذلك، عندما يتم تحديث NetworkLink، ستصبح العلامة الموضعية مرئية مرة أخرى، نظرًا لأن حالة رؤيتها الأصلية كانت TRUE.
<flyToView>
قيمة منطقية تؤدي القيمة 1 إلى انتقال برنامج Google Earth إلى عرض LookLook أو الكاميرا في NetworkLinkControl (إذا كانا موجودين). في حالة عدم احتواء NetworkLinkControl على عنصر AbstractView، فسينتقل Google Earth إلى عنصر LookAt أو Camera في العنصر Feature داخل العنصر <kml> في الملف الذي تم تحديثه. إذا لم يتم تحديد عنصر LookAt أو Camera للعنصر <kml>، فلن يتم تغيير العرض. على سبيل المثال، ينتقل برنامج Google Earth إلى عرض <LookAt> للمستند الرئيسي، وليس إلى <LookAt> العلامات الموضعية المضمنة في المستند.

نصيحة: لعرض مجلد أو مستند المستوى الأعلى ضمن رابط شبكة في عرض القائمة، عيّن رقم تعريف للمجلد أو المستند. وبدون هذا المعرّف، يتم عرض أسماء الكائنات الفرعية فقط في "عرض على شكل قائمة".

مثال

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

لتوسيع

تحتوي على

<NetworkLinkControl>

البنية

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

الوصف

يتحكم في سلوك الملفات التي يتم جلبها عن طريق <NetworkLink>.

عناصر خاصة بـ NetworkLinkControl

<minRefreshPeriod>
يُحدد بالثواني، وهو <minRefreshPeriod>، وهو الحد الأدنى المسموح به للوقت بين عمليات جلب الملف. تتيح هذه المعلمة للخوادم التحكم في عمليات جلب ملف معين ولتخصيص معدلات التحديث وفقًا لمعدّل التغيير المتوقع للبيانات. على سبيل المثال، قد يعين المستخدم تحديث رابط على 5 ثوانٍ، ولكن يمكنك تعيين الحد الأدنى لمدة التحديث على 3600 للحد من تحديثات التحديث مرة واحدة كل ساعة.
<maxSessionLength>
محدد بالثانية، <maxSessionLength> هو الحد الأقصى لمقدار الوقت الذي يظل فيه ارتباط الشبكة للعميل. وتشير القيمة التلقائية -1 إلى عدم إنهاء الجلسة بشكل صريح.
استخدم العنصر لإلحاق سلسلة بطلب عنوان URL عند التحديث التالي لرابط الشبكة. يمكنك استخدام هذه البيانات في النص البرمجي لتوفير معالجة أكثر ذكاءً من جانب الخادم، بما في ذلك طلب البحث عن الإصدار وتسليم الملف الشرطي.
<message>
يمكنك عرض رسالة منبثقة، مثل إرشادات الاستخدام لرابط الشبكة. تظهر الرسالة عند تحميل رابط الشبكة لأول مرة في برنامج Google Earth، أو عند تغييره في عنصر التحكم في رابط الشبكة.
<linkName>
يمكنك التحكم في اسم رابط الشبكة من الخادم، حتى يلغي الخادم التغييرات التي يتم إجراؤها على الاسم من جانب العميل.
<linkDescription>
يمكنك التحكم في وصف رابط الشبكة من الخادم، بحيث يلغي الخادم التغييرات التي تطرأ على الوصف من جانب العميل.
<linkSnippet maxLines="2" >
يمكنك التحكم في مقتطف رابط الشبكة من الخادم، وبذلك يلغي الخادم التغييرات التي يتم إجراؤها على المقتطف من جانب العميل. يحتوي <linkSnippet> على سمة maxLines، وهي عدد صحيح يحدّد الحد الأقصى لعدد السطور المراد عرضها.
<expires>
يمكنكَ تحديد تاريخ/وقت ينبغي فيه تحديث الرابط. لا تسري هذه المواصفات إلا إذا كانت قيمة <refreshMode> في <Link> بالقيمة onExpire. راجع <refreshMode>
تحديث>
باستخدام <تحديث>، يمكنك تحديد أي عدد من علامات التغيير والإنشاء والحذف لملف .kml أو أرشيف .kmz الذي تم تحميله سابقًا باستخدام رابط شبكة. راجع <تحديث>.
<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>

انظر أيضًا

<Object>

البنية

<!-- 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>
  <!-- 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> بتحديد موقع صورة جغرافيًا على الأرض جغرافيًا وتحديد معلمات عرض لتراكب الصور هذا. يمكن أن يكون تراكب الصور مستطيلاً ثنائي الأبعاد بسيطًا أو أسطوانة جزئية أو كاملة أو بانوراما 360 درجة (للبانوراما البانورامية). يتم وضع التراكب في الموقع المحدد ويتم توجيهه نحو نقطة العرض.

ونظرًا لأن <PhotoOverlay> مشتق من <Feature>، يمكن أن يحتوي على أحد العنصرين المستمدة من <AbstractView>—إما <Camera> أو <LookAt>. تحدد الكاميرا (أو LookAt) نقطة عرض واتجاه العرض (يُشار إليهما أيضًا باسم موجّه العرض). يتم وضع تراكب الصور في ما يتعلق بنقطة العرض. وبشكل خاص، فإن مستوى الصورة المستطيلة ثنائية الأبعاد هو عمودي (في الزوايا اليمنى) لمتجه العرض. ويتجه الجزء الطبيعي من هذه الطائرة - أي الجزء الأمامي منها - وهو الجزء الذي يظهر في الصورة - نحو نقطة العرض.

يتم تحديد عنوان URL لصورة تراكب الصور في علامة <Icon> الموروثة من <تراكب>. يجب أن تحتوي علامة <Icon> على عنصر <href> الذي يحدد ملف الصورة لاستخدامه مع PhotoOverlay. في حالة وجود صورة كبيرة جدًا، يكون <href> عنوان URL خاصًا تتم فهرسته إلى هرم به صور بدرجات دقة مختلفة (راجع ImagePyramid).

لمزيد من المعلومات، اطّلع على صفحة "المواضيع في ملف KML" على PhotoOverlay.

العناصر المتعلقة بتراكب الصور

<التدوير>
لضبط كيفية وضع الصورة داخل حقل العرض. يُعد هذا العنصر مفيدًا إذا تم تدوير الصورة وانحرفت قليلاً عن العرض الأفقي المطلوب.
<عرض الحجم>
يحدد مقدار ما يظهر من المشهد الحالي. إن تحديد مجال الرؤية مماثل لتحديد فتح العدسة في كاميرا فعلية. يركّز حقل صغير من الرؤية، مثل العدسة المقرِّبة، على جزء صغير من المشهد. يركّز مجال الرؤية الكبير، مثل العدسة الواسعة الزاوية، على جزء كبير من المشهد.
<leftFov>
الزاوية، بالدرجات، بين اتجاه مشاهدة الكاميرا والجانب الأيسر من مستوى الرؤية.
<rightFov>
الزاوية، بين الدرجات، بين اتجاه مشاهدة الكاميرا والجانب الأيمن من مستوى الصوت.
<bottomFov>
الزاوية، بالدرجات، بين اتجاه مشاهدة الكاميرا والجانب السفلي من مستوى صوت العرض.
<topFov>
الزاوية، بالدرجات، بين اتجاه مشاهدة الكاميرا والجانب العلوي لمستوى صوت العرض.
<near>
قياس بالأمتار باتجاه العرض من نقطة عرض الكاميرا إلى شكل تراكب الصور.
يتم تحديد حقل عرض تراكب الصور من خلال أربع طائرات، يتم تحديد كل منها بزاوية تتناسب مع موجّه العرض. تحدّد هذه الطائرات الأربعة الجوانب العلوية والسفلية واليسرى واليمين لحقل الرؤية، والتي تكون على شكل هرم مقطوع، كما هو موضّح هنا:
توضح الرسوم البيانية التالية زوايا مجال الرؤية الأربع داخل هذا الهرم:
هرم الصورة>
بالنسبة إلى الصور الكبيرة جدًا، ستحتاج إلى إنشاء هرم مصوّر، وهو مجموعة هرمية من الصور، كل منها نسخة متزايدة الدقة من الصورة الأصلية. يتم تقسيم كل صورة في الهرم إلى أجزاء، بحيث لا يلزم تحميل سوى الأجزاء المعروضة فقط. يحسب برنامج Google Earth نقطة العرض الحالية ويحمّل المربعات الملائمة لمسافة المستخدم من الصورة. ومع اقتراب نقطة العرض من تراكب الصور، يحمّل برنامج Google Earth مربعات دقة أعلى. نظرًا لأن جميع وحدات البكسل في الصورة الأصلية لا يمكن عرضها على الشاشة في وقت واحد، فإن هذه المعالجة المسبقة تتيح لـ Google Earth تحقيق الحد الأقصى من الأداء نظرًا لأنها لا تحمّل سوى أجزاء من الصورة التي يتم عرضها، بالإضافة إلى تفاصيل البكسل التي يمكن للمستخدم تمييزها عند نقطة العرض الحالية فقط.
عندما تحدد هرمًا مصوّرًا، يمكنك أيضًا تعديل عنصر <href> في عنصر <Icon> لتضمين مواصفات الصور التي سيتم تحميلها.
<tileSize>
حجم المربّعات بالبكسل يجب أن تكون المربعات مربّعة، ويجب أن تكون قيمة <tileSize> ناتج 2. ويُوصى بحجم 256 (الحجم الافتراضي) أو 512. يتم تقسيم الصورة الأصلية إلى أجزاء بهذا الحجم، بدرجات دقة متباينة.
<maxالعرض>
العرض بالبكسل للصورة الأصلية.
<maxHeight>
ارتفاع بكسل الصورة الأصلية.
<gridOrigin>
يحدد نقطة بدء ترقيم المربعات في كل طبقة من الهرم. تحدد القيمة lowerLeft أن الصف 1، العمود 1 لكل طبقة موجود في الركن السفلي الأيمن من الشبكة.
<Point>
يعمل العنصر <Point> كـ <Point> داخل عنصر <العلامة الموضعية>. وترسم رمزًا لوضع علامة على موضع تراكب الصور. يتم تحديد الرمز المرسوم من خلال الحقلين <styleUrl> و<StyleSelector>، تمامًا كما هو الحال مع <العلامة الموضعية>.
<شكل>
يتم عرض تراكب الصور على الشكل. يمكن أن يكون <shape> واحدًا مما يلي:

مستطيل (افتراضي) - لصورة عادية

اسطوانة - للصور البانورامية، والتي يمكن أن تكون أسطوانات جزئية أو كاملة

بانوراما 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، تظهر علامة موضعية كعنصر قائمة في لوحة الأماكن. تشتمل العلامة الموضعية التي تتضمن نقطة على رمز مرتبط بها يضع علامة على نقطة على الأرض في العارض ثلاثي الأبعاد. (في العارض ثلاثي الأبعاد لبرنامج Google Earth، تعد العلامة الموضعية للنقطة هي الكائن الوحيد الذي يمكنك النقر عليه أو التمرير فوقه. لا تحتوي كائنات الهندسة الأخرى على رمز في العارض ثلاثي الأبعاد. لإعطاء المستخدم شيئًا للنقر عليه في العارض ثلاثي الأبعاد، سيلزمك إنشاء كائن متعدد الأبعاد يحتوي على كل من كائن النقطة والعنصر الهندسي الآخر.)

العناصر الخاصة بالعلامة الموضعية

مثال

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

الوصف

موقع جغرافي يتم تحديده من خلال خط الطول وخط العرض والارتفاع (اختياري) عند احتواء نقطة على علامة موضعية، تحدد النقطة نفسها موضع اسم ورمز العلامة الموضعية. عند انبثاق نقطة ما، يتم توصيلها بالأرض بواسطة خط. يستخدم "التوصيل" نمط الخط الحالي.

عناصر خاصة بالنقطة

بثق>
قيمة منطقية لتحديد ما إذا كان سيتم توصيل النقطة بالأرض بخط أم لا. لإخراج نقطة، يجب أن تكون قيمة <altitudeMode> إما relativeToGround أو relativeToSeaFloor أو absolute. تنبثق النقطة نحو مركز الكرة الأرضية.
<altitudeMode>
يحدد كيفية تفسير مكونات الارتفاع في العنصر <الإحداثيات>. القيم المحتملة هي
  • clampToGround - (افتراضي) تشير إلى تجاهل مواصفات الارتفاع (على سبيل المثال، في العلامة <الإحداثيات>).
  • relativeToGround - لتعيين ارتفاع العنصر بالنسبة إلى ارتفاع الأرض الفعلي لموقع معين. على سبيل المثال، إذا كان ارتفاع الأرض لموقع ما في مستوى سطح البحر تمامًا، وتم ضبط ارتفاع نقطة ما على 9 أمتار، فسيكون ارتفاع رمز ارتفاع العلامة الموضعية للنقطة هو 9 أمتار باستخدام هذا الوضع. ومع ذلك، إذا تم تعيين الإحداثي نفسه فوق موقع حيث يكون ارتفاع الأرض 10 أمتار فوق مستوى سطح البحر، فإن ارتفاع الإحداثي يبلغ 19 مترًا. الاستخدام المعتاد لهذا الوضع هو وضع أعمدة الهاتف أو مصعد التزلج.
  • مطلق - تعيين ارتفاع الإحداثي بالنسبة إلى مستوى سطح البحر، بغض النظر عن الارتفاع الفعلي للتضاريس أسفل العنصر. فعلى سبيل المثال، إذا عينت ارتفاع إحداثيات إلى 10 أمتار باستخدام وضع الارتفاع المطلق، فسيظهر رمز العلامة الموضعية على مستوى الأرض إذا كانت التضاريس تحتها هي أيضًا 10 أمتار فوق مستوى سطح البحر. وإذا كانت التضاريس ترتفع عن مستوى سطح البحر بمسافة 3 أمتار، فستظهر العلامة الموضعية مرتفعة فوق التضاريس بمقدار 7 أمتار. الاستخدام العادي لهذا الوضع مخصص لوضع الطائرة.
<gx:altitudeMode>
امتداد KML في مساحة اسم إضافة Google، يسمح بالارتفاعات المرتبطة بقاع البحر. القيم هي:
  • relativeToSeaFloor - تفسير الارتفاع على أنه قيمة بالأمتار فوق قاع البحر. إذا كانت النقطة أعلى الأرض بدلاً من البحر، فسيتم تفسير الارتفاع على أنه فوق الأرض.
  • clampToSeaFloor - يتم تجاهل مواصفات الارتفاع، وسيتم وضع النقطة في قاع البحر. إذا كانت النقطة على الأرض وليس في البحر، فسيتم وضع النقطة على الأرض.
<الإحداثيات>(مطلوبة)
مكوّن واحد يتكون من قيم نقاط عائمة لخط الطول وخط العرض والارتفاع (بهذا الترتيب) قيم خطوط الطول وخطوط العرض بالدرجات، حيث
  • خط الطول ≥ -180 و<= 180
  • latitude ≥ -90 و≤ 90
  • قيم height (اختيارية) بأمتار فوق مستوى سطح البحر
لا تُدرِج مسافات بين القيم الثلاث التي تصف إحداثيًا.

مثال

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

لتوسيع

تحتوي على

<المضلع>

البنية

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

الوصف

يتم تعريف المضلع بواسطة حد خارجي و0 أو أكثر من الحدود الداخلية. يتم تعريف الحدود بدورها عن طريق linearRings. عند انبثاق مضلع، يتم ربط حدوده بالأرض لتشكيل مضلعات إضافية، مما يعطي مظهرًا لمبنى أو مربع. تستخدم المضلعات المبثوثة <PolyStyle> للألوان ووضع الألوان والتعبئة.

يجب تحديد إحداثيات> المضلعات بترتيب عكس عقارب الساعة. تتبع المضلعات "القاعدة اليمنى"، والتي تنص على أنه عند وضع أصابع اليد اليمنى في الاتجاه الذي يتم تحديد الإحداثيات عليه، يشير إبهامك في الاتجاه العام للشكل الهندسي للمضلع المضلع. (في الرسومات ثلاثية الأبعاد، يتم استخدام الشكل الهندسي العادي للإضاءة وبعيدًا عن الوجه الأمامي للمضلع.) نظرًا لأن Google Earth لا يملأ سوى الواجهة الأمامية للمضلعات، فإنك لن تحقق التأثير المطلوب إلا عندما يتم تحديد الإحداثيات بالترتيب الصحيح. وإلا سيكون المضلع رماديًا.

ملاحظة: في Google Earth، يتبع المضلع مع ارتفاع [altitudeMode> من clampToGround خطوطًا ذات اتجاه ثابت، ولكن يتبع linearRing (بنفسه) مع وضع <altitudeMode> من clampToGround خطوطًا دائرية رائعة.

عناصر خاصة بالمضلع

بثق>
قيمة منطقية لتحديد ما إذا كان سيتم توصيل المضلع بالأرض. لإنتاج مضلع، يجب أن يكون وضع الارتفاع إما relativeToGround أو relativeToSeaFloor أو مطلق. لا تنبثق إلا الرؤوس فقط، وليس الشكل الهندسي نفسه (على سبيل المثال، يتحول المستطيل إلى مربع يحتوي على خمسة أوجه). تنبثق رؤوس المضلّع نحو مركز الكرة الأرضية.
<tessellate>
لا يتم استخدام هذا الحقل بواسطة المضلع. للسماح للمضلّع باتباع التضاريس (أي لتمكين الفسيفساء)، حدد وضع ارتفاع clampToGround أو clampToSeaFloor.
<altitudeMode>
يحدد كيفية تفسير مكونات الارتفاع في العنصر <الإحداثيات>. القيم المحتملة هي
  • clampToGround - (افتراضي) تشير إلى تجاهل مواصفات الارتفاع (على سبيل المثال، في العلامة <الإحداثيات>).
  • relativeToGround - لتعيين ارتفاع العنصر بالنسبة إلى ارتفاع الأرض الفعلي لموقع معين. على سبيل المثال، إذا كان ارتفاع الأرض لموقع ما في مستوى سطح البحر تمامًا، وتم ضبط ارتفاع نقطة ما على 9 أمتار، فسيكون ارتفاع رمز ارتفاع العلامة الموضعية للنقطة هو 9 أمتار باستخدام هذا الوضع. ومع ذلك، إذا تم تعيين الإحداثي نفسه فوق موقع حيث يكون ارتفاع الأرض 10 أمتار فوق مستوى سطح البحر، فإن ارتفاع الإحداثي يبلغ 19 مترًا. الاستخدام المعتاد لهذا الوضع هو وضع أعمدة الهاتف أو مصعد التزلج.
  • مطلق - تعيين ارتفاع الإحداثي بالنسبة إلى مستوى سطح البحر، بغض النظر عن الارتفاع الفعلي للتضاريس أسفل العنصر. فعلى سبيل المثال، إذا عينت ارتفاع إحداثيات إلى 10 أمتار باستخدام وضع الارتفاع المطلق، فسيظهر رمز العلامة الموضعية على مستوى الأرض إذا كانت التضاريس تحتها هي أيضًا 10 أمتار فوق مستوى سطح البحر. وإذا كانت التضاريس ترتفع عن مستوى سطح البحر بمسافة 3 أمتار، فستظهر العلامة الموضعية مرتفعة فوق التضاريس بمقدار 7 أمتار. الاستخدام العادي لهذا الوضع مخصص لوضع الطائرة.
<gx:altitudeMode>
امتداد KML في مساحة اسم إضافة Google، يسمح بالارتفاعات المرتبطة بقاع البحر. القيم هي:
  • relativeToSeaFloor - لتفسير <height> كقيمة بالأمتار فوق قاع البحر. إذا كانت النقطة أعلى الأرض بدلاً من البحر، فسيتم تفسير الارتفاع على أنه فوق الأرض.
  • clampToSeaFloor - يتم تجاهل مواصفات الارتفاع، وسيتم وضع النقطة في قاع البحر. إذا كانت النقطة على الأرض وليس في البحر، فسيتم وضع النقطة على الأرض.
<outerBoundaryIs>(مطلوبة)
تحتوي على عنصر <linearRing>.
<innerBoundaryIs>
تحتوي على عنصر <linearRing>. يمكن أن يحتوي المضلع على العديد من عناصر <innerBoundaryIs> ، والتي تنشئ العديد من القطع داخل المضلع.

مثال

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

لتوسيع

تحتوي على

<PolyStyle>

البنية

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

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

الوصف

لتحديد نمط الرسم لجميع المضلعات، بما في ذلك الأشكال المضلعة (التي تبدو مثل جدران المباني) وخطوط العرض (التي تبدو مثل الأسوار الثابتة).

العناصر الخاصة بـ PolyStyle

<fill>
قيمة منطقية لتحديد ما إذا كان سيتم ملء المضلع أم لا.
<outline>
قيمة منطقية لتحديد ما إذا كان سيتم تخطيط المضلع أم لا. تستخدم المخططات المضلّعة نمط الخط الحالي.

مثال

<?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>) الذي يحدد نطاق صلاحية المنطقة المرتبطة من حيث حجم الشاشة المتوقع. يقال أن إحدى المناطق "نشطة" عندما يكون مربع الإحاطة داخل نطاق عرض المستخدم وتستوفي متطلبات LOD. ولا يتم رسم العناصر المرتبطة بمنطقة إلا عندما تكون المنطقة نشطة. عندما تكون قيمة <viewRefreshMode> هي onRegion، يتم تحميل الرابط أو الرمز فقط عندما تكون المنطقة نشطة. يمكنك الاطلاع على صفحة "المواضيع في ملف KML" في المناطق للحصول على مزيد من التفاصيل. في العرض الهرمي للحاويات أو NetworkLink، تستخدم هذه العملية الحسابية المنطقة الأقرب إلى الأصل في التدرج الهرمي.

عناصر خاصة بالمنطقة

<LatLonAltBox>(مطلوب)
مربّع حدودي يصف منطقة اهتمام تم تحديدها بواسطة إحداثيات وارتفاعات جغرافية. في ما يلي القيم التلقائية والحقول المطلوبة:
<altitudeMode> أو <gx:altitudeMode>
القيم المحتملة لـ <altitudeMode> هي clampToGround وrelativeToGround وabsolute. القيم المحتملة لـ <gx:altitudeMode> هي clampToSeaFloor وrelativeToSeaFloor. راجع أيضًا <LatLonBox>.
<minAltitude>
يتم تحديد هذه العلامة بالأمتار (وتتأثر بمواصفات وضع الارتفاع).
<maxAltitude>
يتم تحديد هذه العلامة بالأمتار (وتتأثر بمواصفات وضع الارتفاع).
<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> 

لتوسيع

تحتوي على

<المخطط>

البنية

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

الوصف

تحدِّد هذه الوسيطة مخطّط KML مخصّصًا يُستخدم لإضافة بيانات مخصّصة إلى ميزات KML. السمة "id" مطلوبة ويجب أن تكون فريدة ضمن ملف KML. ويكون <Schema> دائمًا عنصرًا فرعيًا لـ <Document>.

العناصر المتعلقة بالمخطط

يحتوي عنصر المخطط على عنصر SimpleField واحد أو أكثر. في SimpleField، يعلن المخطط عن نوع واسم الحقل المخصص. تحدد اختياريًا displayName (نموذج سهل الاستخدام، مع المسافات وعلامات الترقيم المناسبة للاستخدام في Google Earth) لهذا الحقل المخصص.

SimpleSimple type="string" name="string">
إعلان الحقل المخصص، والذي يجب أن يحدد كلاً من نوع واسم هذا الحقل. في حال إغفال type أو name، يتم تجاهل الحقل. يمكن أن يكون type واحدًا مما يلي:
  • سلسلة
  • int
  • يونت
  • فيديو قصير
  • قصير
  • عدد عائم
  • مزدوج
  • قيمة منطقية
<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>

لتوسيع

هذا عنصر جذر.

تحتوي على

انظر أيضًا

<تراكب الشاشة>

البنية

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

الوصف

يرسم هذا العنصر تراكب صور ثابتًا على الشاشة. نماذج الاستخدامات لتراكبات الشاشة هي بوصلة وشعارات وشاشة عرض رأسية. يتم تحديد حجم Screen التراكب بواسطة العنصر <size>. يتم التعامل مع موضع التراكب عن طريق تعيين نقطة في الصورة المحددة بواسطة <overlayXY> إلى نقطة على الشاشة يتم تحديدها بواسطة <screenXY>. وبعد ذلك، يتم تدوير الصورة بمقدار <rotation> درجة حول نقطة نسبية إلى الشاشة المحددة عن طريق <rotationXY>.

يحدد عنصر <href> الثانوي لـ <Icon> الصورة التي سيتم استخدامها كتراكب. ويمكن أن يكون هذا الملف على نظام ملفات محلي أو على خادم ويب. إذا تم إسقاط هذا العنصر أو إذا كان لا يحتوي على <href>، فسيتم رسم مستطيل باستخدام اللون والحجم اللذين يحددهما تراكب الشاشة.

عناصر خاصة بتراكب الشاشة

<XXY>
يحدد نقطة على (أو خارج) صورة التراكب التي تم تعيينها إلى إحداثي الشاشة (<screenXY>). يتطلب قيمًا x وy، ووحدات لهذه القيم.
يمكن تحديد القيمتَين x وy بثلاث طرق مختلفة: على شكل بكسل ("pixels") أو على شكل كسور في الصورة ("fraction") أو على شكل بكسل مضمّن("insetPixels")، وهو عبارة عن إزاحة بالبكسل من الزاوية العلوية اليسرى للصورة. يمكن تحديد الموضعين x وy بطرق مختلفة—على سبيل المثال، يمكن أن يكون x بالبكسل ويمكن أن يكون y كسرًا. يقع أصل نظام الإحداثيات في الجانب السفلي الأيمن من الصورة.
  • x - إما عدد وحدات البكسل أو مكوّن كسري للصورة أو إدخال وحدة بكسل يشير إلى المكوّن x لنقطة على صورة التراكب.
  • y - عدد وحدات البكسل أو مكوّنات كسرية من الصورة أو وحدات بكسل مضمنة تشير إلى المكوِّن y لنقطة على صورة التراكب.
  • xunits - الوحدات التي يتم فيها تحديد القيمة x. وتشير القيمة "fraction" إلى أن القيمة x هي جزء من الصورة. وتشير القيمة "pixels" إلى القيمة x بالبكسل. تشير القيمة "insetPixels" إلى المسافة البادئة من الحافة اليمنى للصورة.
  • yunits - الوحدات التي يتم تحديد قيمة y فيها. وتشير القيمة "fraction" إلى أن القيمة y هي جزء من الصورة. وتشير القيمة "pixels" إلى القيمة y بالبكسل. تشير القيمة "insetPixels" إلى المسافة البادئة من الحافة العلوية للصورة.
<screenXY>
يحدد نقطة ذات صلة بأصل الشاشة الذي يتم تعيين صورة التراكب إليه. يمكن تحديد القيم x وy بثلاث طرق مختلفة: كـ بكسل ("pixels")، أو كسور بالشاشة ("fraction")، أو كـ بكسل مضمن ("insetPixels")، وهو إزاحة بالبكسل من الزاوية اليسرى العليا من الشاشة. يمكن تحديد الموضعين x وy بطرق مختلفة—على سبيل المثال، يمكن أن يكون x بالبكسل ويمكن أن يكون y كسرًا. يقع أصل نظام الإحداثيات في الجانب السفلي الأيمن من الشاشة.
  • x - عدد وحدات البكسل أو مكوّنات كسرية من الشاشة أو وحدات بكسل مضمنة تشير إلى المكوِّن x لنقطة على الشاشة.
  • y - عدد وحدات البكسل أو مكوّنات كسرية من الشاشة أو وحدات بكسل مضمنة تشير إلى المكوِّن y لنقطة على الشاشة.
  • xunits - الوحدات التي يتم فيها تحديد القيمة x. وتشير القيمة "fraction" إلى أن القيمة x هي جزء من الشاشة. وتشير القيمة "pixels" إلى القيمة x بالبكسل. تشير القيمة "insetPixels" إلى المسافة البادئة من الحافة اليسرى للشاشة.
  • yunits - الوحدات التي يتم تحديد قيمة y فيها. وتشير القيمة fraction إلى أن القيمة y تمثل جزءًا من الشاشة. وتشير القيمة "pixels" إلى القيمة y بالبكسل. تشير القيمة "insetPixels" إلى المسافة البادئة من الحافة العلوية للشاشة.
على سبيل المثال، يشير <screenXY x=".5" y=".5" xunits="fraction" yunits="fraction"/> إلى نقطة في منتصف الشاشة.
إليك بعض الأمثلة:

توسيط الصورة:

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

ضع الصورة في أعلى اليمين:

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

ضع الصورة على يسار الشاشة:

<ScreenOverlay>
  <overlayXY x="1" y="1" xunits="fraction" yunits="fraction"/>
  <screenXY x="1" y="1" xunits="fraction" yunits="fraction"/>
</ScreenOverlay>  
<rotationXY>
النقطة بالنسبة إلى الشاشة التي يتم تدوير تراكب الشاشة عليها.
<size>
يحدد هذا الإعداد حجم الصورة لتراكب الشاشة على النحو التالي:
  • تشير القيمة -1 إلى استخدام البُعد الأصلي
  • وتشير القيمة 0 إلى الحفاظ على نسبة العرض إلى الارتفاع
  • تعين القيمة n قيمة البُعد
على سبيل المثال:

لفرض الاحتفاظ بالأبعاد الأصلية x وy للصورة، اضبط القيم على -1:

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

لفرض الاحتفاظ بالبعد الأفقي للصورة، على أن تشغل 20% من مساحة الشاشة العمودية:

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

لفرض تغيير حجم الصورة إلى 100 بكسل × 500 بكسل:

<size x="100" y="500" xunits="pixels" yunits="pixels"/> 
<التدوير>
يشير إلى زاوية دوران الكائن الرئيسي. تعني القيمة 0 عدم التدوير. القيمة زاوية بالدرجات عكس اتجاه عقارب الساعة تبدأ من الشمال. استخدِم ±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 id="ID">
<!-- extends StyleSelector -->

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

الوصف

يحدد النمط مجموعة أنماط قابلة للتعيين يمكن الرجوع إليها من خلال StyleMaps and Features. تؤثر الأنماط في كيفية تقديم الشكل الهندسي في العارض ثلاثي الأبعاد وفي كيفية ظهور الميزات في لوحة الأماكن في عرض القائمة. ويتم جمع الأنماط المشتركة في مستند <Document> ويجب أن يكون لها id معرّف لها حتى يمكن الإشارة إليها بواسطة الميزات الفردية التي تستخدمها.

استخدم 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 id="ID">
  <!-- extends StyleSelector -->
  <!-- elements specific to StyleMap -->
  <Pair id="ID">
    <key>normal</key>              <!-- kml:styleStateEnum:  normal or highlight -->
    <styleUrl>...</styleUrl> or <Style>...</Style>
  </Pair>
</StyleMap>

الوصف

يتم تعيين <StyleMap> بين نمطين مختلفين. عادةً ما يتم استخدام عنصر <StyleMap> لتوفير أنماط عادية ومميزة منفصلة للعلامة الموضعية، بحيث يظهر الإصدار المميز عندما يمرر المستخدم الماوس فوق الرمز في Google Earth.

العناصر الخاصة بـ StyleMap

<إقران>(مطلوب)
يحدد زوجًا من المفاتيح/القيمة الذي يعيّن وضعًا (عادي أو تمييز) إلى <styleUrl> المحدّد مسبقًا. يحتوي <إقران> على عنصرين (كلاهما مطلوب):
  • <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>. يحدد عنصر StyleMap نمطًا بناءً على الوضع الحالي للعلامة الموضعية. يتم تحديد عنصر مشتق من StyleSelector بشكل فريد من خلال id وurl الخاص به.

العناصر الخاصة بـ StyleSelector

لا يحتوي هذا العنصر المجرّد على أي عناصر فرعية.

لتوسيع

تمديد بمقدار

<TimePrimitive>

البنية

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

الوصف

هذا عنصر مجرد ولا يمكن استخدامه مباشرة في ملف KML. ويتم تمديد هذا العنصر بواسطة عناصر <TimeSpan> و<TimeStamp>.

لتوسيع

تمديد بمقدار

<TimeSpan>

البنية

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

الوصف

يمثل ذلك حدًا زمنيًا تحدّده أوقات البدء والانتهاء dateTimes.

في حال عدم وجود [begin> أو <end>، تكون نهاية الفترة غير مرتبطة (انظر المثال أدناه).

يتم تحديد dateTime وفقًا لوقت مخطط XML (راجع الجزء الثاني من مخطط XML: أنواع البيانات الإصدار الثاني). يمكن التعبير عن القيمة بالصيغة yyyy-mm-ddThh:mm:ss.ssszzzz، حيث يكون T الفاصل بين التاريخ والوقت، وتكون المنطقة الزمنية إما Z (للتوقيت العالمي المتّفق عليه) أو zzzzzz، والذي يمثل ±hh:mm بالنسبة إلى التوقيت العالمي المنسق. بالإضافة إلى ذلك، يمكن التعبير عن القيمة كتاريخ فقط. راجع <TimeStamp> للحصول على أمثلة.

العناصر الخاصة بـ TimeSpan

<البدء>
وصف فوري فوري للفترة الزمنية. وفي حال عدم وجود قيمة، تكون بداية الفترة غير محدودة.
<end>
وصف نهاية فورية لإحدى الفترات الزمنية. وفي حال عدم وجود قيمة، تكون نهاية الفترة غير محدودة.

مثال

يوضح المثال التالي الفترة الزمنية التي تمثل ولاية كولورادو. وتحتوي فقط على العلامة <begin> لأن ولاية كولورادو أصبحت ولاية في 1 آب (أغسطس) 1876، ولا تزال في حالة:

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

لتوسيع

تحتوي على

الطابع الزمني>

البنية

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

الوصف

يمثل لحظة مفردة من الزمن. هذا العنصر بسيط ولا يحتوي على عناصر ثانوية. وتكون قيمتها dateTime المحددة بوقت XML (راجع XML Schema Part 2: Datatypes Second Edition). تم تحديد دقة الطابع الزمني من خلال قيمة dateTime في العنصر <when> .

العناصر الخاصة بالطابع الزمني

<when>
يحدد لحظة واحدة من الزمن. تكون القيمة dateTime، والتي يمكن أن تكون واحدة مما يلي:
  • dateTime تعطي درجة الدقة الثانية
  • date تمنح درجة الدقة اليومية
  • gYearMonth يعرض قرار الشهر
  • gYear هي السنة التي يتم فيها عرض الحلّ

توضح الأمثلة التالية درجات دقة مختلفة للقيمة <when> :

  • gYear (YYYY)
<TimeStamp>
  <when>1997</when>
</TimeStamp>
  • gYearMonth (YYYY-MM)
<TimeStamp>
  <when>1997-07</when>
</TimeStamp> 
  • date (YYYY-MM-DD)
<TimeStamp>
  <when>1997-07-16</when>
</TimeStamp> 
  • dateTime (YYYY-MM-DDThh:mm:ssZ)
    هنا، يكون T الفاصل بين التقويم وتدوين الوقت بالساعة، ويشير Z إلى UTC. (الثواني مطلوبة.)
<TimeStamp>
  <when>1997-07-16T07:30:15Z</when>
</TimeStamp>
  • dateTime (YYYY-MM-DDThh:mm:sszzzzzz)
    يوفر هذا المثال التوقيت المحلي ثم التحويل ± إلى التوقيت العالمي المنسق.
<TimeStamp>
  <when>1997-07-16T10:30:15+03:00</when>
</TimeStamp>

لتوسيع

تحتوي على

  • أي عنصر يعمل على توسعة <Feature>

<gx:TimeSpan> و<gx:TimeStamp>

هذا العنصر هو امتداد لمعيار OGC KML 2.2 ويتم دعمه في Google Earth 5.0 والإصدارات الأحدث. مزيد من المعلومات

نسخة من عنصرَي <TimeSpan> و<TimeStamp> في مساحة اسم الإضافة يسمح ذلك بإدراج قيم الوقت في 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:Tour> على صفر أو عنصر <gx:Playlist> واحد.
    <gx:Tour>
      <gx:Playlist>
        <!-- gx:TourPrimitive -->
          ...
        <!-- /gx:TourPrimitive -->
    
        <!--- Any number of gx:TourPrimitive elements can be included --->
      </gx:Playlist>
    </gx:Tour>

<gx:TourPrimitive>

هذا العنصر هو امتداد لمعيار OGC KML 2.2 ويتم دعمه في Google Earth 5.0 والإصدارات الأحدث. مزيد من المعلومات

البنية

<gx:Tour>
  <gx:Playlist>

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

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

الوصف

هذا عنصر مجرد ولا يمكن استخدامه مباشرة في ملف KML. ويتم توسيع هذا العنصر بواسطة العناصر <gx:FlyTo> و<gx:AnimatedUpdate> و<gx:TourControl> و<gx:Wait> و<gx:SoundCue>.

تقدم العناصر الممتدة من gx:TourPrimitive إرشادات إلى متصفحات KML أثناء الجولات، بما في ذلك النقاط للانتقال إليها ومدّة رحلات الطيران هذه ومدة الإيقاف المؤقت والتحديثات على ميزات KML والملفات الصوتية لتشغيلها.

يجب تضمين هذه العناصر داخل عنصر <gx:Playlist>، الذي يتم تضمينه بدوره مع عنصر <gx:Tour>.

مثال

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

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

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

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

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

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

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

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

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

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

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

تحتوي على

تم التمديد بمقدار

  • <gx:AnimatedUpdate>
  • <gx:FlyTo>
  • gg: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> تأخير تشغيل الصوت لعدد معين من الثواني قبل تشغيل الملف.
  • gg:TourControl>
    <gx:TourControl id="ID">
      <gx:playMode>pause</gx:playMode>    <!-- gx:playModeEnum: pause -->
    </gx:TourControl>
    تحتوي على عنصر <gx:playMode> واحد، ما يسمح بإيقاف الجولة مؤقتًا حتى يتخذ المستخدم إجراءً لمواصلة الجولة.
  • <gx:wait>
    <gx:Wait id="ID">
      <gx:duration>0.0</gx:duration>    <!-- double -->
    </gx:Wait>
    تظل الكاميرا ثابتة، في gx:AbstractView التي تمّ تحديدها مؤخرًا، لعدد الثواني المحدّدة قبل تشغيل gx:TourPrimitive التالي. لاحظ أن الانتظار لا يؤدي إلى إيقاف المخطط الزمني للجولة مؤقتًا - وسيستمر تشغيل الملفات الصوتية قيد التشغيل حاليًا والتحديثات المتحركة أثناء انتظار الكاميرا.

لتوسيع

<gx:Track>

هذا العنصر هو امتداد لمعيار OGC KML 2.2 ويتم دعمه في Google Earth 5.2 والإصدارات الأحدث. مزيد من المعلومات

البنية

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

الوصف

يصف المسار كيفية تحرك عنصر عبر العالم خلال فترة زمنية معينة. تسمح لك هذه الميزة بإنشاء كائن مرئي في Google Earth (سواء رمز نقطة أو نموذج) يعمل على تشفير مواضع متعددة لنفس الكائن لعدة مرات. في Google Earth، يسمح شريط تمرير الوقت للمستخدم بتحريك العرض عبر الزمن، مما يؤدي إلى تحريك موضع الكائن.

يُستخدم العنصر gx:MultiTrack لجمع مقاطع صوتية متعددة في وحدة مفهومية واحدة من خلال رمز واحد (أو نموذج) مرتبط يتحرك على طول المسار. تُعد هذه الميزة مفيدة إذا كانت لديك مسارات متعددة لنفس العنصر الحقيقي. يحدد العنصر <gx:interpolate> المنطقي لـ <gx:MultiTrack> ما إذا كان يجب الفاصل بين المسارات في مسار متعدد المسارات. إذا كانت هذه القيمة تساوي 0، فستتوقف النقطة أو النموذج في نهاية المسار وينتقل إلى بداية المسار التالي. (على سبيل المثال، إذا كنت تريد علامة موضعية واحدة تمثل تنقلاتك خلال يومين، وتم إيقاف تشغيل وحدة نظام تحديد المواقع العالمي (GPS) لأربع ساعات خلال هذه الفترة، فستحتاج إلى إظهار انقطاع بين النقاط التي تم فيها إيقاف تشغيل الوحدة ثم إعادة تشغيلها مرة أخرى.) إذا كانت قيمة <gx:interpolate> هي 1، يتم إدراج القيم بين نهاية المسار الأول وبداية المسار التالي بحيث يظهر المسار كمسار واحد متواصل.

راجع دليل مستخدم Google Earth للحصول على معلومات حول كيفية استيراد بيانات GPS إلى Google Earth.

لماذا تُعد المسارات مفيدة؟

تتيح لك الإصدارات السابقة من ملفات KML (قبل الإصدار Google Earth 5.2) إمكانية ربط عنصر الوقت بأي ميزة (علامة موضعية، تراكب أرضي، إلخ). ولكن يمكنك إقران عنصر وقت واحد فقط بميزة معيّنة. تعد المسارات آلية أكثر فعالية لربط بيانات الوقت بميزات مرئية، نظرًا لأنك تنشئ عنصرًا واحدًا فقط، يمكن ربطه بعناصر وقت متعددة أثناء تحرك الكائن عبر الفضاء.

بالإضافة إلى ذلك، يعتبر عنصر التتبع أكثر فعالية من الآلية السابقة (الموضحة في فصل الوقت والصور المتحركة من دليل مطوري KML) لأن <Track> يوفر آلية لإقحام موضع الكائن في أي وقت على طول مساره. باستخدام هذه الميزة الجديدة، يعرض برنامج Google Earth رسمًا بيانيًا للارتفاعات والسرعة في الملفات الشخصية (بالإضافة إلى البيانات المخصصة، إن وجدت) للكائن بمرور الوقت.

بيانات "قليلة"

عندما تكون بعض قيم البيانات مفقودة للمواضع في المسار، يمكن توفير علامات <coord/> (<coord></coord>) الفارغة أو <angles/> (<angles></angles>) لموازنة المصفوفات. تشير العلامة <coord/> أو <angles/> الفارغة إلى عدم وجود مثل هذه البيانات لنقطة بيانات معينة، ويجب إقحام القيمة بين أقرب نقطتي بيانات محددة جيدًا. وينطبق هذا السلوك أيضًا على ExtendedData لمقطع صوتي. يمكن ترك أي عنصر باستثناء <when> فارغًا وسيتم تضمينه بين أقرب عنصرين محددين جيدًا.

العناصر الخاصة بالتتبع

<altitudeMode>
يحدد كيفية تفسير مكونات الارتفاع في العنصر <الإحداثيات>. القيم المحتملة هي
  • clampToGround - (افتراضي) تشير إلى تجاهل مواصفات الارتفاع (على سبيل المثال، في العلامة <gx:coord> ).
  • relativeToGround - لتعيين ارتفاع العنصر بالنسبة إلى ارتفاع الأرض الفعلي لموقع معين. على سبيل المثال، إذا كان ارتفاع الأرض لموقع ما في مستوى سطح البحر تمامًا، وتم ضبط ارتفاع نقطة ما على 9 أمتار، فسيكون ارتفاع رمز ارتفاع العلامة الموضعية للنقطة هو 9 أمتار باستخدام هذا الوضع. ومع ذلك، إذا تم تعيين الإحداثي نفسه فوق موقع حيث يكون ارتفاع الأرض 10 أمتار فوق مستوى سطح البحر، فإن ارتفاع الإحداثي يبلغ 19 مترًا.
  • مطلق - تعيين ارتفاع الإحداثي بالنسبة إلى مستوى سطح البحر، بغض النظر عن الارتفاع الفعلي للتضاريس أسفل العنصر. فعلى سبيل المثال، إذا عينت ارتفاع إحداثيات إلى 10 أمتار باستخدام وضع الارتفاع المطلق، فسيظهر رمز العلامة الموضعية على مستوى الأرض إذا كانت التضاريس تحتها هي أيضًا 10 أمتار فوق مستوى سطح البحر. وإذا كانت التضاريس ترتفع عن مستوى سطح البحر بمسافة 3 أمتار، فستظهر العلامة الموضعية مرتفعة فوق التضاريس بمقدار 7 أمتار.
<gx:altitudeMode>
امتداد KML في مساحة اسم إضافة Google، يسمح بالارتفاعات المرتبطة بقاع البحر. القيم هي:
  • relativeToSeaFloor - تفسير الارتفاع على أنه قيمة بالأمتار فوق قاع البحر. إذا كانت النقطة أعلى الأرض بدلاً من البحر، فسيتم تفسير الارتفاع على أنه فوق الأرض.
  • clampToSeaFloor - يتم تجاهل مواصفات الارتفاع، وسيتم وضع النقطة في قاع البحر. إذا كانت النقطة على الأرض وليس في البحر، فسيتم وضع النقطة على الأرض.
<when>
قيمة وقت تقابل موضعًا (محددًا في عنصر <gx:coord> ). يجب أن يكون عدد العناصر في <track> في <Track> مساويًا لعدد العناصر <gx:coord> (والعناصر <gx:angles>، في حال تضمينها).
<gx:coord>
قيمة إحداثيات تتكون من ثلاث قيم لخط الطول وخط العرض والارتفاع، بدون فواصل بين الفواصل. على سبيل المثال:
<gx:coord>-122.207881 37.371915 156.000000</gx:coord>

لاحظ أن بنية العنصر <gx:coord> تختلف عن البنية للعنصر <coordinates>، الذي يستخدم الفاصلات لفصل عناصر خط الطول وخط العرض والارتفاع. يجب أن يساوي عدد العناصر المحددة عدد الوقت () وعناصر الموضع (). يمكنك تحديد عنصر <gx:coord> فارغ لقيمة غير ضرورية إذا لزم الأمر.

<gx:angles>
تُستخدم هذه القيمة لتحديد قيمة إضافية للرأس والإمالة والتدوير إلى الرمز أو النموذج لكل وقت/موضع ضمن المسار. يتم إدراج قيم النقاط العائمة الثلاث بدون فواصل بين الفواصل وتمثل درجات التدوير. إذا لم يتم تحديد <gx:angles>، فسيستنتج برنامج Google Earth عنوان الكائن وإمالته وتدويره من مساره. يجب أن يساوي عدد العناصر <gx:angles> المحددة عدد الوقت (<when>) وعناصر الموضع (<gx:coord>). يمكنك تحديد عنصر <gx:angles> فارغ لقيمة غير ضرورية إذا لزم الأمر.

تدعم الرموز حاليًا العناوين فقط، بينما تدعم النماذج القيم الثلاث جميعها.

في ما يلي مثال على ضبط هذه القيمة:

<gx:angles>45.54676 66.2342 77.0</gx:angles>
<الطراز>
في حالة التحديد، يحل النموذج محل رمز النقطة المستخدم للإشارة إلى الموضع الحالي على المسار. عند تحديد <Model> ضمن <gx:Track>، إليك كيفية عمل العناصر الفرعية للدالة <Model>:
  • ويتم تجاهل العنصر <Location>.
  • يتم تجاهل العنصر .heightMode>.
  • يتم دمج قيمة الاتجاه > الاتجاه مع اتجاه المسار على النحو التالي. أولاً، يتم تطبيق تدوير > الاتجاه ، الذي يجلب النموذج من نظام الإحداثي المحلي (س، ص، ع) إلى اتجاه الاتجاه من اليمين إلى الأعلى، باتجاه الشمال. بعد ذلك، يتم تطبيق دوران يتوافق مع عملية إقحام قيم <gx:angles> التي تؤثر في عنوان النموذج وإمالته وتدويره أثناء تحركه في المسار. إذا لم يتم تحديد أي زوايا، فسيتم الاستدلال على العنوان والإمالة من حركة النموذج.

    نصيحة: إذا لم تكن متأكدًا من كيفية تحديد الاتجاه، فاحذف العنصر <Orientation> من <النموذج> وشاهد كيف يحدد برنامج Google Earth النموذج أثناء تحركه في المسار. إذا لاحظت أن الواجهة الأمامية للنموذج تواجه الجانبين، فعدّل العنصر <heading> في <الاتجاه> لتدوير النموذج بحيث يشير إلى الواجهة الأمامية. إذا لم يكن النموذج مستقيمًا، فحاول تعديل العناصر <tilt> أو <roll>.

<ExtendedData>

عناصر بيانات مخصصة محددة في مخطط سابق في ملف KML.

غالبًا ما يكون من المفيد إضافة البيانات الموسعة المرتبطة بكل مرة/موضع على المسار. على سبيل المثال، قد تتضمن جولات الدراجات بيانات عن معدل ضربات القلب والإيقاع والطاقة، كما هو موضح في مثال للمسار مع البيانات الموسعة. في <Schema>، حدّد <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>

مثال على التتبّع بالبيانات الموسّعة

يبرز نوع الخط الغامق في هذا المثال العناصر المستخدمة لتحديد وتحديد البيانات المخصصة لركوب الدراجة. تتم تسمية حقول البيانات المُخصَّصة داخليًا باسم "القلب" و"الوتيرة" و"القوة". يحدد العنصر <Schema> الاسم المطلوب عرضه لكل مجموعة قيم (معدّل نبضات القلب والإيقاع والطاقة) ويحدد نوع البيانات لكل حقل جديد (المعدل والوتيرة من النوع int، والقوة من النوع float). في Google Earth، يتم عرض هذه البيانات المخصصة مع ملف تحديد الارتفاع للمسار.

هذا المثال عبارة عن عرض تقديمي أكثر واقعية لمسار، مع رموز مخصصة وأنماط خطوط ورموز منفصلة لتمييز الأوضاع العادية. ومع ذلك، لاحظ أن المثال لا يتضمن سوى سبع مجموعات من قيم البيانات. يتضمن المثال الفعلي عشرات الآلاف من القيم. (البيانات مقدمة من شون برودر. تم جمع هذه البيانات باستخدام جهاز Garmin Edge 705 المزوَّد بجهاز رصد معدّل نبضات القلب ومُعدَّل الطاقة.)

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

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

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

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

لتوسيع

تحتوي على

<تحديث>

البنية

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

الوصف

تحدّد الإضافة أو التغيير أو الحذف إلى بيانات KML التي تم تحميلها باستخدام عنوان URL المحدّد. يحدد <targetHref> الملف .kml أو .kmz الذي سيتم تعديل بياناته (داخل Google Earth). يتم دومًا تضمين <Update> في NetworkLinkControl. بالإضافة إلى ذلك، يجب أن يتم تحميل الملف الذي يحتوي على NetworkLinkControl من خلال NetworkLink. يمكنك الاطلاع على صفحة "المواضيع في KML" ضمن التحديثات للحصول على مثال مفصّل عن آلية عمل التحديث.

العناصر الخاصة بالتحديث

يمكن أن تحتوي على أي عدد من العناصر <Change> و<Create> و<Delete>، التي ستتم معالجتها بالترتيب.

<targetHref>(مطلوبة)
عنوان URL يحدد ملف .kml أو .kmz المراد تعديل بياناته (داخل Google Earth) عن طريق عنصر <تحديث>. يجب أن يكون ملف KML هذا قد تم تحميله من قبل عبر <NetworkLink>. في هذا الملف، يجب أن يحتوي العنصر المطلوب تعديله على سمة id (معرّف) واضحة محددة له.
<تغيير>
تعديل القيم في عنصر تم تحميله بالفعل باستخدام <NetworkLink>. ضمن عنصر Change، يجب أن يتضمن العنصر الفرعي المراد تعديله سمة targetId التي تشير إلى id للعنصر الأصلي.
يمكن اعتبار هذا التعديل "تحديثًا ضئيلاً": في العنصر المعدَّل، لا يتم استبدال سوى القيم المدرَجة في <Change>، بينما تبقى جميع القيم الأخرى بدون تغيير. عند تطبيق <Change> على مجموعة من الإحداثيات، تحل الإحداثيات الجديدة محل الإحداثيات الحالية.
العناصر الفرعية لهذا العنصر هي العناصر المطلوب تعديلها والمحدّدة من خلال السمة targetId.
<إنشاء>
إضافة عناصر جديدة إلى مجلد أو مستند تم تحميله عبر <NetworkLink>. يحدد العنصر <targetHref> في <Update> عنوان URL لملف .kml أو .kmz الذي يحتوي على المجلد أو المستند الأصلي. وداخل هذا الملف، يجب أن يحتوي المجلد أو المستند الذي يحتوي على البيانات الجديدة على معرِّف صريح محدد له. تتم الإشارة إلى id هذه باعتبارها السمة targetId للمجلد أو المستند ضمن <Create> التي تحتوي على العنصر المُراد إضافته.
بعد إنشاء كائن وتحميله إلى Google Earth، سينتقل إلى عنوان URL لمستند المجلد الأصلي الأصلي. لإجراء تعديلات لاحقة على العناصر التي تمت إضافتها باستخدام آلية التحديث/الإنشاء هذه، اضبط <targetHref> على عنوان URL للمستند أو المجلد الأصلي (وليس عنوان URL للملف الذي حمّل التحديثات المتداخلة).
<حذف>
يحذف عناصر من عنصر معقد تم تحميله عبر <NetworkLink>. يحدد العنصر <targetHref> في <Update> ملف .kml أو .kmz الذي يتضمن البيانات المراد حذفها. داخل هذا الملف، يجب أن يكون للعنصر المطلوب حذفه معرِّف صريحًا محددًا له. يشير العنصر <Delete> إلى id هذا في السمة targetId.
العناصر الفرعية في <Delete>، وهي العناصر الوحيدة التي يمكن حذفها، هي "المستندات" و"المجلد" و"GroundOverlay" و"العلامة الموضعية" و"تراكب الشاشة".

مثال على <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>

ينشئ هذا المثال علامة موضعية جديدة في مستند تم إنشاؤه سابقًا ويحتوي على رقم تعريف "region24". لاحظ أنك إذا كنت تريد إجراء تحديثات لاحقة لـ "placemark891"، فستستمر في استخدام http://myserver.com/Point.kml باعتباره <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>

ملاحظة: تم إيقاف هذا العنصر في الإصدار 2.1 من KML وتم استبداله بـ <Link> الذي يوفّر الوظائف الإضافية في المناطق. ستظل علامة <Url> تعمل في Google Earth، ولكن يُوصى باستخدام العلامة <Link> الأحدث.

استخدم هذا العنصر لتعيين موقع الرابط إلى ملف KML، لتحديد خيارات التحديث لتغييرات الخادم والمشاهد، ولملء متغير لعرض معلومات عميل مفيدة إلى الخادم.

الرجوع إلى أعلى الصفحة