Data

فئة البيانات

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
تضيف هذه الطريقة ميزة إلى المجموعة وتعرض الميزة المضافة.

إذا كان للعنصر معرّف، سيحلّ محلّ أي عنصر حالي في المجموعة يحمل المعرّف نفسه. في حال عدم توفّر أي ميزة، سيتم إنشاء ميزة جديدة بدون شكل هندسي وبدون خصائص. في حال توفُّر FeatureOptions، سيتم إنشاء ميزة جديدة بالخصائص المحدّدة.

يُرجى العِلم أنّ المعرّفَين 1234 و'1234' متكافئان. ستؤدي إضافة ميزة تحمل المعرّف 1234 إلى استبدال ميزة تحمل المعرّف '1234'، والعكس صحيح.

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)
المَعلمات: 
  • idnumber|string
قيمة العائد:  Data.Feature|undefined
تعرِض هذه الطريقة العنصر الذي يحمل المعرّف المحدّد، إذا كان متوفّرًا في المجموعة. بخلاف ذلك، تعرض undefined.

يُرجى العِلم أنّ المعرّفَين 1234 و'1234' متكافئان. يمكن استخدام أي منهما للبحث عن الميزة نفسها.

getMap
getMap()
المَعلمات:  بدون
قيمة العائد:  Map
تعرِض هذه السمة الخريطة التي يتم عرض العناصر عليها.
getStyle
getStyle()
المَعلمات:  بدون
قيمة العائد:  Data.StylingFunction|Data.StyleOptions
تعرض هذه السمة نمط جميع العناصر في المجموعة.
loadGeoJson
loadGeoJson(url[, options, callback])
المَعلمات: 
القيمة المعروضة:  لا شيء
تحمّل هذه الطريقة GeoJSON من عنوان URL، وتضيف الميزات إلى المجموعة.

ملاحظة: يتم جلب GeoJSON باستخدام XHR، وقد لا يعمل على مستوى عدة نطاقات. في حال حدوث مشاكل، ننصحك باسترداد GeoJSON باستخدام مكتبة AJAX التي تختارها، ثم استدعاء addGeoJson().

overrideStyle
overrideStyle(feature, style)
المَعلمات: 
القيمة المعروضة:  لا شيء
تغيير نمط ميزة يتم تطبيق هذه التغييرات فوق النمط المحدّد بواسطة setStyle(). تعود خصائص النمط التي تم ضبطها على null إلى القيمة المحدّدة من خلال setStyle().
remove
remove(feature)
المَعلمات: 
القيمة المعروضة:  لا شيء
يزيل هذا الإجراء ميزة من المجموعة.
revertStyle
revertStyle([feature])
المَعلمات: 
القيمة المعروضة:  لا شيء
يزيل تأثير طلبات overrideStyle() السابقة. يعود نمط العنصر المحدّد إلى النمط الذي تحدّده setStyle().

إذا لم يتم تحديد أي ميزة، ستتم إعادة ضبط نمط جميع الميزات.

setControlPosition
setControlPosition(controlPosition)
المَعلمات: 
القيمة المعروضة:  لا شيء
تضبط هذه السمة موضع عناصر التحكّم في الرسم على الخريطة.
setControls
setControls(controls)
المَعلمات: 
  • controlsArray<string>
القيمة المعروضة:  لا شيء
تحدّد هذه السمة أوضاع الرسم المتاحة للمستخدم للاختيار من بينها، وذلك بالترتيب الذي يتم عرضها به. يجب ألا يشمل ذلك وضع الرسم null الذي تتم إضافته تلقائيًا. إذا تم اختيار null، يتم إيقاف عناصر التحكّم في الرسم وعدم عرضها. أوضاع الرسم المحتملة هي "Point" أو "LineString" أو "Polygon".
setDrawingMode
setDrawingMode(drawingMode)
المَعلمات: 
  • drawingModestring optional
القيمة المعروضة:  لا شيء
تضبط هذه السمة وضع الرسم الحالي لطبقة البيانات المحدّدة. يعني وضع الرسم null أنّه يمكن للمستخدم التفاعل مع الخريطة كالمعتاد، ولا تؤدي النقرات إلى رسم أي شيء. أوضاع الرسم المتاحة هي null أو "Point" أو "LineString" أو "Polygon".
setMap
setMap(map)
المَعلمات: 
القيمة المعروضة:  لا شيء
تعرض هذه الطريقة الميزات على الخريطة المحدّدة. إذا تم ضبط الخريطة على null، ستتم إزالة العناصر من الخريطة.
setStyle
setStyle(style)
المَعلمات: 
القيمة المعروضة:  لا شيء
تضبط هذه السمة نمط جميع العناصر في المجموعة. ستبقى الأنماط المحدّدة على أساس كل ميزة على حدة من خلال overrideStyle() سارية.

مرِّر إما عنصرًا يتضمّن خيارات النمط المطلوبة أو دالة تحسب النمط لكل ميزة. سيتم استدعاء الدالة في كل مرة يتم فيها تعديل خصائص إحدى الميزات.

toGeoJson
toGeoJson(callback)
المَعلمات: 
  • callbackfunction(Object): void
القيمة المعروضة:  لا شيء
تصدِّر هذه الطريقة الميزات في المجموعة إلى عنصر GeoJSON.
موروثة: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
addfeature
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند إضافة ميزة إلى المجموعة.
click
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر على الشكل الهندسي.
contextmenu
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تنشيط حدث DOM contextmenu على الشكل الهندسي.