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

Data

فئة البيانات

google.maps.Data الصف الدراسي

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

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

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

الكائن Data عبارة عن مجموعة من Features.

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {Data} = await google.map.importLibrary("maps"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

الشركة المصنِّعة
`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` بدلاً من ذلك لإتاحة أنماط الاستخدام، مثل التحكّم بالنقر على نظام التشغيل 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

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"`.