עיצוב מפות חדש יתווסף בקרוב לפלטפורמה של מפות Google. העדכון הזה בסגנון המפה כולל לוח צבעים חדש שמוגדר כברירת מחדל ושיפורים בחוויית השימוש במפות ובנוחות השימוש. כל סגנונות המפה יעודכנו באופן אוטומטי במרץ 2025. אפשר לקרוא מידע נוסף על זמינות ועל האפשרות להצטרף בשלב מוקדם יותר במאמר בנושא סגנון מפה חדש לפלטפורמה של מפות Google.

דף זה תורגם על ידי Cloud Translation API.

Data-driven styling

ממשק FeatureLayer

ממשק google.maps.FeatureLayer

ממשק שמייצג שכבת מפה שמכילה תכונות של FeatureType ספציפי, שאפשר לשנות את הסגנון שלו בצד הלקוח או לצרף אליו אירועים.

תכונות
`featureType`	סוג: `FeatureType` `FeatureType` שמשויך אל `FeatureLayer`.
`isAvailable`	סוג: `boolean` האם `FeatureLayer` זמין, כלומר האם סגנון מבוסס-נתונים זמין למפה הזו (קיים מזהה מפה באמצעות משבצות וקטוריות כאשר `FeatureLayer` מופעל בסגנון המפה במסוף Google Cloud). אם הערך הוא False (או הופך ל-False), הסגנון של `FeatureLayer` הזה חוזר לברירת המחדל והאירועים לא מופעלים.
`datasetId optional`	הערה: התכונה הזו זמינה רק בערוץ v=beta. סוג: `string optional` מזהה מערך הנתונים בשביל `FeatureLayer`. מוצג רק אם הערך של `featureType` הוא `FeatureType.DATASET`.
`style optional`	סוג: `FeatureStyleOptions\|FeatureStyleFunction optional` הסגנון של `Feature`s ב`FeatureLayer`. הסגנון מיושם כשהסגנון מוגדר. אם פונקציית הסגנון תתעדכן, תצטרכו להגדיר שוב את מאפיין הסגנון. `FeatureStyleFunction` חייב להחזיר תוצאות עקביות כאשר הוא מוחל על אריחי המפה, וצריך לבצע אופטימיזציה לביצועים. אין תמיכה בפונקציות אסינכרוניות. אם משתמשים ב-`FeatureStyleOptions`, כל התכונות בשכבה יסווגו באותו `FeatureStyleOptions`. כדי להסיר את הסגנון שהוגדר קודם לכן, יש להגדיר את הסגנון כ-`null`. אם `FeatureLayer` לא זמין, סגנון ההגדרה לא עושה דבר ומתעד שגיאה.

שיטות
`addListener`	`addListener(eventName, handler)` פרמטרים: `eventName`: `string` אירוע שנצפה. `handler`: הפונקציה `Function` לטיפול באירועים. ערך החזרה: `MapsEventListener` האזנה לאירוע שמתקבל. הפונקציה מוסיפה את פונקציית ה-listener שצוינה לשם האירוע הנתון. מחזירה מזהה עבור ה-listener הזה שאפשר להשתמש בו עם `event.removeListener`.

שיטות

addListener

addListener(eventName, handler)

פרמטרים:

eventName: string אירוע שנצפה.
handler: הפונקציה Function לטיפול באירועים.

ערך החזרה: MapsEventListener האזנה לאירוע שמתקבל.

הפונקציה מוסיפה את פונקציית ה-listener שצוינה לשם האירוע הנתון. מחזירה מזהה עבור ה-listener הזה שאפשר להשתמש בו עם event.removeListener.

אירועים
`click`	`function(event)` ארגומנטים: `event`: `FeatureMouseEvent` האירוע הזה מופעל לאחר לחיצה על `FeatureLayer`.
`mousemove`	`function(event)` ארגומנטים: `event`: `FeatureMouseEvent` האירוע הזה מופעל כשהעכב של המשתמש עובר מעל `FeatureLayer`.

קבועים של FeatureType

google.maps.FeatureType קבועים

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

ניתן לגשת באמצעות חיוג אל const {FeatureType} = await google.maps.importLibrary("maps"). ראה ספריות ב-Maps JavaScript API.

קבועים
`ADMINISTRATIVE_AREA_LEVEL_1`	מציין ישות אזרחית מסדר ראשון מתחת לרמת המדינה.
`ADMINISTRATIVE_AREA_LEVEL_2`	מציין ישות אזרחית מסדר שני מתחת לרמת המדינה.
`COUNTRY`	מציין את הישות הפוליטית הלאומית.
`DATASET`	הערה: התכונה הזו זמינה רק בערוץ v=beta. מציין מערך נתונים של צד שלישי.
`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`.

שיטות

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`