הודעה: בקרוב תהיה אפשרות להשתמש בסגנון חדש למפות הבסיס בפלטפורמה של מפות 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` לא זמין, הפונקציה setting style לא מבצעת שום פעולה ומתעדת שגיאה ביומן.

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

Methods

addListener

addListener(eventName, handler)

פרמטרים:

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

ערך המוחזר: MapsEventListener מעבד האירועים שנוצר.

הפונקציה הזו מוסיפה את פונקציית ה-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` מחרוזת RGB של Hex (כמו ‎#00FF00 לירוק). ההגדרה חלה רק על גיאומטריות של פוליגונים.
`fillOpacity optional`	סוג: `number optional` שקיפות המילוי בין 0.0 ל-1.0. ההגדרה חלה רק על גיאומטריות של פוליגונים.
`strokeColor optional`	סוג: `string optional` מחרוזת RGB של Hex (כמו ‎#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 ו-FeatureType.SCHOOL_DISTRICT.

הממשק הזה הוא תוספת ל-Feature.

מאפיינים
`placeId`	סוג: `string` `PlaceResult.place_id`.
עבר בירושה: `featureType`

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

Methods

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`

Methods
עבר בירושה: `stop`