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)
المَعلمات: 
  • eventNamestring حدث تم رصده.
  • 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

واجهة google.maps.FeatureStyleFunctionOptions

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

feature
النوع:  Feature
تم تمرير Feature إلى FeatureStyleFunction للتصميم.

واجهة FeatureStyleOptions

واجهة google.maps.FeatureStyleOptions

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

fillColor optional
النوع:  string optional
سلسلة سداسية عشرية (مثل "#00FF00" باللون الأخضر) ينطبق هذا الإجراء فقط على الأشكال الهندسية المضلّعة.
fillOpacity optional
النوع:  number optional
تعتيم التعبئة بين 0.0 و1.0. ينطبق هذا الإجراء فقط على الأشكال الهندسية المضلّعة.
strokeColor optional
النوع:  string optional
سلسلة سداسية عشرية (مثل "#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
مُكتسَب: featureType
fetchPlace
fetchPlace()
المَعلمات: لا شيء
قيمة الإرجاع:  Promise<Place>
يتم استرجاع Place لهذا PlaceFeature. في العنصر Place الناتج، ستتم تعبئة السمتَين id وdisplayName. سيكون الاسم المعروض باللغة التي يراها المستخدم النهائي على الخريطة. (يمكن بعد ذلك طلب حقول إضافية من خلال Place.fetchFields() مع تفعيل Places API والفوترة العادية). لا تستدعي هذه السمة من FeatureStyleFunction، لأنّ FeatureStyles المتزامنة فقط هي تلك المتوافقة. يتم رفض الوعد في حال حدوث خطأ أثناء استرجاع 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