Data-driven styling

واجهة FeatureLayer

google.maps.FeatureLayer واجهة

واجهة تمثّل طبقة خريطة تحتوي على عناصر FeatureType معيّنة يمكن إلغاء أسلوبها من جهة العميل، أو أن تكون مرتبطة بأحداث
featureType
النوع:  FeatureType
FeatureType المرتبط بهذا FeatureLayer
isAvailable
النوع:  boolean
ما إذا كان هذا الخيار FeatureLayer متاحًا، أي ما إذا كان التصميم المستنِد إلى البيانات متاحًا لهذه الخريطة (يتوفر معرّف خريطة يستخدم شرائح رسومات متجاوبة مع هذا الخيار FeatureLayer مفعّلاً في نمط الخريطة في Google Cloud Console) إذا كانت هذه القيمة غير صحيحة (أو أصبحت غير صحيحة)، يعود تنسيق هذا FeatureLayer إلى الإعداد التلقائي ولا يتم تشغيل الأحداث.
BetadatasetId optional
النوع:  string optional
رقم تعريف مجموعة البيانات لهذا FeatureLayer. لا يظهر هذا الحقل إلّا إذا كان featureType يساوي FeatureType.DATASET.
style optional
نمط Feature في FeatureLayer يتم تطبيق النمط عند ضبطه. إذا تم تعديل دالة التصميم، يجب ضبط سمة التصميم مرة أخرى. يجب أن يعرض FeatureStyleFunction نتائج متسقة عند تطبيقه على مربّعات الخريطة، ويجب تحسينه لتحسين الأداء. لا تتوفّر الدوالّ غير المتزامنة. في حال استخدام FeatureStyleOptions، سيتمّ تطبيق FeatureStyleOptions نفسه على جميع عناصر هذه الطبقة. اضبط النمط على null لإزالة النمط الذي تم ضبطه سابقًا. إذا لم يكن هذا FeatureLayer متاحًا، لن يؤدي ضبط النمط إلى أيّ إجراء وسيتم تسجيل خطأ.
addListener
addListener(eventName, handler)
المَعلمات: 
  • eventName:  string الحدث المرصود
  • handler:  Function وظيفة لمعالجة الأحداث
القيمة المعروضة:  MapsEventListener أداة معالجة الحدث الناتجة.
تُضيف دالة أداة مراقبة الأحداث المحدّدة إلى اسم الحدث المحدّد. تعرِض هذه السمة معرّفًا لهذا المستمع يمكن استخدامه مع event.removeListener.
click
function(event)
الوسيطات: 
يتم تنشيط هذا الحدث عند النقر على FeatureLayer.
mousemove
function(event)
الوسيطات: 
يتمّ تشغيل هذا الحدث عندما يتحرّك مؤشّر الماوس الخاص بالمستخدم فوق FeatureLayer.

FeatureType الثوابت

google.maps.FeatureType الثوابت

معرّفات لأنواع العناصر

يمكنك الوصول إليه من خلال الاتصال بالرقم const {FeatureType} = await google.maps.importLibrary("maps"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
ADMINISTRATIVE_AREA_LEVEL_1 يشير إلى كيان مدني من الدرجة الأولى على مستوى أقل من مستوى البلد.
ADMINISTRATIVE_AREA_LEVEL_2 يشير إلى كيان مدني من الدرجة الثانية أقل من مستوى البلد.
COUNTRY يشير إلى الكيان السياسي الوطني.
BetaDATASET يشير إلى مجموعة بيانات تابعة لجهة خارجية.
LOCALITY يشير إلى كيان سياسي مدين أو بلدة مدمجة.
POSTAL_CODE يشير إلى الرمز البريدي المستخدَم في توجيه البريد البريدي داخل البلد. ويشمل ذلك الرموز البريدية.
SCHOOL_DISTRICT يشير إلى منطقة تعليمية.

FeatureStyleFunction typedef

google.maps.FeatureStyleFunction typedef

دالة لتنسيق FeatureLayer

function(FeatureStyleFunctionOptions): (FeatureStyleOptions optional)

FeatureStyleFunctionOptions واجهة

google.maps.FeatureStyleFunctionOptions واجهة

تم تمرير الخيارات إلى FeatureStyleFunction.
feature
النوع:  Feature
تم تمرير Feature إلى FeatureStyleFunction لتنسيقه.

FeatureStyleOptions واجهة

google.maps.FeatureStyleOptions واجهة

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

واجهة الميزة

google.maps.Feature واجهة

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

واجهة PlaceFeature

google.maps.PlaceFeature واجهة

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

تمتد هذه الواجهة Feature.

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 واجهة

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

تمتد هذه الواجهة Feature.

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

واجهة FeatureMouseEvent

google.maps.FeatureMouseEvent واجهة

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

تمتد هذه الواجهة MapMouseEvent.

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