השקת Places UI Kit: ספריית רכיבים מוכנה לשימוש בעלות נמוכה, שמאפשרת לכם להוסיף לכל מפה שתבחרו את ממשק המשתמש המוכר של 'מקומות' במפות Google. כדאי לנסות אותו ולשלוח לנו משוב כדי לעזור לנו לעצב את העתיד של GMP.

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

Maps

‫Map class

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`.

Constants
`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. ערך מוחזר: אין מגדיר את אזור התצוגה כך שיכיל את הגבולות שצוינו. הערה: אם המפה מוגדרת כ-`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` הפונקציה מחזירה את האפשרות ללחוץ על הסמלים במפה. סמל של מפה שמייצג נקודת עניין (POI). אם הערך שמוחזר הוא `true`, אפשר ללחוץ על הסמלים במפה.
`getDatasetFeatureLayer`	הערה: התכונה זמינה רק בערוץ v=beta. `getDatasetFeatureLayer(datasetId)` פרמטרים: `datasetId`: `string` ערך מוחזר: `FeatureLayer` הפונקציה מחזירה את `FeatureLayer` של `datasetId` שצוין. צריך להגדיר את מזהי מערכי הנתונים ב-Google Cloud Console. אם מזהה מערך הנתונים לא משויך לסגנון המפה, או אם התכונה 'סגנון מבוסס-נתונים' לא זמינה (אין מזהה מפה, אין משבצות וקטוריות, אין שכבות של תכונות או מערכי נתונים של סגנון מבוסס-נתונים שהוגדרו בסגנון המפה), נרשמת שגיאה, והתוצאה של `FeatureLayer.isAvailable` תהיה false.
`getDiv`	`getDiv()` פרמטרים: אין ערך ההחזרה: `HTMLElement` mapDiv של המפה.
`getFeatureLayer`	`getFeatureLayer(featureType)` פרמטרים: `featureType`: `FeatureType` ערך מוחזר: `FeatureLayer` הפונקציה מחזירה את `FeatureLayer` של `FeatureType` מסוים. צריך להפעיל `FeatureLayer` ב-Google Cloud Console. אם `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` הפונקציה מחזירה את הערך הנוכחי של RenderingType במפה.
`getStreetView`	`getStreetView()` פרמטרים: אין ערך ההחזרה: `StreetViewPanorama` הפנורמה שמוצגת במפה. מחזירה את ברירת המחדל `StreetViewPanorama` שמשויכת למפה, שיכולה להיות פנורמה שמוטמעת במפה כברירת מחדל, או הפנורמה שהוגדרה באמצעות `setStreetView()`. שינויים ב-`streetViewControl` של המפה ישתקפו בתצוגה של פנורמה מוגבלת כזו.
`getTilt`	`getTilt()` פרמטרים: אין ערך מוחזר: `number\|undefined` מחזירה את זווית הפגיעה הנוכחית של המפה, במעלות ממישור אזור התצוגה למישור המפה. במפות רסטר, התוצאה תהיה `0` לתמונות שצולמו ישירות מלמעלה או `45` לתמונות שצולמו בזווית של 45 מעלות. השיטה הזו לא מחזירה את הערך שהוגדר על ידי `setTilt`. פרטים נוספים מופיעים בכתובת `setTilt`.
`getTiltInteractionEnabled`	`getTiltInteractionEnabled()` פרמטרים: אין ערך מוחזר: `boolean\|null` הפונקציה מחזירה אם אינטראקציות של הטיה מופעלות. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטור. אם לא מגדירים את המזהה בקוד, ייעשה שימוש בהגדרת הענן של מזהה המפה (אם היא זמינה).
`getZoom`	`getZoom()` פרמטרים: אין ערך מוחזר: `number\|undefined` מחזירה את רמת הזום של המפה. אם לא הוגדר זום, התוצאה היא `undefined`.
`moveCamera`	`moveCamera(cameraOptions)` פרמטרים: `cameraOptions`: `CameraOptions` ערך מוחזר: אין מגדיר באופן מיידי את המצלמה במפה לאפשרויות המצלמה של היעד, ללא אנימציה.
`panBy`	`panBy(x, y)` פרמטרים: ‫`x`: `number` מספר הפיקסלים להזזת המפה בכיוון x. ‫`y`: `number` מספר הפיקסלים להזזת המפה בכיוון y. ערך מוחזר: אין משנה את מרכז המפה במרחק הנתון בפיקסלים. אם המרחק קטן מהרוחב ומהגובה של המפה, המעבר יהיה חלק. שימו לב שמערכת הקואורדינטות של המפה גדלה ממערב למזרח (עבור ערכי x) ומצפון לדרום (עבור ערכי y).
`panTo`	`panTo(latLng)` פרמטרים: ‫`latLng`: `LatLng\|LatLngLiteral` קו הרוחב או קו האורך החדשים של מרכז המפה. ערך מוחזר: אין משנה את מרכז המפה לערך `LatLng` שצוין. אם השינוי קטן מהרוחב ומהגובה של המפה, המעבר יהיה חלק.
`panToBounds`	`panToBounds(latLngBounds[, padding])` פרמטרים: ‫`latLngBounds`: `LatLngBounds\|LatLngBoundsLiteral` הגבולות של המפה שאליה רוצים להזיז את המפה. ‫`padding`: `number\|Padding optional` מרווח פנימי בפיקסלים. ערך מספרי יניב את אותו ריווח פנימי בכל 4 הצדדים. ערך ברירת המחדל הוא 0. ערך מוחזר: אין מזיז את המפה במידה המינימלית הנדרשת כדי להכיל את `LatLngBounds` הנתון. אין הבטחה לגבי המיקום של הגבולות במפה, מלבד העובדה שהמפה תזוז כדי להציג כמה שיותר מהגבולות בתוך `{currentMapSizeInPx} - {padding}`. במפות רסטר ובמפות וקטוריות, לא ישתנו מרחק התצוגה, ההטיה והכיוון של המפה.
`setCenter`	`setCenter(latlng)` פרמטרים: `latlng`: `LatLng\|LatLngLiteral` ערך מוחזר: אין
`setClickableIcons`	`setClickableIcons(value)` פרמטרים: `value`: `boolean` ערך מוחזר: אין המדיניות קובעת אם אפשר ללחוץ על הסמלים במפה או לא. סמל של מפה שמייצג נקודת עניין (POI). כדי להשבית את האפשרות ללחוץ על סמלי המפה, מעבירים ערך של `false` לשיטה הזו.
`setHeading`	`setHeading(heading)` פרמטרים: `heading`: `number` ערך מוחזר: אין מגדיר את כיוון המצפן של המפה במעלות מכיוון צפון. במפות רסטר, השיטה הזו רלוונטית רק לתמונות אוויריות.
`setHeadingInteractionEnabled`	`setHeadingInteractionEnabled(headingInteractionEnabled)` פרמטרים: `headingInteractionEnabled`: `boolean` ערך מוחזר: אין ההגדרה הזו קובעת אם אינטראקציות עם כותרות מופעלות. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטור. אם לא מגדירים את המזהה בקוד, ייעשה שימוש בהגדרת הענן של מזהה המפה (אם היא זמינה).
`setMapTypeId`	`setMapTypeId(mapTypeId)` פרמטרים: `mapTypeId`: `MapTypeId\|string` ערך מוחזר: אין
`setOptions`	`setOptions(options)` פרמטרים: `options`: `MapOptions optional` ערך מוחזר: אין
`setRenderingType`	`setRenderingType(renderingType)` פרמטרים: `renderingType`: `RenderingType` ערך מוחזר: אין הגדרת ה-RenderingType הנוכחי של המפה.
`setStreetView`	`setStreetView(panorama)` פרמטרים: ‫`panorama`: `StreetViewPanorama optional` תמונת הפנורמה שרוצים לקשר למפה. ערך מוחזר: אין קושרים את `StreetViewPanorama` למפה. הפנורמה הזו מבטלת את ברירת המחדל של `StreetViewPanorama`, ומאפשרת למפה להיקשר לפנורמה חיצונית מחוץ למפה. הגדרת הפנורמה ל-`null` מחזירה את פנורמת ברירת המחדל המוטמעת למפה.
`setTilt`	`setTilt(tilt)` פרמטרים: `tilt`: `number` ערך מוחזר: אין למפות וקטוריות, מגדיר את זווית הפגיעה של המפה. הערכים המותרים מוגבלים בהתאם לרמת הזום של המפה. במפות רסטר, ההגדרה הזו קובעת את אופן המעבר האוטומטי בין זוויות ההסתכלות על המפה. הערכים המותרים היחידים הם `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` ערך מוחזר: אין ההגדרה הזו קובעת אם אינטראקציות של הטיה מופעלות. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטור. אם לא מגדירים את המזהה בקוד, ייעשה שימוש בהגדרת הענן של מזהה המפה (אם היא זמינה).
`setZoom`	`setZoom(zoom)` פרמטרים: ‫`zoom`: `number` ערכי זום גדולים יותר מתאימים לרזולוציה גבוהה יותר. ערך מוחזר: אין הגדרת הזום של המפה.
בירושה: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

אירועים
`bounds_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשגבולות אזור התצוגה משתנים.
`center_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמאפיין מרכז המפה משתנה.
`click`	`function(event)` ארגומנטים: `event`: `MapMouseEvent\|IconMouseEvent` האירוע הזה מופעל כשהמשתמש לוחץ על המפה. מוחזר MapMouseEvent עם מאפיינים של המיקום שנלחץ, אלא אם נלחץ סמל של מקום, ובמקרה כזה מוחזר IconMouseEvent עם מזהה מקום. ‫IconMouseEvent ו-MapMouseEvent זהים, מלבד העובדה של-IconMouseEvent יש שדה של מזהה מקום. תמיד אפשר להתייחס לאירוע כאל MapMouseEvent כשמזהה המקום לא חשוב. אירוע הקליק לא מופעל אם לחצו על סמן או על חלון מידע.
`contextmenu`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהאירוע contextmenu של DOM מופעל במאגר המפות.
`dblclick`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהמשתמש לוחץ לחיצה כפולה על המפה. שימו לב: לפעמים אירוע הקליק יופעל פעם אחת ולפעמים פעמיים, ממש לפני האירוע הזה.
`drag`	`function()` ארגומנטים: אין האירוע הזה מופעל שוב ושוב בזמן שהמשתמש גורר את המפה.
`dragend`	`function()` ארגומנטים: אין האירוע הזה מופעל כשהמשתמש מפסיק לגרור את המפה. הערה: האירוע dragend לא מופעל כשהמשתמש מפסיק להזיז את המפה באמצעות המקלדת. כדי לקבוע מתי המשתמש הפסיק להזיז או לגרור את המפה, צריך להשתמש באירוע `Map.idle` במקום זאת.
`dragstart`	`function()` ארגומנטים: אין האירוע הזה מופעל כשהמשתמש מתחיל לגרור את המפה.
`heading_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמאפיין הכותרת של המפה משתנה.
`idle`	`function()` ארגומנטים: אין האירוע הזה מופעל כשהמפה עוברת למצב לא פעיל אחרי הזזה או שינוי מרחק התצוגה.
`isfractionalzoomenabled_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשהמאפיין isFractionalZoomEnabled משתנה.
`mapcapabilities_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמשתנים היכולות של המפה.
`maptypeid_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמשתנה המאפיין mapTypeId.
`mousemove`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל בכל פעם שהעכבר של המשתמש עובר מעל מאגר המפות.
`mouseout`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהעכבר של המשתמש יוצא מהמאגר של המפה.
`mouseover`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהעכבר של המשתמש נכנס למאגר המפות.
`projection_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשההטלה משתנה.
`renderingtype_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשערך המאפיין renderingType משתנה.
`tilesloaded`	`function()` ארגומנטים: אין האירוע הזה מופעל כשהטעינה של המשבצות הגלויות מסתיימת.
`tilt_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמשנים את מאפיין ההטיה של המפה.
`zoom_changed`	`function()` ארגומנטים: אין האירוע הזה מופעל כשמאפיין הזום של המפה משתנה.
`rightclick`	הוצא משימוש: כדי לתמוך בדפוסי שימוש כמו קליק עם Ctrl ב-macOS, צריך להשתמש באירוע `Map.contextmenu` במקום זאת. `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` מופעל, אי אפשר ללחוץ על סמלי המפה. סמל של מפה שמייצג נקודת עניין (POI).
`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 של הסמן שיוצג כשמעבירים את העכבר מעל מפה שאפשר לגרור. המאפיין הזה משתמש במאפיין `cursor` css כדי לשנות את הסמל. בדומה למאפיין css, צריך לציין לפחות סמן גיבוי אחד שלא מוגדר ככתובת URL. לדוגמה: `draggableCursor: 'url(http://www.example.com/icon.png), auto;'`
`draggingCursor optional`	סוג: `string optional` השם או כתובת ה-URL של הסמן שיוצג כשגוררים את המפה. המאפיין הזה משתמש במאפיין `cursor` css כדי לשנות את הסמל. בדומה למאפיין 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` מוסיף מזהה שיוך שימוש לאתחול, שעוזר ל-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`, נעשה שימוש במקום זאת בהתקרבות המקסימלית מסוג המפה הנוכחי. ערכי הזום התקינים הם מספרים מאפס ועד רמת הזום המקסימלית הנתמכת.
`minZoom optional`	סוג: `number optional` רמת הזום המינימלית שתוצג במפה. אם לא מציינים ערך או אם מציינים את הערך `null`, המערכת משתמשת במקום זאת בערך הזום המינימלי מסוג המפה הנוכחי. ערכי הזום התקינים הם מספרים מאפס ועד רמת הזום המקסימלית הנתמכת.
`noClear optional`	סוג: `boolean optional` אם `true`, לא מוחקים את התוכן של Map 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` מצב ההפעלה או ההשבתה הראשוני של אמצעי הבקרה של שינוי הגודל.
`scaleControlOptions optional`	סוג: `ScaleControlOptions optional` אפשרויות התצוגה הראשוניות של אמצעי הבקרה של קנה המידה.
`scrollwheel optional`	סוג: `boolean optional` אם `false`, משבית את שינוי מרחק התצוגה במפה באמצעות גלגל הגלילה של העכבר. גלגל הגלילה מופעל כברירת מחדל. הערה: לא מומלץ להשתמש במאפיין הזה. כדי להשבית את הזום באמצעות גלגל העכבר, אפשר להשתמש במאפיין `gestureHandling` ולהגדיר אותו ל-`"cooperative"` או ל-`"none"`.
`streetView optional`	סוג: `StreetViewPanorama optional` `StreetViewPanorama` שיוצג כשמשחררים את אטב-איש של Street View במפה. אם לא מצוינת תמונה פנורמית, כשממקמים את איש הפג, במפה מוצגת תמונת ברירת מחדל `StreetViewPanorama`.`div`
`streetViewControl optional`	סוג: `boolean optional` המצב הראשוני של הפקד של אטב-איש ב-Street View (מופעל או מושבת). האמצעי הזה הוא חלק מממשק המשתמש שמוגדר כברירת מחדל, והוא צריך להיות מוגדר לערך `false` כשמוצג סוג מפה ששכבת העל של הכבישים בתצוגת רחוב לא אמורה להופיע בו (למשל, סוג מפה שאינו 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` מתייחסות לדברים שונים, ולכן אל `bind()` את המאפיין `tilt`. פעולה כזו עלולה להניב תוצאות בלתי צפויות.
`tiltInteractionEnabled optional`	סוג: `boolean optional` ברירת מחדל: `false` האם המפה צריכה לאפשר למשתמש לשלוט בהטיית המצלמה. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטור. אם לא מגדירים את המזהה בקוד, ייעשה שימוש בהגדרת הענן של מזהה המפה (אם היא זמינה).
`zoom optional`	סוג: `number optional` רמת הזום ההתחלתית של המפה. ערכי הזום התקינים הם מספרים מאפס ועד רמת הזום המקסימלית הנתמכת. ערכי זום גדולים יותר מתאימים לרזולוציה גבוהה יותר.
`zoomControl optional`	סוג: `boolean optional` מצב ההפעלה או ההשבתה של בקרת הזום.
`zoomControlOptions optional`	סוג: `ZoomControlOptions optional` אפשרויות התצוגה של אמצעי הבקרה של הזום.

‫MapElement class

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` מוסיף מזהה שיוך שימוש לאתחול, שעוזר ל-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` רמת הזום של המפה. ערכי הזום התקינים הם מספרים מאפס ועד רמת הזום המקסימלית הנתמכת. ערכי זום גדולים יותר מתאימים לרזולוציה גבוהה יותר. מאפיין HTML: `<gmp-map zoom="number"></gmp-map>`

מכונות מזל
`control-block-end-inline-center`	ממקם את הרכיב עם slot במיקום `ControlPosition.BLOCK_END_INLINE_CENTER`.
`control-block-end-inline-end`	ממקם את הרכיב עם slot במיקום `ControlPosition.BLOCK_END_INLINE_END`.
`control-block-end-inline-start`	ממקם את הרכיב עם slot במיקום `ControlPosition.BLOCK_END_INLINE_START`.
`control-block-start-inline-center`	ממקם את הרכיב עם slot במיקום `ControlPosition.BLOCK_START_INLINE_CENTER`.
`control-block-start-inline-end`	ממקם את הרכיב עם slot במיקום `ControlPosition.BLOCK_START_INLINE_END`.
`control-block-start-inline-start`	ממקם את הרכיב עם slot במיקום `ControlPosition.BLOCK_START_INLINE_START`.
`control-inline-end-block-center`	ממקם את הרכיב עם slot במיקום `ControlPosition.INLINE_END_BLOCK_CENTER`.
`control-inline-end-block-end`	ממקם את הרכיב עם slot במיקום `ControlPosition.INLINE_END_BLOCK_END`.
`control-inline-end-block-start`	ממקם את הרכיב עם slot במיקום `ControlPosition.INLINE_END_BLOCK_START`.
`control-inline-start-block-center`	ממקם את הרכיב עם slot במיקום `ControlPosition.INLINE_START_BLOCK_CENTER`.
`control-inline-start-block-end`	ממקם את הרכיב עם slot במיקום `ControlPosition.INLINE_START_BLOCK_END`.
`control-inline-start-block-start`	ממקם את הרכיב עם slot במיקום `ControlPosition.INLINE_START_BLOCK_START`.
`default`	אפשר ליצור רכיבים לשימוש חוזר סביב רכיבי האינטרנט של Maps JavaScript, כמו `AdvancedMarkerElement`, באמצעות רכיבים בהתאמה אישית. כברירת מחדל, כל רכיב בהתאמה אישית שמוסיפים ישירות ל-`MapElement` ימוקם ויוצג ב-`MapPanes.overlayMouseTarget`. עם זאת, יכול להיות שרכיבי האינטרנט של 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` מסירה מהיעד event listener שנרשם קודם באמצעות 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

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

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

‫MapElementOptions interface

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 class

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` click יכול להיות `domEvent` מסוג `KeyboardEvent`).
`latLng optional`	סוג: `LatLng optional` קו הרוחב וקו האורך שהיו מתחת לסמן כשהאירוע התרחש.

מאפיינים

domEvent

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

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

latLng optional

סוג: LatLng optional

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

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

‫IconMouseEvent interface

google.maps.IconMouseEvent ממשק

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

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

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

Methods
Inherited: `stop`

ColorScheme constants

google.maps.ColorScheme constants

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

אפשר להתקשר אל const {ColorScheme} = await google.maps.importLibrary("core") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

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

MapTypeId constants

google.maps.MapTypeId constants

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

אפשר להתקשר אל const {MapTypeId} = await google.maps.importLibrary("maps") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

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

‫MapTypeRegistry class

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 שרוצים להוסיף לרישום. ערך מוחזר: אין מגדיר את הרישום כך שישייך את מזהה המחרוזת שהועבר ל-MapType שהועבר.
בירושה: `addListener`, `bindTo`, `get`, `notify`, `setValues`, `unbind`, `unbindAll`

‫MapRestriction interface

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 class

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` ערך מוחזר: אין הפונקציה מעבדת את השכבה במפה שצוינה. אם המפה מוגדרת ל-`null`, השכבה תוסר.
`setOptions`	`setOptions(options)` פרמטרים: `options`: `TrafficLayerOptions optional` ערך מוחזר: אין
בירושה: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

‫TrafficLayerOptions interface

google.maps.TrafficLayerOptions ממשק

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

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

‫TransitLayer class

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 class

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 interface

google.maps.CameraOptions ממשק

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

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

‫VisibleRegion interface

google.maps.VisibleRegion ממשק

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

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

קבועים של RenderingType

google.maps.RenderingType constants

אפשר להתקשר אל const {RenderingType} = await google.maps.importLibrary("maps") כדי לקבל גישה.
מידע נוסף זמין במאמר בנושא ספריות ב-Maps JavaScript API.

Constants
`RASTER`	מציין שהמפה היא מפת רסטר.
`UNINITIALIZED`	הערך הזה מציין שעדיין לא ידוע אם המפה היא וקטורית או רסטרית, כי המפה עדיין לא סיימה אתחול.
`VECTOR`	מציין שהמפה היא מפה וקטורית.

‫MapCapabilities interface

google.maps.MapCapabilities ממשק

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

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

Maps קל לארגן דפים בעזרת אוספים אפשר לשמור ולסווג תוכן על סמך ההעדפות שלך.

‫Map class

יצרן

Constants

מאפיינים

Methods

אירועים

ממשק MapOptions

מאפיינים

‫MapElement class

יצרן

מאפיינים

מכונות מזל

Methods

אירועים

‫MapElementOptions interface

מאפיינים

ZoomChangeEvent class

‫MapTypeStyle ממשק

מאפיינים

ממשק MapMouseEvent

מאפיינים

Methods

‫IconMouseEvent interface

מאפיינים

Methods

ColorScheme constants

Constants

MapTypeId constants

Constants

‫MapTypeRegistry class

יצרן

Methods

‫MapRestriction interface

מאפיינים

‫TrafficLayer class

יצרן

Methods

‫TrafficLayerOptions interface

מאפיינים

‫TransitLayer class

יצרן

Methods

‫BicyclingLayer class

יצרן

Methods

‫CameraOptions interface

מאפיינים

‫VisibleRegion interface

מאפיינים

קבועים של RenderingType

Constants

‫MapCapabilities interface

מאפיינים

Maps