Data-driven styling

ממשק FeatureLayer

ממשק google.maps.FeatureLayer

ממשק שמייצג שכבת מפה שמכילה תכונות של FeatureType ספציפי, שאפשר לשנות את הסגנון שלו בצד הלקוח או לצרף אליו אירועים.
featureType
סוג:  FeatureType
FeatureType שמשויך אל FeatureLayer.
isAvailable
סוג:  boolean
האם FeatureLayer זמין, כלומר האם סגנון מבוסס-נתונים זמין למפה הזו (קיים מזהה מפה באמצעות משבצות וקטוריות כאשר FeatureLayer מופעל בסגנון המפה במסוף Google Cloud). אם הערך הוא False (או הופך ל-False), הסגנון של FeatureLayer הזה חוזר לברירת המחדל והאירועים לא מופעלים.
BetadatasetId optional
סוג:  string optional
מזהה מערך הנתונים בשביל FeatureLayer. מוצג רק אם הערך של featureType הוא FeatureType.DATASET.
style optional
הסגנון של Features בFeatureLayer. הסגנון מיושם כשהסגנון מוגדר. אם פונקציית הסגנון תתעדכן, תצטרכו להגדיר שוב את מאפיין הסגנון. FeatureStyleFunction חייב להחזיר תוצאות עקביות כאשר הוא מוחל על אריחי המפה, וצריך לבצע אופטימיזציה לביצועים. אין תמיכה בפונקציות אסינכרוניות. אם משתמשים ב-FeatureStyleOptions, כל התכונות בשכבה יסווגו באותו FeatureStyleOptions. כדי להסיר את הסגנון שהוגדר קודם לכן, יש להגדיר את הסגנון כ-null. אם FeatureLayer לא זמין, סגנון ההגדרה לא עושה דבר ומתעד שגיאה.
addListener
addListener(eventName, handler)
פרמטרים: 
  • eventName:  string אירוע שנצפה.
  • handler:  הפונקציה Function לטיפול באירועים.
ערך החזרה:  MapsEventListener האזנה לאירוע שמתקבל.
הפונקציה מוסיפה את פונקציית ה-listener שצוינה לשם האירוע הנתון. מחזירה מזהה עבור ה-listener הזה שאפשר להשתמש בו עם 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
מחרוזת הקסדצימלית (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

ממשק שמייצג תכונה של אריח מפה וקטורית. אלה ערכי הקלט ל-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
PlaceResult.place_id.
עברה בירושה: featureType
fetchPlace
fetchPlace()
פרמטרים: ללא
הערך המוחזר:  Promise<Place>
הפונקציה מאחזרת Place עבור PlaceFeature הזה. באובייקט Place שיתקבל, המאפיין id והמאפיינים displayName יאוכלסו. השם המוצג יהיה בשפה שמשתמש הקצה רואה במפה. (ניתן לבקש שדות נוספים בהמשך דרך Place.fetchFields() בכפוף להפעלה ולחיוב הרגילים של Places API). אין לקרוא לפונקציה הזו מ-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