Data-driven styling (beta)

FeatureLayer واجهة

واجهة google.maps.FeatureLayer

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

ثوابت FeatureType

google.maps.FeatureType ثوابت

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

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

FeatureStyleFunction typedef

google.maps.FeatureStyleFunction typedef

دالة لنمط FeatureLayer.

function(FeatureStyleFunctionOptions): (FeatureStyleOptions optional)

FeatureStyleFunctionFunction واجهة

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

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

placeId
النوع:  string
PlaceResult.place_id.
موروثة: featureType
fetchPlace
fetchPlace()
المعلّمات: بدون
قيمة الإرجاع:  Promise<Place>
لجلب Place لهذا PlaceFeature. في الكائن Place الناتج، ستتم تعبئة الخاصيتين id وdisplayName. (ويمكن في وقت لاحق طلب حقول إضافية عبر Place.fetchFields() وفقًا للتمكين العادي لخدمة API للأماكن والفوترة.) يجب عدم استدعاء هذا الإجراء من FeatureStyleFunction لأنّ ميزة StyleStyleFunctions المتزامنة فقط متاحة. يتم رفض الوعد في حال حدوث خطأ أثناء جلب Place.

واجهة FeatureMouseEvent

واجهة google.maps.FeatureMouseEvent

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

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

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