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

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

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])` المَعلمات: `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 contentList على الشكل الهندسي.
`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` عند تمكين الرسم ورسم المستخدم هندسة (نقطة أو سلسلة خط أو مضلّع)، يتم استدعاء هذه الدالة بهذه الشكل الهندسي ويجب أن تعرض ميزة ستتم إضافتها إلى طبقة البيانات. إذا لم يتم توفير ميزة المصنع، فسيتم إنشاء عنصر بدون معرّف ولن يتم إنشاء خصائص من ذلك الشكل الهندسي بدلاً من ذلك. وتكون الإعدادات التلقائية `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

صف واحد (google.maps.Data.Feature)

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

الشركة المصنِّعة
`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"`.