‫ Places UI Kit: ספרייה מוכנה לשימוש שמאפשרת למפתחים להתאים אישית ולשלוט. כדאי לנסות ולשתף את המשוב שלך על חוויית השימוש בערכת ממשק המשתמש.

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

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

‫Map class

יצרן

Constants

מאפיינים

Methods

אירועים

ממשק MapOptions

מאפיינים

Maps