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 على الشكل الهندسي.
dblclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر مرّتين على الشكل الهندسي.
mousedown
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند الضغط على زر الماوس لأسفل على الشكل الهندسي.
mouseout
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يغادر مؤشر الماوس مساحة الشكل الهندسي.
mouseover
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عندما يدخل مؤشر الماوس إلى مساحة الشكل الهندسي.
mouseup
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند تحرير زر الماوس على الشكل الهندسي.
removefeature
function(event)
الوسيطات: 
يتم تشغيل هذا الحدث عند إزالة ميزة من المجموعة.
removeproperty
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند إزالة سمة من سمات عنصر.
setgeometry
function(event)
الوسيطات: 
يتم إطلاق هذا الحدث عند ضبط شكل هندسي لعنصر.
setproperty
function(event)
الوسيطات: 
يتم إطلاق هذا الحدث عند ضبط إحدى سمات العنصر.
rightclick
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر بزر الماوس الأيمن على الشكل الهندسي.

Data.DataOptions interface

google.maps.Data.DataOptions interface

عنصر DataOptions المستخدَم لتحديد الخصائص التي يمكن للمطوّر ضبطها على عنصر Data.

map
النوع:  Map
الخريطة التي سيتم عرض العناصر فيها
controlPosition optional
النوع:  ControlPosition optional
القيمة التلقائية: ControlPosition.TOP_LEFT
موضع عناصر التحكّم في الرسم على الخريطة
controls optional
النوع:  Array<string> optional
القيمة التلقائية: null
توضّح هذه السمة أوضاع الرسم المتاحة للمستخدم للاختيار من بينها، وذلك بالترتيب الذي تظهر به. يجب ألا يشمل ذلك وضع الرسم null الذي تتم إضافته تلقائيًا. إذا تم اختيار null، يتم إيقاف عناصر التحكّم في الرسم وعدم عرضها. أوضاع الرسم المحتملة هي "Point" أو "LineString" أو "Polygon".
drawingMode optional
النوع:  string optional
القيمة التلقائية: null
وضع الرسم الحالي لطبقة البيانات المحدّدة. يعني وضع الرسم null أنّه يمكن للمستخدم التفاعل مع الخريطة كالمعتاد، ولا تؤدي النقرات إلى رسم أي شيء. أوضاع الرسم المتاحة هي null أو "Point" أو "LineString" أو "Polygon".
featureFactory optional
النوع:  function(Data.Geometry): Data.Feature optional
عند تفعيل الرسم ورسم المستخدم لشكل هندسي (نقطة أو سلسلة خطوط أو مضلّع)، يتم استدعاء هذه الدالة مع هذا الشكل الهندسي ويجب أن تعرض عنصرًا سيتمّت إضافته إلى طبقة البيانات. في حال عدم توفير featureFactory، سيتم إنشاء Feature بدون رقم تعريف وبدون سمات من Geometry بدلاً من ذلك. القيمة التلقائية هي null.
style optional
نمط جميع العناصر في المجموعة لمزيد من التفاصيل، اطّلِع على طريقة setStyle() أعلاه.

Data.GeoJsonOptions interface

google.maps.Data.GeoJsonOptions interface

المَعلمات الاختيارية لاستيراد GeoJSON

idPropertyName optional
النوع:  string optional
اسم خاصية Feature التي سيتم استخدامها كمعرّف Feature. في حال عدم تحديدها، سيتم استخدام معرّف ميزة GeoJSON.

Data.StyleOptions interface

google.maps.Data.StyleOptions interface

تحدّد هذه الخيارات الطريقة التي يجب أن يظهر بها العنصر عند عرضه على خريطة.

animation optional
النوع:  Animation optional
الصورة المتحركة التي سيتم تشغيلها عند إضافة علامة إلى خريطة. ينطبق ذلك على أشكال النقاط الهندسية فقط.
clickable optional
النوع:  boolean optional
القيمة التلقائية: true
إذا كانت القيمة true، تتلقّى العلامة أحداث الماوس واللمس.
cursor optional
النوع:  string optional
مؤشر الماوس الذي سيظهر عند التمرير فوق العنصر ينطبق ذلك على أشكال النقاط الهندسية فقط.
draggable optional
النوع:  boolean optional
القيمة التلقائية: false
إذا كانت القيمة true، يمكن سحب العنصر على الخريطة وسيتم تعديل الشكل الهندسي للعنصر الأساسي.
editable optional
النوع:  boolean optional
القيمة التلقائية: false
إذا كانت القيمة true، يمكن تعديل العنصر عن طريق سحب نقاط التحكّم وسيتم تعديل شكل العنصر الأساسي. ينطبق ذلك على أشكال LineString وPolygon الهندسية فقط.
fillColor optional
النوع:  string optional
لون التعبئة تتوفّر جميع ألوان CSS3 باستثناء الألوان الموسّعة المُسمّاة. ينطبق ذلك على أشكال المضلّعات الهندسية فقط.
fillOpacity optional
النوع:  number optional
تعتيم التعبئة بين 0.0 و1.0 ينطبق ذلك على أشكال المضلّعات الهندسية فقط.
icon optional
النوع:  string|Icon|Symbol optional
رمز المقدّمة في حال توفير سلسلة، يتم التعامل معها كما لو كانت Icon مع السلسلة كـ url. ينطبق ذلك على أشكال النقاط الهندسية فقط.
icons optional
النوع:  Array<IconSequence> optional
الرموز التي سيتم عرضها على طول خط متعدد الأضلاع ينطبق ذلك على أشكال الخطوط الهندسية فقط.
label optional
النوع:  string|MarkerLabel optional
تضيف هذه السمة تصنيفًا إلى العلامة. يمكن أن تكون التصنيفات سلسلة أو عنصر MarkerLabel. ينطبق ذلك على أشكال النقاط الهندسية فقط.
opacity optional
النوع:  number optional
تتراوح درجة عتامة العلامة بين 0.0 و1.0. ينطبق ذلك على أشكال النقاط الهندسية فقط.
shape optional
النوع:  MarkerShape optional
تحدّد هذه السمة خريطة الصور المستخدَمة لرصد النقرات. ينطبق ذلك على أشكال النقاط الهندسية فقط.
strokeColor optional
النوع:  string optional
لون الخط تتوفّر جميع ألوان CSS3 باستثناء الألوان الموسّعة المُسمّاة. ينطبق ذلك على أشكال الخطوط والمضلّعات فقط.
strokeOpacity optional
النوع:  number optional
مستوى عتامة الحدّ الخارجي بين 0.0 و1.0 ينطبق ذلك على أشكال الخطوط والمضلّعات فقط.
strokeWeight optional
النوع:  number optional
تمثّل هذه السمة عرض الخط بالبكسل. ينطبق ذلك على أشكال الخطوط والمضلّعات فقط.
title optional
النوع:  string optional
نص التمرير ينطبق ذلك على أشكال النقاط الهندسية فقط.
visible optional
النوع:  boolean optional
القيمة التلقائية: true
تحديد ما إذا كانت الميزة مرئية
zIndex optional
النوع:  number optional
يتم عرض جميع العناصر على الخريطة بترتيب zIndex، مع عرض القيم الأعلى أمام العناصر ذات القيم الأقل. تظهر العلامات دائمًا أمام السلاسل الخطية والمضلّعات.

Data.StylingFunction typedef

google.maps.Data.StylingFunction typedef

دالة تحسب مظهر ميزة.

يمكن أن تقبل طريقة Data.setStyle() دالة تنسيق. استخدِم هذه السمة عندما يجب أن تظهر الميزات بشكل مختلف استنادًا إلى خصائصها. يمكنك الاطّلاع على مزيد من المعلومات حول ميزات التصميم في دليل المطوّر.

function(Data.Feature): Data.StyleOptions

فئة Data.Feature

google.maps.Data.Feature صف

تحتوي الميزة على شكل هندسي ومعرّف ومجموعة من السمات.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Data} = await google.maps.importLibrary("maps").
اطّلِع على المكتبات في Maps JavaScript API.

Data.Feature
Data.Feature([options])
المَعلمات: 
تنشئ هذه الطريقة ميزة باستخدام الخيارات المحدّدة.
forEachProperty
forEachProperty(callback)
المَعلمات: 
  • callbackfunction(*, string): void
القيمة المعروضة:  لا شيء
يستدعي الدالة المحدّدة بشكل متكرّر، مع تمرير قيمة اسم السمة في كل استدعاء. ترتيب التكرار خلال الخصائص غير محدّد.
getGeometry
getGeometry()
المَعلمات:  بدون
قيمة العائد:  Data.Geometry
تعرِض هذه السمة الشكل الهندسي للعنصر.
getId
getId()
المَعلمات:  بدون
قيمة العائد:  number|string|undefined
تعرض هذه السمة رقم تعريف الميزة.
getProperty
getProperty(name)
المَعلمات: 
  • namestring
قيمة العائد:  *
تعرض هذه الدالة قيمة السمة المطلوبة، أو undefined إذا كانت السمة غير متوفّرة.
removeProperty
removeProperty(name)
المَعلمات: 
  • namestring
القيمة المعروضة:  لا شيء
يزيل السمة التي تحمل الاسم المحدّد.
setGeometry
setGeometry(newGeometry)
المَعلمات: 
القيمة المعروضة:  لا شيء
تضبط هذه السمة الشكل الهندسي للعنصر.
setProperty
setProperty(name, newValue)
المَعلمات: 
  • namestring
  • newValue*
القيمة المعروضة:  لا شيء
تضبط هذه السمة قيمة السمة المحدّدة. إذا كانت قيمة newValue هي undefined، يكون ذلك مكافئًا لاستدعاء removeProperty.
toGeoJson
toGeoJson(callback)
المَعلمات: 
  • callbackfunction(Object): void
القيمة المعروضة:  لا شيء
تصدير العنصر إلى كائن GeoJSON
removeproperty
function(event)
الوسيطات: 
يتم بدء هذا الحدث عند إزالة سمة من سمات عنصر.
setgeometry
function(event)
الوسيطات: 
يتم بدء هذا الحدث عند ضبط شكل هندسي لإحدى الميزات.
setproperty
function(event)
الوسيطات: 
يتم بدء هذا الحدث عند ضبط سمة لأحد العناصر.

Data.FeatureOptions interface

google.maps.Data.FeatureOptions interface

مَعلمات اختيارية لإنشاء عناصر Data.Feature.

geometry optional
النوع:  Data.Geometry|LatLng|LatLngLiteral optional
تمثّل هذه السمة الشكل الهندسي للعنصر. إذا لم يتم تحديد أي قيمة عند إنشاء عنصر، ستكون الأشكال الهندسية للعنصر null. إذا تم توفير عنصر LatLng أو LatLngLiteral، سيتم تحويله إلى شكل هندسي Data.Point.
id optional
النوع:  number|string optional
رقم تعريف الميزة اختياري. إذا تم توفيرها، يمكن استخدامها للبحث عن الميزة في عنصر Data باستخدام الطريقة getFeatureById(). يُرجى العلم أنّه لا يمكن تغيير معرّف إحدى الميزات لاحقًا.
properties optional
النوع:  Object optional
خصائص الميزة هذا هو التعيين العشوائي لأسماء السمات إلى القيم.

واجهة Data.Geometry

google.maps.Data.Geometry interface

فئة رئيسية لكائنات الأشكال الهندسية المختلفة

forEachLatLng
forEachLatLng(callback)
المَعلمات: 
  • callbackfunction(LatLng): void
القيمة المعروضة:  لا شيء
يتم استدعاء الدالة المحدّدة بشكل متكرّر، مع تمرير نقطة من الشكل الهندسي إلى الدالة في كل عملية استدعاء.
getType
getType()
المَعلمات:  بدون
قيمة العائد:  string
تعرِض هذه السمة نوع عنصر الشكل الهندسي. يمكن أن تكون القيم "Point" أو "MultiPoint" أو "LineString" أو "MultiLineString" أو "LinearRing" أو "Polygon" أو "MultiPolygon" أو "GeometryCollection".

فئة Data.Point

google.maps.Data.Point صف

يحتوي عنصر Point الهندسي على LatLng واحد.

تنفّذ هذه الفئة Data.Geometry.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Data} = await google.maps.importLibrary("maps").
اطّلِع على المكتبات في Maps JavaScript API.

Data.Point
Data.Point(latLng)
المَعلمات: 
تنشئ هذه الدالة Data.Point من LatLng أو LatLngLiteral المحدّدة.
forEachLatLng
forEachLatLng(callback)
المَعلمات: 
  • callbackfunction(LatLng): void
القيمة المعروضة:  لا شيء
get
get()
المَعلمات:  بدون
قيمة العائد:  LatLng
تعرض هذه السمة LatLng.
getType
getType()
المَعلمات:  بدون
قيمة العائد:  string
تعرض السلسلة "Point".

فئة Data.MultiPoint

google.maps.Data.MultiPoint صف

يحتوي عنصر MultiPoint الهندسي على عدد من LatLng.

تنفّذ هذه الفئة Data.Geometry.

يمكنك الوصول إلى الدعم من خلال الاتصال بالرقم const {Data} = await google.maps.importLibrary("maps").
اطّلِع على المكتبات في Maps JavaScript API.

Data.MultiPoint
Data.MultiPoint(elements)
المَعلمات: