‫ 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`,

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

‫Map class

יצרן

Constants

מאפיינים

Methods

Maps