KML

فئة 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()
المَعلمات: لا شيء
قيمة الإرجاع:  string عنوان URL
للحصول على عنوان URL لملف KML المعروض.
getZIndex
getZIndex()
المَعلمات: لا شيء
قيمة العرض:  number مؤشر z.
للحصول على الفهرس z لطبقة KML.
setMap
setMap(map)
المَعلمات: 
قيمة الإرجاع: لا شيء
لعرض طبقة KML على الخريطة المحددة. في حال ضبط الخريطة على null، ستتم إزالة الطبقة.
setOptions
setOptions(options)
المَعلمات: 
قيمة الإرجاع: لا شيء
setUrl
setUrl(url)
المَعلمات: 
  • urlstring
قيمة الإرجاع: لا شيء
لضبط عنوان URL لملف KML المطلوب عرضه.
setZIndex
setZIndex(zIndex)
المَعلمات: 
  • zIndexnumber فهرس z المطلوب إعداده.
قيمة الإرجاع: لا شيء
لتعيين الفهرس z لطبقة 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"). يمكنك الاطّلاع على المكتبات في 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
الصفحة الرئيسية للمؤلف، أو سلسلة فارغة إذا لم يتم تحديدها