Maps

Map class

google.maps.Map class

הכיתה הזו היא הרחבה של MVCObject.

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

Map
Map(mapDiv[, opts])
פרמטרים: 
  • mapDivHTMLElement המפה תוצג כך שתמלא את הרכיב הזה.
  • optsMapOptions 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.
  • paddingnumber|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, אפשר ללחוץ על הסמלים במפה.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
פרמטרים: 
  • datasetIdstring
ערך מוחזר:  FeatureLayer
הפונקציה מחזירה את FeatureLayer של datasetId שצוין. צריך להגדיר את מזהי מערכי הנתונים ב-Google Cloud Console. אם מזהה מערך הנתונים לא משויך לסגנון המפה, או אם התכונה 'סגנון מבוסס-נתונים' לא זמינה (אין מזהה מפה, אין משבצות וקטוריות, אין שכבות של תכונות או מערכי נתונים של סגנון מבוסס-נתונים שהוגדרו בסגנון המפה), נרשמת שגיאה, והתוצאה של FeatureLayer.isAvailable תהיה false.
getDiv
getDiv()
פרמטרים:  אין
ערך ההחזרה:  HTMLElement mapDiv של המפה.
getFeatureLayer
getFeatureLayer(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)
פרמטרים: 
ערך מוחזר:  אין
מגדיר באופן מיידי את המצלמה במפה לאפשרויות המצלמה של היעד, ללא אנימציה.
panBy
panBy(x, y)
פרמטרים: 
  • xnumber מספר הפיקסלים להזזת המפה בכיוון x.
  • ynumber מספר הפיקסלים להזזת המפה בכיוון y.
ערך מוחזר:  אין
משנה את מרכז המפה במרחק הנתון בפיקסלים. אם המרחק קטן מהרוחב ומהגובה של המפה, המעבר יהיה חלק. שימו לב שמערכת הקואורדינטות של המפה גדלה ממערב למזרח (עבור ערכי x) ומצפון לדרום (עבור ערכי y).
panTo
panTo(latLng)
פרמטרים: 
  • latLngLatLng|LatLngLiteral קו הרוחב או קו האורך החדשים של מרכז המפה.
ערך מוחזר:  אין
משנה את מרכז המפה לערך LatLng שצוין. אם השינוי קטן מהרוחב ומהגובה של המפה, המעבר יהיה חלק.
panToBounds
panToBounds(latLngBounds[, padding])
פרמטרים: 
  • latLngBoundsLatLngBounds|LatLngBoundsLiteral הגבולות של המפה שאליה רוצים להזיז את המפה.
  • paddingnumber|Padding optional מרווח פנימי בפיקסלים. ערך מספרי יניב את אותו ריווח פנימי בכל 4 הצדדים. ערך ברירת המחדל הוא 0.
ערך מוחזר:  אין
מזיז את המפה במידה המינימלית הנדרשת כדי להכיל את LatLngBounds הנתון. אין הבטחה לגבי המיקום של הגבולות במפה, מלבד העובדה שהמפה תזוז כדי להציג כמה שיותר מהגבולות בתוך {currentMapSizeInPx} - {padding}. במפות רסטר ובמפות וקטוריות, לא ישתנו מרחק התצוגה, ההטיה והכיוון של המפה.
setCenter
setCenter(latlng)
פרמטרים: 
ערך מוחזר:  אין
setClickableIcons
setClickableIcons(value)
פרמטרים: 
  • valueboolean
ערך מוחזר:  אין
המדיניות קובעת אם אפשר ללחוץ על הסמלים במפה או לא. סמל של מפה שמייצג נקודת עניין (POI). כדי להשבית את האפשרות ללחוץ על סמלי המפה, מעבירים ערך של false לשיטה הזו.
setHeading
setHeading(heading)
פרמטרים: 
  • headingnumber
ערך מוחזר:  אין
מגדיר את כיוון המצפן של המפה במעלות מכיוון צפון. במפות רסטר, השיטה הזו רלוונטית רק לתמונות אוויריות.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
פרמטרים: 
  • headingInteractionEnabledboolean
ערך מוחזר:  אין
ההגדרה הזו קובעת אם אינטראקציות עם כותרות מופעלות. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטור. אם לא מגדירים את המזהה בקוד, ייעשה שימוש בהגדרת הענן של מזהה המפה (אם היא זמינה).
setMapTypeId
setMapTypeId(mapTypeId)
פרמטרים: 
ערך מוחזר:  אין
setOptions
setOptions(options)
פרמטרים: 
ערך מוחזר:  אין
setRenderingType
setRenderingType(renderingType)
פרמטרים: 
ערך מוחזר:  אין
הגדרת ה-RenderingType הנוכחי של המפה.
setStreetView
setStreetView(panorama)
פרמטרים: 
  • panoramaStreetViewPanorama optional תמונת הפנורמה שרוצים לקשר למפה.
ערך מוחזר:  אין
קושרים את StreetViewPanorama למפה. הפנורמה הזו מבטלת את ברירת המחדל של StreetViewPanorama, ומאפשרת למפה להיקשר לפנורמה חיצונית מחוץ למפה. הגדרת הפנורמה ל-null מחזירה את פנורמת ברירת המחדל המוטמעת למפה.
setTilt
setTilt(tilt)
פרמטרים: 
  • tiltnumber
ערך מוחזר:  אין
למפות וקטוריות, מגדיר את זווית הפגיעה של המפה. הערכים המותרים מוגבלים בהתאם לרמת הזום של המפה.

במפות רסטר, ההגדרה הזו קובעת את אופן המעבר האוטומטי בין זוויות ההסתכלות על המפה. הערכים המותרים היחידים הם 0 ו-45. ‫setTilt(0) גורם למפה להשתמש תמיד בתצוגה עילית של 0°, ללא קשר לרמת הזום ולאזור התצוגה. ‫setTilt(45) גורם לזווית ההטיה לעבור אוטומטית ל-45 בכל פעם שתמונות מזווית של 45° זמינות לרמת הזום ולחלון התצוגה הנוכחיים, ולחזור ל-0 בכל פעם שתמונות מזווית של 45° לא זמינות (זו התנהגות ברירת המחדל). תמונות מזווית של 45° זמינות רק במפות מסוג satellite ו-hybrid, במיקומים מסוימים וברמות זום מסוימות. הערה: הפונקציה getTilt מחזירה את זווית ההטיה הנוכחית, ולא את הערך שמוגדר על ידי setTilt. ‫getTilt ו-setTilt מתייחסים לדברים שונים, ולכן אין bind() את המאפיין tilt. פעולה כזו עלולה להניב תוצאות בלתי צפויות.
setTiltInteractionEnabled
setTiltInteractionEnabled(tiltInteractionEnabled)
פרמטרים: 
  • tiltInteractionEnabledboolean
ערך מוחזר:  אין
ההגדרה הזו קובעת אם אינטראקציות של הטיה מופעלות. האפשרות הזו רלוונטית רק אם המפה היא מפת וקטור. אם לא מגדירים את המזהה בקוד, ייעשה שימוש בהגדרת הענן של מזהה המפה (אם היא זמינה).
setZoom
setZoom(zoom)
פרמטרים: 
  • zoomnumber ערכי זום גדולים יותר מתאימים לרזולוציה גבוהה יותר.
ערך מוחזר:  אין
הגדרת הזום של המפה.
בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
ארגומנטים:  אין
האירוע הזה מופעל כשגבולות אזור התצוגה משתנים.
center_changed
function()
ארגומנטים:  אין
האירוע הזה מופעל כשמאפיין מרכז המפה משתנה.
click
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהמשתמש לוחץ על המפה. מוחזר MapMouseEvent עם מאפיינים של המיקום שנלחץ, אלא אם נלחץ סמל של מקום, ובמקרה כזה מוחזר IconMouseEvent עם מזהה מקום. ‫IconMouseEvent ו-MapMouseEvent זהים, מלבד העובדה של-IconMouseEvent יש שדה של מזהה מקום. תמיד אפשר להתייחס לאירוע כאל MapMouseEvent כשמזהה המקום לא חשוב. אירוע הקליק לא מופעל אם לחצו על סמן או על חלון מידע.
contextmenu
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהאירוע contextmenu של DOM מופעל במאגר המפות.
dblclick
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהמשתמש לוחץ לחיצה כפולה על המפה. שימו לב: לפעמים אירוע הקליק יופעל פעם אחת ולפעמים פעמיים, ממש לפני האירוע הזה.
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)
ארגומנטים: 
האירוע הזה מופעל בכל פעם שהעכבר של המשתמש עובר מעל מאגר המפות.
mouseout
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהעכבר של המשתמש יוצא מהמאגר של המפה.
mouseover
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהעכבר של המשתמש נכנס למאגר המפות.
projection_changed
function()
ארגומנטים:  אין
האירוע הזה מופעל כשההטלה משתנה.
renderingtype_changed
function()
ארגומנטים:  אין
האירוע הזה מופעל כשערך המאפיין renderingType משתנה.
tilesloaded
function()
ארגומנטים:  אין
האירוע הזה מופעל כשהטעינה של המשבצות הגלויות מסתיימת.
tilt_changed
function()
ארגומנטים:  אין
האירוע הזה מופעל כשמשנים את מאפיין ההטיה של המפה.
zoom_changed
function()
ארגומנטים:  אין
האירוע הזה מופעל כשמאפיין הזום של המפה משתנה.
rightclick
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהמשתמש לוחץ לחיצה ימנית על המפה.

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

הערה: לא מומלץ להשתמש במאפיין הזה. כדי להשבית את הזום בלחיצה כפולה, אפשר להשתמש במאפיין gestureHandling ולהגדיר אותו לערך "none".

draggable optional
סוג:  boolean optional
אם הערך הוא false, אי אפשר לגרור את המפה. הגרירה מופעלת כברירת מחדל.
draggableCursor optional
סוג:  string optional
השם או כתובת ה-URL של הסמן שיוצג כשמעבירים את העכבר מעל מפה שאפשר לגרור. המאפיין הזה משתמש במאפיין cursor css כדי לשנות את הסמל. בדומה למאפיין css, צריך לציין לפחות סמן גיבוי אחד שלא מוגדר ככתובת URL. לדוגמה: draggableCursor: 'url(http://www.example.com/icon.png), auto;'
draggingCursor optional
סוג:  string optional
השם או כתובת ה-URL של הסמן שיוצג כשגוררים את המפה. המאפיין הזה משתמש במאפיין cursor css כדי לשנות את הסמל. בדומה למאפיין 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
האם המפה צריכה לאפשר למשתמשים לשלוט בכיוון המצלמה (סיבוב). האפשרות הזו רלוונטית רק אם המפה היא מפת וקטור. אם לא מגדירים את המזהה בקוד, ייעשה שימוש בהגדרת הענן של מזהה המפה (אם היא זמינה).
internalUsageAttributionIds optional
סוג:  Iterable<string> optional
ברירת מחדל: null
מוסיף מזהה שיוך שימוש לאתחול, שעוזר ל-Google להבין אילו ספריות ודוגמאות שימושיות למפתחים, כמו שימוש בספרייה של אשכולות סמנים. כדי לבטל את ההסכמה לשליחת מזהה שיוך השימוש, אפשר למחוק את המאפיין הזה או להחליף את הערך במחרוזת ריקה. יישלחו רק ערכים ייחודיים. יכול להיות שהמערכת תתעלם משינויים בערך הזה אחרי יצירת המופע.
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 של המפה. ברירת המחדל היא ROADMAP.
maxZoom optional
סוג:  number optional
רמת הזום המקסימלית שתוצג במפה. אם לא מציינים ערך או אם הערך שמוגדר הוא null, נעשה שימוש במקום זאת בהתקרבות המקסימלית מסוג המפה הנוכחי. ערכי הזום התקינים הם מספרים מאפס ועד רמת הזום המקסימלית הנתמכת.
minZoom optional
סוג:  number optional
רמת הזום המינימלית שתוצג במפה. אם לא מציינים ערך או אם מציינים את הערך null, המערכת משתמשת במקום זאת בערך הזום המינימלי מסוג המפה הנוכחי. ערכי הזום התקינים הם מספרים מאפס ועד רמת הזום המקסימלית הנתמכת.
noClear optional
סוג:  boolean optional
אם true, לא מוחקים את התוכן של Map div.
panControl optional
סוג:  boolean optional
מצב ההפעלה או ההשבתה של לחצן ההזזה.

panControlOptions optional
סוג:  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 כשמוצג סוג מפה ששכבת העל של הכבישים בתצוגת רחוב לא אמורה להופיע בו (למשל, סוג מפה שאינו Earth).
streetViewControlOptions optional
סוג:  StreetViewControlOptions optional
אפשרויות התצוגה הראשוניות של אמצעי הבקרה של אטב-איש ב-Street View.
styles optional
סוג: