KML

کلاس KmlLayer

google.maps . KmlLayer کلاس google.maps . KmlLayer

یک KmlLayer نشانه‌گذاری جغرافیایی را از یک فایل KML، KMZ یا GeoRSS که بر روی یک سرور وب در دسترس عموم میزبانی می‌شود، به نقشه اضافه می‌کند. یک شی KmlFeatureData برای هر ویژگی با کلیک کردن ارائه می شود.

این کلاس MVCObject را گسترش می دهد.

با فراخوانی const {KmlLayer} = await google.maps.importLibrary("maps") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

سازنده
KmlLayer	KmlLayer([opts]) مولفه های: opts : KmlLayerOptions optional برای این لایه. یک KmlLayer ایجاد می کند که محتوای فایل KML/KMZ مشخص شده ( https://developers.google.com/kml/documentation/kmlreference ) یا فایل GeoRSS ( http://www.georss.org ) را ارائه می کند.

مواد و روش ها
getDefaultViewport	getDefaultViewport() پارامترها: ندارد مقدار بازگشتی: LatLngBounds نمای پیش فرض لایه نمایش داده شده را دریافت کنید.
getMap	getMap() پارامترها: ندارد مقدار بازگشتی: Map نقشه ای را دریافت کنید که لایه KML روی آن رندر می شود.
getMetadata	getMetadata() پارامترها: ندارد مقدار بازگشتی: KmlLayerMetadata همانطور که در نشانه گذاری لایه مشخص شده است، فراداده مرتبط با این لایه را دریافت کنید.
getStatus	getStatus() پارامترها: ندارد مقدار بازگشتی: KmlLayerStatus وضعیت لایه را دریافت کنید، پس از بارگیری سند درخواستی تنظیم کنید.
getUrl	getUrl() پارامترها: ندارد مقدار بازگشتی: URL string URL فایل KML در حال نمایش را دریافت می کند.
getZIndex	getZIndex() پارامترها: ندارد مقدار بازگشتی: number Z-index. z-index لایه KML را دریافت می کند.
setMap	setMap(map) مولفه های: map : Map ارزش بازگشتی: ندارد لایه KML را روی نقشه مشخص شده رندر می کند. اگر نقشه روی null تنظیم شود، لایه حذف می شود.
setOptions	setOptions(options) مولفه های: options : KmlLayerOptions ارزش بازگشتی: ندارد
setUrl	setUrl(url) مولفه های: url : string ارزش بازگشتی: ندارد URL فایل KML را برای نمایش تنظیم می کند.
setZIndex	setZIndex(zIndex) مولفه های: zIndex : number شاخص z برای تنظیم. ارزش بازگشتی: ندارد z-index لایه KML را تنظیم می کند.
به ارث رسیده: addListener ، bindTo ، get ، notify ، set ، setValues ، unbind ، unbindAll

مناسبت ها
click	function(kmlClickEvent) استدلال ها: kmlClickEvent : KmlMouseEvent این رویداد زمانی فعال می شود که یک ویژگی در لایه کلیک شود.
defaultviewport_changed	function() استدلال ها: هیچ این رویداد زمانی فعال می شود که نمای پیش فرض لایه های KML تغییر کند.
status_changed	function() استدلال ها: هیچ این رویداد زمانی فعال می شود که لایه KML بارگیری به پایان برسد. در این مرحله، خواندن ویژگی status برای تعیین اینکه آیا لایه با موفقیت بارگذاری شده است، ایمن است.

رابط KmlLayerOptions

google.maps . KmlLayerOptions رابط google.maps . KmlLayerOptions

این شیء خصوصیاتی را که می توان روی یک شی KmlLayer تنظیم کرد را تعریف می کند.

خواص
clickable optional	نوع: boolean optional پیش فرض: true اگر true ، لایه رویدادهای ماوس را دریافت می کند.
map optional	نوع: Map optional نقشه ای که روی آن لایه نمایش داده می شود.
preserveViewport optional	نوع: boolean optional پیش فرض: false اگر این گزینه روی true تنظیم شده باشد یا اگر مرکز و بزرگنمایی نقشه هرگز تنظیم نشده باشد، نقشه ورودی در مرکز قرار گرفته و به کادر محدود محتویات لایه زوم می شود.
screenOverlays optional	نوع: boolean optional پیش فرض: true رندر کردن همپوشانی های صفحه نمایش.
suppressInfoWindows optional	نوع: boolean optional هنگامی که روی ویژگی های لایه کلیک می شود، رندر پنجره های اطلاعات را متوقف کنید.
url optional	نوع: string optional URL سند KML برای نمایش.
zIndex optional	نوع: number optional شاخص z لایه.

رابط KmlLayerMetadata

google.maps . KmlLayerMetadata رابط google.maps . KmlLayerMetadata

فراداده برای یک لایه KML واحد، در قالب JSON.

خواص
author	نوع: KmlAuthor لایه <atom:author> ، از نشانه گذاری لایه استخراج شده است.
description	نوع: string <description> لایه، از نشانه گذاری لایه استخراج شده است.
hasScreenOverlays	نوع: boolean اینکه آیا لایه دارای پوشش روی صفحه است یا خیر.
name	نوع: string لایه <name> ، از نشانه گذاری لایه استخراج شده است.
snippet	نوع: string لایه <Snippet> ، از نشانه گذاری لایه استخراج شده است

ثابت های KmlLayerStatus

google.maps . KmlLayerStatus ثابت های google.maps . KmlLayerStatus

وضعیتی که پس از بارگیری یک سند توسط KmlLayer بازگردانده شد. اینها را با مقدار یا با استفاده از نام ثابت مشخص کنید. برای مثال، 'OK' یا google.maps.KmlLayerStatus.OK .

با فراخوانی const {KmlLayerStatus} = await google.maps.importLibrary("maps") دسترسی پیدا کنید. کتابخانه ها را در Maps JavaScript API ببینید.

ثابت ها
DOCUMENT_NOT_FOUND	سند پیدا نشد. به احتمال زیاد URL نامعتبر است یا سند در دسترس عموم نیست.
DOCUMENT_TOO_LARGE	سند از محدودیت اندازه فایل KmlLayer بیشتر است.
FETCH_ERROR	سند واکشی نشد.
INVALID_DOCUMENT	سند یک سند KML، KMZ یا GeoRSS معتبر نیست.
INVALID_REQUEST	KmlLayer نامعتبر است.
LIMITS_EXCEEDED	سند از محدودیت ویژگی های KmlLayer فراتر رفته است.
OK	لایه با موفقیت بارگیری شد.
TIMED_OUT	سند در مدت زمان معقولی بارگیری نمی شود.
UNKNOWN	سند به دلیل نامعلومی بارگیری نشد.

رابط KmlMouseEvent

google.maps . KmlMouseEvent رابط google.maps . KmlMouseEvent

ویژگی های یک رویداد کلیک روی یک سند KML/KMZ یا GeoRSS.

خواص
featureData	نوع: KmlFeatureData یک شی KmlFeatureData ، حاوی اطلاعاتی در مورد ویژگی کلیک شده.
latLng	نوع: LatLng موقعیتی که در آن پنجره اطلاعات روی ویژگی کلیک شده لنگر می‌اندازد.
pixelOffset	نوع: Size افست برای اعمال به پنجره اطلاعاتی که روی ویژگی کلیک شده لنگر انداخته است.

رابط KmlFeatureData

google.maps . KmlFeatureData رابط google.maps . KmlFeatureData

داده‌های یک ویژگی KML در قالب JSON، با کلیک روی یک ویژگی KML برگردانده می‌شود. داده‌های موجود در این شی منعکس کننده ویژگی‌هایی هستند که در نشانه‌گذاری KML یا GeoRSS که در آن اعلان شده است، مرتبط است.

خواص
author	نوع: KmlAuthor <atom:author> این ویژگی، از نشانه گذاری لایه استخراج شده است (در صورت مشخص شدن).
description	نوع: string <description> این ویژگی، از نشانه گذاری لایه استخراج شده است.
id	نوع: string ویژگی <id> است که از نشانه گذاری لایه استخراج شده است. اگر <id> مشخص نشده باشد، یک شناسه منحصر به فرد برای این ویژگی ایجاد می شود.
infoWindowHtml	نوع: string اگر تنظیم شده باشد، متن سبک بالون ویژگی.
name	نوع: string ویژگی <name> ، از نشانه گذاری لایه استخراج شده است.
snippet	نوع: string <Snippet> این ویژگی، از نشانه گذاری لایه استخراج شده است.

رابط KmlAuthor

google.maps . KmlAuthor رابط google.maps . KmlAuthor

حاوی جزئیات نویسنده سند یا ویژگی KML است.

خواص
email	نوع: string آدرس ایمیل نویسنده یا یک رشته خالی اگر مشخص نشده باشد.
name	نوع: string نام نویسنده یا یک رشته خالی اگر مشخص نشده باشد.
uri	نوع: string صفحه اصلی نویسنده یا یک رشته خالی اگر مشخص نشده باشد.