Maps

המחלקה MapElement

class google.maps.MapElement extends HTMLElement implements MapElementOptions
library "maps"

‫MapElement היא מחלקת משנה של HTMLElement לעיבוד מפות. אחרי שטוענים את הספרייה maps, אפשר ליצור מפה ב-HTML. לדוגמה: 

<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID">
  <button slot="control-block-start-inline-end">Custom Control</button>
</gmp-map>
באופן פנימי, הוא משתמש ב-Map, שאפשר לגשת אליו באמצעות המאפיין MapElement.innerMap.

<gmp-map
  center="lat,lng"
  heading-interaction-disabled
  internal-usage-attribution-ids="id1 id2"
  map-id="string"
  rendering-type="value-name"
  tilt-interaction-disabled
  zoom="number">
</gmp-map>
 
const {MapElement} = await google.maps.importLibrary("maps");
MapElement
MapElement([options])
פרמטרים:
center
attr: center
סוג: LatLng|LatLngLiteral optional
קו הרוחב/האורך של מרכז המפה.
מאפיין HTML: center="lat,lng"
headingInteractionDisabled
attr: heading-interaction-disabled
סוג: boolean optional
ברירת המחדל: false
אם המפה צריכה לאפשר למשתמש לשלוט בכיוון המצלמה (סיבוב). האפשרות הזו רלוונטית רק אם המפה היא מפה וקטורית. אם לא מגדירים את הסגנון בקוד, המערכת משתמשת בהגדרות של מזהה המפה בענן (אם הן זמינות).
מאפיין HTML: heading-interaction-disabled
innerMap
סוג: Map
הפניה ל-Map שבו MapElement משתמש באופן פנימי.
internalUsageAttributionIds
attr: internal-usage-attribution-ids
סוג הקלט: Iterable<string> optional
סוג הפלט: Array<string> optional
ברירת המחדל: null
מוסיף מזהה שיוך שימוש למאתחל, שעוזר ל-Google להבין אילו ספריות ודוגמאות מועילות למפתחים, כמו שימוש בספריית מקבצי סמנים. כדי לבטל את ההסכמה לשליחת מזהה השיוך של השימוש, אפשר למחוק את המאפיין הזה או להחליף את הערך במחרוזת ריקה. יישלחו רק ערכים ייחודיים. יכול להיות שהמערכת תתעלם משינויים בערך הזה אחרי יצירת המופע.
מאפיין HTML: internal-usage-attribution-ids="id1 id2"
mapId
attr: map-id
סוג: string optional
מזהה המפה. אי אפשר להגדיר או לשנות את הפרמטר הזה אחרי שיוצרים מופע של מפה. אפשר להשתמש ב-Map.DEMO_MAP_ID כדי לנסות תכונות שדורשות מזהה מפה אבל לא דורשות הפעלה בענן.
מאפיין HTML: map-id="string"
renderingType
attr: rendering-type
סוג: RenderingType optional
ברירת המחדל: RenderingType.VECTOR
אם המפה צריכה להיות מפת רסטר או מפה וקטורית. אי אפשר להגדיר או לשנות את הפרמטר הזה אחרי שיוצרים מופע של מפה. אם לא מגדירים את המאפיין, סוג העיבוד נקבע לפי ההגדרות בענן של מזהה המפה (אם הן זמינות). חשוב לדעת: יכול להיות שמפות וקטוריות לא יהיו זמינות בכל המכשירים והדפדפנים, ובמקרה כזה המפה תוחלף במפה מבוססת-פיקסלים.
מאפיין HTML: rendering-type="value-name"
tiltInteractionDisabled
attr: tilt-interaction-disabled
סוג: boolean optional
ברירת המחדל: false
אם המפה צריכה לאפשר למשתמש לשלוט בהטיית המצלמה. האפשרות הזו רלוונטית רק אם המפה היא מפה וקטורית. אם לא מגדירים את הסגנון בקוד, המערכת משתמשת בהגדרות של מזהה המפה בענן (אם הן זמינות).
מאפיין HTML: tilt-interaction-disabled
zoom
attr: zoom
סוג: number optional
רמת הזום של המפה. ערכי זום חוקיים הם מספרים מאפס ועד רמת הזום המקסימלית שנתמכת. ערכי זום גדולים יותר תואמים לרזולוציה גבוהה יותר.
מאפיין HTML: zoom="number"
control-block-end-inline-center
ממקם את הרכיב עם המשבצת במיקום ControlPosition.BLOCK_END_INLINE_CENTER.
control-block-end-inline-end
ממקם את הרכיב עם המשבצת במיקום ControlPosition.BLOCK_END_INLINE_END.
control-block-end-inline-start
ממקם את הרכיב עם המשבצת במיקום ControlPosition.BLOCK_END_INLINE_START.
control-block-start-inline-center
ממקם את הרכיב עם המשבצת במיקום ControlPosition.BLOCK_START_INLINE_CENTER.
control-block-start-inline-end
ממקם את הרכיב עם המשבצת במיקום ControlPosition.BLOCK_START_INLINE_END.
control-block-start-inline-start
ממקם את הרכיב עם המשבצת במיקום ControlPosition.BLOCK_START_INLINE_START.
control-inline-end-block-center
ממקם את הרכיב עם המשבצת במיקום ControlPosition.INLINE_END_BLOCK_CENTER.
control-inline-end-block-end
ממקם את הרכיב עם המשבצת במיקום ControlPosition.INLINE_END_BLOCK_END.
control-inline-end-block-start
ממקם את הרכיב עם המשבצת במיקום ControlPosition.INLINE_END_BLOCK_START.
control-inline-start-block-center
ממקם את הרכיב עם המשבצת במיקום ControlPosition.INLINE_START_BLOCK_CENTER.
control-inline-start-block-end
ממקם את הרכיב עם המשבצת במיקום ControlPosition.INLINE_START_BLOCK_END.
control-inline-start-block-start
ממקם את הרכיב עם המשבצת במיקום ControlPosition.INLINE_START_BLOCK_START.
default
אתם יכולים ליצור רכיבים לשימוש חוזר סביב רכיבי האינטרנט של Maps JavaScript, כמו AdvancedMarkerElement, באמצעות רכיבים בהתאמה אישית. כברירת מחדל, כל רכיב בהתאמה אישית שנוסף ישירות אל MapElement יוקצה ויוצג ב-MapPanes.overlayMouseTarget. עם זאת, יכול להיות שרכיבי האינטרנט של Maps JavaScript API יועברו למיקומים הפנימיים של MapElement.
בירושה: addEventListener, removeEventListener
gmp-zoomchange
function(event)
ארגומנטים:
האירוע הזה מופעל כשמאפיין הזום של המפה משתנה.

הממשק MapElementOptions

ממשק google.maps.MapElementOptions
מיושם על ידי MapElement

אובייקט MapElementOptions משמש להגדרת המאפיינים שאפשר להגדיר ב-MapElement.
center
אופציונלי
סוג: LatLng|LatLngLiteral optional
MapElement.center.
headingInteractionDisabled
אופציונלי
סוג: boolean optional
MapElement.headingInteractionDisabled.
internalUsageAttributionIds
אופציונלי
סוג: Iterable<string> optional
MapElement.internalUsageAttributionIds.
mapId
אופציונלי
סוג: string optional
MapElement.mapId.
renderingType
אופציונלי
סוג: RenderingType optional
MapElement.renderingType.
tiltInteractionDisabled
אופציונלי
סוג: boolean optional
MapElement.tiltInteractionDisabled.
zoom
אופציונלי
סוג: number optional
MapElement.zoom.

מחלקה ZoomChangeEvent

class google.maps.ZoomChangeEvent extends Event
library "maps"

האירוע הזה נוצר ממעקב אחרי שינוי מרחק התצוגה.

const {ZoomChangeEvent} = await google.maps.importLibrary("maps");

מחלקה Map

class google.maps.Map extends MVCObject
library "maps" 

const {Map} = await google.maps.importLibrary("maps");
Map
Map(mapDiv[, opts])
פרמטרים:
  • ‫mapDiv: HTMLElement המפה תעובד כדי למלא את הרכיב הזה.
  • ‫opts: MapOptions optional אפשרויות
יוצרת מפה חדשה בתוך מאגר ה-HTML שצוין, שהוא בדרך כלל רכיב DIV.
DEMO_MAP_ID מזהה מפה שאפשר להשתמש בו בדוגמאות קוד שנדרש בהן מזהה מפה. מזהה המפה הזה לא מיועד לשימוש באפליקציות בסביבת ייצור, ואי אפשר להשתמש בו לתכונות שדורשות הגדרה בענן (כמו עיצוב מבוסס-ענן).
controls
פקדים נוספים שאפשר לצרף למפה. כדי להוסיף פקד למפה, מוסיפים את ה-<div> של הפקד ל-MVCArray שתואם ל-ControlPosition שבו הוא אמור להופיע.
data
סוג: Data
מופע של Data, שמקושר למפה. אפשר להוסיף תכונות לאובייקט Data כדי להציג אותן בנוחות במפה הזו.
mapTypes
מרשם של מופעי 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.
getCenter
getCenter()
פרמטרים: אין
ערך מוחזר: LatLng|undefined
מחזירה את המיקום שמוצג במרכז המפה. שימו לב שהאובייקט LatLng הזה לא עטוף. מידע נוסף זמין בכתובת LatLng. אם המרכז או הגבולות לא הוגדרו, התוצאה היא undefined.
getClickableIcons
getClickableIcons()
פרמטרים: אין
ערך מוחזר: boolean|undefined
הפונקציה מחזירה את האפשרות ללחוץ על סמלי המפה. סמל במפה מייצג נקודת עניין, שנקראת גם POI. אם הערך שמוחזר הוא true, אפשר ללחוץ על הסמלים במפה.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
פרמטרים:
  • datasetId: string
ערך מוחזר: FeatureLayer
הפונקציה מחזירה את ה-FeatureLayer של ה-datasetId שצוין. צריך להגדיר את מזהי מערכי הנתונים במסוף Google Cloud. אם מזהה מערך הנתונים לא משויך לסגנון המפה, או אם סגנון מבוסס-נתונים לא זמין (אין מזהה מפה, אין משבצות וקטוריות, אין שכבות במפה של סגנון מבוסס-נתונים או מערכי נתונים שהוגדרו בסגנון המפה), תירשם שגיאה ביומן, והערך של FeatureLayer.isAvailable יהיה false.
getDiv
getDiv()
פרמטרים: אין
ערך מוחזר: HTMLElement ה-mapDiv של המפה.
getFeatureLayer
getFeatureLayer(featureType)
פרמטרים:
ערך מוחזר: FeatureLayer
הפונקציה מחזירה את ה-FeatureLayer של ה-FeatureType הספציפי. צריך להפעיל FeatureLayer במסוף Google Cloud. אם FeatureLayer של FeatureType שצוין לא קיים במפה הזו, או אם סגנון מבוסס-נתונים לא זמין (אין מזהה מפה, אין משבצות וקטוריות ואין FeatureLayer מופעל בסגנון המפה), תירשם שגיאה והתוצאה של FeatureLayer.isAvailable תהיה false.
getHeading
getHeading()
פרמטרים: אין
ערך מוחזר: number|undefined
מחזירה את כיוון המצפן של המפה. ערך הכיוון נמדד במעלות (בכיוון השעון) מהכיוון הראשי צפון. אם המפה עדיין לא אותחלה, התוצאה היא undefined.
getHeadingInteractionEnabled
getHeadingInteractionEnabled()
פרמטרים: אין
ערך מוחזר: boolean|null
הפונקציה מחזירה ערך שמציין אם האינטראקציות עם הכותרות מופעלות. האפשרות הזו רלוונטית רק אם המפה היא מפה וקטורית. אם לא מגדירים את הסגנון בקוד, המערכת משתמשת בהגדרות של מזהה המפה בענן (אם הן זמינות).
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)
פרמטרים:
  • ‫x: number מספר הפיקסלים להזזת המפה בכיוון x.
  • ‫y: number מספר הפיקסלים להזזת המפה בכיוון ציר ה-Y.
הערך המוחזר: אין
משנה את מרכז המפה לפי המרחק שצוין בפיקסלים. אם המרחק קטן גם מהרוחב וגם מהגובה של המפה, המעבר יתבצע באנימציה חלקה. שימו לב שמערכת הקואורדינטות של המפה גדלה ממערב למזרח (לערכי x) ומצפון לדרום (לערכי y).
panTo
panTo(latLng)
פרמטרים:
הערך המוחזר: אין
משנה את מרכז המפה ל-LatLng שצוין. אם השינוי קטן מהרוחב ומהגובה של המפה, המעבר יהיה חלק.
panToBounds
panToBounds(latLngBounds[, padding])
פרמטרים:
  • ‫latLngBounds: LatLngBounds|LatLngBoundsLiteral הגבולות שאליהם המפה תזוז.
  • padding: number|Padding optional מרווח פנימי בפיקסלים. ערך מספרי יניב את אותו ריפוד בכל 4 הצדדים. ערך ברירת המחדל הוא 0.
הערך המוחזר: אין
הזזה של המפה במידה המינימלית שנדרשת כדי להכיל את ה-LatLngBounds הנתון. היא לא מבטיחה איפה הגבולות יהיו במפה, אלא שהמפה תזוז כדי להציג כמה שיותר מהגבולות בתוך {currentMapSizeInPx} - {padding}. גם במפות רסטר וגם במפות וקטוריות, הזום, ההטיה והכיוון של המפה לא ישתנו.
setCenter
setCenter(latlng)
פרמטרים:
הערך המוחזר: אין
setClickableIcons
setClickableIcons(value)
פרמטרים:
  • value: boolean
הערך המוחזר: אין
ההגדרה קובעת אם אפשר ללחוץ על הסמלים במפה או לא. סמל במפה מייצג נקודת עניין, שנקראת גם POI. כדי להשבית את האפשרות ללחוץ על סמלי המפה, מעבירים את הערך false לשיטה הזו.
setHeading
setHeading(heading)
פרמטרים:
  • heading: number
הערך המוחזר: אין
מגדיר את כיוון המצפן במפה, שנמדד במעלות מכיוון הצפון. במפות מבוססות-פיקסלים, השיטה הזו רלוונטית רק לצילומי אוויר.
setHeadingInteractionEnabled
setHeadingInteractionEnabled(headingInteractionEnabled)
פרמטרים:
  • headingInteractionEnabled: boolean
הערך המוחזר: אין
ההגדרה קובעת אם האינטראקציות עם הכותרות מופעלות. האפשרות הזו רלוונטית רק אם המפה היא מפה וקטורית. אם לא מגדירים את הסגנון בקוד, המערכת משתמשת בהגדרות של מזהה המפה בענן (אם הן זמינות).
setMapTypeId
setMapTypeId(mapTypeId)
פרמטרים:
הערך המוחזר: אין
setOptions
setOptions(options)
פרמטרים:
הערך המוחזר: אין
setRenderingType
setRenderingType(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)
ארגומנטים:
האירוע הזה מופעל כשהמשתמש לוחץ על המפה. מוחזר 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
אופציונלי
סוג: string optional
הצבע שמשמש לרקע של רכיב ה-div של המפה. הצבע הזה יוצג כשהאריחים עדיין לא נטענו בזמן שהמשתמש מזיז את המפה. אפשר להגדיר את האפשרות הזו רק כשהמפה מאותחלת.
cameraControl
אופציונלי
סוג: boolean optional
הסטטוס של פקד המצלמה (מופעל או מושבת).
cameraControlOptions
אופציונלי
סוג: CameraControlOptions optional
אפשרויות התצוגה של פקד המצלמה.
center
אופציונלי
סוג: LatLng|LatLngLiteral optional
מרכז המפה הראשוני.
clickableIcons
אופציונלי
סוג: boolean optional
ברירת המחדל: true
כשהאפשרות false מופעלת, אי אפשר ללחוץ על סמלים במפה. סמל במפה מייצג נקודת עניין, שנקראת גם POI.
colorScheme
אופציונלי
סוג: ColorScheme|string optional
ברירת המחדל: ColorScheme.LIGHT
ערכת הצבעים הראשונית של המפה. אפשר להגדיר את האפשרות הזו רק כשהמפה מאותחלת.
controlSize
אופציונלי
סוג: number optional
גודל הפקדים שמופיעים במפה, בפיקסלים. צריך לספק את הערך הזה ישירות כשיוצרים את המפה. עדכון של הערך הזה בשלב מאוחר יותר עלול להעביר את הפקדים למצב undefined. המדיניות הזו חלה רק על אמצעי הבקרה שנוצרו על ידי Maps API עצמו. לא משנה את הגודל של פקדים מותאמים אישית שנוצרו על ידי מפתחים.
disableDefaultUI
אופציונלי
סוג: boolean optional
הפעלה או השבתה של כל לחצני ברירת המחדל בממשק המשתמש. אפשר לשנות את ההגדרה הזו לכל משתמש בנפרד. האפשרות הזו לא משביתה את פקדי המקלדת, שנשלטים בנפרד על ידי האפשרות MapOptions.keyboardShortcuts. ההגדרה הזו לא משביתה את אמצעי הבקרה באמצעות תנועות, שנשלטים בנפרד על ידי האפשרות MapOptions.gestureHandling.
disableDoubleClickZoom
אופציונלי
סוג: boolean optional
הפעלה או השבתה של התכונה "התמקדות ומרכוז בלחיצה כפולה". מופעלת כברירת מחדל.

הערה: לא מומלץ להשתמש במאפיין הזה. כדי להשבית את הזום בלחיצה כפולה, אפשר להשתמש במאפיין gestureHandling ולהגדיר אותו ל-"none".
draggable
אופציונלי
סוג: boolean optional
אם הערך הוא false, המשתמשים לא יכולים לגרור את המפה ולשנות את מרחק התצוגה באמצעות העכבר ותנועות מגע. הגרירה מופעלת כברירת מחדל.
draggableCursor
אופציונלי
סוג: string optional
השם או כתובת ה-URL של הסמן שיוצג כשמעבירים את העכבר מעל מפה שניתן לגרור. המאפיין הזה משתמש במאפיין ה-CSS‏ cursor כדי לשנות את הסמל. כמו במאפיין ה-CSS, צריך לציין לפחות סמן חלופי אחד שהוא לא כתובת URL. לדוגמה: draggableCursor: 'url(http://www.example.com/icon.png), auto;'.
draggingCursor
אופציונלי
סוג: string optional
השם או כתובת ה-URL של הסמן שיוצג כשגוררים את המפה. המאפיין הזה משתמש במאפיין ה-CSS‏ cursor כדי לשנות את הסמל. כמו במאפיין ה-CSS, צריך לציין לפחות סמן חלופי אחד שהוא לא כתובת URL. לדוגמה: draggingCursor: 'url(http://www.example.com/icon.png), auto;'.
fullscreenControl
אופציונלי
סוג: boolean optional
מצב ההפעלה/ההשבתה של פקד המסך המלא.
fullscreenControlOptions
אופציונלי
סוג: FullscreenControlOptions optional
אפשרויות התצוגה של הפקד "מסך מלא".
gestureHandling
אופציונלי
סוג: string optional
ההגדרה הזו קובעת איך ה-API מטפל בתנועות במפה. ערכים מותרים:
  • "cooperative": אירועי גלילה ותנועות מגע באצבע אחת גוללים את הדף, ולא משנים את מרחק התצוגה או את המיקום במפה. תנועות מגע בשתי אצבעות מאפשרות להזיז את המפה ולשנות את מרחק התצוגה. אירועי גלילה עם מקש Ctrl או מקש ⌘ לחוץ משנים את מרחק התצוגה במפה.
    במצב הזה, המפה משתפת פעולה עם הדף.
  • ‫"greedy": כל תנועות המגע ואירועי הגלילה מזיזים את המפה או משנים את מרחק התצוגה.
  • ‫"none": המפה לא יכולה להיות מוזזת או עם שינוי מרחק תצוגה באמצעות תנועות של המשתמש.
  • "auto": (ברירת המחדל) הטיפול בתנועות הוא שיתופי או חמדני, בהתאם לאפשרות הגלילה בדף או אם הוא נמצא ב-iframe.
heading
אופציונלי
סוג: number optional
הכיוון של צילומי האוויר במעלות, שנמדד בכיוון השעון מהכיוון הראשי צפון. הכיוונים נצמדים לזווית הזמינה הקרובה ביותר שבה יש תמונות.
headingInteractionEnabled
אופציונלי
סוג: boolean optional
ברירת המחדל: false
אם המפה צריכה לאפשר למשתמש לשלוט בכיוון המצלמה (סיבוב). האפשרות הזו רלוונטית רק אם המפה היא מפה וקטורית. אם לא מגדירים את הסגנון בקוד, המערכת משתמשת בהגדרות של מזהה המפה בענן (אם הן זמינות).
internalUsageAttributionIds
אופציונלי
סוג: Iterable<string> optional
ברירת המחדל: null
מוסיף מזהה שיוך שימוש למאתחל, שעוזר ל-Google להבין אילו ספריות ודוגמאות מועילות למפתחים, כמו שימוש בספריית מקבצי סמנים. כדי לבטל את ההסכמה לשליחת מזהה השיוך של השימוש, אפשר למחוק את המאפיין הזה או להחליף את הערך במחרוזת ריקה. יישלחו רק ערכים ייחודיים. יכול להיות שהמערכת תתעלם משינויים בערך הזה אחרי יצירת המופע.
isFractionalZoomEnabled
אופציונלי
סוג: boolean optional
ברירת מחדל: true למפות וקטוריות ו-false למפות מבוססות-פיקסלים
אם המפה צריכה לאפשר רמות זום חלקיות. כדי לדעת מתי ברירת המחדל הוגדרה, צריך להקשיב ל-isfractionalzoomenabled_changed.
keyboardShortcuts
אופציונלי
סוג: boolean optional
אם הערך הוא false, המפה לא נשלטת על ידי המקלדת. מקשי הקיצור מופעלים כברירת מחדל.
mapId
אופציונלי
סוג: string optional
מזהה המפה. אי אפשר להגדיר או לשנות את הפרמטר הזה אחרי שיוצרים מופע של מפה. אפשר להשתמש ב-Map.DEMO_MAP_ID כדי לנסות תכונות שדורשות מזהה מפה אבל לא דורשות הפעלה בענן.
mapTypeControl
אופציונלי
סוג: boolean optional
המצב הראשוני (מופעל/מושבת) של פקד סוג המפה.
mapTypeControlOptions
אופציונלי
סוג: MapTypeControlOptions optional
אפשרויות התצוגה הראשוניות של פקד סוג המפה.
mapTypeId
אופציונלי
סוג: MapTypeId|string optional
ה-mapTypeId הראשוני של המפה. ברירת המחדל היא ROADMAP.
maxZoom
אופציונלי
סוג: number optional
רמת הזום המקסימלית שתוצג במפה. אם משמיטים את הפרמטר או מגדירים אותו לערך null, המערכת משתמשת במקום זאת ברמת הזום המקסימלית של סוג המפה הנוכחי. ערכי זום חוקיים הם מספרים מאפס ועד רמת הזום המקסימלית שנתמכת.
minZoom
אופציונלי
סוג: number optional
רמת הזום המינימלית שתוצג במפה. אם משמיטים את הפרמטר הזה או מגדירים אותו לערך null, המערכת משתמשת במקום זאת ברמת הזום המינימלית של סוג המפה הנוכחי. ערכי זום חוקיים הם מספרים מאפס ועד רמת הזום המקסימלית שנתמכת.
noClear
אופציונלי
סוג: boolean optional
אם true, אל תנקה את התוכן של ה-div של המפה.
panControl
אופציונלי
סוג: boolean optional
הסטטוס של פקד ההזזה (מופעל או מושבת).

panControlOptions
אופציונלי
סוג: PanControlOptions optional
אפשרויות התצוגה של פקד ההזזה.

renderingType
אופציונלי
סוג: RenderingType optional
ברירת המחדל: RenderingType.RASTER
אם המפה צריכה להיות מפת רסטר או מפה וקטורית. אי אפשר להגדיר או לשנות את הפרמטר הזה אחרי שיוצרים מופע של מפה. אם לא מגדירים את המאפיין, סוג העיבוד נקבע לפי ההגדרות בענן של מזהה המפה (אם הן זמינות). חשוב לדעת: יכול להיות שמפות וקטוריות לא יהיו זמינות בכל המכשירים והדפדפנים, ובמקרה כזה המפה תוחלף במפה מבוססת-פיקסלים.
restriction
אופציונלי
סוג: MapRestriction optional
מגדיר גבול שמגביל את אזור המפה שנגיש למשתמשים. כשההגדרה הזו מופעלת, המשתמש יכול להזיז את התמונה ולשנות את מרחק התצוגה רק בתוך הגבולות של התמונה מהמצלמה.
rotateControl
אופציונלי
סוג: boolean optional
מצב ההפעלה/ההשבתה של פקד הסיבוב.
rotateControlOptions
אופציונלי
סוג: RotateControlOptions optional
אפשרויות התצוגה של פקד הסיבוב.
scaleControl
אופציונלי
סוג: boolean optional
המצב הראשוני (מופעל/מושבת) של פקד קנה המידה.
scaleControlOptions
אופציונלי
סוג: ScaleControlOptions optional
אפשרויות התצוגה הראשוניות של פקד קנה המידה.
scrollwheel
אופציונלי
סוג: boolean optional
אם הערך הוא false, האפשרות לשנות את מרחק התצוגה במפה באמצעות גלגל הגלילה של העכבר מושבתת. גלגל הגלילה מופעל כברירת מחדל.

הערה: לא מומלץ להשתמש במאפיין הזה. כדי להשבית את האפשרות לשנות את מרחק התצוגה באמצעות גלגלת העכבר, אפשר להשתמש במאפיין gestureHandling ולהגדיר אותו לערך "cooperative" או "none".
streetView
אופציונלי
סוג: StreetViewPanorama optional
StreetViewPanorama שמוצג כשמפילים את האיש הקטן של Street View על המפה. אם לא צוינה פנורמה, יוצג StreetViewPanorama כברירת מחדל ב-div של המפה כשהאיש הצהוב יונח.
streetViewControl
אופציונלי
סוג: boolean optional
המצב הראשוני (מופעל/מושבת) של פקד האטב-איש ב-Street View. הפקד הזה הוא חלק מממשק המשתמש שמוגדר כברירת מחדל, וצריך להגדיר אותו לערך false כשמציגים סוג מפה שבו שכבת-העל של הדרכים ב-Street View לא אמורה להופיע (למשל, סוג מפה שאינו Earth).
streetViewControlOptions
אופציונלי
סוג: StreetViewControlOptions optional
אפשרויות התצוגה הראשוניות של פקד האטב-איש ב-Street View.
styles
אופציונלי
סוג: Array<MapTypeStyle> optional
סגנונות שאפשר להחיל על כל אחד מסוגי המפות שמוגדרים כברירת מחדל. חשוב לזכור שבמצבים satellite/hybrid ו-terrain, הסגנונות האלה יחולו רק על תוויות ועל גיאומטריה. התכונה הזו לא זמינה כשמשתמשים במזהה מפה או במפות וקטוריות (במקום זאת, צריך להשתמש בעיצוב מפות מבוסס-ענן).
tilt
אופציונלי
סוג: number optional
במפות וקטוריות, מגדיר את זווית ההטיה של המפה. הערכים המותרים מוגבלים בהתאם לרמת הזום של המפה. במפות מבוססות-פיקסלים, ההגדרה הזו קובעת את ההתנהגות של המעבר האוטומטי לזווית ההטיה של המפה. הערכים היחידים שמותרים הם 0 ו-45. הערך 0 גורם למפה להשתמש תמיד בתצוגה עילית של 0°, בלי קשר לרמת הזום ולמסך התצוגה. הערך 45 גורם לזווית ההטיה להשתנות אוטומטית ל-45 בכל פעם שתמונות ב-45° זמינות ברמת הזום ובאזור התצוגה הנוכחיים, ולחזור ל-0 בכל פעם שתמונות ב-45° לא זמינות (זוהי פעולת ברירת המחדל). תמונות בזווית של 45° זמינות רק לסוגי המפות satellite ו-hybrid, במיקומים מסוימים וברמות זום מסוימות. הערה: הפונקציה getTilt מחזירה את זווית ההטיה הנוכחית, ולא את הערך שצוין באפשרות הזו. מכיוון ש-getTilt והאפשרות הזו מתייחסים לדברים שונים, אין bind() את המאפיין tilt. פעולה כזו עלולה להוביל לתוצאות בלתי צפויות.
tiltInteractionEnabled
אופציונלי
סוג: boolean optional
ברירת המחדל: false
אם המפה צריכה לאפשר למשתמש לשלוט בהטיית המצלמה. האפשרות הזו רלוונטית רק אם המפה היא מפה וקטורית. אם לא מגדירים את הסגנון בקוד, המערכת משתמשת בהגדרות של מזהה המפה בענן (אם הן זמינות).
zoom
אופציונלי
סוג: number optional
רמת הזום הראשונית של המפה. ערכי זום חוקיים הם מספרים מאפס ועד רמת הזום המקסימלית שנתמכת. ערכי זום גדולים יותר תואמים לרזולוציה גבוהה יותר.
zoomControl
אופציונלי
סוג: boolean optional
מצב ההפעלה/ההשבתה של פקד הזום.
zoomControlOptions
אופציונלי
סוג: ZoomControlOptions optional
אפשרויות התצוגה של פקד הזום.

ממשק MapTypeStyle

ממשק google.maps.MapTypeStyle

MapTypeStyle הוא אוסף של בוררים וסגנונות שמגדירים את סגנון המפה. הסלקטורים מציינים את התכונות ו/או הרכיבים במפה שיושפעו, והמעצבים מציינים איך לשנות את התכונות והרכיבים האלה. פרטים נוספים זמינים בחומר העזר בנושא סגנונות.
stylers
סוג: Array<Object>
כללי הסגנון שיוחלו על המאפיינים והרכיבים שנבחרו במפה. הכללים מופעלים לפי הסדר שציינתם במערך הזה. בהנחיות הסגנון מפורטות הנחיות לשימוש ולערכים מותרים.
elementType
אופציונלי
סוג: string optional
הרכיב שעליו צריך להחיל את העיצוב. רכיב הוא היבט חזותי של מאפיין במפה. לדוגמה: תווית, סמל, קו המתאר או המילוי שמוחלים על הגיאומטריה ועוד. אופציונלי. אם לא צוין elementType, הערך המשוער הוא 'all'. לפרטים על השימוש ועל הערכים המותרים, אפשר לעיין בחומר העזר בנושא סגנון.
featureType
אופציונלי
סוג: string optional
התכונה או קבוצת התכונות שעליהן צריך להחיל את הסגנון. אופציונלי. אם לא צוין featureType, הערך המשוער הוא 'all'. לפרטים על השימוש ועל הערכים המותרים, אפשר לעיין בחומר העזר בנושא סגנון.

ממשק MapMouseEvent

ממשק google.maps.MapMouseEvent
מורחב על ידי Data.MouseEvent, FeatureMouseEvent, IconMouseEvent, PolyMouseEvent

האובייקט הזה מוחזר מאירועי עכבר שונים במפה ובשכבות-העל, והוא מכיל את כל השדות שמוצגים בהמשך.
domEvent
אירוע ה-DOM המקורי התואם. המפתחים לא צריכים להסתמך על כך שהמאפיינים target,‏ currentTarget,‏ relatedTarget ו-path מוגדרים ועקביים. בנוסף, המפתחים לא צריכים להסתמך על מבנה ה-DOM של ההטמעה הפנימית של Maps API. בגלל מיפוי אירועים פנימי, יכול להיות של-domEvent תהיה סמנטיקה שונה מזו של MapMouseEvent (למשל, ל-MapMouseEvent מסוג "קליק" יכול להיות domEvent מסוג KeyboardEvent).
latLng
אופציונלי
סוג: LatLng optional
קו הרוחב/קו האורך שהיו מתחת לסמן כשהאירוע התרחש.
stop
stop()
פרמטרים: אין
ערך מוחזר: void
מונעת מהאירוע הזה להתפשט הלאה.

ממשק IconMouseEvent

interface google.maps.IconMouseEvent extends MapMouseEvent

האובייקט הזה נשלח באירוע כשמשתמש לוחץ על סמל במפה. מזהה המקום של המקום הזה מאוחסן באיבר placeId. כדי למנוע את הצגת חלון המידע שמוגדר כברירת מחדל, צריך להפעיל את השיטה stop()‎ באירוע הזה כדי למנוע את ההפצה שלו. מידע נוסף על מזהי מקומות זמין במדריך למפתחים של Places API.
placeId
אופציונלי
סוג: string optional
מזהה המקום של המקום שעליו לחצו. אפשר להשתמש במזהה המקום הזה כדי לשלוח שאילתה לקבלת מידע נוסף על התכונה שעליה לחצו.

מידע נוסף על מזהי מקומות זמין במדריך למפתחים של Places API.
בירושה: domEvent, latLng
בירושה: stop

קבועים של ColorScheme

constants google.maps.ColorScheme
ספרייה "core"

מזהים של ערכות צבעים במפה. אפשר לציין אותם לפי ערך או לפי שם הקבוע. לדוגמה, 'FOLLOW_SYSTEM' או google.maps.ColorScheme.FOLLOW_SYSTEM.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג ColorSchemeString.

const {ColorScheme} = await google.maps.importLibrary("core");
DARK ערכת הצבעים הכהה של המפה.
FOLLOW_SYSTEM ערכת הצבעים נבחרת על סמך העדפות המערכת, שנבדקות פעם אחת בזמן הפעלת השיטה.
LIGHT ערכת הצבעים הבהירה של המפה. ערך ברירת המחדל של Maps JS מדור קודם.

קבועים של MapTypeId

constants google.maps.MapTypeId
ספרייה "maps"

מזהים של סוגי מפות נפוצים. אפשר לציין אותם לפי ערך או לפי שם הקבוע. לדוגמה, 'satellite' או google.maps.MapTypeId.SATELLITE.

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג MapTypeIdString.

const {MapTypeId} = await google.maps.importLibrary("maps");
HYBRID בסוג המפה הזה מוצגת שכבה שקופה של רחובות ראשיים על גבי תצלומי לוויין.
ROADMAP בסוג המפה הזה מוצגת מפת רחובות רגילה.
SATELLITE בסוג המפה הזה מוצגים צילומי לוויין.
TERRAIN בסוג המפה הזה מוצגות מפות עם מאפיינים פיזיים כמו פני השטח וצמחייה.

המחלקה MapTypeRegistry

class google.maps.MapTypeRegistry extends MVCObject
library "maps"

מרשם של מופעי MapType, עם מפתח לפי מזהה MapType.

const {MapTypeRegistry} = await google.maps.importLibrary("maps");
MapTypeRegistry
MapTypeRegistry()
פרמטרים: אין
האובייקט MapTypeRegistry מכיל את אוסף סוגי המפות בהתאמה אישית שזמינים לשימוש במפה. לדוגמה, ה-API מתייעץ עם המרשם הזה כשהוא מספק את רשימת סוגי המפות הזמינים בתוך אמצעי הבקרה.
set
set(id, mapType)
פרמטרים:
  • ‫id: string המזהה של MapType שצריך להוסיף לרישום.
  • mapType: MapType|* אובייקט MapType שצריך להוסיף לרישום.
הערך המוחזר: אין
מגדיר את המרשם לשיוך מזהה המחרוזת שהועבר ל-MapType שהועבר.
‫עברו בירושה: addListener, bindTo, get, notify, setValues, unbind, unbindAll

ממשק MapRestriction

ממשק google.maps.MapRestriction

הגבלה שאפשר להחיל על המפה. אזור התצוגה של המפה לא יחרוג מההגבלות האלה.
latLngBounds
כשהאפשרות הזו מוגדרת, המשתמש יכול להזיז את המפה ולשנות את מרחק התצוגה רק בתוך הגבולות שצוינו. הגבולות יכולים להגביל גם את קו האורך וגם את קו הרוחב, או להגביל רק את קו הרוחב. כדי להגדיר גבולות של קווי רוחב בלבד, משתמשים בקווי אורך מערביים ומזרחיים של ‎-180 ו-180, בהתאמה, לדוגמה, latLngBounds: {north: northLat, south: southLat, west: -180, east: 180}.
strictBounds
אופציונלי
סוג: boolean optional
כדי להגדיר גבולות מחמירים יותר, אפשר להגדיר את הדגל strictBounds לערך true. כך המשתמשים לא יכולים להתרחק יותר מדי, וכל מה שנמצא מחוץ לגבולות המוגבלים נשאר מוסתר. ערך ברירת המחדל הוא false, כלומר המשתמש יכול להקטין את התצוגה עד שכל האזור התחום מוצג, כולל אזורים מחוץ לאזור התחום.

הכיתה TrafficLayer

class google.maps.TrafficLayer extends MVCObject
library "maps"

שכבת תנועה.

const {TrafficLayer} = await google.maps.importLibrary("maps");
TrafficLayer
TrafficLayer([opts])
פרמטרים:
שכבה שמוצג בה עומס התנועה הנוכחי בכבישים.
getMap
getMap()
פרמטרים: אין
ערך מוחזר: Map|null
מחזירה את המפה שבה מוצגת השכבה הזו.
setMap
setMap(map)
פרמטרים:
  • map: Map optional
הערך המוחזר: אין
הפונקציה מעבדת את השכבה במפה שצוינה. אם המפה מוגדרת ל-null, השכבה תוסר.
setOptions
setOptions(options)
פרמטרים:
הערך המוחזר: אין
‫עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

ממשק TrafficLayerOptions

ממשק google.maps.TrafficLayerOptions

אובייקט TrafficLayerOptions משמש להגדרת המאפיינים שאפשר להגדיר ב-TrafficLayer.
autoRefresh
אופציונלי
סוג: boolean optional
ברירת המחדל: true
אם שכבת התנועה מתרעננת באופן אוטומטי עם מידע מעודכן.
map
אופציונלי
סוג: Map optional
המפה שבה תוצג שכבת התנועה.

המחלקה TransitLayer

class google.maps.TransitLayer extends MVCObject
library "maps"

שכבת תחבורה ציבורית.

const {TransitLayer} = await google.maps.importLibrary("maps");
TransitLayer
TransitLayer()
פרמטרים: אין
שכבה שמוצגים בה קווי תחבורה ציבורית.
getMap
getMap()
פרמטרים: אין
ערך מוחזר: Map|null
מחזירה את המפה שבה מוצגת השכבה הזו.
setMap
setMap(map)
פרמטרים:
  • map: Map optional
ערך מוחזר: void
הפונקציה מעבדת את השכבה במפה שצוינה. אם המפה מוגדרת ל-null, השכבה תוסר.
‫עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

המחלקה BicyclingLayer

class google.maps.BicyclingLayer extends MVCObject
library "maps"

שכבה המציגה נתיבי אופניים ושבילים.

const {BicyclingLayer} = await google.maps.importLibrary("maps");
BicyclingLayer
BicyclingLayer()
פרמטרים: אין
שכבה שמציגה נתיבים ושבילים לאופניים ומורידה בדרגה כבישים גדולים.
getMap
getMap()
פרמטרים: אין
ערך מוחזר: Map|null
מחזירה את המפה שבה מוצגת השכבה הזו.
setMap
setMap(map)
פרמטרים:
  • map: Map optional
ערך מוחזר: void
הפונקציה מעבדת את השכבה במפה שצוינה. אם המפה מוגדרת ל-null, השכבה תוסר.
‫עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

ממשק CameraOptions

ממשק google.maps.CameraOptions
מורחב על ידי CameraParams

משמש להגדרת אפשרויות המצלמה של המפה.
center
אופציונלי
סוג: LatLngLiteral|LatLng optional
heading
אופציונלי
סוג: number optional
tilt
אופציונלי
סוג: number optional
zoom
אופציונלי
סוג: number optional

ממשק VisibleRegion

ממשק google.maps.VisibleRegion

מכיל את ארבע הנקודות שמגדירות את המצולע בעל ארבע הצלעות שהוא האזור הגלוי של המפה. במפה וקטורית, הפוליגון הזה יכול להיות טרפז במקום מלבן, כשיש הטיה במפה וקטורית.
farLeft
סוג: LatLng
farRight
סוג: LatLng
latLngBounds
סוג: LatLngBounds
התיבה התוחמת הקטנה ביותר שכוללת את האזור הגלוי.
nearLeft
סוג: LatLng
nearRight
סוג: LatLng

קבועים של RenderingType

constants google.maps.RenderingType
ספרייה "maps"

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג RenderingTypeString.

const {RenderingType} = await google.maps.importLibrary("maps");
RASTER מציין שהמפה היא מפה מבוססת-פיקסלים.
UNINITIALIZED מציין שעדיין לא ידוע אם המפה היא וקטורית או רסטר, כי המפה עדיין לא סיימה את תהליך האתחול.
VECTOR מציין שהמפה היא מפה וקטורית.

ממשק MapCapabilities

ממשק google.maps.MapCapabilities

אובייקט שמכיל תמונת מצב של היכולות שזמינות כרגע במפה. חשוב לזכור שזה לא בהכרח אומר שהמודולים הרלוונטיים נטענים או מאותחלים, אלא שלמפה הנוכחית יש הרשאה להשתמש בממשקי ה-API האלה. רשימה של יכולות אפשריות מופיעה במאפיינים.
isAdvancedMarkersAvailable
אופציונלי
סוג: boolean optional
אם הערך הוא True, המפה הזו מוגדרת בצורה תקינה ומאפשרת שימוש בסמנים מתקדמים. שימו לב שעדיין צריך לייבא את הספרייה marker כדי להשתמש בסמנים מתקדמים. מידע נוסף זמין בכתובת https://goo.gle/gmp-isAdvancedMarkersAvailable.
isDataDrivenStylingAvailable
אופציונלי
סוג: boolean optional
אם הערך הוא True, המפה הזו מוגדרת בצורה נכונה ומאפשרת להשתמש בסגנון מבוסס-נתונים בשכבת FeatureLayer אחת לפחות. מידע נוסף זמין בכתובות https://goo.gle/gmp-data-driven-styling ו-https://goo.gle/gmp-FeatureLayerIsAvailable.
isWebGLOverlayViewAvailable
אופציונלי
סוג: boolean optional
אם הערך הוא True, המפה הזו מוגדרת כמו שצריך כדי לאפשר שימוש ב-WebGLOverlayView.