הודעת אבטחה: נודע לנו על בעיית אבטחה שעשויה להשפיע על אתרים שמשתמשים בספריות ספציפיות של צד שלישי (כולל polyfill.io). בעיה זו עלולה לפעמים להפנות מבקרים אל מחוץ לאתר המיועד ללא ידיעתו או אישור של בעלי האתר. רבות מדוגמאות ה-JavaScript שלנו כללו בעבר הצהרה של סקריפט polyfill.io. הסרנו את הדוגמאות האלה מהדוגמאות. אם השתמשת בדוגמאות JavaScript שלנו שמכילות את ההצהרה הזו, מומלץ להסיר את ההצהרה.

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

Maps

מפה כיתה

google.maps.Map כיתה

הקורס הזה נמשך 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).

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

שיטות
`fitBounds`	`fitBounds(bounds[, padding])` פרמטרים: `bounds`: `LatLngBounds\|LatLngBoundsLiteral` גבולות להצגה. `padding`: `number\|Padding optional` מרווח פנימי בפיקסלים. הגבולות יתאימו לחלק במפה שיישאר אחרי הסרת המרווח הפנימי. ערך של מספר יניב את אותו מרווח פנימי בכל 4 הצדדים. הזינו כאן את הערך 0 כדי ליצור אידמפוטנטיות של MatchBounds לתוצאה של getBounds. ערך החזרה: ללא מגדיר את אזור התצוגה כך שיכלול את הגבולות הנתונים. הערה: כשהמפה מוגדרת לערך `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` the 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` הפונקציה מחזירה אם האינטראקציות עם הכותרות מופעלות. האפשרות הזו בתוקף רק כשהמפה היא מפה וקטורית. אם המאפיין לא מוגדר בקוד, ייעשה שימוש בהגדרות הענן של מזהה המפה (אם הן זמינות).
`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` ערך החזרה: ללא המדיניות קובעת אם סמלי המפה ניתנים ללחיצה או לא. סמל של מפה מייצג נקודת עניין, שנקראת גם נקודת עניין. כדי להשבית את הקליקביליות של סמלי המפה, צריך להעביר את הערך `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` ערך החזרה: ללא מגדיר את סוג הרינדור הנוכחי של המפה.
`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` האירוע הזה מופעל כשהאירוע של תפריט ההקשר של DOM מופעל במאגר התגים של המפה.
`dblclick`	`function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהמשתמש לוחץ לחיצה כפולה על המפה. הערה: לפעמים אירוע הקליק יופעל פעם אחת ולפעמים פעמיים, ממש לפני האירוע הזה.
`drag`	`function()` ארגומנטים: ללא האירוע הזה מופעל שוב ושוב בזמן שהמשתמש גורר את המפה.
`dragend`	`function()` ארגומנטים: ללא האירוע הזה מופעל כשהמשתמש מפסיק לגרור את המפה.
`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()` ארגומנטים: ללא האירוע הזה מופעל כש-רינדורType משתנה.
`tilesloaded`	`function()` ארגומנטים: ללא האירוע הזה מופעל כשהטעינה של המשבצות הגלויות מסתיימת.
`tilt_changed`	`function()` ארגומנטים: ללא האירוע הזה מופעל כשמאפיין הטיית המפה משתנה.
`zoom_changed`	`function()` ארגומנטים: ללא האירוע הזה מופעל כשמאפיין שינוי מרחק התצוגה במפה משתנה.
`rightclick`	הוצאה משימוש: אפשר להשתמש באירוע `Map.contextmenu` במקום זאת כדי לתמוך בדפוסי שימוש כמו לחיצה על לחצן הבקרה ב-macOS. `function(event)` ארגומנטים: `event`: `MapMouseEvent` האירוע הזה מופעל כשהמשתמש לוחץ לחיצה ימנית על המפה.

MapOptions ממשק

google.maps.MapOptions ממשק

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

מאפיינים
`backgroundColor optional`	סוג: `string optional` צבע המשמש לרקע של המפה div. הצבע הזה יוצג אם המשבצות עדיין לא נטענו בזמן שהמשתמש הזזה. אפשר להגדיר את האפשרות הזו רק כשהמפה מאותחלת.
`center optional`	סוג: `LatLng\|LatLngLiteral optional` מרכז המפה הראשוני.
`clickableIcons optional`	סוג: `boolean optional` ברירת המחדל: `true` כאשר `false`, לא ניתן ללחוץ על סמלי המפה. סמל של מפה מייצג נקודת עניין, שנקראת גם נקודת עניין.
`colorScheme optional`	הערה: האפשרות הזו זמינה רק בערוץ v=beta. סוג: `ColorScheme\|string optional` ברירת המחדל: `ColorScheme.LIGHT` ערכת הצבעים הראשונית של המפה. אפשר להגדיר את האפשרות הזו רק כשהמפה מאותחלת.
`controlSize optional`	סוג: `number optional` הגודל בפיקסלים של הפקדים שמופיעים במפה. צריך לספק את הערך הזה ישירות כשיוצרים את המפה. עדכון הערך הזה מאוחר יותר עשוי להעביר את הפקדים למצב `undefined`. קובע רק את אמצעי הבקרה שנוצרו על ידי ממשק ה-API של מפות Google עצמו. לא מתבצעת התאמה לעומס (scaling) של פקדים מותאמים אישית שנוצרו על ידי המפתח.
`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` האם המפה מאפשרת למשתמש לשלוט בכותרת המצלמה (סיבוב). האפשרות הזו בתוקף רק כשהמפה היא מפה וקטורית. אם המאפיין לא מוגדר בקוד, ייעשה שימוש בהגדרות הענן של מזהה המפה (אם הן זמינות).
`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 הראשוני של MapTypeId. ברירת המחדל היא `ROADMAP`.
`maxZoom optional`	סוג: `number optional` רמת הזום המקסימלית שתוצג במפה. אם הושמט או מוגדר לערך `null`, המערכת תשתמש בזום המקסימלי מסוג המפה הנוכחי. ערכי מרחק התצוגה החוקיים הם מספרים החל מאפס עד לרמת הזום המקסימלית הנתמכת.
`minZoom optional`	סוג: `number optional` רמת הזום המינימלית שתוצג במפה. אם הושמט או מוגדר לערך `null`, המערכת תשתמש במקום זאת בזום המינימלי מסוג המפה הנוכחי. ערכי מרחק התצוגה החוקיים הם מספרים החל מאפס עד לרמת הזום המקסימלית הנתמכת.
`noClear optional`	סוג: `boolean optional` אם הערך הוא `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` המצב הראשוני של הפעלה/השבתה של פקד המדידה.
`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` כשמציגים סוג מפה שבו לא אמורה להופיע שכבת-על של כביש ב-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` ואפשרות זו מתייחסות לדברים שונים, אל `bind()` הנכס `tilt`; פעולה כזו עלולה להוביל להשפעות בלתי צפויות.
`tiltInteractionEnabled optional`	סוג: `boolean optional` ברירת המחדל: `false` האם המפה צריכה לאפשר למשתמש לשלוט בהטיה של המצלמה. האפשרות הזו בתוקף רק כשהמפה היא מפה וקטורית. אם המאפיין לא מוגדר בקוד, ייעשה שימוש בהגדרות הענן של מזהה המפה (אם הן זמינות).
`zoom optional`	סוג: `number optional` רמת הזום הראשונית של המפה. ערכי מרחק התצוגה החוקיים הם מספרים החל מאפס עד לרמת הזום המקסימלית הנתמכת. ערכי זום גדולים יותר מתאימים לרזולוציה גבוהה יותר.
`zoomControl optional`	סוג: `boolean optional` מצב ההפעלה/ההשבתה של הפקד Zoom.
`zoomControlOptions optional`	סוג: `ZoomControlOptions optional` אפשרויות התצוגה לפקד Zoom.

MapElement כיתה

google.maps.MapElement כיתה

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 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 משתמש באופן פנימי.
`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`	הצבת הרכיב המחורר במיקום `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`	ניתן ליצור רכיבים לשימוש חוזר סביב רכיבי JavaScript של מפות Google, כמו `AdvancedMarkerElement`, באמצעות רכיבים מותאמים אישית. כברירת מחדל, כל רכיב מותאם אישית שנוסף ישירות אל `MapElement` יעבור עיבוד ומעובד ב-`MapPanes.overlayMouseTarget`. עם זאת, ייתכן שרכיבי האינטרנט של Maps JavaScript API יחוברו מחדש במשבצות הפנימיות של `MapElement`.

שיטות
`addEventListener`	הערה: האפשרות הזו זמינה רק בערוץ v=beta. `addEventListener(type, listener[, options])` פרמטרים: `type`: `string` מחרוזת תלוית אותיות רישיות שמייצגת את סוג האירוע שצריך להאזין לו. `listener`: `EventListener\|EventListenerObject` האובייקט שמקבל את ההתראה. הכתובת הזו חייבת להיות פונקציה או אובייקט עם method headEvent. `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

שיטות

addEventListener

addEventListener(type, listener[, options])

פרמטרים:

type: string מחרוזת תלוית אותיות רישיות שמייצגת את סוג האירוע שצריך להאזין לו.
listener: EventListener|EventListenerObject האובייקט שמקבל את ההתראה. הכתובת הזו חייבת להיות פונקציה או אובייקט עם method headEvent.
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`.
`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 כיתה

האירוע הזה נוצר על ידי מעקב אחר שינוי הזום.

הקורס הזה נמשך 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 של ההטמעה הפנימית של ה-API של מפות Google. בגלל מיפוי אירועים פנימי, ייתכן שהסמנטיקה של `domEvent` תהיה שונה מהסמנטיקה של `MapMouseEvent` (למשל, 'קליק' `MapMouseEvent` עשוי להיות מסוג `domEvent` מסוג `KeyboardEvent`).
`latLng optional`	סוג: `LatLng optional` קו הרוחב/קו האורך שהיו מתחת לסמן כשהאירוע התרחש.

מאפיינים

domEvent

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

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

latLng optional

סוג: LatLng optional

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

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

IconMouseEvent ממשק

google.maps.IconMouseEvent ממשק

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

הממשק הזה מתרחב MapMouseEvent

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

שיטות
עברה בירושה: `stop`

ערכת צבעים קבועים

google.maps.ColorScheme קבועים

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

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

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

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 כיתה

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

הקורס הזה נמשך MVCObject

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

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

שיטות
`set`	`set(id, mapType)` פרמטרים: `id`: `string` מזהה של סוג ה-MapType שיש להוסיף למרשם. `mapType`: `MapType\|` אובייקט MapType להוספה למרשם. ערך החזרה:* ללא מגדיר את המרשם לשייך את מזהה המחרוזת שהועברה ל-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 כיתה

שכבת תנועה.

הקורס הזה נמשך MVCObject

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

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

שיטות
`getMap`	`getMap()` פרמטרים: ללא ערך החזרה: `Map` מחזירה את המפה שבה מוצגת השכבה הזו.
`setMap`	`setMap(map)` פרמטרים: `map`: `Map` ערך החזרה: ללא עיבוד השכבה במפה שצוינה. אם המפה מוגדרת לערך `null`, השכבה תוסר.
`setOptions`	`setOptions(options)` פרמטרים: `options`: `TrafficLayerOptions` ערך החזרה: ללא
עברה בירושה: `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 כיתה

שכבה של תחבורה ציבורית.

הקורס הזה נמשך MVCObject

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

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

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

BicyclingLayer כיתה

google.maps.BicyclingLayer כיתה

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

הקורס הזה נמשך MVCObject

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

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

שיטות
`getMap`	`getMap()` פרמטרים: ללא ערך החזרה: `Map` מחזירה את המפה שבה מוצגת השכבה הזו.
`setMap`	`setMap(map)` פרמטרים: `map`: `Map` ערך החזרה: ללא עיבוד השכבה במפה שצוינה. אם המפה מוגדרת לערך `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 ממשק

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

מפה כיתה

יצרן

קבועים

מאפיינים

שיטות

אירועים

MapOptions ממשק

מאפיינים

MapElement כיתה

יצרן

מאפיינים

מכונות מזל

שיטות

אירועים

MapElementOptions ממשק

מאפיינים

ZoomChangeEvent כיתה

MapTypeStyle ממשק

מאפיינים

MapMouseEvent ממשק

מאפיינים

שיטות

IconMouseEvent ממשק

מאפיינים

שיטות

ערכת צבעים קבועים

קבועים

MapTypeId קבועים

קבועים

MapTypeRegistry כיתה

יצרן

שיטות

MapRestriction ממשק

מאפיינים

TrafficLayer כיתה

יצרן

שיטות

TrafficLayerOptions ממשק

מאפיינים

TransitLayer כיתה

יצרן

שיטות

BicyclingLayer כיתה

יצרן

שיטות

CameraOptions ממשק

מאפיינים

VisibleRegion ממשק

מאפיינים

RenderingType קבועים

קבועים

MapCapabilities ממשק

מאפיינים