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

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

Maps

הכיתה Map

google.maps.Map class

הכיתה הזו היא תת-מחלקה של MVCObject.

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

יצרן
`Map`	`Map(mapDiv[, opts])` פרמטרים: `mapDiv`: `HTMLElement` המפה תעבור רינדור כדי למלא את הרכיב הזה. `opts`: `MapOptions optional` אפשרויות יצירת מפה חדשה בתוך קונטיינר ה-HTML הנתון, שהוא בדרך כלל רכיב `DIV`.

קבועים
`DEMO_MAP_ID`	מזהה מפה שאפשר להשתמש בו בדוגמאות קוד שדורשות מזהה מפה. מזהה המפה הזה לא מיועד לשימוש באפליקציות ייצור, ואי אפשר להשתמש בו בפיצ'רים שדורשים הגדרה בענן (כמו Cloud Styling).

מאפיינים
`controls`	סוג: `Array<MVCArray<HTMLElement>>` פקדים נוספים שאפשר לצרף למפה. כדי להוסיף אמצעי בקרה למפה, מוסיפים את `<div>` של אמצעי הבקרה ל-`MVCArray` התואם ל-`ControlPosition` שבו צריך ליצור את הרינדור שלו.
`data`	סוג: `Data` מופע של `Data` שמקושר למפה. מוסיפים תכונות לאובייקט `Data` הזה כדי להציג אותן בנוחות במפה הזו.
`mapTypes`	סוג: `MapTypeRegistry` מרשם של מכונות `MapType` לפי מזהה מחרוזת.
`overlayMapTypes`	סוג: `MVCArray<MapType optional>` סוגי מפות נוספים להצגה על גבי המפה. סוגי המפות של שכבות-העל יוצגו מעל למפת הבסיס שהן מצורפות אליה, בסדר שבו הן מופיעות במערך `overlayMapTypes` (שכבות-על עם ערכי אינדקס גבוהים יותר יוצגו לפני שכבות-על עם ערכי אינדקס נמוכים יותר).

Methods
`fitBounds`	`fitBounds(bounds[, padding])` פרמטרים: `bounds`: `LatLngBounds\|LatLngBoundsLiteral` גבולות להצגה. `padding`: `number\|Padding optional` רווח בפסקה בפיקסלים. הגבולות יותאמו לחלק של המפה שנשאר אחרי הסרת הרווח. ערך מספרי יניב את אותו הוספת רווח לכל 4 הצדדים. כדי להפוך את fitBounds לבלתי תלוי בתוצאה של getBounds, צריך להזין כאן 0. ערך המוחזר: None מגדיר את אזור התצוגה כך שיכיל את הגבולות שצוינו. הערה: כשהמפה מוגדרת כ-`display: none`, הפונקציה `fitBounds` קוראת את גודל המפה כ-0x0, ולכן היא לא מבצעת שום פעולה. כדי לשנות את אזור התצוגה בזמן שהמפה מוסתרת, מגדירים את המפה כ-`visibility: hidden`, וכך מוודאים של-div של המפה יש גודל בפועל. במפות וקטורי, השיטה הזו מגדירה את הטיה ואת הכיוון של המפה לערכי ברירת המחדל של אפס. קריאה לשיטה הזו עשויה לגרום לאנימציה חלקה בזמן שהמפה מתמקדת ומגדילה כדי להתאים לגבולות. ההחלטה אם השיטה הזו תיצור אנימציה תלויה בהיוריסטיקה פנימית.
`getBounds`	`getBounds()` פרמטרים: ללא ערך המובהק: `LatLngBounds\|undefined` גבולות קו הרוחב/קו האורך של אזור התצוגה הנוכחי. הפונקציה מחזירה את גבולות קו הרוחב/קו האורך של אזור התצוגה הנוכחי. אם מוצגים יותר מעתק אחד של העולם, טווח קו האורך הוא מ-180 מעלות ועד -180 מעלות, כולל. אם המפה עדיין לא אתחולה או שלא הוגדרו מיקום מרכזי ומרחק התצוגה, התוצאה היא `undefined`. במפות וקטוריות עם הטיה או כיוון שאינם אפס, גבולות קו הרוחב/קו האורך שמוחזרים מייצגים את תיבת הגבול הקטנה ביותר שכוללת את האזור הגלוי של אזור התצוגה של המפה. במאמר `MapCanvasProjection.getVisibleRegion` מוסבר איך לקבל את האזור המדויק שגלוי בחלון התצוגה של המפה.
`getCenter`	`getCenter()` פרמטרים: ללא ערך המוחזר: `LatLng\|undefined` הפונקציה מחזירה את המיקום שמוצג במרכז המפה. שימו לב שהאובייקט `LatLng` לא עטוף. מידע נוסף זמין בכתובת `LatLng`. אם לא הגדרתם את המרכז או את הגבולות, התוצאה תהיה `undefined`.
`getClickableIcons`	`getClickableIcons()` פרמטרים: ללא ערך המוחזר: `boolean\|undefined` הפונקציה מחזירה את האפשרות ללחוץ על הסמלים במפה. סמל מפה מייצג נקודת עניין, שנקראת גם 'נקודת עניין'. אם הערך המוחזר הוא `true`, אפשר ללחוץ על הסמלים במפה.
`getDatasetFeatureLayer`	הערה: התכונה זמינה רק בערוץ v=beta. `getDatasetFeatureLayer(datasetId)` פרמטרים: `datasetId`: `string` ערך המוחזר: `FeatureLayer` הפונקציה מחזירה את הערך של `FeatureLayer` עבור `datasetId` שצוין. צריך להגדיר את מזהי מערכי הנתונים במסוף Google Cloud. אם מזהה מערך הנתונים לא משויך לסגנון המפה, או אם סגנון מבוסס-נתונים לא זמין (אין מזהה מפה, אין משבצות וקטורים, אין שכבות תכונות או מערכי נתונים של סגנון מבוסס-נתונים שהוגדרו בסגנון המפה), תירשם ביומן שגיאה והערך של `FeatureLayer.isAvailable` יהיה false.
`getDiv`	`getDiv()` פרמטרים: ללא ערך המובהק: `HTMLElement` ה-mapDiv של המפה.
`getFeatureLayer`	`getFeatureLayer(featureType)` פרמטרים: `featureType`: `FeatureType` ערך המוחזר: `FeatureLayer` הפונקציה מחזירה את הערך של `FeatureLayer` של `FeatureType` הספציפי. צריך להפעיל את `FeatureLayer` במסוף Google Cloud. אם `FeatureLayer` של `FeatureType` שצוין לא קיים במפה הזו, או אם העיצוב מבוסס-הנתונים לא זמין (אין מזהה מפה, אין משבצות וקטורים ואין `FeatureLayer` מופעל בסגנון המפה), תירשם שגיאה ביומן והערך של `FeatureLayer.isAvailable` שייווצר יהיה false.
`getHeading`	`getHeading()` פרמטרים: ללא ערך המוחזר: `number\|undefined` הפונקציה מחזירה את כיוון המצפן של המפה. הערך של הכיוון נמדד בדרגות (בכיוון השעון) מכיוון צפון. אם המפה עדיין לא אתחולה, התוצאה תהיה `undefined`.
`getHeadingInteractionEnabled`	`getHeadingInteractionEnabled()` פרמטרים: ללא ערך המוחזר: `boolean\|null` הפונקציה מחזירה את הערך 'true' אם האינטראקציות עם הכותרות מופעלות, או את הערך 'false' אם הן מושבתות. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטורים. אם לא תגדירו את המזהה בקוד, המערכת תשתמש בהגדרה של המזהה בענן (אם היא זמינה).
`getInternalUsageAttributionIds`	`getInternalUsageAttributionIds()` פרמטרים: ללא ערך המוחזר: `Iterable<string>\|null` הפונקציה מחזירה את רשימת מזהי השיוך לשימוש, שעוזרים ל-Google להבין אילו ספריות ודוגמאות מועילות למפתחים, למשל שימוש בספרייה של קיבוץ סמנים.
`getMapCapabilities`	`getMapCapabilities()` פרמטרים: ללא ערך המוחזר: `MapCapabilities` הפונקציה מעדכנת את מבצע הקריאה לגבי היכולות הנוכחיות הזמינות במפה על סמך מזהה המפה שסופק.
`getMapTypeId`	`getMapTypeId()` פרמטרים: ללא ערך המוחזר: `MapTypeId\|string\|undefined`
`getProjection`	`getProjection()` פרמטרים: ללא ערך המוחזר: `Projection\|undefined` הפונקציה מחזירה את הערך הנוכחי של `Projection`. אם המפה עדיין לא אתחולה, התוצאה תהיה `undefined`. מקשיבים לאירוע `projection_changed` ובודקים את הערך שלו כדי לוודא שהוא לא `undefined`.
`getRenderingType`	`getRenderingType()` פרמטרים: ללא ערך המוחזר: `RenderingType` הפונקציה מחזירה את סוג העיבוד הנוכחי של המפה.
`getStreetView`	`getStreetView()` פרמטרים: ללא ערך המחזרה: `StreetViewPanorama` התצוגה הפנורמית שמקושרת למפה. הפונקציה מחזירה את `StreetViewPanorama` שמוגדרת כברירת מחדל ומקושרת למפה. יכול להיות שזו תהיה תמונה פנורמית שמוגדרת כברירת מחדל ומוטמעת במפה, או התמונה הפנורמית שהוגדרה באמצעות `setStreetView()`. שינויים ב-`streetViewControl` של המפה ישתקפו בתצוגה של פנורמה מוגדרת כזו.
`getTilt`	`getTilt()` פרמטרים: ללא ערך המוחזר: `number\|undefined` הפונקציה מחזירה את זווית ההגעה הנוכחית של המפה, במעלות, ממישור חלון התצוגה למישור המפה. במפות רסטר, התוצאה תהיה `0` לתמונות שצולמו ישירות מעל הראש או `45` לתמונות שצולמו בזווית של 45°. השיטה הזו לא מחזירה את הערך שהוגדר על ידי `setTilt`. פרטים נוספים זמינים בכתובת `setTilt`.
`getTiltInteractionEnabled`	`getTiltInteractionEnabled()` פרמטרים: ללא ערך המוחזר: `boolean\|null` הפונקציה מחזירה את הערך 'true' אם אינטראקציות של הטיה מופעלות, או את הערך 'false' אם הן מושבתות. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטורים. אם לא תגדירו את המזהה בקוד, המערכת תשתמש בהגדרה של המזהה בענן (אם היא זמינה).
`getZoom`	`getZoom()` פרמטרים: ללא ערך המוחזר: `number\|undefined` הפונקציה מחזירה את מרחק התצוגה של המפה. אם לא הגדרתם את הזום, התוצאה תהיה `undefined`.
`moveCamera`	`moveCamera(cameraOptions)` פרמטרים: `cameraOptions`: `CameraOptions` ערך המוחזר: None מגדיר באופן מיידי את מצלמת המפה לאפשרויות המצלמה של היעד, ללא אנימציה.
`panBy`	`panBy(x, y)` פרמטרים: `x`: `number` מספר הפיקסלים להזזת המפה בכיוון x. `y`: `number` מספר הפיקסלים להזזת המפה בכיוון y. ערך המוחזר: None שינוי מרכז המפה לפי המרחק שצוין בפיקסלים. אם המרחק קטן מהרוחב ומהגובה של המפה, המעבר יתבצע עם אנימציה חלקה. שימו לב שמערכת הקואורדינטות של המפה עולה ממערב למזרח (לערכים של x) ומצפון לדרום (לערכים של y).
`panTo`	`panTo(latLng)` פרמטרים: `latLng`: `LatLng\|LatLngLiteral` קו הרוחב/קו האורך החדשים של מרכז המפה. ערך המוחזר: None שינוי מרכז המפה ל-`LatLng` שצוין. אם השינוי קטן מהרוחב ומהגובה של המפה, המעבר יתבצע עם אנימציה חלקה.
`panToBounds`	`panToBounds(latLngBounds[, padding])` פרמטרים: `latLngBounds`: `LatLngBounds\|LatLngBoundsLiteral` הגבולות שאליהם רוצים להזיז את המפה. `padding`: `number\|Padding optional` רווח בפסקה בפיקסלים. ערך מספרי יניב את אותו הוספת רווח לכל 4 הצדדים. ערך ברירת המחדל הוא 0. ערך המוחזר: None המערכת מזיזה את המפה בתנועת החלקה (pan) במרחק המינימלי הנדרש כדי לכלול את `LatLngBounds` הנתון. אין ערובה למיקום של הגבולות במפה, מלבד העובדה שהמפה תזוז כדי להציג כמה שיותר מהגבולות בתוך `{currentMapSizeInPx} - {padding}`. גם במפות רסטר וגם במפות וקטורים, מרחק התצוגה, ההטיה והכיוון של המפה לא ישתנו.
`setCenter`	`setCenter(latlng)` פרמטרים: `latlng`: `LatLng\|LatLngLiteral` ערך המוחזר: None
`setClickableIcons`	`setClickableIcons(value)` פרמטרים: `value`: `boolean` ערך המוחזר: None קובע אם אפשר ללחוץ על הסמלים במפה או לא. סמל מפה מייצג נקודת עניין, שנקראת גם 'נקודת עניין'. כדי להשבית את האפשרות ללחוץ על סמלי המפה, מעבירים לערך של השיטה הזו את הערך `false`.
`setHeading`	`setHeading(heading)` פרמטרים: `heading`: `number` ערך המוחזר: None הגדרת כיוון המצפן למפה, שנמדד בזוויות מכיוון צפון. במפות רסטר, השיטה הזו חלה רק על תמונות אוויר.
`setHeadingInteractionEnabled`	`setHeadingInteractionEnabled(headingInteractionEnabled)` פרמטרים: `headingInteractionEnabled`: `boolean` ערך המוחזר: None ההגדרה קובעת אם האינטראקציות עם הכותרות מופעלות. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטורים. אם לא תגדירו את המזהה בקוד, המערכת תשתמש בהגדרה של המזהה בענן (אם היא זמינה).
`setMapTypeId`	`setMapTypeId(mapTypeId)` פרמטרים: `mapTypeId`: `MapTypeId\|string` ערך המוחזר: None
`setOptions`	`setOptions(options)` פרמטרים: `options`: `MapOptions optional` ערך המוחזר: None
`setRenderingType`	`setRenderingType(renderingType)` פרמטרים: `renderingType`: `RenderingType` ערך המוחזר: None הגדרת RenderingType הנוכחי של המפה.
`setStreetView`	`setStreetView(panorama)` פרמטרים: `panorama`: `StreetViewPanorama optional` התמונה הפנורמית שרוצים לקשר למפה. ערך המוחזר: None קישור של `StreetViewPanorama` למפה. התמונה הפנורמית הזו מבטלת את ברירת המחדל `StreetViewPanorama` ומאפשרת למפה להתחבר לתמונה פנורמית חיצונית מחוץ למפה. הגדרת התצוגה הפנורמית לערך `null` מקשרת חזרה למפה את התצוגה הפנורמית המוטמעת שמוגדרת כברירת מחדל.
`setTilt`	`setTilt(tilt)` פרמטרים: `tilt`: `number` ערך המוחזר: None במפות וקטורים, מגדיר את זווית המגע של המפה. הערכים המותרים מוגבלים בהתאם לרמת הזום של המפה. במפות רסטר, קובע את אופן המעבר האוטומטי של זווית המקרן של המפה. הערכים המותרים היחידים הם `0` ו-`45`. `setTilt(0)` גורם לכך שבמפה תמיד תהיה תצוגה ממעוף גבוה בזווית 0°, ללא קשר לרמת הזום ולתצוגה במסך. `setTilt(45)` גורם לזווית ההטיה לעבור באופן אוטומטי ל-45 בכל פעם שתמונות מזווית של 45° זמינות ברמת הזום הנוכחית ובתצוגת המסך הנוכחית, ולחזור ל-0 בכל פעם שתמונות מזווית של 45° לא זמינות (זוהי התנהגות ברירת המחדל). תמונות מזווית של 45° זמינות רק בסוגי המפה `satellite` ו-`hybrid`, במיקומים מסוימים ובמרחבי התצוגה מסוימים. הערה: הפונקציה `getTilt` מחזירה את זווית ההטיה הנוכחית, ולא את הערך שהוגדר על ידי `setTilt`. מאחר ש-`getTilt` ו-`setTilt` מתייחסים לדברים שונים, אין `bind()` את המאפיין `tilt`. הפעולה הזו עלולה לגרום לתוצאות בלתי צפויות.
`setTiltInteractionEnabled`	`setTiltInteractionEnabled(tiltInteractionEnabled)` פרמטרים: `tiltInteractionEnabled`: `boolean` ערך המוחזר: None הגדרה שמציינת אם האינטראקציות עם הטיה מופעלות. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטורים. אם לא תגדירו את המזהה בקוד, המערכת תשתמש בהגדרה של המזהה בענן (אם היא זמינה).
`setZoom`	`setZoom(zoom)` פרמטרים: `zoom`: `number` ערכי זום גדולים יותר מתאימים לרזולוציה גבוהה יותר. ערך המוחזר: None הגדרת מרחק התצוגה במפה.
עובר בירושה: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

אירועים
`bounds_changed`	`function()` ארגומנטים: None האירוע הזה מופעל כשגבולות שדה התצוגה משתנים.
`center_changed`	`function()` ארגומנטים: None האירוע הזה מופעל כשהנכס של מרכז המפה משתנה.
`click`	`function(event)` ארגומנטים: `event`: `MapMouseEvent\|IconMouseEvent` האירוע הזה מופעל כשהמשתמש לוחץ על המפה. המערכת מחזירה אירוע MapMouseEvent עם מאפיינים של המיקום שבו לוחצים, אלא אם לוחצים על סמל של מקום. במקרה כזה, המערכת מחזירה אירוע IconMouseEvent עם מזהה מקום. האירועים IconMouseEvent ו-MapMouseEvent זהים, מלבד השדה place ID (מזהה מקום) שמופיע ב-IconMouseEvent. תמיד אפשר להתייחס לאירוע כאירוע MapMouseEvent אם מזהה המקום לא חשוב. אירוע הקליק לא יופעל אם לוחצים על סמן או על חלון מידע.
`contextmenu`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשאירוע contextmenu של DOM מופעל במאגר המפה.
`dblclick`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כאשר המשתמש לוחץ לחיצה כפולה על המפה. חשוב לדעת: לפעמים אירוע הקליק יופעל פעם אחת ולפעמים פעמיים, ממש לפני האירוע הזה.
`drag`	`function()` ארגומנטים: None האירוע הזה מופעל שוב ושוב בזמן שהמשתמש גורר את המפה.
`dragend`	`function()` ארגומנטים: None האירוע הזה מופעל כשהמשתמש מפסיק לגרור את המפה. הערה: האירוע dragend לא מופעל כשהמשתמש מפסיק להזיז את המפה באמצעות המקלדת. במקום זאת, יש להשתמש באירוע `Map.idle` כדי לקבוע מתי המשתמש הפסיק להזיז את המפה או לגרור אותה.
`dragstart`	`function()` ארגומנטים: None האירוע הזה מופעל כשהמשתמש מתחיל לגרור את המפה.
`heading_changed`	`function()` ארגומנטים: None האירוע הזה מופעל כשיש שינוי במאפיין הכותרת של המפה.
`idle`	`function()` ארגומנטים: None האירוע הזה מופעל כשהמפה הופכת ללא פעילה אחרי שמזיזים אותה או משנים את מרחק התצוגה.
`isfractionalzoomenabled_changed`	`function()` ארגומנטים: None האירוע הזה מופעל כשהנכס isFractionalZoomEnabled משתנה.
`mapcapabilities_changed`	`function()` ארגומנטים: None האירוע הזה מופעל כשיש שינוי ביכולות המפה.
`maptypeid_changed`	`function()` ארגומנטים: None האירוע הזה מופעל כשיש שינוי במאפיין mapTypeId.
`mousemove`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל בכל פעם שהעכבר של המשתמש נע מעל מאגר המפות.
`mouseout`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהעכבר של המשתמש יוצא ממסגרת המפה.
`mouseover`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהעכבר של המשתמש נכנס למאגר המפות.
`projection_changed`	`function()` ארגומנטים: None האירוע הזה מופעל כשהתצוגה משתנה.
`renderingtype_changed`	`function()` ארגומנטים: None האירוע הזה מופעל כשהערך של renderingType משתנה.
`tilesloaded`	`function()` ארגומנטים: None האירוע הזה מופעל כשהמטרות הנראות מסתיימות לטעינת.
`tilt_changed`	`function()` ארגומנטים: None האירוע הזה מופעל כשהתכונה 'הטיה של המפה' משתנה.
`zoom_changed`	`function()` ארגומנטים: None האירוע הזה מופעל כשהנכס של מרחק התצוגה במפה משתנה.
`rightclick`	האירוע הוצא משימוש: במקום זאת, צריך להשתמש באירוע `Map.contextmenu` כדי לתמוך בדפוסי שימוש כמו לחיצה עם לחצן ה-Control ב-macOS. `function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהמשתמש לוחץ לחיצה ימנית על המפה.

הממשק MapOptions

ממשק google.maps.MapOptions

אובייקט MapOptions שמשמש להגדרת המאפיינים שאפשר להגדיר במפה.

מאפיינים
`backgroundColor optional`	סוג: `string optional` הצבע שמשמש לרקע של ה-div של המפה. הצבע הזה יהיה גלוי כשהמשתמשים מזיזים את המפה ואריחי המפה עדיין לא נטענו. אפשר להגדיר את האפשרות הזו רק כשמפעילים את המפה.
`cameraControl optional`	סוג: `boolean optional` המצב המופעל/מושבת של אמצעי הבקרה של המצלמה.
`cameraControlOptions optional`	סוג: `CameraControlOptions optional` אפשרויות התצוגה של אמצעי הבקרה של המצלמה.
`center optional`	סוג: `LatLng\|LatLngLiteral optional` מרכז המפה הראשוני.
`clickableIcons optional`	סוג: `boolean optional` ברירת מחדל: `true` כשהסמל `false` מופיע, אי אפשר ללחוץ על הסמלים במפה. סמל מפה מייצג נקודת עניין, שנקראת גם 'נקודת עניין'.
`colorScheme optional`	סוג: `ColorScheme\|string optional` ברירת מחדל: `ColorScheme.LIGHT` ערכת הצבעים הראשונית של המפה. אפשר להגדיר את האפשרות הזו רק כשמפעילים את המפה.
`controlSize optional`	סוג: `number optional` הגודל בפיקסלים של הפקדים שמופיעים במפה. צריך לספק את הערך הזה ישירות כשיוצרים את המפה. עדכון הערך הזה בשלב מאוחר יותר עלול להעביר את אמצעי הבקרה למצב `undefined`. חלה רק על אמצעי הבקרה שנוצרו על ידי Maps API עצמו. לא מתבצעת התאמה לעומס של אמצעי בקרה מותאמים אישית שנוצרו על ידי מפתחים.
`disableDefaultUI optional`	סוג: `boolean optional` הפעלה או השבתה של כל לחצני ממשק המשתמש שמוגדרים כברירת מחדל. אפשר לשנות אותם בנפרד. לא משביתה את אמצעי הבקרה במקלדת, ששולטים בהם בנפרד באמצעות האפשרות `MapOptions.keyboardShortcuts`. לא משביתה את אמצעי הבקרה באמצעות תנועות, ששולטים בהם בנפרד באמצעות האפשרות `MapOptions.gestureHandling`.
`disableDoubleClickZoom optional`	סוג: `boolean optional` הפעלה/השבתה של התכונה 'הגדלת התצוגה והתמקדות בה לחיצה כפולה'. מופעלת כברירת מחדל. הערה: לא מומלץ להשתמש במאפיין הזה. כדי להשבית את התכונה של התכווננות באמצעות לחיצה כפולה, אפשר להשתמש בנכס `gestureHandling` ולהגדיר אותו כ-`"none"`.
`draggable optional`	הוצא משימוש: הוצא משימוש בשנת 2017. כדי להשבית את האפשרות לגרור את המפה, אפשר להשתמש במאפיין `gestureHandling` ולהגדיר אותו כ-`"none"`. סוג: `boolean optional` אם הערך הוא `false`, לא ניתן יהיה לגרור את המפה. האפשרות לגרירה מופעלת כברירת מחדל.
`draggableCursor optional`	סוג: `string optional` השם או כתובת ה-URL של הסמן שיוצג כשמציבים את העכבר מעל מפה שניתן לגרירה. בנכס הזה נעשה שימוש במאפיין ה-CSS `cursor` כדי לשנות את הסמל. בדומה למאפיין ה-CSS, צריך לציין לפחות סמן אחד לגיבוי שאינו כתובת URL. לדוגמה: `draggableCursor: 'url(http://www.example.com/icon.png), auto;'`.
`draggingCursor optional`	סוג: `string optional` השם או כתובת ה-URL של הסמן שיוצג כשגוררים את המפה. בנכס הזה נעשה שימוש במאפיין ה-CSS `cursor` כדי לשנות את הסמל. בדומה למאפיין ה-CSS, צריך לציין לפחות סמן אחד לגיבוי שאינו כתובת URL. לדוגמה: `draggingCursor: 'url(http://www.example.com/icon.png), auto;'`.
`fullscreenControl optional`	סוג: `boolean optional` המצב המופעל/מושבת של הלחצן למסך מלא.
`fullscreenControlOptions optional`	סוג: `FullscreenControlOptions optional` אפשרויות התצוגה של הלחצן 'מסך מלא'.
`gestureHandling optional`	סוג: `string optional` ההגדרה הזו קובעת איך ה-API מטפל בתנועות במפה. הערכים המותרים: `"cooperative"`: אירועי גלילה ותנועות מגע באצבע אחת מאפשרות לגלול בדף, אבל לא לשנות את מרחק התצוגה או להזיז את המפה. תנועות מגע בשתי אצבעות מאפשרות להזיז את המפה ולשנות את מרחק התצוגה. כדי לגלול באירועים, לוחצים על מקש Ctrl או על מקש ⌘ כדי להגדיל את המפה. במצב הזה, המפה פועלת בשיתוף פעולה עם הדף. `"greedy"`: כל תנועות המגע ואירועי הגלילה מאפשרים להזיז את המפה או לשנות את רמת התצוגה שלה. `"none"`: לא ניתן להזיז את המפה או לשנות את מרחק התצוגה באמצעות תנועות של המשתמש. `"auto"`: (ברירת המחדל) טיפול בתנועות הוא שיתופי או חמדן, בהתאם לכך אם הדף ניתן לגלילה או שהוא ב-iframe.
`heading optional`	סוג: `number optional` הכיוון של תמונות אוויר במעלות, נמדד בכיוון השעון מכיוון צפון. הכותרות מוצמדות לזווית הקרובה ביותר שזמינה לתמונות.
`headingInteractionEnabled optional`	סוג: `boolean optional` ברירת מחדל: `false` אם המשתמש יוכל לשלוט בכיוון המצלמה (רוטציה) במפה. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטורים. אם לא תגדירו את המזהה בקוד, המערכת תשתמש בהגדרה של המזהה בענן (אם היא זמינה).
`internalUsageAttributionIds optional`	סוג: `Iterable<string> optional` ברירת מחדל: `null` הוספת מזהה שיוך לשימוש למפעיל (initializer), שעוזר ל-Google להבין אילו ספריות ודוגמאות מועילות למפתחים, כמו שימוש בספרייה של קיבוץ סמנים. כדי לבטל את ההסכמה לשליחת מזהה השיוך לשימוש, אפשר למחוק את המאפיין הזה או להחליף את הערך במחרוזת ריקה. יישלחו רק ערכים ייחודיים. יכול להיות שהמערכת תתעלם משינויים בערך הזה אחרי היצירה.
`isFractionalZoomEnabled optional`	סוג: `boolean optional` ברירת מחדל: `true` למפות וקטוריות ו-`false` למפות רסטר האם המפה תאפשר רמות זום חלקיות. כדי לדעת מתי ברירת המחדל הוגדרה, אפשר להאזין ל-`isfractionalzoomenabled_changed`.
`keyboardShortcuts optional`	סוג: `boolean optional` אם הערך הוא `false`, לא ניתן לשלוט במפה באמצעות המקלדת. מקשי הקיצור מופעלים כברירת מחדל.
`mapId optional`	סוג: `string optional` מזהה המפה. אי אפשר להגדיר או לשנות את הפרמטר הזה אחרי שיוצרים מופע של מפה. אפשר להשתמש ב-`Map.DEMO_MAP_ID` כדי לנסות תכונות שדורשות מזהה מפה אבל לא דורשות הפעלה בענן.
`mapTypeControl optional`	סוג: `boolean optional` המצב הראשוני של הכלי להגדרת סוג המפה (מופעל/מושבת).
`mapTypeControlOptions optional`	סוג: `MapTypeControlOptions optional` אפשרויות התצוגה הראשוניות של הפקדים של סוג המפה.
`mapTypeId optional`	סוג: `MapTypeId\|string optional` mapTypeId הראשוני של המפה. ברירת המחדל היא `ROADMAP`.
`maxZoom optional`	סוג: `number optional` רמת הזום המקסימלית שתוצג במפה. אם השדה הזה לא יצוין או ימולא ב-`null`, המערכת תשתמש במקום זאת בהגדרת הזום המקסימלית של סוג המפה הנוכחי. הערכים החוקיים של מרחק התצוגה הם מספרים מ-0 ועד רמת הזום המקסימלית הנתמכת.
`minZoom optional`	סוג: `number optional` מרחק התצוגה המינימלי שיוצג במפה. אם השדה הזה לא יצוין או ימולא ב-`null`, המערכת תשתמש במקום זאת בהגדרת הזום המינימלית של סוג המפה הנוכחי. הערכים החוקיים של מרחק התצוגה הם מספרים מ-0 ועד רמת הזום המקסימלית הנתמכת.
`noClear optional`	סוג: `boolean optional` אם הערך של `true` הוא true, לא צריך לנקות את התוכן של ה-div של המפה.
`panControl optional`	הוצא משימוש: אמצעי הבקרה להזזה הוצא משימוש בספטמבר 2015. סוג: `boolean optional` המצב המופעל/מושבת של לחצן ההזזה.
`panControlOptions optional`	הוצא משימוש: אמצעי הבקרה להזזה הוצא משימוש בספטמבר 2015. סוג: `PanControlOptions optional` אפשרויות התצוגה של לחצן ההזזה.
`renderingType optional`	סוג: `RenderingType optional` ברירת מחדל: `RenderingType.RASTER` האם המפה צריכה להיות מפה רסטר או מפה וקטורית. אי אפשר להגדיר או לשנות את הפרמטר הזה אחרי שיוצרים מופע של מפה. אם לא תגדירו את הערך, סוג הרינדור (אם הוא זמין) ייקבע לפי ההגדרה בענן של מזהה המפה. חשוב לדעת: יכול להיות שמפות וקטורים לא יהיו זמינות בכל המכשירים והדפדפנים, והמפה תעבור למפה רסטר לפי הצורך.
`restriction optional`	סוג: `MapRestriction optional` הגדרת גבול שמגביל את האזור במפה שזמין למשתמשים. כשמגדירים גבולות, המשתמש יכול להזיז את התצוגה ולבצע זום רק כשהיא נשארת בתוך גבולות השטח.
`rotateControl optional`	סוג: `boolean optional` המצב המופעל/מושבת של הלחצן 'סיבוב'.
`rotateControlOptions optional`	סוג: `RotateControlOptions optional` אפשרויות התצוגה של אמצעי הבקרה 'סיבוב'.
`scaleControl optional`	סוג: `boolean optional` המצב הראשוני של הלחצן Scale (התאמה) – מופעל או מושבת.
`scaleControlOptions optional`	סוג: `ScaleControlOptions optional` אפשרויות התצוגה הראשוניות של אמצעי הבקרה Scale.
`scrollwheel optional`	סוג: `boolean optional` אם הערך הוא `false`, אי אפשר לשנות את מרחק התצוגה במפה באמצעות גלגל הגלילה של העכבר. גלגלת הגלילה מופעלת כברירת מחדל. הערה: לא מומלץ להשתמש במאפיין הזה. כדי להשבית את שינוי מרחק התצוגה באמצעות גלגלת הגלילה, אפשר להשתמש במאפיין `gestureHandling` ולהגדיר אותו ל-`"cooperative"` או ל-`"none"`.
`streetView optional`	סוג: `StreetViewPanorama optional` `StreetViewPanorama` להצגה כשאטב-האיש של Street View מושלך על המפה. אם לא צוינה תמונה פנורמית, `StreetViewPanorama` ברירת המחדל יוצג ב-`div` של המפה כשהסיכה תיפול.
`streetViewControl optional`	סוג: `boolean optional` המצב הראשוני (מופעל/מושבת) של אטב-האיש של Street View. הלחצן הזה הוא חלק מממשק המשתמש שמוגדר כברירת מחדל, וצריך להגדיר אותו לערך `false` כשמציגים סוג מפה שבו שכבת-העל של הכביש ב-Street View לא אמורה להופיע (למשל, סוג מפה שאינו מפות Earth).
`streetViewControlOptions optional`	סוג: `StreetViewControlOptions optional` אפשרויות התצוגה הראשוניות של אטב-האיש של Street View.
`styles optional`	סוג: `Array<MapTypeStyle> optional` סגנונות שיחולו על כל אחד מסוגי המפות שמוגדרים כברירת מחדל. חשוב לזכור שבמצבים `satellite`/`hybrid` ו-`terrain`, הסגנונות האלה יחולו רק על תוויות ועל גיאומטריה. התכונה הזו לא זמינה כשמשתמשים במזהה מפה או במפות וקטוריות (במקום זאת, צריך להשתמש בעיצוב של מפות מבוססות-ענן).
`tilt optional`	סוג: `number optional` במפות וקטורים, מגדיר את זווית המגע של המפה. הערכים המותרים מוגבלים בהתאם לרמת הזום של המפה. במפות רסטר, קובע את התנהגות המעבר האוטומטי של זווית המקרן של המפה. הערכים המותרים היחידים הם `0` ו-`45`. הערך `0` גורם לכך שבמפה תמיד תהיה תצוגה ממעוף גבוה בזווית 0°, ללא קשר לרמת הזום ולתצוגה בחלון. הערך `45` גורם לכך שזווית ההטיה תעבור באופן אוטומטי ל-45 בכל פעם שתמונות בזווית 45° זמינות ברמת הזום הנוכחית ובתצוגת המסך הנוכחית, ותעבור חזרה ל-0 בכל פעם שתמונות בזווית 45° לא זמינות (זוהי התנהגות ברירת המחדל). תמונות מזווית של 45° זמינות רק בסוגי המפה `satellite` ו-`hybrid`, במיקומים מסוימים ובמרחבי התצוגה מסוימים. הערה: הפונקציה `getTilt` מחזירה את זווית ההטיה הנוכחית, ולא את הערך שצוין באפשרות הזו. מכיוון שהאפשרות הזו והאפשרות `getTilt` מתייחסות לדברים שונים, אל תגדירו את המאפיין `tilt` כ-`bind()`. הפעולה הזו עלולה לגרום לתוצאות בלתי צפויות.
`tiltInteractionEnabled optional`	סוג: `boolean optional` ברירת מחדל: `false` אם המשתמש יוכל לשנות את הטיה המצלמה במפה. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטורים. אם לא תגדירו את המזהה בקוד, המערכת תשתמש בהגדרה של המזהה בענן (אם היא זמינה).
`zoom optional`	סוג: `number optional` רמת הזום הראשונית של המפה. הערכים החוקיים של מרחק התצוגה הם מספרים מ-0 ועד רמת הזום המקסימלית הנתמכת. ערכים גדולים יותר של זום מתאימים לרזולוציה גבוהה יותר.
`zoomControl optional`	סוג: `boolean optional` המצב המופעל/מושבת של אמצעי הבקרה של שינוי המרחק מהתצוגה.
`zoomControlOptions optional`	סוג: `ZoomControlOptions optional` אפשרויות התצוגה של פקדי המרחק מהתצוגה.

הכיתה MapElement

google.maps.MapElement class

MapElement הוא תת-סוג של HTMLElement לעיבוד מפות. אחרי טעינת הספרייה maps, אפשר ליצור מפה ב-HTML. לדוגמה:

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>

באופן פנימי, הוא משתמש ב-Map, שאפשר לגשת אליו באמצעות המאפיין innerMap.

רכיב מותאם אישית:
<gmp-map center="lat,lng" heading-interaction-disabled internal-usage-attribution-ids="id1 id2" map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>

הכיתה הזו היא תת-מחלקה של HTMLElement.

המחלקה הזו מטמיעה את MapElementOptions.

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

יצרן
`MapElement`	`MapElement([options])` פרמטרים: `options`: `MapElementOptions optional`

מאפיינים
`center`	סוג: `LatLng\|LatLngLiteral optional` קו הרוחב/קו האורך של מרכז המפה. מאפיין HTML: `<gmp-map center="lat,lng"></gmp-map>`
`headingInteractionDisabled`	סוג: `boolean optional` ברירת מחדל: `false` אם המשתמש יוכל לשלוט בכיוון המצלמה (רוטציה) במפה. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטורים. אם לא תגדירו את המזהה בקוד, המערכת תשתמש בהגדרה של המזהה בענן (אם היא זמינה). מאפיין HTML: `<gmp-map heading-interaction-disabled></gmp-map>`
`innerMap`	סוג: `Map` הפניה ל-`Map` שבו MapElement משתמש באופן פנימי.
`internalUsageAttributionIds`	סוג: `Iterable<string> optional` ברירת מחדל: `null` הוספת מזהה שיוך לשימוש למפעיל (initializer), שעוזר ל-Google להבין אילו ספריות ודוגמאות מועילות למפתחים, כמו שימוש בספרייה של קיבוץ סמנים. כדי לבטל את ההסכמה לשליחת מזהה השיוך לשימוש, אפשר למחוק את המאפיין הזה או להחליף את הערך במחרוזת ריקה. יישלחו רק ערכים ייחודיים. יכול להיות שהמערכת תתעלם משינויים בערך הזה אחרי היצירה. מאפיין HTML: `<gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>`
`mapId`	סוג: `string optional` מזהה המפה. אי אפשר להגדיר או לשנות את הפרמטר הזה אחרי שיוצרים מופע של מפה. אפשר להשתמש ב-`Map.DEMO_MAP_ID` כדי לנסות תכונות שדורשות מזהה מפה אבל לא דורשות הפעלה בענן. מאפיין HTML: `<gmp-map map-id="string"></gmp-map>`
`renderingType`	סוג: `RenderingType optional` ברירת מחדל: `RenderingType.VECTOR` האם המפה צריכה להיות מפה רסטר או מפה וקטורית. אי אפשר להגדיר או לשנות את הפרמטר הזה אחרי שיוצרים מופע של מפה. אם לא תגדירו את הערך, סוג הרינדור (אם הוא זמין) ייקבע לפי ההגדרה בענן של מזהה המפה. חשוב לדעת: יכול להיות שמפות וקטורים לא יהיו זמינות בכל המכשירים והדפדפנים, והמפה תעבור למפה רסטר לפי הצורך. מאפיין HTML: `<gmp-map rendering-type="vector"></gmp-map>` `<gmp-map rendering-type="raster"></gmp-map>`
`tiltInteractionDisabled`	סוג: `boolean optional` ברירת מחדל: `false` אם המשתמש יוכל לשנות את הטיה המצלמה במפה. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטורים. אם לא תגדירו את המזהה בקוד, המערכת תשתמש בהגדרה של המזהה בענן (אם היא זמינה). מאפיין HTML: `<gmp-map tilt-interaction-disabled></gmp-map>`
`zoom`	סוג: `number optional` רמת הזום של המפה. הערכים החוקיים של מרחק התצוגה הם מספרים מ-0 ועד רמת הזום המקסימלית הנתמכת. ערכים גדולים יותר של זום מתאימים לרזולוציה גבוהה יותר. מאפיין HTML: `<gmp-map zoom="number"></gmp-map>`

מכונות מזל
`control-block-end-inline-center`	הרכיב בחריץ ממוקם במיקום `ControlPosition.BLOCK_END_INLINE_CENTER`.
`control-block-end-inline-end`	הרכיב בחריץ ממוקם במיקום `ControlPosition.BLOCK_END_INLINE_END`.
`control-block-end-inline-start`	הרכיב בחריץ ממוקם במיקום `ControlPosition.BLOCK_END_INLINE_START`.
`control-block-start-inline-center`	הרכיב בחריץ ממוקם במיקום `ControlPosition.BLOCK_START_INLINE_CENTER`.
`control-block-start-inline-end`	הרכיב בחריץ ממוקם במיקום `ControlPosition.BLOCK_START_INLINE_END`.
`control-block-start-inline-start`	הרכיב בחריץ ממוקם במיקום `ControlPosition.BLOCK_START_INLINE_START`.
`control-inline-end-block-center`	הרכיב בחריץ ממוקם במיקום `ControlPosition.INLINE_END_BLOCK_CENTER`.
`control-inline-end-block-end`	הרכיב בחריץ ממוקם במיקום `ControlPosition.INLINE_END_BLOCK_END`.
`control-inline-end-block-start`	הרכיב בחריץ ממוקם במיקום `ControlPosition.INLINE_END_BLOCK_START`.
`control-inline-start-block-center`	הרכיב בחריץ ממוקם במיקום `ControlPosition.INLINE_START_BLOCK_CENTER`.
`control-inline-start-block-end`	הרכיב בחריץ ממוקם במיקום `ControlPosition.INLINE_START_BLOCK_END`.
`control-inline-start-block-start`	הרכיב בחריץ ממוקם במיקום `ControlPosition.INLINE_START_BLOCK_START`.
`default`	אפשר ליצור רכיבים לשימוש חוזר סביב רכיבי ה-Web של JavaScript של מפות Google, כמו `AdvancedMarkerElement`, באמצעות רכיבים מותאמים אישית. כברירת מחדל, רכיבים מותאמים אישית שנוספו ישירות ל-`MapElement` ימוקמו ב-`MapPanes.overlayMouseTarget` ויעבדו (render) בו. עם זאת, אפשר להקצות מחדש את רכיבי Web Components של Maps JavaScript API לחריצים הפנימיים של `MapElement`.

Methods
`addEventListener`	הערה: התכונה זמינה רק בערוץ v=beta. `addEventListener(type, listener[, options])` פרמטרים: `type`: `string` מחרוזת רגישה לאותיות רישיות שמייצגת את סוג האירוע שרוצים להאזין לו. `listener`: `EventListener\|EventListenerObject` האובייקט שמקבל התראה. זה חייב להיות פונקציה או אובייקט עם שיטת handleEvent `options`: `boolean\|AddEventListenerOptions optional` אפשר לעיין באפשרויות. אירועים מותאמים אישית תומכים רק ב-`capture` וב-`passive`. ערך המוחזר: `void` הגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener
`removeEventListener`	הערה: התכונה זמינה רק בערוץ v=beta. `removeEventListener(type, listener[, options])` פרמטרים: `type`: `string` מחרוזת שמציינת את סוג האירוע שעבורו רוצים להסיר את מאזין האירועים. `listener`: `EventListener\|EventListenerObject` ה-event listener של גורם הטיפול באירוע שרוצים להסיר מיעד האירוע. `options`: `boolean\|EventListenerOptions optional` אפשר לעיין באפשרויות ערך המוחזר: `void` הסרת רכיב מעקב אירועים שרשום קודם לכן באמצעות addEventListener מהיעד. מידע נוסף זמין במאמר removeEventListener

Methods

addEventListener

addEventListener(type, listener[, options])

פרמטרים:

type: string מחרוזת רגישה לאותיות רישיות שמייצגת את סוג האירוע שרוצים להאזין לו.
listener: EventListener|EventListenerObject האובייקט שמקבל התראה. זה חייב להיות פונקציה או אובייקט עם שיטת handleEvent
options: boolean|AddEventListenerOptions optional אפשר לעיין באפשרויות. אירועים מותאמים אישית תומכים רק ב-capture וב-passive.

ערך המוחזר: void

הגדרת פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener

removeEventListener

removeEventListener(type, listener[, options])

פרמטרים:

type: string מחרוזת שמציינת את סוג האירוע שעבורו רוצים להסיר את מאזין האירועים.
listener: EventListener|EventListenerObject ה-event listener של גורם הטיפול באירוע שרוצים להסיר מיעד האירוע.
options: boolean|EventListenerOptions optional אפשר לעיין באפשרויות

ערך המוחזר: void

הסרת רכיב מעקב אירועים שרשום קודם לכן באמצעות addEventListener מהיעד. מידע נוסף זמין במאמר removeEventListener

אירועים
`gmp-zoomchange`	`function(event)` ארגומנטים: `event`: `ZoomChangeEvent` האירוע הזה מופעל כשהנכס של מרחק התצוגה במפה משתנה.

הממשק MapElementOptions

ממשק google.maps.MapElementOptions

אובייקט MapElementOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-MapElement.

מאפיינים
`center optional`	סוג: `LatLng\|LatLngLiteral optional` `MapElement.center`.
`headingInteractionDisabled optional`	סוג: `boolean optional` `MapElement.headingInteractionDisabled`.
`internalUsageAttributionIds optional`	סוג: `Iterable<string> optional` `MapElement.internalUsageAttributionIds`.
`mapId optional`	סוג: `string optional` `MapElement.mapId`.
`renderingType optional`	סוג: `RenderingType optional` `MapElement.renderingType`.
`tiltInteractionDisabled optional`	סוג: `boolean optional` `MapElement.tiltInteractionDisabled`.
`zoom optional`	סוג: `number optional` `MapElement.zoom`.

הכיתה ZoomChangeEvent

google.maps.ZoomChangeEvent class

האירוע הזה נוצר במסגרת מעקב אחר שינוי מרחק התצוגה.

הכיתה הזו היא תת-מחלקה של Event.

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

הממשק MapTypeStyle

ממשק google.maps.MapTypeStyle

ה-MapTypeStyle הוא אוסף של סלקטורים וסטיילרים שמגדירים את סגנון המפה. סלקטורים מציינים את התכונות או הרכיבים במפה שרוצים לשנות, וסטיילרים מציינים איך לשנות את התכונות והרכיבים האלה. פרטים נוספים זמינים במאמר העזרה בנושא סגנונות.

מאפיינים
`stylers`	סוג: `Array<Object>` כללי הסגנון שיחולו על התכונות והרכיבים שנבחרו במפה. הכללים יחולו לפי הסדר שציינתם במערך הזה. הנחיות לשימוש ולערכים מותרים מפורטות במאמר העזרה בנושא סגנונות.
`elementType optional`	סוג: `string optional` הרכיב שבו צריך להחיל את הסטיילר. רכיב הוא היבט חזותי של תכונה במפה. דוגמה: תווית, סמל, קו או מילוי שחלים על הגיאומטריה ועוד. זה שינוי אופציונלי. אם לא מציינים את `elementType`, הערך מוגדר כ-`'all'`. פרטים על השימוש ועל הערכים המותרים זמינים במאמרי העזרה בנושא סגנונות.
`featureType optional`	סוג: `string optional` התכונה או קבוצת התכונות שעליהן צריך להחיל את הסטיילר. זה שינוי אופציונלי. אם לא מציינים את `featureType`, הערך מוגדר כ-`'all'`. פרטים על השימוש ועל הערכים המותרים זמינים במאמרי העזרה בנושא סגנונות.

הממשק MapMouseEvent

ממשק google.maps.MapMouseEvent

האובייקט הזה מוחזר מאירועי עכבר שונים במפה ובשכבות-העל, והוא מכיל את כל השדות שמפורטים בהמשך.

מאפיינים
`domEvent`	סוג: `MouseEvent\|TouchEvent\|PointerEvent\|KeyboardEvent\|Event` אירוע ה-DOM המקורי התואם. מפתחים לא צריכים להסתמך על הגדרה ועקביות של המאפיינים `target`, ‏ `currentTarget`, ‏ `relatedTarget` ו-`path`. בנוסף, מפתחים לא צריכים להסתמך על מבנה ה-DOM של ההטמעה הפנימית של Maps API. בגלל מיפוי אירועים פנימי, ל-`domEvent` יכולה להיות סמנטיקה שונה מזו של ה-`MapMouseEvent` (למשל, ל-`MapMouseEvent` 'קליק' יכול להיות `domEvent` מסוג `KeyboardEvent`).
`latLng optional`	סוג: `LatLng optional` קו הרוחב/קו האורך שהיו מתחת לסמן כשהאירוע התרחש.

מאפיינים

domEvent

סוג: MouseEvent|TouchEvent|PointerEvent|KeyboardEvent|Event

אירוע ה-DOM המקורי התואם. מפתחים לא צריכים להסתמך על הגדרה ועקביות של המאפיינים target, ‏ currentTarget, ‏ relatedTarget ו-path. בנוסף, מפתחים לא צריכים להסתמך על מבנה ה-DOM של ההטמעה הפנימית של Maps API. בגלל מיפוי אירועים פנימי, ל-domEvent יכולה להיות סמנטיקה שונה מזו של ה-MapMouseEvent (למשל, ל-MapMouseEvent 'קליק' יכול להיות domEvent מסוג KeyboardEvent).

latLng optional

סוג: LatLng optional

קו הרוחב/קו האורך שהיו מתחת לסמן כשהאירוע התרחש.

Methods
`stop`	`stop()` פרמטרים: ללא ערך המוחזר: `void` מונעת את ההפצה של האירוע הזה.

הממשק IconMouseEvent

ממשק google.maps.IconMouseEvent

האובייקט הזה נשלח באירוע כשמשתמש לוחץ על סמל במפה. מזהה המקום של המקום הזה מאוחסן במאפיין placeId. כדי למנוע את הצגת חלון המידע שמוגדר כברירת מחדל, צריך לבצע קריאה ל-method‏ stop() באירוע הזה כדי למנוע את ההפצה שלו. מידע נוסף על מזהי מקומות זמין במדריך למפתחים של Places API.

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

מאפיינים
`placeId optional`	סוג: `string optional` מזהה המקום של המקום שעליו לחץ המשתמש. אפשר להשתמש במזהה המקום הזה כדי לשלוח שאילתה לקבלת מידע נוסף על התכונה שנלחצה עליה. מידע נוסף על מזהי מקומות זמין במדריך למפתחים של Places API.
עובר בירושה: `domEvent`, `latLng`

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

קבועים של ColorScheme

google.maps.ColorScheme קבועים

מזהים של ערכות צבעים למפות. אפשר לציין אותם לפי ערך או באמצעות שם הקבוע. לדוגמה, 'FOLLOW_SYSTEM' או google.maps.ColorScheme.FOLLOW_SYSTEM.

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

קבועים
`DARK`	ערכת הצבעים הכהה של המפה.
`FOLLOW_SYSTEM`	ערכת הצבעים נבחרת על סמך העדפות המערכת.
`LIGHT`	ערכת הצבעים הבהירה של המפה. ערך ברירת המחדל של גרסה קודמת של Maps JS.

קבועים של MapTypeId

google.maps.MapTypeId קבועים

מזהים של סוגי מפות נפוצים. אפשר לציין אותם לפי ערך או באמצעות שם הקבוע. לדוגמה, 'satellite' או google.maps.MapTypeId.SATELLITE.

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

קבועים
`HYBRID`	בסוג המפה הזה מוצגת שכבה שקופה של רחובות ראשיים בתמונות לוויין.
`ROADMAP`	בסוג המפה הזה מוצגת מפת רחובות רגילה.
`SATELLITE`	בסוג המפה הזה מוצגות תמונות לוויין.
`TERRAIN`	בסוג המפה הזה מוצגות מפות עם תכונות פיזיות כמו פני השטח וצומח.

הכיתה MapTypeRegistry

google.maps.MapTypeRegistry class

מרשם למופעים של MapType, עם מפתחות לפי מזהה MapType.

הכיתה הזו היא תת-מחלקה של MVCObject.

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

יצרן
`MapTypeRegistry`	`MapTypeRegistry()` פרמטרים: ללא השדה `MapTypeRegistry` מכיל את האוסף של סוגי המפות המותאמים אישית שזמינים למפה לשימוש. ה-API מבקש מהרשם הזה מידע, למשל, כשהוא מספק את רשימת סוגי המפות הזמינים באמצעי הבקרה.

Methods
`set`	`set(id, mapType)` פרמטרים: `id`: `string` המזהה של MapType שרוצים להוסיף למרשם. `mapType`: אובייקט MapType מסוג `MapType\|?` שרוצים להוסיף למרשם. ערך המוחזר: None מגדיר את המרשם כך שישייך את מזהה המחרוזת שהועברה ל-MapType שהועברה.
עובר בירושה: `addListener`, `bindTo`, `get`, `notify`, `setValues`, `unbind`, `unbindAll`

הממשק MapRestriction

ממשק google.maps.MapRestriction

הגבלה שאפשר להחיל על המפה. חלון התצוגה של המפה לא יחרוג מהמגבלות האלה.

מאפיינים
`latLngBounds`	סוג: `LatLngBounds\|LatLngBoundsLiteral` כשמגדירים את הגבולות, המשתמש יכול להזיז את התצוגה ולהגדיל או להקטין את התצוגה רק בתוך הגבולות שצוינו. אפשר להגביל את הגבולות גם לאורך וגם לרוחב, או רק לרוחב. כדי לציין גבולות לפי קו רוחב בלבד, צריך להשתמש בקו אורך מערבי ובקו אורך מזרחי של ‎-180 ו-180, בהתאמה. לדוגמה, `latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}`.
`strictBounds optional`	סוג: `boolean optional` כדי להגביל את הגבולות עוד יותר, אפשר להגדיר את הדגל `strictBounds` לערך `true`. כך אפשר לצמצם את מרחק הזום החוצה של המשתמש, וכך לוודא שכל מה שמחוץ לגבולות המוגבלים יישאר מוסתר. ברירת המחדל היא `false`, כלומר המשתמש יכול להתרחק עד שכל האזור המוגדר יוצג, כולל אזורים מחוץ לאזור המוגדר.

מאפיינים

latLngBounds

סוג: LatLngBounds|LatLngBoundsLiteral

כשמגדירים את הגבולות, המשתמש יכול להזיז את התצוגה ולהגדיל או להקטין את התצוגה רק בתוך הגבולות שצוינו. אפשר להגביל את הגבולות גם לאורך וגם לרוחב, או רק לרוחב. כדי לציין גבולות לפי קו רוחב בלבד, צריך להשתמש בקו אורך מערבי ובקו אורך מזרחי של ‎-180 ו-180, בהתאמה. לדוגמה, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.

strictBounds optional

סוג: boolean optional

כדי להגביל את הגבולות עוד יותר, אפשר להגדיר את הדגל strictBounds לערך true. כך אפשר לצמצם את מרחק הזום החוצה של המשתמש, וכך לוודא שכל מה שמחוץ לגבולות המוגבלים יישאר מוסתר. ברירת המחדל היא false, כלומר המשתמש יכול להתרחק עד שכל האזור המוגדר יוצג, כולל אזורים מחוץ לאזור המוגדר.

הכיתה TrafficLayer

google.maps.TrafficLayer class

שכבת תנועה.

הכיתה הזו היא תת-מחלקה של MVCObject.

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

יצרן
`TrafficLayer`	`TrafficLayer([opts])` פרמטרים: `opts`: `TrafficLayerOptions optional` שכבה שמציגה את תנועת הרכבים הנוכחית בכבישים.

Methods
`getMap`	`getMap()` פרמטרים: ללא ערך המוחזר: `Map\|null` הפונקציה מחזירה את המפה שבה השכבה הזו מוצגת.
`setMap`	`setMap(map)` פרמטרים: `map`: `Map optional` ערך המוחזר: None המערכת מרינדרת את השכבה במפה שצוינה. אם המפה מוגדרת כ-`null`, השכבה תוסר.
`setOptions`	`setOptions(options)` פרמטרים: `options`: `TrafficLayerOptions optional` ערך המוחזר: None
עובר בירושה: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

ממשק TrafficLayerOptions

ממשק google.maps.TrafficLayerOptions

אובייקט TrafficLayerOptions שמשמש להגדרת המאפיינים שאפשר להגדיר ב-TrafficLayer.

מאפיינים
`autoRefresh optional`	סוג: `boolean optional` ברירת מחדל: `true` אם שכבת התנועה תתעדכן באופן אוטומטי במידע מעודכן.
`map optional`	סוג: `Map optional` המפה שבה רוצים להציג את שכבת התנועה.

הכיתה TransitLayer

google.maps.TransitLayer class

שכבת מעבר.

הכיתה הזו היא תת-מחלקה של MVCObject.

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

יצרן
`TransitLayer`	`TransitLayer()` פרמטרים: ללא שכבה שבה מוצגים קווי תחבורה ציבורית.

Methods
`getMap`	`getMap()` פרמטרים: ללא ערך המוחזר: `Map\|null` הפונקציה מחזירה את המפה שבה השכבה הזו מוצגת.
`setMap`	`setMap(map)` פרמטרים: `map`: `Map optional` ערך המוחזר: `void` המערכת מרינדרת את השכבה במפה שצוינה. אם המפה מוגדרת כ-`null`, השכבה תוסר.
עובר בירושה: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

הכיתה BicyclingLayer

google.maps.BicyclingLayer class

שכבה שבה מוצגים שבילים ונתיבים לאופניים.

הכיתה הזו היא תת-מחלקה של MVCObject.

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

יצרן
`BicyclingLayer`	`BicyclingLayer()` פרמטרים: ללא שכבה שבה מוצגים נתיבים ושבילים לאופניים, והכבישים הגדולים מוצגים ברמה נמוכה יותר.

Methods
`getMap`	`getMap()` פרמטרים: ללא ערך המוחזר: `Map\|null` הפונקציה מחזירה את המפה שבה השכבה הזו מוצגת.
`setMap`	`setMap(map)` פרמטרים: `map`: `Map optional` ערך המוחזר: `void` המערכת מרינדרת את השכבה במפה שצוינה. אם המפה מוגדרת כ-`null`, השכבה תוסר.
עובר בירושה: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

הממשק CameraOptions

ממשק google.maps.CameraOptions

משמש להגדרת אפשרויות המצלמה במפה.

מאפיינים
`center optional`	סוג: `LatLngLiteral\|LatLng optional`
`heading optional`	סוג: `number optional`
`tilt optional`	סוג: `number optional`
`zoom optional`	סוג: `number optional`

ממשק VisibleRegion

ממשק google.maps.VisibleRegion

מכיל את ארבע הנקודות שמגדירות את הפוליגון בעל ארבע הצלעות שהוא האזור הגלוי במפה. במפה וקטורית, הפוליגון הזה יכול להיות טריז במקום מלבן, אם למפה הוקטורית יש הטיה.

מאפיינים
`farLeft`	סוג: `LatLng`
`farRight`	סוג: `LatLng`
`latLngBounds`	סוג: `LatLngBounds` תיבת הגבול הקטנה ביותר שכוללת את האזור הגלוי.
`nearLeft`	סוג: `LatLng`
`nearRight`	סוג: `LatLng`

קבועים של RenderingType

google.maps.RenderingType קבועים

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

קבועים
`RASTER`	מציין שהמפה היא מפת רסטר.
`UNINITIALIZED`	המשמעות היא שעדיין לא ידוע אם המפה היא וקטורית או רסטרית, כי עדיין לא הסתיימה האינטליגנציה של המפה.
`VECTOR`	מציין שהמפה היא מפה וקטורית.

ממשק MapCapabilities

ממשק google.maps.MapCapabilities

אובייקט שמכיל קובץ snapshot של היכולות שזמינות כרגע במפה. חשוב לזכור שזה לא בהכרח אומר שהמודולים הרלוונטיים נטענים או מופעלים, אלא שהמפה הנוכחית כוללת הרשאה לשימוש בממשקי ה-API האלה. בנכסים מפורטת רשימה של היכולות האפשריות.

מאפיינים
`isAdvancedMarkersAvailable optional`	סוג: `boolean optional` אם הערך הוא True, המפה מוגדרת כראוי ומאפשרת להשתמש בסמנים מתקדמים. שימו לב שעדיין צריך לייבא את הספרייה `marker` כדי להשתמש בסימנים מתקדמים. מידע נוסף זמין בכתובת https://goo.gle/gmp-isAdvancedMarkersAvailable.
`isDataDrivenStylingAvailable optional`	סוג: `boolean optional` אם הערך הוא true, המפה מוגדרת כראוי ומאפשרת להשתמש בסגנון מבוסס-נתונים לפחות ב-FeatureLayer אחד. מידע נוסף זמין בכתובות https://goo.gle/gmp-data-driven-styling ו-https://goo.gle/gmp-FeatureLayerIsAvailable.
`isWebGLOverlayViewAvailable optional`	סוג: `boolean optional` אם הערך הוא True, המפה מוגדרת כראוי ומאפשרת להשתמש ב-`WebGLOverlayView`.

Maps

הכיתה Map

יצרן

קבועים

מאפיינים

Methods

אירועים

הממשק MapOptions

מאפיינים

הכיתה MapElement

יצרן

מאפיינים

מכונות מזל

Methods

אירועים

הממשק MapElementOptions

מאפיינים

הכיתה ZoomChangeEvent

הממשק MapTypeStyle

מאפיינים

הממשק MapMouseEvent

מאפיינים

Methods

הממשק IconMouseEvent

מאפיינים

Methods

קבועים של ColorScheme

קבועים

קבועים של MapTypeId

קבועים

הכיתה MapTypeRegistry

יצרן

Methods

הממשק MapRestriction

מאפיינים

הכיתה TrafficLayer

יצרן

Methods

ממשק TrafficLayerOptions

מאפיינים

הכיתה TransitLayer

יצרן

Methods

הכיתה BicyclingLayer

יצרן

Methods

הממשק CameraOptions

מאפיינים

ממשק VisibleRegion

מאפיינים

קבועים של RenderingType

קבועים

ממשק MapCapabilities

מאפיינים