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 حدث تمت مراقبته.
  • handlerFunction دالة معالجة الأحداث.
قيمة العرض:  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 تحديد الكتابة

دالة لتصميم 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() بموجب التفعيل والفوترة العادية لواجهة برمجة تطبيقات الأماكن). لا تستدعي هذه السمة من 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