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.
DEMO_MAP_ID מזהה המפה שאפשר להשתמש בו בדוגמאות קוד שדורשות מזהה מפה. מזהה המפה הזה לא מיועד לשימוש באפליקציות בייצור, ואי אפשר להשתמש בו בתכונות שדורשות הגדרת ענן (כמו Cloud Styling).
controls
פקדים נוספים לצירוף למפה. כדי להוסיף אמצעי בקרה למפה, מוסיפים את <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 הצדדים. כדי ש-fitBounds יהיה אידמפוטנטי על התוצאה של getBounds, צריך להזין כאן 0.
ערך מוחזר:  אין
מגדיר את אזור התצוגה כך שיכיל את הגבולות שצוינו.
הערה: אם המפה מוגדרת כ-display: none, הפונקציה fitBounds קוראת את גודל המפה כ-0x0, ולכן לא עושה כלום. כדי לשנות את אזור התצוגה כשהמפה מוסתרת, צריך להגדיר את המפה ל-visibility: hidden, וכך לוודא שרכיב ה-div של המפה הוא בגודל אמיתי. במפות וקטוריות, השיטה הזו מגדירה את ההטיה והכיוון של המפה לערכי ברירת המחדל שלהם, שהם אפס. הפעלת השיטה הזו עשויה לגרום לאנימציה חלקה בזמן שהמפה עוברת פנורמה ומתבצע זום כדי להתאים לגבולות. ההחלטה אם להשתמש באנימציה בשיטה הזו מתבססת על היוריסטיקה פנימית.
getBounds
getBounds()
פרמטרים:  אין
ערך ההחזרה:  LatLngBounds|undefined גבולות קווי הרוחב והאורך של אזור התצוגה הנוכחי.
מחזירה את גבולות קווי הרוחב והאורך של אזור התצוגה הנוכחי. אם רואים יותר מעותק אחד של העולם, טווח הגבולות בקו האורך הוא מ-‎-180 עד 180 מעלות כולל. אם המפה עדיין לא אותחלה או שמרכז המפה ורמת הזום לא הוגדרו, התוצאה היא undefined. במפות וקטוריות עם הטיה או כיוון שאינם אפס, גבולות קווי הרוחב והאורך שמוחזרים מייצגים את תיבת התוחמת הקטנה ביותר שכוללת את האזור הגלוי של אזור התצוגה של המפה. אפשר לעיין ב-MapCanvasProjection.getVisibleRegion כדי לקבל את האזור הגלוי המדויק של אזור התצוגה במפה.