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

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

‫Map class

יצרן

Constants

מאפיינים

Methods

Maps