إشعار: ستتوفّر قريبًا ميزة جديدة لتصميم الخرائط الأساسية في "منصة خرائط Google". يتضمّن هذا التعديل على تصميم الخريطة لوحة ألوان تلقائية جديدة وعلامات جديدة وتحسينات على تجارب الخريطة وسهولة استخدامها. سيتم تعديل جميع أنماط الخرائط تلقائيًا في آذار (مارس) 2025. لمزيد من المعلومات عن مدى التوفّر وكيفية تفعيل هذا النمط في وقت سابق، يُرجى الاطّلاع على نمط الخريطة الجديد لمنصّة "خرائط Google".

تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Data

فئة البيانات

google.maps.Data class

طبقة لعرض البيانات الجغرافية المكانية يمكن عرض النقاط وسلسلة الخطوط والمضلّعات.

يحتوي كل Map على عنصر Data تلقائيًا، لذلك لا يلزم إنشاء عنصر في معظم الأحيان. على سبيل المثال:

 var myMap = new google.maps.Map(...);
 myMap.data.addGeoJson(...);
 myMap.data.setStyle(...);

عنصر Data هو مجموعة من Features.

يمتدّ هذا الصف إلى MVCObject.

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

الشركة المصنِّعة
`Data`	`Data([options])` المَعلمات: `options`: `Data.DataOptions optional` لإنشاء مجموعة فارغة باستخدام `DataOptions` المحدّد

الطُرق
`add`	`add([feature])` المَعلمات: `feature`: `Data.Feature\|Data.FeatureOptions optional` القيمة المعروضة: `Data.Feature` تُضيف ميزة إلى المجموعة، وتُرجع الميزة المُضافة. إذا كانت الميزة لها معرّف، سيتم استبدال أي ميزة حالية في المجموعة بمعرّف الميزة نفسه. في حال عدم تقديم أيّ سمة، سيتمّ إنشاء سمة جديدة باستخدام شكل هندسي فارغ وبدون أيّ خصائص. في حال تم تقديم `FeatureOptions`، سيتم إنشاء ميزة جديدة باستخدام السمات المحدّدة. يُرجى العلم أنّ المعرّفَين `1234` و`'1234'` متكافئان. ستؤدي إضافة ميزة تحمل المعرّف `1234` إلى استبدال ميزة تحمل المعرّف `'1234'` والعكس صحيح.
`addGeoJson`	`addGeoJson(geoJson[, options])` المَعلمات: `geoJson`: `Object` `options`: `Data.GeoJsonOptions optional` القيمة المعروضة: `Array<Data.Feature>` تُضيف عناصر GeoJSON إلى المجموعة. قدِّم لهذه الطريقة ملف JSON تم تحليله. يتم عرض الميزات التي تم استيرادها. يُلقي استثناءً في حال تعذّر استيراد GeoJSON.
`contains`	`contains(feature)` المَعلمات: `feature`: `Data.Feature` القيمة المعروضة: `boolean` للتحقّق مما إذا كانت الميزة المحدّدة موجودة في المجموعة
`forEach`	`forEach(callback)` المَعلمات: `callback`: `function(Data.Feature): void` القيمة المعروضة: لا شيء تستدعي هذه الوظيفة الدالة المحدّدة بشكل متكرّر، مع تمرير سمة في المجموعة إلى الدالة عند كلّ استدعاء. ترتيب التكرار في الميزات غير محدّد.
`getControlPosition`	`getControlPosition()` المَعلمات: بدون القيمة المعروضة: `ControlPosition` تعرِض هذه السمة موضع عناصر التحكّم في الرسم على الخريطة.
`getControls`	`getControls()` المَعلمات: بدون القيمة المعروضة: `Array<string>` تعرِض أوضاع الرسم المتاحة للمستخدم لاختيارها، بالترتيب الذي تظهر به. ولا يشمل ذلك وضع الرسم `null` الذي تتم إضافته تلقائيًا. أوضاع الرسم المحتمَلة هي `"Point"` أو `"LineString"` أو `"Polygon"`.
`getDrawingMode`	`getDrawingMode()` المَعلمات: بدون القيمة المعروضة: `string\|null` لعرض وضع الرسم الحالي لطبقة البيانات المحدّدة. يعني وضع الرسم `null` أنّه يمكن للمستخدم التفاعل مع الخريطة كالمعتاد، ولا ترسم النقرات أي شيء. أوضاع الرسم المحتملة هي `null` أو `"Point"` أو `"LineString"` أو `"Polygon"`.
`getFeatureById`	`getFeatureById(id)` المَعلمات: `id`: `number\|string` القيمة المعروضة: `Data.Feature\|undefined` لعرض العنصر الذي يحمل رقم التعريف المحدّد، إذا كان متوفّرًا في المجموعة بخلاف ذلك، يتم عرض `undefined`. يُرجى العلم أنّ المعرّفَين `1234` و`'1234'` متكافئان. ويمكن استخدام أي منهما للبحث عن الميزة نفسها.
`getMap`	`getMap()` المَعلمات: بدون القيمة المعروضة: `Map` عرض الخريطة التي يتم عرض العناصر عليها
`getStyle`	`getStyle()` المَعلمات: بدون القيمة المعروضة: `Data.StylingFunction\|Data.StyleOptions` الحصول على نمط جميع العناصر في المجموعة
`loadGeoJson`	`loadGeoJson(url[, options, callback])` المَعلمات: `url`: `string` `options`: `Data.GeoJsonOptions optional` `callback`: `function(Array<Data.Feature>): void optional` القيمة المعروضة: لا شيء تحمِّل هذه الدالة تنسيق GeoJSON من عنوان URL وتضيف الميزات إلى المجموعة. ملاحظة: يتم جلب GeoJSON باستخدام XHR، وقد لا يعمل على مستوى النطاقات المختلفة. إذا واجهت مشاكل، ننصحك بجلب GeoJSON باستخدام مكتبة AJAX التي تختارها، ثم استدعاء `addGeoJson()`.
`overrideStyle`	`overrideStyle(feature, style)` المَعلمات: `feature`: `Data.Feature` `style`: `Data.StyleOptions` القيمة المعروضة: لا شيء لتغيير نمط ميزة يتم تطبيق هذه التغييرات على النمط المحدّد بواسطة `setStyle()`. يتمّ إعادة ضبط خصائص الأسلوب التي تمّ ضبطها على `null` إلى القيمة المحدّدة من خلال `setStyle()`.
`remove`	`remove(feature)` المَعلمات: `feature`: `Data.Feature` القيمة المعروضة: لا شيء تزيل ميزة من المجموعة.
`revertStyle`	`revertStyle([feature])` المَعلمات: `feature`: `Data.Feature optional` القيمة المعروضة: لا شيء إزالة تأثير مكالمات `overrideStyle()` السابقة يعود نمط العنصر المحدّد إلى النمط المحدّد بواسطة `setStyle()`. إذا لم يتم تحديد ميزة، سيتمّ استعادة نمط جميع الميزات.
`setControlPosition`	`setControlPosition(controlPosition)` المَعلمات: `controlPosition`: `ControlPosition` القيمة المعروضة: لا شيء لضبط موضع عناصر التحكّم في الرسم على الخريطة
`setControls`	`setControls(controls)` المَعلمات: `controls`: `Array<string>` القيمة المعروضة: لا شيء تُستخدَم لتحديد أوضاع الرسم المتاحة للمستخدم لاختيارها، بالترتيب الذي تظهر به. يجب ألا يتضمّن ذلك وضع الرسم `null` الذي تتم إضافته تلقائيًا. إذا كان الخيار `null`، يتم إيقاف عناصر التحكّم في الرسم وعدم عرضها. أوضاع الرسم المحتمَلة هي `"Point"` أو `"LineString"` أو `"Polygon"`.
`setDrawingMode`	`setDrawingMode(drawingMode)` المَعلمات: `drawingMode`: `string optional` القيمة المعروضة: لا شيء لضبط وضع الرسم الحالي لطبقة البيانات المحدّدة. يعني وضع الرسم `null` أنّه يمكن للمستخدم التفاعل مع الخريطة كالمعتاد، ولا ترسم النقرات أي شيء. أوضاع الرسم المحتملة هي `null` أو `"Point"` أو `"LineString"` أو `"Polygon"`.
`setMap`	`setMap(map)` المَعلمات: `map`: `Map` القيمة المعروضة: لا شيء لعرض العناصر على الخريطة المحدّدة إذا تم ضبط الخريطة على `null`، ستتم إزالة العناصر من الخريطة.
`setStyle`	`setStyle(style)` المَعلمات: `style`: `Data.StylingFunction\|Data.StyleOptions` القيمة المعروضة: لا شيء لضبط النمط لجميع العناصر في المجموعة ستبقى الأنماط المحدّدة لكل ميزة من خلال `overrideStyle()` سارية. يمكنك تمرير عنصر يتضمّن خيارات النمط المطلوبة، أو دالة تحسب النمط لكل ميزة. سيتمّ استدعاء الدالة في كلّ مرّة يتمّ فيها تعديل خصائص إحدى الميزات.
`toGeoJson`	`toGeoJson(callback)` المَعلمات: `callback`: `function(Object): void` القيمة المعروضة: لا شيء تصدير العناصر في المجموعة إلى كائن GeoJSON
مُكتسَبة: `addListener`، `bindTo`، `get`، `notify`، `set`، `setValues`، `unbind`، `unbindAll`

الفعاليات
`addfeature`	`function(event)` الوسيطات: `event`: `Data.AddFeatureEvent` يتم تنشيط هذا الحدث عند إضافة ميزة إلى المجموعة.
`click`	`function(event)` الوسيطات: `event`: `Data.MouseEvent` يتم تنشيط هذا الحدث عند النقر على الشكل الهندسي.
`contextmenu`	`function(event)` الوسيطات: `event`: `Data.MouseEvent` يتم تنشيط هذا الحدث عند تنشيط حدث قائمة السياق DOM على الشكل الهندسي.
`dblclick`	`function(event)` الوسيطات: `event`: `Data.MouseEvent` يتم تشغيل هذا الحدث عند النقر مرّتين على الشكل الهندسي.
`mousedown`	`function(event)` الوسيطات: `event`: `Data.MouseEvent` يتم تنشيط هذا الحدث عند الضغط على زر الماوس في الشكل الهندسي.
`mouseout`	`function(event)` الوسيطات: `event`: `Data.MouseEvent` يتم تنشيط هذا الحدث عندما يغادر مؤشر الماوس منطقة الشكل الهندسي.
`mouseover`	`function(event)` الوسيطات: `event`: `Data.MouseEvent` يتم تنشيط هذا الحدث عندما يدخل الماوس إلى منطقة الشكل الهندسي.
`mouseup`	`function(event)` الوسيطات: `event`: `Data.MouseEvent` يتم تشغيل هذا الحدث عند رفع مؤشر الماوس عن الشكل الهندسي.
`removefeature`	`function(event)` الوسيطات: `event`: `Data.RemoveFeatureEvent` يتم تشغيل هذا الحدث عند إزالة ميزة من المجموعة.
`removeproperty`	`function(event)` الوسيطات: `event`: `Data.RemovePropertyEvent` يتمّ تشغيل هذا الحدث عند إزالة خاصيّة ميزة.
`setgeometry`	`function(event)` الوسيطات: `event`: `Data.SetGeometryEvent` يتمّ تشغيل هذا الحدث عند ضبط هندسة أحد العناصر.
`setproperty`	`function(event)` الوسيطات: `event`: `Data.SetPropertyEvent` يتمّ إطلاق هذا الحدث عند ضبط خاصيّة ميزة معيّنة.
`rightclick`	متوقف نهائيًا: استخدِم الحدث `Data.contextmenu` بدلاً من ذلك لتتوافق مع أنماط الاستخدام، مثل النقر مع الضغط على مفتاح التحكّم (Control) في نظام التشغيل macOS. `function(event)` الوسيطات: `event`: `Data.MouseEvent` يتم تشغيل هذا الحدث عند النقر بزر الماوس الأيمن على الشكل الهندسي.

واجهة Data.DataOptions

google.maps.Data.DataOptions واجهة

عنصر 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، سيتم إنشاء عنصر بدون معرّف أو سمات من هذا الشكل الهندسي بدلاً من ذلك. الإعداد التلقائي هو `null`.
`style optional`	النوع: `Data.StylingFunction\|Data.StyleOptions optional` النمط لجميع الميزات في المجموعة لمزيد من التفاصيل، يُرجى الاطّلاع على طريقة `setStyle()` أعلاه.

واجهة Data.GeoJsonOptions

google.maps.Data.GeoJsonOptions واجهة

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

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

واجهة Data.StyleOptions

google.maps.Data.StyleOptions واجهة

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

الخصائص
`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`، يمكن تعديل الجسم عن طريق سحب نقاط التحكّم وسيتم تعديل الشكل الهندسي للعنصر الأساسي. لا ينطبق إلا على أشكال الخطوط والأشكال المتعددة الأضلاع.
`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 class

google.maps.Data.Feature class

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

الشركة المصنِّعة
`Data.Feature`	`Data.Feature([options])` المَعلمات: `options`: `Data.FeatureOptions optional` تُنشئ ميزة باستخدام الخيارات المحدّدة.

الطُرق
`forEachProperty`	`forEachProperty(callback)` المَعلمات: `callback`: `function(, string): void` القيمة المعروضة:* لا شيء تستدعي الدالة المحدّدة بشكل متكرّر، مع تمرير قيمة خاصية واسم في كلّ استدعاء. ترتيب التكرار في السمات غير محدّد.
`getGeometry`	`getGeometry()` المَعلمات: بدون القيمة المعروضة: `Data.Geometry` لعرض الشكل الهندسي للعنصر
`getId`	`getId()` المَعلمات: بدون القيمة المعروضة: `number\|string\|undefined` لعرض رقم تعريف الميزة.
`getProperty`	`getProperty(name)` المَعلمات: `name`: `string` القيمة المعروضة: `*` تعرِض هذه الدالة قيمة السمة المطلوبة، أو `undefined` إذا لم تكن السمة متوفّرة.
`removeProperty`	`removeProperty(name)` المَعلمات: `name`: `string` القيمة المعروضة: لا شيء تزيل السمة التي تحمل الاسم المحدّد.
`setGeometry`	`setGeometry(newGeometry)` المَعلمات: `newGeometry`: `Data.Geometry\|LatLng\|LatLngLiteral` القيمة المعروضة: لا شيء تُستخدَم لضبط هندسة العنصر.
`setProperty`	`setProperty(name, newValue)` المَعلمات: `name`: `string` `newValue`: `` القيمة المعروضة:* لا شيء تُحدِّد قيمة السمة المحدّدة. إذا كانت `newValue` هي `undefined`، هذا يعادل استدعاء `removeProperty`.
`toGeoJson`	`toGeoJson(callback)` المَعلمات: `callback`: `function(Object): void` القيمة المعروضة: لا شيء تصدير العنصر إلى كائن GeoJSON

الفعاليات
`removeproperty`	`function(event)` الوسيطات: `event`: `Data.RemovePropertyEvent` يتم بدء هذا الحدث عند إزالة خاصية ميزة.
`setgeometry`	`function(event)` الوسيطات: `event`: `Data.SetGeometryEvent` يتم بدء هذا الحدث عند ضبط هندسة أحد العناصر.
`setproperty`	`function(event)` الوسيطات: `event`: `Data.SetPropertyEvent` يتم بدء هذا الحدث عند ضبط خاصية عنصر.

Data.FeatureOptions واجهة

google.maps.Data.FeatureOptions واجهة

مَعلمات اختيارية لإنشاء عناصر 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 واجهة

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

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