Data-driven styling

واجهة FeatureLayer

google.maps.FeatureLayer interface

تمثّل هذه السمة طبقة خريطة تحتوي على عناصر 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").
اطّلِع على المكتبات في Maps JavaScript API.
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 interface

google.maps.FeatureStyleFunctionOptions interface

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

FeatureStyleOptions interface

google.maps.FeatureStyleOptions interface

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

واجهة الميزة

google.maps.Feature interface

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

واجهة PlaceFeature

google.maps.PlaceFeature interface

واجهة تمثّل ميزة تتضمّن معرّف مكان يشمل ميزات من النوع 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 interface

google.maps.DatasetFeature interface

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

توسّع هذه الواجهة Feature.

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

FeatureMouseEvent

google.maps.FeatureMouseEvent interface

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

توسّع هذه الواجهة MapMouseEvent.

features
النوع:  Array<Feature>
تمثّل Features موضع مؤشر الماوس عند وقوع الحدث.
موروثة: domEvent, latLng
موروثة: stop