راهنمای توسعه دهنده
با مجموعه‌ها، منظم بمانید
ذخیره و طبقه‌بندی محتوا براساس اولویت‌های شما.
این بخش شامل صفحاتی با اطلاعات اضافی در مورد عناصر کلیدی KML و نحوه استفاده از آنها است.
- فایل های KMZ به روز شد
بیاموزید که چگونه فایل KML خود و همه تصاویر، همپوشانی ها، نمادها و فایل های صوتی مربوط به آن را در یک واحد مرتب بسته بندی کنید (و فشرده کنید) که می تواند به عنوان یک موجودیت واحد پست یا ایمیل شود.- گردش
- Google Earth 5.0 تور را معرفی می کند: حرکت با کنترل KML در فضا و زمان. عناصر مرتبط با تور در فضای نام برنامه افزودنی Google موجود است.
- حالت های ارتفاع
- با معرفی عناصر در فضای نام برنامه افزودنی Google، Google Earth 5.0 می‌تواند بینندگان را با حالت‌های ارتفاعی جدید clampToSeaFloor و relativeToSeaFloor به زیر آب ببرد. این فصل همچنین حالت های سنتی و بالای زمین را مورد بحث قرار می دهد.
- زمان و انیمیشن
- هر ویژگی در KML می‌تواند داده‌های زمانی مرتبط با آن داشته باشد. هنگامی که یک فایل KML حاوی یک ویژگی با عناصر TimeSpan یا TimeStamp باشد، Google Earth یک نوار لغزنده زمانی نمایش می دهد. با استفاده از لغزنده و دکمه پخش، کاربر می تواند کل دنباله را "بازی" کند یا می تواند دوره های زمانی فردی را برای نمایش انتخاب کند.
- دوربین ها
- عنصر دوربین یک راه اضافی برای مشخص کردن دیدگاه برای یک ویژگی فراهم می کند. دوربین ها با PhotoOverlays استفاده می شوند، ویژگی دیگری که در KML 2.2 اضافه شده است. <Camera> کنترل کامل شش درجه آزادی را بر روی نما فراهم می کند، بنابراین می توانید دوربین را در فضا قرار دهید و سپس آن را حول محورهای x ، y و z بچرخانید.
- پوشش های عکس
- عنصر PhotoOverlay به شما این امکان را می دهد که موقعیت جغرافیایی یک عکس را بر روی زمین قرار دهید و مکان و جهت دوربینی را که این PhotoOverlay را مشاهده می کند، مشخص کنید. PhotoOverlay می تواند یک مستطیل دو بعدی ساده، یک استوانه جزئی یا کامل، یا یک کره (برای پانورامای کروی) باشد. عنصر فرزند ImagePyramid PhotoOverlay مدیریت کارآمد عکس‌های بزرگ دلخواه را در Google Earth فراهم می‌کند.
- داده های آسمان در KML
- اکنون می توانید داده های آسمانی را در Google Earth نمایش دهید. این صفحه نحوه تنظیم فایل KML خود را برای مشاهده آسمان، با نکاتی در مورد تبدیل مختصات استاندارد آسمانی برای نمایش در حالت Google Earth، Sky توضیح می دهد.
- افزودن داده های سفارشی
- بسته به نوع داده های سفارشی، می توانید داده های سفارشی را به سه روش مختلف به ویژگی های KML اضافه کنید. عنصر ExtendedData جدید به شما امکان می دهد داده های تایپ نشده، داده های تایپ شده یا داده های دلخواه XML خود را به یک ویژگی KML اضافه کنید. Google Earth این اطلاعات را همراه با فایل حفظ می کند. داده های تایپ نشده و داده های تایپ شده حاوی عناصر نمایشی هستند که می توانند برای الگوهای سبک و جایگزینی موجودیت در بالون استفاده شوند.
- مدل ها
- اشیاء سه بعدی را می توان به طور طبیعی در فضای مختصات خود مدل سازی کرد و به عنوان فایل های COLLADA™ صادر کرد، سپس به Google Earth وارد کرد و روی سطح زمین قرار داد.
- مناطق
- منطقه‌ها رفتارهای جمع‌آوری و سطح جزئیات را ارائه می‌کنند که به شما امکان می‌دهد نحوه ارائه داده‌های خود را در Google Earth تنظیم کنید. وقتی با NetworkLinks استفاده می‌شود، منطقه‌ها پخش مجموعه‌های داده بسیار بزرگ را با بارگیری «هوشمند» داده‌ها در سطوح مختلف وضوح فعال می‌کنند (به بخش Super-Overlays مراجعه کنید). همچنین می‌توانید لایه‌های Google Earth را با استفاده از Regions شبیه‌سازی کنید.
- به روز رسانی ها
- می‌توانید داده‌های بارگیری‌شده توسط NetworkLinks را به‌صورت تدریجی به‌روزرسانی کنید—تغییر، افزودن و حذف داده‌های KML که قبلاً در Google Earth بارگیری شده‌اند.
- انقضاء
- این صفحه نحوه جلوگیری از کهنه شدن داده های KML را از طریق استفاده از هدرهای HTTP و زمان انقضای KML مورد بحث قرار می دهد.
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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."]]
