KML

فئة KmlLayer

class google.maps.KmlLayer extends MVCObject
library "maps" 

const {KmlLayer} = await google.maps.importLibrary("maps");
KmlLayer
KmlLayer([opts])
المَعلمات:
تنشئ هذه الدالة KmlLayer يعرض محتوى ملف KML/KMZ المحدّد (https://developers.google.com/kml/documentation/kmlreference) أو ملف GeoRSS‏ (http://www.georss.org).
getDefaultViewport
getDefaultViewport()
المَعلمات: لا تتوفّر أي مَعلمات
القيمة المعروضة: LatLngBounds|null
الحصول على إطار العرض التلقائي للطبقة المعروضة
getMap
getMap()
المَعلمات: لا تتوفّر أي مَعلمات
القيمة المعروضة: Map|null
الحصول على الخريطة التي يتم عرض طبقة KML عليها
getMetadata
getMetadata()
المَعلمات: لا تتوفّر أي مَعلمات
القيمة المعروضة: KmlLayerMetadata|null
الحصول على البيانات الوصفية المرتبطة بهذه الطبقة، كما هو محدّد في ترميز الطبقة
getStatus
getStatus()
المَعلمات: لا تتوفّر أي مَعلمات
القيمة المعروضة: KmlLayerStatus|null
يمكنك الحصول على حالة الطبقة، والتي يتم ضبطها بعد تحميل المستند المطلوب.
getUrl
getUrl()
المَعلمات: لا تتوفّر أي مَعلمات
القيمة المعروضة: عنوان URL لـ string
تحصل على عنوان URL لملف KML الذي يتم عرضه.
getZIndex
getZIndex()
المَعلمات: لا تتوفّر أي مَعلمات
القيمة المعروضة: number فهرس z.
تحصل على فهرس Z لطبقة KML.
setMap
setMap(map)
المَعلمات:
  • map: Map optional
القيمة المعروضة: لا شيء
تعرض هذه الدالة طبقة 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
اختياري
النوع: boolean optional
القيمة التلقائية: true
إذا كانت القيمة true، تتلقّى الطبقة أحداث الماوس.
map
اختياري
النوع: Map optional
الخريطة التي سيتم عرض الطبقة عليها
preserveViewport
اختياري
النوع: boolean optional
القيمة التلقائية: false
إذا تم ضبط هذا الخيار على true أو إذا لم يتم ضبط مركز الخريطة ومستوى التكبير/التصغير مطلقًا، يتم توسيط خريطة الإدخال وتكبيرها إلى المربّع المحيط بمحتوى الطبقة.
screenOverlays
اختياري
النوع: boolean optional
القيمة التلقائية: true
لتحديد ما إذا كان سيتم عرض العناصر التي تظهر فوق المحتوى على الشاشة
suppressInfoWindows
اختياري
النوع: boolean optional
يتم منع عرض نوافذ المعلومات عند النقر على ميزات الطبقة.
url
اختياري
النوع: string optional
عنوان URL لمستند KML المطلوب عرضه
zIndex
اختياري
النوع: number optional
فهرس z للطبقة

واجهة KmlLayerMetadata

واجهة google.maps.KmlLayerMetadata

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

ثوابت KmlLayerStatus

ثوابت google.maps.KmlLayerStatus
مكتبة "maps"

الحالة التي يعرضها KmlLayer عند اكتمال تحميل مستند حدِّد هذه القيم حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'OK' أو google.maps.KmlLayerStatus.OK.

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع KmlLayerStatusString.

const {KmlLayerStatus} = await google.maps.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 interface

واجهة 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
الصفحة الرئيسية للمؤلف، أو سلسلة فارغة في حال عدم تحديدها