Maps

המחלקה MapElement

מחלקה google.maps.MapElement

‫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="vector" tilt-interaction-disabled zoom="number"></gmp-map>

המחלקה הזו מרחיבה את HTMLElement.

המחלקה הזו מטמיעה את MapElementOptions.

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

MapElement
MapElement([options])
פרמטרים: 
center
סוג:  LatLng|LatLngLiteral optional
קו הרוחב/האורך של מרכז המפה.
מאפיין HTML:
  • <gmp-map center="lat,lng"></gmp-map>
headingInteractionDisabled
סוג:  boolean optional
ברירת המחדל: false
אם המפה צריכה לאפשר למשתמש לשלוט בכיוון המצלמה (סיבוב). האפשרות הזו רלוונטית רק אם המפה היא מפה וקטורית. אם לא מגדירים את הסגנון בקוד, המערכת משתמשת בהגדרות של מזהה המפה בענן (אם הן זמינות).
מאפיין HTML:
  • <gmp-map heading-interaction-disabled></gmp-map>
innerMap
סוג:  Map
הפניה ל-Map שבו MapElement משתמש באופן פנימי.
internalUsageAttributionIds
סוג:  Iterable<string> optional
ברירת המחדל: null
מוסיף מזהה שיוך שימוש למאתחל, שעוזר ל-Google להבין אילו ספריות ודוגמאות מועילות למפתחים, כמו שימוש בספריית מקבצי סמנים. כדי לבטל את ההסכמה לשליחת מזהה השיוך של השימוש, אפשר למחוק את המאפיין הזה או להחליף את הערך במחרוזת ריקה. יישלחו רק ערכים ייחודיים. יכול להיות שהמערכת תתעלם משינויים בערך הזה אחרי יצירת המופע.
מאפיין HTML:
  • <gmp-map internal-usage-attribution-ids="id1 id2"></gmp-map>
mapId
סוג:  string optional
מזהה המפה. אי אפשר להגדיר או לשנות את הפרמטר הזה אחרי שיוצרים מופע של מפה. אפשר להשתמש ב-Map.DEMO_MAP_ID כדי לנסות תכונות שדורשות מזהה מפה אבל לא דורשות הפעלה בענן.
מאפיין HTML:
  • <gmp-map map-id="string"></gmp-map>
renderingType
סוג:  RenderingType optional
ברירת המחדל: RenderingType.VECTOR
אם המפה צריכה להיות מפת רסטר או מפה וקטורית. אי אפשר להגדיר או לשנות את הפרמטר הזה אחרי שיוצרים מופע של מפה. אם לא מגדירים את המאפיין, סוג העיבוד נקבע לפי ההגדרות בענן של מזהה המפה (אם הן זמינות). חשוב לדעת: יכול להיות שמפות וקטוריות לא יהיו זמינות בכל המכשירים והדפדפנים, ובמקרה כזה המפה תוחלף במפה מבוססת-פיקסלים.
מאפיין HTML:
  • <gmp-map rendering-type="vector"></gmp-map>
  • <gmp-map rendering-type="raster"></gmp-map>
tiltInteractionDisabled
סוג:  boolean optional
ברירת המחדל: false
אם המפה צריכה לאפשר למשתמש לשלוט בהטיית המצלמה. האפשרות הזו רלוונטית רק אם המפה היא מפה וקטורית. אם לא מגדירים את הסגנון בקוד, המערכת משתמשת בהגדרות של מזהה המפה בענן (אם הן זמינות).
מאפיין HTML:
  • <gmp-map tilt-interaction-disabled></gmp-map>
zoom
סוג:  number optional
רמת הזום של המפה. ערכי זום חוקיים הם מספרים מאפס ועד רמת הזום המקסימלית שנתמכת. ערכי זום גדולים יותר תואמים לרזולוציה גבוהה יותר.
מאפיין HTML:
  • <gmp-map zoom="number"></gmp-map>
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
addEventListener(type, listener[, options])
פרמטרים: 
  • ‫type:  string מחרוזת תלויית אותיות רישיות שמייצגת את סוג האירוע שרוצים להאזין לו.
  • ‫listener:  EventListener|EventListenerObject האובייקט שמקבל התראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent
  • ‫options:  boolean|AddEventListenerOptions optional לאפשרויות. אירועים בהתאמה אישית תומכים רק ב-capture וב-passive.
ערך מוחזר:  void
מגדירה פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. אפשר לעיין במאמר בנושא addEventListener.
removeEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • type:  string מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener.
  • ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע.
  • ‫options:  boolean|EventListenerOptions optional לאפשרויות.
ערך מוחזר:  void
הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.
gmp-zoomchange
function(event)
ארגומנטים: 
האירוע הזה מופעל כשמאפיין הזום של המפה משתנה.

הממשק MapElementOptions

ממשק google.maps.MapElementOptions

אובייקט MapElementOptions משמש להגדרת המאפיינים שאפשר להגדיר ב-MapElement.

center optional
סוג:  LatLng|LatLngLiteral optional
headingInteractionDisabled optional
סוג:  boolean optional
internalUsageAttributionIds optional
סוג:  Iterable<string> optional
mapId optional
סוג:  string optional
renderingType optional
סוג:  RenderingType optional
tiltInteractionDisabled optional
סוג:  boolean optional
zoom optional
סוג:  number optional

מחלקה ZoomChangeEvent

מחלקה google.maps.ZoomChangeEvent

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

המחלקה הזו מרחיבה את Event.

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

מחלקה Map

מחלקה google.maps.Map

המחלקה הזו מרחיבה את 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 מזהה מפה שאפשר להשתמש בו בדוגמאות קוד שנדרש בהן מזהה מפה. מזהה המפה הזה לא מיועד לשימוש באפליקציות בסביבת ייצור, ואי אפשר להשתמש בו לתכונות שדורשות הגדרה בענן (כמו עיצוב מבוסס-ענן).
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.
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:  LatLng|LatLngLiteral קו הרוחב/קו האורך החדש של מרכז המפה.
ערך מוחזר:  אין
משנה את מרכז המפה ל-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 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 של הסמן שיוצג כשמעבירים את העכבר מעל מפה שניתן לגרור. המאפיין הזה משתמש במאפיין ה-CSS‏ cursor כדי לשנות את הסמל. כמו במאפיין ה-CSS, צריך לציין לפחות סמן חלופי אחד שהוא לא כתובת URL. לדוגמה: draggableCursor: 'url(http://www.example.com/icon.png), auto;'.
draggingCursor optional
סוג:  string optional
השם או כתובת ה-URL של הסמן שיוצג כשגוררים את המפה. המאפיין הזה משתמש במאפיין ה-CSS‏ cursor כדי לשנות את הסמל. כמו במאפיין ה-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, אל תנקה את התוכן של ה-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 כשמציגים סוג מפה שבו שכבת-העל של הדרכים ב-Street View לא אמורה להופיע (למשל, סוג מפה שאינו Earth).
streetViewControlOptions optional
סוג:  StreetViewControlOptions optional
אפשרויות התצוגה הראשוניות של פקד האטב-איש ב-Street View.
styles optional
סוג:  Array<MapTypeStyle> optional
סגנונות שאפשר להחיל על כל אחד מסוגי המפות שמוגדרים כברירת מחדל. חשוב לזכור שבמצבים satellite/hybrid ו-terrain, הסגנונות האלה יחולו רק על תוויות ועל גיאומטריה. התכונה הזו לא זמינה כשמשתמשים במזהה מפה או במפות וקטוריות (במקום זאת, צריך להשתמש בעיצוב מפות מבוסס-ענן).
tilt optional
סוג:  number optional
במפות וקטוריות, מגדיר את זווית ההטיה של המפה. הערכים המותרים מוגבלים בהתאם לרמת הזום של המפה. במפות מבוססות-פיקסלים, ההגדרה הזו קובעת את ההתנהגות של המעבר האוטומטי לזווית ההטיה של המפה. הערכים היחידים שמותרים הם 0 ו-45. הערך 0 גורם למפה להשתמש תמיד בתצוגה עילית של 0°, בלי קשר לרמת הזום ולמסך התצוגה. הערך 45 גורם לזווית ההטיה להשתנות אוטומטית ל-45 בכל פעם שתמונות ב-45° זמינות ברמת הזום ובאזור התצוגה הנוכחיים, ולחזור ל-0 בכל פעם שתמונות ב-45° לא זמינות (זוהי פעולת ברירת המחדל). תמונות בזווית של 45 מעלות זמינות רק לסוגי המפות satellite ו-hybrid, במיקומים מסוימים וברמות זום מסוימות. הערה: הפונקציה getTilt מחזירה את זווית ההטיה הנוכחית, ולא את הערך שצוין באפשרות הזו. מכיוון ש-getTilt והאפשרות הזו מתייחסים לדברים שונים, אין bind() את המאפיין tilt. פעולה כזו עלולה להוביל לתוצאות בלתי צפויות.
tiltInteractionEnabled optional
סוג:  boolean optional
ברירת המחדל: false
אם המפה צריכה לאפשר למשתמש לשלוט בהטיית המצלמה. האפשרות הזו רלוונטית רק אם המפה היא מפה וקטורית. אם לא מגדירים את הסגנון בקוד, המערכת משתמשת בהגדרות של מזהה המפה בענן (אם הן זמינות).
zoom optional
סוג:  number optional
רמת הזום הראשונית של המפה. ערכי זום חוקיים הם מספרים מאפס ועד רמת הזום המקסימלית שנתמכת. ערכי זום גדולים יותר תואמים לרזולוציה גבוהה יותר.
zoomControl optional
סוג:  boolean optional
מצב ההפעלה/ההשבתה של פקד הזום.
zoomControlOptions optional
סוג:  ZoomControlOptions optional
אפשרויות התצוגה של פקד הזום.

ממשק MapTypeStyle

ממשק google.maps.MapTypeStyle

MapTypeStyle הוא אוסף של בוררים וסגנונות שמגדירים את סגנון המפה. הסלקטורים מציינים את התכונות ו/או הרכיבים במפה שיושפעו, והמעצבים מציינים איך לשנות את התכונות והרכיבים האלה. פרטים נוספים זמינים בחומר העזר בנושא סגנונות.

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

ממשק MapMouseEvent

ממשק google.maps.MapMouseEvent

האובייקט הזה מוחזר מאירועי עכבר שונים במפה ובשכבות-העל, והוא מכיל את כל השדות שמוצגים בהמשך.

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

ממשק IconMouseEvent

ממשק google.maps.IconMouseEvent

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

הממשק הזה מרחיב את MapMouseEvent.

placeId optional
סוג:  string optional
מזהה המקום של המקום שעליו לחצו. אפשר להשתמש במזהה המקום הזה כדי לשלוח שאילתה לקבלת מידע נוסף על התכונה שעליה לחצו.

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

בירושה: domEvent, latLng
בירושה: stop

קבועים של ColorScheme

google.maps.ColorScheme קבועים

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

כדי לקבל גישה, צריך לקרוא ל: const {ColorScheme} = await google.maps.importLibrary("core").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

DARK ערכת הצבעים הכהה של המפה.
FOLLOW_SYSTEM ערכת הצבעים נבחרת על סמך העדפות המערכת, שנבדקות פעם אחת בזמן הפעלת השיטה.
LIGHT ערכת הצבעים הבהירה של המפה. ערך ברירת המחדל של Maps JS מדור קודם.

קבועים של MapTypeId

google.maps.MapTypeId קבועים

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

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

HYBRID בסוג המפה הזה מוצגת שכבה שקופה של רחובות ראשיים על גבי תצלומי לוויין.
ROADMAP בסוג המפה הזה מוצגת מפת רחובות רגילה.
SATELLITE בסוג המפה הזה מוצגים צילומי לוויין.
TERRAIN בסוג המפה הזה מוצגות מפות עם מאפיינים פיזיים כמו פני השטח וצמחייה.

המחלקה MapTypeRegistry

מחלקה google.maps.MapTypeRegistry

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

המחלקה הזו מרחיבה את MVCObject.

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

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 optional
סוג:  boolean optional
כדי להגדיר גבולות מחמירים יותר, אפשר להגדיר את הדגל strictBounds לערך true. כך המשתמשים לא יכולים להתרחק יותר מדי, וכל מה שנמצא מחוץ לגבולות המוגבלים נשאר מוסתר. ערך ברירת המחדל הוא false, כלומר המשתמש יכול להקטין את התצוגה עד שכל האזור התחום מוצג, כולל אזורים מחוץ לאזור התחום.

הכיתה TrafficLayer

מחלקה google.maps.TrafficLayer

שכבת תנועה.

המחלקה הזו מרחיבה את MVCObject.

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

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 optional
סוג:  boolean optional
ברירת המחדל: true
אם שכבת התנועה מתרעננת באופן אוטומטי עם מידע מעודכן.
map optional
סוג:  Map optional
המפה שבה תוצג שכבת התנועה.

המחלקה TransitLayer

מחלקה google.maps.TransitLayer

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

המחלקה הזו מרחיבה את MVCObject.

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

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

המחלקה BicyclingLayer

מחלקה google.maps.BicyclingLayer

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

המחלקה הזו מרחיבה את MVCObject.

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

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

משמש להגדרת אפשרויות המצלמה של המפה.

center optional
סוג:  LatLngLiteral|LatLng optional
heading optional
סוג:  number optional
tilt optional
סוג:  number optional
zoom optional
סוג:  number optional

ממשק VisibleRegion

ממשק google.maps.VisibleRegion

מכיל את ארבע הנקודות שמגדירות את המצולע בעל ארבע הצלעות שהוא האזור הגלוי של המפה. במפה וקטורית, הפוליגון הזה יכול להיות טרפז במקום מלבן, כשיש הטיה במפה וקטורית.

farLeft
סוג:  LatLng
farRight
סוג:  LatLng
latLngBounds
סוג:  LatLngBounds
התיבה התוחמת הקטנה ביותר שכוללת את האזור הגלוי.
nearLeft
סוג:  LatLng
nearRight
סוג:  LatLng

קבועים של RenderingType

google.maps.RenderingType קבועים

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

RASTER מציין שהמפה היא מפה מבוססת-פיקסלים.
UNINITIALIZED מציין שעדיין לא ידוע אם המפה היא וקטורית או רסטר, כי המפה עדיין לא סיימה את תהליך האתחול.
VECTOR מציין שהמפה היא מפה וקטורית.

ממשק MapCapabilities

ממשק google.maps.MapCapabilities

אובייקט שמכיל תמונת מצב של היכולות שזמינות כרגע במפה. חשוב לזכור שזה לא בהכרח אומר שהמודולים הרלוונטיים נטענים או מאותחלים, אלא שלמפה הנוכחית יש הרשאה להשתמש בממשקי ה-API האלה. רשימה של יכולות אפשריות מופיעה במאפיינים.

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