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
تعرض هذه السمة ترتيب الطبقة 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 interface

يحدّد هذا العنصر السمات التي يمكن ضبطها على عنصر 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 interface

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

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

خصائص حدث النقر على مستند KML/KMZ أو GeoRSS
featureData
النوع:  KmlFeatureData
عنصر KmlFeatureData يحتوي على معلومات حول الميزة التي تم النقر عليها.
latLng
النوع:  LatLng
الموضع الذي سيتم فيه ربط نافذة المعلومات بالعنصر الذي تم النقر عليه.
pixelOffset
النوع:  Size
الإزاحة التي سيتم تطبيقها على نافذة معلومات مثبّتة على العنصر الذي تم النقر عليه

واجهة KmlFeatureData

google.maps.KmlFeatureData interface

بيانات عنصر 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 interface

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