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.

ثوابت 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 يشير إلى رمز بريدي يُستخدم لمعالجة البريد العادي في البلد.

دالة FeatureStyle 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.

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

placeId
النوع:  string
PlaceResult.place_id
مكتسَب: featureType
fetchPlace
fetchPlace()
المعلّمات: بدون
قيمة العرض:  Promise<Place>
استرجاع Place لهذا PlaceFeature. في العنصر Place الناتج، ستتم تعبئة السمتَين id وdisplayName. سيظهر الاسم المعروض باللغة التي يراها المستخدم النهائي على الخريطة. (يمكن طلب الحقول الإضافية لاحقًا عبر Place.fetchFields() وفقًا للتفعيل العادي والفوترة في واجهة برمجة تطبيقات الأماكن). يجب عدم طلب هذه السمة من 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