Data-driven styling

ממשק FeatureLayer

google.maps.FeatureLayer ממשק

ממשק שמייצג שכבת מפה שמכילה תכונות של FeatureType ספציפי, שאפשר לבטל את הסגנון שלו בצד הלקוח או לצרף אליו אירועים.
featureType
סוג:  FeatureType
FeatureType שמשויך לFeatureLayer הזה.
isAvailable
סוג:  boolean
האם FeatureLayer זמין, כלומר האם עיצוב מבוסס-נתונים זמין למפה הזו (יש מזהה מפה שמשתמש במשבצות וקטוריות עם FeatureLayer מופעל בסגנון המפה ב-Google Cloud Console). אם הערך הוא False (או אם הוא הופך ל-False), העיצוב של 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 listener שנוצרת.
מוסיפה את פונקציית ה-listener שצוינה לשם האירוע שצוין. מחזירה מזהה של מאזין שאפשר להשתמש בו עם event.removeListener.
click
function(event)
ארגומנטים: 
האירוע הזה מופעל כשלוחצים על FeatureLayer.
mousemove
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהעכבר של המשתמש עובר מעל FeatureLayer.

FeatureType constants

google.maps.FeatureType constants

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

אפשר להתקשר אל 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 interface

google.maps.FeatureStyleFunctionOptions ממשק

אפשרויות שמועברות אל FeatureStyleFunction.
feature
סוג:  Feature
הערך Feature מועבר אל FeatureStyleFunction כדי להגדיר את הסגנון.

‫FeatureStyleOptions interface

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 interface

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

‫DatasetFeature interface

google.maps.DatasetFeature ממשק

ממשק שמייצג תכונה מ-Dataset. הערך של featureType של DatasetFeature יהיה תמיד FeatureType.DATASET.

הממשק הזה מרחיב את Feature.

datasetAttributes
סוג:  Object<string, string>
מיפוי של מאפיינים של התכונה עם ערכי מפתח.
datasetId
סוג:  string
מזהה מערך הנתונים שאליו שייכת התכונה הזו.
Inherited: featureType

ממשק FeatureMouseEvent

google.maps.FeatureMouseEvent ממשק

האובייקט הזה מוחזר מאירוע של עכבר ב-FeatureLayer.

הממשק הזה מרחיב את MapMouseEvent.

features
סוג:  Array<Feature>
הערכים של Feature באירוע העכבר הזה.
בירושה: domEvent, latLng
Inherited: stop