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
הסגנון של Feature בFeatureLayer. הסגנון מוחל כשהסגנון מוגדר. אם פונקציית הסגנון מתעדכנת, צריך להגדיר שוב את מאפיין הסגנון. רכיב FeatureStyleFunction חייב להחזיר תוצאות עקביות אם הוא מוחל על קטעי המפה, וצריך לבצע לו אופטימיזציה לביצועים. אין תמיכה בפונקציות אסינכרוניות. אם משתמשים ב-FeatureStyleOptions, כל התכונות בשכבה הזו יעוצבו באמצעות אותה FeatureStyleOptions. יש להגדיר את הסגנון כ-null כדי להסיר את הסגנון הקודם שהוגדר. אם הערך FeatureLayer לא זמין, הגדרת הסגנון לא גורמת לשגיאה.
addListener
addListener(eventName, handler)
פרמטרים: 
  • eventNamestring האירוע שנצפה.
  • handlerFunction פונקציה לטיפול באירועים.
ערך החזרה:  MapsEventListener מאזין האירוע כתוצאה מכך.
הפונקציה מוסיפה את פונקציית ההאזנה הנתונה לשם האירוע. מחזיר מזהה עבור ה-listener הזה שניתן להשתמש בו עם event.removeListener.
click
function(event)
ארגומנטים: 
האירוע הזה מופעל כאשר לוחצים על FeatureLayer.

קבועים של FeatureType

google.maps.FeatureType קבועים

מזהים של סוגי התכונות.

כדי לקבל גישה, צריך להתקשר ל-const {FeatureType} = await google.maps.importLibrary("maps"). כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.

ADMINISTRATIVE_AREA_LEVEL_1 מציין ישות אזרחית מסדר ראשון מתחת לרמת המדינה.
ADMINISTRATIVE_AREA_LEVEL_2 מציין ישות אזרחית מסדר שני מתחת לרמת מדינה.
COUNTRY מציין את הישות הפוליטית הלאומית.
BetaDATASET מציין מערך נתונים של צד שלישי.
LOCALITY מציין ישות פוליטית משולבת של עיר או עיירה.
POSTAL_CODE מציין מיקוד המשמש לכתובת הדואר בתוך המדינה.

defStyle ברגע

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
רוחב המשיכת בפיקסלים. רלוונטי רק לגבי גיאומטריה של קווים ופוליגונים.

ממשק Feature

ממשק 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() בכפוף להפעלת החיוב הרגילה של מקומות Google). לא ניתן להפעיל את הפונקציה הזו מ-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