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])
پارامترها:
یک 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)
پارامترها:
ارزش بازگشتی: ندارد
لایه KML را روی نقشه مشخص شده رندر می کند. اگر نقشه روی null تنظیم شود، لایه حذف می شود.
setOptions
setOptions(options)
پارامترها:
ارزش بازگشتی: ندارد
setUrl
setUrl(url)
پارامترها:
  • url : string
ارزش بازگشتی: ندارد
URL فایل KML را برای نمایش تنظیم می کند.
setZIndex
setZIndex(zIndex)
پارامترها:
  • zIndex : number Z-index برای تنظیم.
ارزش بازگشتی: ندارد
z-index لایه KML را تنظیم می کند.
به ارث رسیده: addListener ، bindTo ، get ، notify ، set ، setValues ، unbind ، unbindAll
click
function(kmlClickEvent)
استدلال ها:
این رویداد زمانی فعال می شود که یک ویژگی در لایه کلیک شود.
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.

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

ثابت های 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 ، حاوی اطلاعاتی در مورد ویژگی کلیک شده.
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
صفحه اصلی نویسنده یا یک رشته خالی اگر مشخص نشده باشد.