فئة البيانات
google.maps.Data
صف
طبقة لعرض البيانات الجغرافية المكانية يمكن عرض النقاط وسلاسل الخطوط والمضلّعات.
يحتوي كل Map
على عنصر Data
تلقائيًا، لذا لا داعي لإنشاء عنصر في معظم الأحيان. على سبيل المثال:
var myMap = new google.maps.Map(...);
myMap.data.addGeoJson(...);
myMap.data.setStyle(...);
Data
هو مجموعة من Features
.
يمتد هذا الصف إلى MVCObject
.
يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Data} = await google.maps.importLibrary("maps")
.
اطّلِع على المكتبات في Maps JavaScript API.
الشركة المصنِّعة | |
---|---|
Data |
Data([options]) المَعلمات:
تنشئ هذه الطريقة مجموعة فارغة مع DataOptions المحدّد. |
الطُرق | |
---|---|
add |
add([feature]) المَعلمات:
قيمة العائد:
Data.Feature تضيف هذه الطريقة ميزة إلى المجموعة وتعرض الميزة المضافة. إذا كان للعنصر معرّف، سيحلّ محلّ أي عنصر حالي في المجموعة يحمل المعرّف نفسه. في حال عدم توفّر أي ميزة، سيتم إنشاء ميزة جديدة بدون شكل هندسي وبدون خصائص. في حال توفُّر يُرجى العِلم أنّ المعرّفَين |
addGeoJson |
addGeoJson(geoJson[, options]) المَعلمات:
قيمة العائد:
Array<Data.Feature> تضيف هذه الطريقة ميزات GeoJSON إلى المجموعة. امنح هذه الطريقة ملف JSON تم تحليله. يتم عرض الميزات التي تم استيرادها. يُطلق هذا الإجراء استثناءً إذا تعذّر استيراد GeoJSON. |
contains |
contains(feature) المَعلمات:
قيمة العائد:
boolean تتحقّق هذه الطريقة مما إذا كانت الميزة المحدّدة مضمّنة في المجموعة. |
forEach |
forEach(callback) المَعلمات:
القيمة المعروضة: لا شيء
تستدعي الدالة المحدّدة بشكل متكرّر، مع تمرير عنصر في المجموعة إلى الدالة في كل استدعاء. ترتيب التكرار خلال الميزات غير محدّد. |
getControlPosition |
getControlPosition() المَعلمات: بدون
قيمة العائد:
ControlPosition تعرض هذه السمة موضع عناصر التحكّم في الرسم على الخريطة. |
getControls |
getControls() المَعلمات: بدون
قيمة العائد:
Array<string> تعرِض هذه السمة أوضاع الرسم المتاحة للمستخدم للاختيار من بينها، وذلك بالترتيب الذي يتم عرضها به. لا يشمل ذلك وضع الرسم null الذي تتم إضافته تلقائيًا. أوضاع الرسم المحتملة هي "Point" أو "LineString" أو "Polygon" . |
getDrawingMode |
getDrawingMode() المَعلمات: بدون
قيمة العائد:
string|null تعرض هذه السمة وضع الرسم الحالي لطبقة البيانات المحدّدة. يعني وضع الرسم null أنّه يمكن للمستخدم التفاعل مع الخريطة كالمعتاد، ولا تؤدي النقرات إلى رسم أي شيء. أوضاع الرسم المتاحة هي null أو "Point" أو "LineString" أو "Polygon" . |
getFeatureById |
getFeatureById(id) المَعلمات:
قيمة العائد:
Data.Feature|undefined تعرِض هذه الطريقة العنصر الذي يحمل المعرّف المحدّد، إذا كان متوفّرًا في المجموعة. بخلاف ذلك، تعرض undefined . يُرجى العِلم أنّ المعرّفَين |
getMap |
getMap() المَعلمات: بدون
قيمة العائد:
Map تعرِض هذه السمة الخريطة التي يتم عرض العناصر عليها. |
getStyle |
getStyle() المَعلمات: بدون
قيمة العائد:
Data.StylingFunction|Data.StyleOptions تعرض هذه السمة نمط جميع العناصر في المجموعة. |
loadGeoJson |
loadGeoJson(url[, options, callback]) المَعلمات:
القيمة المعروضة: لا شيء
تحمّل هذه الطريقة GeoJSON من عنوان URL، وتضيف الميزات إلى المجموعة. ملاحظة: يتم جلب GeoJSON باستخدام XHR، وقد لا يعمل على مستوى عدة نطاقات. في حال حدوث مشاكل، ننصحك باسترداد GeoJSON باستخدام مكتبة AJAX التي تختارها، ثم استدعاء |
overrideStyle |
overrideStyle(feature, style) المَعلمات:
القيمة المعروضة: لا شيء
تغيير نمط ميزة يتم تطبيق هذه التغييرات فوق النمط المحدّد بواسطة setStyle() . تعود خصائص النمط التي تم ضبطها على null إلى القيمة المحدّدة من خلال setStyle() . |
remove |
remove(feature) المَعلمات:
القيمة المعروضة: لا شيء
يزيل هذا الإجراء ميزة من المجموعة. |
revertStyle |
revertStyle([feature]) المَعلمات:
القيمة المعروضة: لا شيء
يزيل تأثير طلبات overrideStyle() السابقة. يعود نمط العنصر المحدّد إلى النمط الذي تحدّده setStyle() . إذا لم يتم تحديد أي ميزة، ستتم إعادة ضبط نمط جميع الميزات. |
setControlPosition |
setControlPosition(controlPosition) المَعلمات:
القيمة المعروضة: لا شيء
تضبط هذه السمة موضع عناصر التحكّم في الرسم على الخريطة. |
setControls |
setControls(controls) المَعلمات:
القيمة المعروضة: لا شيء
تحدّد هذه السمة أوضاع الرسم المتاحة للمستخدم للاختيار من بينها، وذلك بالترتيب الذي يتم عرضها به. يجب ألا يشمل ذلك وضع الرسم null الذي تتم إضافته تلقائيًا. إذا تم اختيار null ، يتم إيقاف عناصر التحكّم في الرسم وعدم عرضها. أوضاع الرسم المحتملة هي "Point" أو "LineString" أو "Polygon" . |
setDrawingMode |
setDrawingMode(drawingMode) المَعلمات:
القيمة المعروضة: لا شيء
تضبط هذه السمة وضع الرسم الحالي لطبقة البيانات المحدّدة. يعني وضع الرسم null أنّه يمكن للمستخدم التفاعل مع الخريطة كالمعتاد، ولا تؤدي النقرات إلى رسم أي شيء. أوضاع الرسم المتاحة هي null أو "Point" أو "LineString" أو "Polygon" . |
setMap |
setMap(map) المَعلمات:
القيمة المعروضة: لا شيء
تعرض هذه الطريقة الميزات على الخريطة المحدّدة. إذا تم ضبط الخريطة على null ، ستتم إزالة العناصر من الخريطة. |
setStyle |
setStyle(style) المَعلمات:
القيمة المعروضة: لا شيء
تضبط هذه السمة نمط جميع العناصر في المجموعة. ستبقى الأنماط المحدّدة على أساس كل ميزة على حدة من خلال overrideStyle() سارية. مرِّر إما عنصرًا يتضمّن خيارات النمط المطلوبة أو دالة تحسب النمط لكل ميزة. سيتم استدعاء الدالة في كل مرة يتم فيها تعديل خصائص إحدى الميزات. |
toGeoJson |
toGeoJson(callback) المَعلمات:
القيمة المعروضة: لا شيء
تصدِّر هذه الطريقة الميزات في المجموعة إلى عنصر GeoJSON. |
موروثة:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
الفعاليات | |
---|---|
addfeature |
function(event) الوسيطات:
يتم تنشيط هذا الحدث عند إضافة ميزة إلى المجموعة. |
click |
function(event) الوسيطات:
يتم تنشيط هذا الحدث عند النقر على الشكل الهندسي. |
contextmenu |
function(event) الوسيطات:
يتم تنشيط هذا الحدث عند تنشيط حدث DOM contextmenu على الشكل الهندسي. |
|