KML

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

فئة KmlLayer

google.maps.KmlLayer الصف الدراسي

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

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

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {KmlLayerStatus} = await google.map.importLibrary("maps"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.
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
الصفحة الرئيسية للمؤلف، أو سلسلة فارغة إذا لم يتم تحديدها.