Data-driven styling

واجهة FeatureLayer

واجهة google.maps.FeatureLayer

تمثّل هذه الواجهة طبقة خريطة تحتوي على عناصر من FeatureType معيّن يمكن إلغاء نمطه من جهة العميل أو إرفاق أحداث به.

الخصائص
featureType	النوع: FeatureType ‫FeatureType المرتبط بهذا FeatureLayer.
isAvailable	النوع: boolean ما إذا كان هذا FeatureLayer متاحًا، أي ما إذا كان "التصميم المستند إلى البيانات" متاحًا لهذه الخريطة (هناك معرّف خريطة يستخدم مربّعات متّجهة مع تفعيل هذا FeatureLayer في نمط الخريطة في Google Cloud Console) إذا كانت هذه القيمة "خطأ" (أو أصبحت "خطأ")، يعود النمط في FeatureLayer إلى النمط التلقائي ولا يتم تشغيل الأحداث.
datasetId اختياري	ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية. النوع: string optional معرّف مجموعة البيانات لـ FeatureLayer. لا تظهر إلا إذا كانت قيمة featureType هي FeatureType.DATASET.
style اختياري	النوع: FeatureStyleOptions|FeatureStyleFunction optional نمط Feature في FeatureLayer يتم تطبيق النمط عند ضبطه. إذا تم تعديل دالة النمط، يجب ضبط سمة النمط مرة أخرى. يجب أن يعرض FeatureStyleFunction نتائج متسقة عند تطبيقه على مربّعات الخريطة، ويجب تحسينه لتقديم أفضل أداء. لا تتوفّر الدوال غير المتزامنة. إذا كنت تستخدم FeatureStyleOptions، سيتم تصميم جميع ميزات هذه الطبقة باستخدام FeatureStyleOptions نفسه. اضبط النمط على null لإزالة النمط الذي تم ضبطه سابقًا. إذا لم يكن هذا FeatureLayer متاحًا، لن يؤدي ضبط النمط إلى أي نتيجة وسيتم تسجيل خطأ.

الطُرق
addListener	addListener(eventName, handler) المَعلمات: ‫eventName: حدث "string" المرصود ‫handler: Function دالة لمعالجة الأحداث القيمة المعروضة: MapsEventListener متتبِّع الأحداث الناتج تضيف هذه الطريقة دالة أداة معالجة الحدث المحدّدة إلى اسم الحدث المحدّد. تعرض هذه الدالة معرّفًا لهذا المستمع يمكن استخدامه مع event.removeListener.

الفعاليات
click	function(event) الوسيطات: event: FeatureMouseEvent يتم تنشيط هذا الحدث عند النقر على FeatureLayer.
mousemove	function(event) الوسيطات: event: FeatureMouseEvent يتم تنشيط هذا الحدث عندما يتحرك مؤشر الماوس الخاص بالمستخدم فوق FeatureLayer.

ثوابت FeatureType

google.maps.FeatureType ثوابت
مكتبة "maps"

معرّفات أنواع الميزات

ويمكن أيضًا استخدام هذه الثوابت كسلاسل. في TypeScript، يتم تحديد سلاسل القيم الثابتة حسب النوع FeatureTypeString.

const {FeatureType} = await google.maps.importLibrary("maps");

الثوابت
ADMINISTRATIVE_AREA_LEVEL_1	تشير إلى منطقة إدارية من الدرجة الأولى تندرج تحت مستوى البلد.
ADMINISTRATIVE_AREA_LEVEL_2	يشير إلى منطقة إدارية من الدرجة الثانية تندرج تحت مستوى البلد.
COUNTRY	يشير إلى الكيان السياسي الوطني.
DATASET	ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية. يشير إلى مجموعة بيانات تابعة لجهة خارجية.
LOCALITY	يشير إلى كيان سياسي لمدينة أو بلدة مدمجة.
POSTAL_CODE	يشير إلى رمز بريدي يُستخدم لإرسال البريد داخل البلد. تتضمّن الرموز البريدية.
SCHOOL_DISTRICT	يشير إلى منطقة تعليمية.

FeatureStyleFunction typedef

google.maps.FeatureStyleFunction typedef

دالة لتنسيق FeatureLayer.

function(FeatureStyleFunctionOptions): (FeatureStyleOptions optional)

FeatureStyleFunctionOptions interface

واجهة google.maps.FeatureStyleFunctionOptions

الخيارات التي تم تمريرها إلى FeatureStyleFunction.

الخصائص
feature	النوع: Feature تم تمرير Feature إلى FeatureStyleFunction لتطبيق النمط.

FeatureStyleOptions interface

واجهة google.maps.FeatureStyleOptions

تحدّد هذه الخيارات طريقة تعديل نمط Feature على الخريطة.

الخصائص
fillColor اختياري	النوع: string optional سلسلة Hex RGB (مثل "#00FF00" للأخضر) ينطبق ذلك على الأشكال الهندسية المضلّعة فقط.
fillOpacity اختياري	النوع: number optional تعتيم التعبئة بين 0.0 و1.0. ينطبق ذلك على الأشكال الهندسية المضلّعة فقط.
strokeColor اختياري	النوع: string optional سلسلة Hex RGB (مثل "#00FF00" للأخضر)
strokeOpacity اختياري	النوع: number optional تتراوح عتامة الخط بين 0.0 و1.0. ينطبق ذلك على الأشكال الهندسية للخطوط والمضلّعات فقط.
strokeWeight اختياري	النوع: number optional عرض الخط بالبكسل ينطبق ذلك على الأشكال الهندسية للخطوط والمضلّعات فقط.

واجهة الميزة

واجهة google.maps.Feature

واجهة تمثّل ميزة مربّع خريطة اتجاهية هذه هي المدخلات إلى FeatureStyleFunction. لا تحفظ مرجعًا لكائن Feature معيّن لأنّ المرجع لن يكون ثابتًا.

الخصائص
featureType	النوع: FeatureType ‫FeatureType من هذا Feature

واجهة PlaceFeature

google.maps.PlaceFeature interface
extends Feature

واجهة تمثّل ميزة برقم تعريف مكان يتضمّن ميزات من النوع FeatureType.ADMINISTRATIVE_AREA_LEVEL_1 وFeatureType.ADMINISTRATIVE_AREA_LEVEL_2 وFeatureType.COUNTRY وFeatureType.LOCALITY وFeatureType.POSTAL_CODE وFeatureType.SCHOOL_DISTRICT.

الخصائص
placeId	النوع: string PlaceResult.place_id.
مكتسَبة: featureType

الطُرق

fetchPlace

fetchPlace() المَعلمات: لا تتوفّر أي مَعلمات القيمة المعروضة: Promise<Place> يجلب Place لـ PlaceFeature. في عنصر Place الناتج، ستتم تعبئة السمتَين id وdisplayName. سيكون الاسم المعروض باللغة التي يراها المستخدم النهائي على الخريطة. (يمكن طلب حقول إضافية لاحقًا من خلال Place.fetchFields()، وذلك وفقًا لعملية تفعيل Places API والفوترة العادية). لا تستدعِ هذه الدالة من FeatureStyleFunction لأنّ دوال FeatureStyleFunctions المتزامنة فقط هي المتوافقة. يتم رفض الوعد في حال حدوث خطأ أثناء جلب Place.

واجهة DatasetFeature

google.maps.DatasetFeature interface
extends Feature

ملاحظة: تتوفّر هذه الميزة فقط في قناة تجريبية.

واجهة تمثّل ميزة من مجموعة بيانات ستكون قيمة featureType لـ DatasetFeature دائمًا FeatureType.DATASET.

الخصائص
datasetAttributes	النوع: Object<string, string> تمثيل المفتاح والقيمة لسمات الميزة
datasetId	النوع: string معرّف مجموعة البيانات التي تنتمي إليها هذه الميزة.
مكتسَبة: featureType

واجهة FeatureMouseEvent

google.maps.FeatureMouseEvent interface
extends MapMouseEvent

يتم عرض هذا العنصر من حدث ماوس على FeatureLayer.

الخصائص
features	النوع: Array<Feature> ‫Feature في حدث الماوس هذا
السمات المكتسَبة: domEvent، latLng

الطُرق
مكتسَبة: stop