KML

فئة 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() المَعلمات: لا شيء قيمة الإرجاع:  string عنوان URL للحصول على عنوان URL لملف KML المعروض.
getZIndex	getZIndex() المَعلمات: لا شيء قيمة العرض:  number مؤشر z. للحصول على الفهرس z لطبقة 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 لطبقة KML.
المحتوى المُكتسَب: addListener، bindTo، get، notify، set، setValues، unbind، unbindAll

فعاليات
click	function(kmlClickEvent) الوسيطات:  kmlClickEvent:  KmlMouseEvent يتم تنشيط هذا الحدث عند النقر على عنصر في الطبقة.
defaultviewport_changed	function() الوسيطات: لا شيء يتم تنشيط هذا الحدث عند تغيير إطار العرض التلقائي لطبقات KML.
status_changed	function() الوسيطات: لا شيء يتم تنشيط هذا الحدث عند انتهاء تحميل طبقة KML. في هذه المرحلة، من الآمن قراءة خاصية الحالة لتحديد ما إذا تم تحميل الطبقة بنجاح.

واجهة 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

البيانات الوصفية لطبقة KML واحدة بتنسيق JSON

أماكن إقامة
author	النوع:  KmlAuthor تم استخراج <atom:author> للطبقة من ترميز الطبقة.
description	النوع:  string تم استخراج <description> للطبقة من ترميز الطبقة.
hasScreenOverlays	النوع:  boolean ما إذا كانت الطبقة تحتوي على أيّ عناصر مركّبة على الشاشة.
name	النوع:  string تم استخراج <name> للطبقة من ترميز الطبقة.
snippet	النوع:  string تم استخراج <Snippet> للطبقة من ترميز الطبقة

ثابت 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

خصائص حدث النقر في مستند KML/KMZ أو GeoRSS.

أماكن إقامة
featureData	النوع:  KmlFeatureData عنصر KmlFeatureData يحتوي على معلومات حول الميزة التي تم النقر عليها
latLng	النوع:  LatLng موضع تثبيت نافذة المعلومات على الميزة التي تم النقر عليها.
pixelOffset	النوع:  Size الإزاحة المطلوب تطبيقها على نافذة معلومات مضمّنة في الميزة التي تم النقر عليها.

واجهة 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

تحتوي على تفاصيل مؤلف مستند أو ميزة KML.

أماكن إقامة
email	النوع:  string عنوان البريد الإلكتروني للمؤلف، أو سلسلة فارغة إذا لم يتم تحديدها
name	النوع:  string اسم المؤلف، أو سلسلة فارغة إذا لم يتم تحديدها.
uri	النوع:  string الصفحة الرئيسية للمؤلف، أو سلسلة فارغة إذا لم يتم تحديدها