دليل مطوّري البرامج
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
يتضمن هذا القسم صفحات بها معلومات إضافية عن عناصر KML الأساسية وكيفية استخدامها.
- ملفات KMZتم التحديث
تعرف على كيفية تجميع (وضغط) ملف KML وجميع الصور والتراكبات والرموز والملفات الصوتية ذات الصلة في وحدة مرتبة واحدة يمكن نشرها أو إرسالها عبر البريد الإلكتروني ككيان واحد.
- التجول
- يقدّم Google Earth 5.0 جولة: إمكانية التحكم في حركة KML عبر الفضاء والوقت. يتم تضمين العناصر ذات الصلة بالتجول في مساحة اسم إضافة Google.
- أوضاع الارتفاع
- مع طرح العناصر في مساحة الاسم "إضافة" في Google، يمكن أن يأخذ Google Earth 5.0 المشاهدين تحت الماء باستخدام وضعي الارتفاع الجديدين clampToSeaFloor والارتفاع النسبي إلى ToSeaFloor. يناقش هذا الفصل أيضًا الأوضاع التقليدية الموجودة فوق الأرض.
- الوقت والصور المتحركة
- يمكن أن ترتبط أي ميزة في KML ببيانات الوقت. عندما يحتوي ملف KML على ميزة بها عنصري TimeSpan أو TimeStamp، يعرض برنامج Google Earth شريط تمرير وقت. وباستخدام شريط التمرير وزر التشغيل، يمكن للمستخدم "تشغيل" التسلسل بالكامل أو اختيار فترات زمنية فردية للعرض.
- الكاميرات
- يوفر عنصر الكاميرا طريقة إضافية لتحديد نقطة العرض لميزة ما. يتم استخدام الكاميرات مع تراكبات الصور، وهي ميزة أخرى تتم إضافتها في KML 2.2. توفر كاميرا >الكاميرا> إمكانية التحكم الكامل في العرض ست درجات حرية، حتى تتمكن من وضع الكاميرا في الفضاء ثم تدويرها حول المحاور x وy وz.
- تراكبات الصور
- يسمح لك عنصر PhotoOverlay بتحديد موقع صورة جغرافيًا على الأرض جغرافيًا وتحديد موضع الكاميرا واتجاهها التي يمكنها عرض PhotoOverlay. يمكن أن يكون تراكب الصور مستطيلاً ثنائي الأبعاد بسيطًا أو أسطوانة جزئية أو كاملة أو بانوراما 360 درجة (للبانوراما البانورامية). يوفّر العنصر الفرعي ImagePyramid في PhotoOverlay التعامل الفعّل مع الصور الكبيرة العشوائية في Google Earth.
- بيانات Sky في KML
- يمكنك الآن عرض البيانات السماوية في Google Earth. توضح هذه الصفحة كيفية إعداد ملف KML لعرض السماء، مع تقديم نصائح حول تحويل الإحداثيات السماوية القياسية لعرضها في Google Earth، وضع Sky.
- إضافة بيانات مخصصة
- يمكنك إضافة بيانات مخصصة إلى ميزات KML بثلاث طرق مختلفة، حسب نوع البيانات المخصصة. يتيح لك عنصر ExtendedData الجديد إضافة بياناتك غير المكتوبة أو البيانات المكتوبة أو بيانات XML العشوائية إلى ميزة KML. ويحتفظ برنامج Google Earth بهذه المعلومات مع الملف. تحتوي البيانات غير المكتوبة والبيانات المكتوبة على عناصر عرض يمكن استخدامها لقوالب الأنماط واستبدال العناصر في البالون.
- الطُرز
- يمكن تصميم النماذج الثلاثية الأبعاد بشكل طبيعي في فضاء إحداثياتها الخاص وتصديرها كملفات COLLADATM، ثم استيرادها إلى Google Earth ووضعها على سطح الأرض.
- المناطق
- توفّر المناطق سلوكًا اختياريًا ومستوى تفاصيل يتيح لك ضبط كيفية عرض بياناتك في Google Earth. وعند استخدامها مع NetworkLinks، تتيح المناطق بث مجموعات بيانات كبيرة للغاية، وذلك عن طريق التحميل "الذكي" للبيانات على مستويات متعددة من الدقة (راجع القسم حول تراكبات مميزة). يمكنك أيضًا محاكاة طبقات Google Earth باستخدام "المناطق".
- آخر الأخبار
- يمكنك تحديث البيانات التي يتم تحميلها من خلال NetworkLinks بشكل تدريجي، مع تغيير بيانات KML التي تم تحميلها سابقًا إلى Google Earth وإضافتها وحذفها.
- انتهاء الصلاحية
- تناقش هذه الصفحة كيفية منع بيانات KML من أن تصبح قديمة من خلال استخدام رؤوس HTTP وأوقات انتهاء صلاحية ملفات KML.
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2022-12-20 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2022-12-20 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eThis section provides further detail on key KML elements and their usage.\u003c/p\u003e\n"],["\u003cp\u003eKML files can incorporate touring, altitude modes, time, animation, and camera viewpoints for features.\u003c/p\u003e\n"],["\u003cp\u003eFeatures can include photo overlays, sky data, custom data, 3D models, and regions for enhanced visualization.\u003c/p\u003e\n"],["\u003cp\u003eNetworkLinks support data updates and can leverage regions for efficient streaming and level-of-detail management.\u003c/p\u003e\n"],["\u003cp\u003eKML data freshness can be controlled using HTTP headers and expiration times to prevent staleness.\u003c/p\u003e\n"]]],[],null,["# Developer's Guide\n\nThis section includes pages with additional information on key KML elements and how to use them.\n\n[KMZ Files](/kml/documentation/kmzarchives)^Updated^\n: Learn how to package up (and compress) your KML file and all its related images, overlays, icons, and sound files into one tidy unit that can be posted or emailed as a single entity.\n\n[Touring](/kml/documentation/touring)\n: Google Earth 5.0 introduces touring: KML-controlled movement through space and time. Touring-related elements are contained in the Google extension namespace.\n\n[Altitude Modes](/kml/documentation/altitudemode)\n: With the introduction of elements in the Google extension namespace, Google Earth 5.0 can take viewers underwater with new clampToSeaFloor and relativeToSeaFloor altitude modes. This chapter also discusses the traditional, above-ground modes.\n\n[Time and Animation](/kml/documentation/time)\n: Any Feature in KML can have time data associated with it. When a KML file contains a Feature with TimeSpan or TimeStamp elements, Google Earth displays a time slider. Using the slider and play button, the user can \"play\" the entire sequence or can select individual time periods for display.\n\n[Cameras](/kml/documentation/cameras)\n: The Camera element provides an additional way to specify the viewpoint for a Feature. Cameras are used with PhotoOverlays, another feature added in KML 2.2. \\\u003cCamera\\\u003e provides full six-degrees-of-freedom control over the view, so you can position the Camera in space and then rotate it around the *x* , *y* , and *z* axes.\n\n[PhotoOverlays](/kml/documentation/photos)\n: The PhotoOverlay element allows you to geographically locate a photograph on the Earth and to specify the placement and orientation of the Camera that views this PhotoOverlay. The PhotoOverlay can be a simple 2D rectangle, a partial or full cylinder, or a sphere (for spherical panoramas). The ImagePyramid child element of PhotoOverlay provides for efficient handling of arbitrarily large photographs in Google Earth.\n\n[Sky Data in KML](/kml/documentation/kmlsky)\n: Now you can display celestial data in Google Earth. This page describes how to set up your KML file to view the sky, with tips on converting standard celestial coordinates to display in Google Earth, Sky mode.\n\n[Adding Custom Data](/kml/documentation/extendeddata)\n: You can add custom data to KML Features in three different ways, depending on the kind of custom data. The new ExtendedData element allows you to add your own untyped data, typed data, or arbitrary XML data to a KML Feature. Google Earth preserves this information along with the file. Untyped data and typed data contain display elements that can be used for style templates and entity replacement in the balloon.\n\n[Models](/kml/documentation/models)\n: Three-dimensional objects can be modeled naturally in their own coordinate space and exported as COLLADA™ files, then imported into Google Earth and placed on the Earth's surface.\n\n[Regions](/kml/documentation/regions)\n: Regions provide culling and level-of-detail behavior that allow you to fine-tune how your data is presented in Google Earth. When used with NetworkLinks, Regions enable streaming of very large datasets, with \"smart\" loading of data at multiple levels of resolution (see the section on [Super-Overlays](/kml/documentation/regions#superoverlays)). You can also simulate Google Earth's layers using Regions.\n\n[Updates](/kml/documentation/updates)\n: You can incrementally update data loaded by NetworkLinks---changing, adding, and deleting KML data that was previously loaded into Google Earth.\n\n[Expiration](/kml/documentation/expiration)\n: This page discusses how to prevent KML data from becoming stale, through the use of HTTP headers and KML expiration times."]]
