فئة 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 لملف KML للعرض. |
setZIndex |
setZIndex(zIndex) المعلّمات:
قيمة الإرجاع: بدون
لتعيين فهرس 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 الصفحة الرئيسية للمؤلف، أو سلسلة فارغة إذا لم يتم تحديدها. |