نقدّم لك مجموعة أدوات واجهة المستخدم الخاصة بـ Places: هي مكتبة مكوّنات جاهزة للاستخدام ومنخفضة التكلفة تتيح لك إضافة واجهة مستخدم Places المألوفة من "خرائط Google" إلى أي خريطة تختارها. ننصحك بتجربتها و مشاركة ملاحظاتك للمساعدة في رسم مستقبل "منصة 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 contextmenu على الشكل الهندسي.
`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 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`	النوع: `Data.StylingFunction\|Data.StyleOptions 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 صف

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

الشركة المصنِّعة
`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 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)` المَعلمات: `callback`: `function(LatLng): void` القيمة المعروضة: لا شيء يتم استدعاء الدالة المحدّدة بشكل متكرّر، مع تمرير نقطة من الشكل الهندسي إلى الدالة في كل عملية استدعاء.
`getType`	`getType()` المَعلمات: بدون قيمة العائد: `string` تعرِض هذه السمة نوع عنصر الشكل الهندسي. يمكن أن تكون القيم `"Point"` أو `"MultiPoint"` أو `"LineString"` أو `"MultiLineString"` أو `"LinearRing"` أو `"Polygon"` أو `"MultiPolygon"` أو `"GeometryCollection"`.