Data-driven styling

הממשק FeatureLayer

ממשק google.maps.FeatureLayer

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

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

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג FeatureTypeString.

const {FeatureType} = await google.maps.importLibrary("maps");
ADMINISTRATIVE_AREA_LEVEL_1 מציין חלוקה מנהלית מדרגה ראשונה מתחת לרמה הארצית.
ADMINISTRATIVE_AREA_LEVEL_2 מציין חלוקה מנהלית מדרגה שנייה מתחת לרמה הארצית.
COUNTRY מציין את הישות הפוליטית הלאומית.
BetaDATASET מציין קבוצת נתונים של צד שלישי.
LOCALITY מציין ישות פוליטית של עיר או עיירה מאוגדת.
POSTAL_CODE מציין מיקוד שמשמש למשלוח דואר בתוך המדינה. כולל מיקודים.
SCHOOL_DISTRICT מציין מחוז במערכת החינוך.

FeatureStyleFunction typedef

typedef google.maps.FeatureStyleFunction

פונקציה לעיצוב FeatureLayer.

function(FeatureStyleFunctionOptions): (FeatureStyleOptions optional)

הממשק FeatureStyleFunctionOptions

ממשק google.maps.FeatureStyleFunctionOptions

אפשרויות שהועברו אל FeatureStyleFunction.
feature
סוג: Feature
Feature מועבר אל FeatureStyleFunction לעיצוב.

הממשק FeatureStyleOptions

ממשק google.maps.FeatureStyleOptions

האפשרויות האלה מציינות איך לשנות את הסגנון של Feature במפה.
fillColor
אופציונלי
סוג: string optional
מחרוזת RGB הקסדצימלית (למשל, "‎#00FF00" לצבע ירוק). רלוונטי רק לגיאומטריות של פוליגונים.
fillOpacity
אופציונלי
סוג: number optional
מידת האטימות של המילוי, בין 0.0 ל-1.0. רלוונטי רק לגיאומטריות של פוליגונים.
strokeColor
אופציונלי
סוג: string optional
מחרוזת RGB הקסדצימלית (למשל, "‎#00FF00" לצבע ירוק).
strokeOpacity
אופציונלי
סוג: number optional
אטימות הקו בין 0.0 ל-1.0. רלוונטי רק לגיאומטריות של קווים ופוליגונים.
strokeWeight
אופציונלי
סוג: number optional
רוחב הקו בפיקסלים. רלוונטי רק לגיאומטריות של קווים ופוליגונים.

ממשק התכונה

ממשק google.maps.Feature
מורחב על ידי DatasetFeature, PlaceFeature

ממשק שמייצג תכונה של משבצת במפה וקטורית. אלה קלטים של FeatureStyleFunction. אל תשמרו הפניה לאובייקט Feature מסוים כי ההפניה לא תהיה יציבה.
featureType
סוג: FeatureType
FeatureType של Feature.

ממשק PlaceFeature

interface google.maps.PlaceFeature extends Feature

ממשק שמייצג מאפיין עם מזהה מקום, שכולל מאפיינים מהסוגים FeatureType.ADMINISTRATIVE_AREA_LEVEL_1,‏ FeatureType.ADMINISTRATIVE_AREA_LEVEL_2,‏ FeatureType.COUNTRY,‏ FeatureType.LOCALITY,‏ FeatureType.POSTAL_CODE ו-FeatureType.SCHOOL_DISTRICT.
placeId
סוג: string
הPlaceResult.place_id.
בירושה: featureType
fetchPlace
fetchPlace()
פרמטרים: אין
ערך מוחזר: Promise<Place>
מאחזרת Place של ה-PlaceFeature הזו. באובייקט Place שיתקבל, המאפיינים id ו-displayName יאוכלסו. השם המוצג יהיה בשפה שמשתמש הקצה רואה במפה. (אפשר לבקש שדות נוספים בהמשך דרך Place.fetchFields() בכפוף להפעלה ולחיוב הרגילים של Places API). אין לקרוא לפונקציה הזו מ-FeatureStyleFunction, כי יש תמיכה רק בפונקציות FeatureStyleFunctions סינכרוניות. ה-promise נדחה אם הייתה שגיאה באחזור של Place.

ממשק DatasetFeature

interface google.maps.DatasetFeature extends Feature

ממשק שמייצג מאפיין מקבוצת נתונים. ה-featureType של DatasetFeature תמיד יהיה FeatureType.DATASET.
datasetAttributes
סוג: Object<string, string>
מיפוי ערכי מפתח של מאפייני התכונה.
datasetId
סוג: string
מזהה קבוצת הנתונים שהתכונה הזו שייכת אליה.
בירושה: featureType

ממשק FeatureMouseEvent

interface google.maps.FeatureMouseEvent extends MapMouseEvent

האובייקט הזה מוחזר מאירוע עכבר ב-FeatureLayer.
features
סוג: Array<Feature>
ה-Features באירוע העכבר הזה.
בירושה: domEvent, latLng
בירושה: stop