KML

فئة KmlLayer

google.maps.KmlLayer class

تضيف KmlLayer علامات جغرافية إلى الخريطة من ملف KML أو KMZ أو GeoRSS مستضاف على خادم ويب متاح للجميع. يتم توفير عنصر KmlFeatureData لكل ميزة عند النقر عليها.

يمتدّ هذا الصف إلى MVCObject.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {KmlLayer} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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()
المَعلمات:  بدون
القيمة المعروضة:  string عنوان URL
تحصل على عنوان URL لملف KML الذي يتم عرضه.
getZIndex
getZIndex()
المَعلمات:  بدون
القيمة المعروضة:  numberفهرس z.
تحصل على فهرس z لطبقة KML.
setMap
setMap(map)
المَعلمات: 
القيمة المعروضة:  لا شيء
تعرِض هذه الدالة طبقة KML على الخريطة المحدّدة. إذا تم ضبط الخريطة على null، تتم إزالة الطبقة.
setOptions
setOptions(options)
المَعلمات: 
القيمة المعروضة:  لا شيء
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)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر على عنصر في الطبقة.
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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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
الصفحة الرئيسية للمؤلف، أو سلسلة فارغة في حال عدم تحديدها