Maps

סיווג מפה

google.maps.Map מחלקה

כיתה זו תקפה ל-MVCObject.

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

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])
פרמטרים: 
  • boundsLatLngBounds|LatLngBoundsLiteral גבולות להצגה.
  • paddingnumber|Padding optional מרווח בפיקסלים. הגבולות יותאמו לחלק שיישאר במפה לאחר הסרת המרווח הפנימי. ערך של מספר יגרום לאותו מרווח פנימי בכל 4 הצדדים. מזינים כאן את הערך 0 כדי ליצור אידמפוטנט של BoundBounds על התוצאה של getBounds.
ערך החזרה: ללא
מגדירה את אזור התצוגה כך שיכיל את הגבולות הנתונים.
הערה: כשהמפה מוגדרת לערך 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
מחזירה את הקליקביליות של סמלי המפה. סמל מפה מייצג נקודת עניין, ידועה גם כנקודת עניין. אם הערך המוחזר הוא true, הסמלים לחיצים במפה.
BetagetDatasetFeatureLayer
getDatasetFeatureLayer(datasetId)
פרמטרים: 
  • datasetIdstring
הערך המוחזר:  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.
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.
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
ערך החזרה: ללא
קובעת אם ניתן ללחוץ על סמלי המפה. סמל מפה מייצג נקודת עניין, ידועה גם כנקודת עניין. כדי להשבית את יכולת הקליקביליות של סמלי המפה, יש להעביר את הערך false לשיטה הזו.
setHeading
setHeading(heading)
פרמטרים: 
  • headingnumber
ערך החזרה: ללא
מגדירה את כיוון המצפן עבור מפה שנמדדת במעלות מכיוון צפון. עבור מפות רסטר, שיטה זו חלה רק על תמונות אוויריות.
setMapTypeId
setMapTypeId(mapTypeId)
פרמטרים: 
ערך החזרה: ללא
setOptions
setOptions(options)
פרמטרים: 
ערך החזרה: ללא
setStreetView
setStreetView(panorama)
פרמטרים: 
ערך החזרה: ללא
מקשר 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. פעולה זו עלולה לגרום להשפעות בלתי צפויות.
setZoom
setZoom(zoom)
פרמטרים: 
  • zoomnumber ערכים גדולים יותר של זום תואמים לרזולוציה גבוהה יותר.
ערך החזרה: ללא
הגדרת מרחק התצוגה של המפה.
עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
bounds_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר הגבולות של אזור התצוגה משתנים.
center_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כשנכס מרכז המפה משתנה.
click
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהמשתמש לוחץ על המפה. מוצג אירועי MapMouse עם מאפיינים עבור המיקום שעליו לוחצים, אלא אם לוחצים על סמל מקום. במקרה כזה מוחזר IconMouseEvent עם מזהה מקום. IconMouseEvent ו-MapMouseEvent זהים, אלא ש- IconMouseEvent מכיל את שדה מזהה המקום. תמיד אפשר להתייחס לאירוע כ-MapMouseEvent כאשר מזהה המקום אינו חשוב. אירוע הקליק לא מופעל אם לוחצים על סמן או על חלון מידע.
contextmenu
function(event)
ארגומנטים: 
האירוע הזה מופעל כאשר אירוע תפריט ההקשר של DOM מופעל במאגר התגים של המפה.
dblclick
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהמשתמש לוחץ לחיצה כפולה על המפה. חשוב לדעת שאירוע הקליק מופעל לפעמים פעם אחת ולפעמים פעמיים, ממש לפני האירוע הזה.
drag
function()
ארגומנטים: ללא
האירוע הזה מופעל שוב ושוב בזמן שהמשתמש גורר את המפה.
dragend
function()
ארגומנטים: ללא
האירוע הזה מופעל כשהמשתמש מפסיק לגרור את המפה.
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()
ארגומנטים: ללא
האירוע הזה מופעל כשה-רינדורType משתנה.
tilesloaded
function()
ארגומנטים: ללא
האירוע הזה מופעל כשהמשבצות הגלויות מסתיימות.
tilt_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כשמאפיין הטיה של המפה משתנה.
zoom_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כשהמאפיין של שינוי מרחק התצוגה במפה משתנה.
rightclick
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהמשתמש לוחץ לחיצה ימנית על המפה.

ממשק MapOptions

google.maps.MapOptions ממשק

אובייקט MapOptions המשמש להגדרת המאפיינים שניתן להגדיר במפה.

backgroundColor optional
סוג:  string optional
הצבע המשמש לרקע של Map div. הצבע הזה יופיע כאשר המשבצות עדיין לא נטענו בזמן הצגת המשבצות של המשתמש. ניתן להגדיר את האפשרות הזו רק לאחר אתחול המפה.
center optional
סוג:  LatLng|LatLngLiteral optional
מרכז המפה הראשוני.
clickableIcons optional
סוג:  boolean optional
ברירת מחדל: true
אחרי false, לא ניתן ללחוץ על סמלי המפה. סמל מפה מייצג נקודת עניין, ידועה גם כנקודת עניין.
controlSize optional
סוג:  number optional
הגודל בפיקסלים של הפקדים שמופיעים במפה. יש לספק את הערך הזה ישירות בזמן יצירת המפה. עדכון הערך הזה מאוחר יותר עשוי להעביר את הפקדים למצב undefined. המדיניות הזו קובעת רק את אמצעי הבקרה שהוגדרו על ידי ה-API של מפות Google עצמו. לא מתבצעת התאמה לעומס (scaling) של פקדים מותאמים אישית שנוצרו על ידי המפתח.
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
הכותרת של צילומי אוויר במעלות נמדדה בכיוון השעון מהכיוון הקרדינל צפוני. הכותרות מוצמדות לזווית הקרובה ביותר לזמינות עבור התמונה.
isFractionalZoomEnabled optional
סוג:  boolean optional
ברירת מחדל: true למפות וקטוריות ו-false למפות רסטר
האם כדאי במפה לאפשר רמות חלקיות של מרחק מתצוגה. כדי לדעת מתי הוגדרה ברירת המחדל, יש להאזין לisfractionalzoomenabled_changed.
keyboardShortcuts optional
סוג:  boolean optional
אם המדיניות false מוגדרת כך, המפה לא נשלטת על ידי המקלדת. מקשי הקיצור מופעלים כברירת מחדל.
mapId optional
סוג:  string optional
מזהה המפה של המפה. לא ניתן להגדיר או לשנות פרמטר זה לאחר יצירת מפה.
mapTypeControl optional
סוג:  boolean optional
המצב הראשוני המופעל/מושבת של פקד סוג המפה.
mapTypeControlOptions optional
סוג:  MapTypeControlOptions optional
אפשרויות התצוגה הראשונות לבקרת סוג המפה.
mapTypeId optional
סוג:  MapTypeId|string optional
מזהה המפה ההתחלתי. ברירת המחדל היא 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
אפשרויות התצוגה של פקד ההזזה.

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 (למשל, סוג מפה שאינו כדור הארץ).
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. אם תעשו זאת, עלולה להיות לכך השפעות בלתי צפויות.
zoom optional
סוג:  number optional
רמת המרחק מהתצוגה הראשונית של המפה. הערכים החוקיים של מרחק התצוגה הם מספרים מאפס עד לרמת הזום המקסימלית הנתמכת. ערכי זום גדולים יותר מציינים רזולוציה גבוהה יותר.
zoomControl optional
סוג:  boolean optional
המצב המופעל/מושבת של הפקד של Zoom.
zoomControlOptions optional
סוג:  ZoomControlOptions optional
אפשרויות התצוגה של הפקד 'מרחק מתצוגה'.

מחלקה של 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, שניתן לגשת אליו באמצעות הנכס innerMap.

רכיב מותאם אישית:
<gmp-map center="lat,lng" map-id="string" zoom="number"></gmp-map>

כיתה זו תקפה ל-HTMLElement.

בדומיין הזה מוטמעת MapElementOptions.

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

MapElement
MapElement([options])
פרמטרים: 
center
סוג:  LatLng|LatLngLiteral optional
קו הרוחב/קו האורך המרכזי של המפה.
מאפיין HTML:
  • <gmp-map center="lat,lng"></gmp-map>
innerMap
סוג:  Map
הפניה ל-Map שבו משתמש MapElement באופן פנימי.
mapId
סוג:  string optional
מזהה המפה של המפה. מידע נוסף זמין במסמכי התיעוד של מזהה המפה.
מאפיין HTML:
  • <gmp-map map-id="string"></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.
BetaaddEventListener
addEventListener(type, listener[, options])
פרמטרים: 
  • typestring מחרוזת תלוית אותיות רישיות שמייצגת את סוג האירוע שצריך להאזין לו.
  • listenerEventListener|EventListenerObject האובייקט שמקבל התראה. הפריט הזה חייב להיות פונקציה או אובייקט עם method מסוג HandEvent
  • optionsboolean|AddEventListenerOptions optional ראו אפשרויות. אירועים בהתאמה אישית תומכים רק ב-capture וב-passive.
הערך המוחזר:  void
מגדירה פונקציה שתיקרא בכל פעם שהאירוע שצוין מועבר ליעד. הצגת addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • typestring מחרוזת שמציינת את סוג האירוע שעבורו יש להסיר פונקציות event listener.
  • listenerEventListener|EventListenerObject ה-event listener של הגורם המטפל באירועים שיש להסיר מהיעד.
  • optionsboolean|EventListenerOptions optional ראה אפשרויות
הערך המוחזר:  void
מסיר מהיעד מעבד אירוע שנרשם בעבר ב-addEventListener. הצגת removeEventListener
gmp-zoomchange
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהמאפיין של שינוי מרחק התצוגה במפה משתנה.

הממשק MapElementOptions

google.maps.MapElementOptions ממשק

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

center optional
סוג:  LatLng|LatLngLiteral optional
מרכז המפה הראשוני.
mapId optional
סוג:  string optional
מזהה המפה של המפה. לא ניתן להגדיר או לשנות פרמטר זה לאחר יצירת מפה.
zoom optional
סוג:  number optional
רמת המרחק מהתצוגה הראשונית של המפה. הערכים החוקיים של מרחק התצוגה הם מספרים מאפס עד לרמת הזום המקסימלית הנתמכת. ערכי זום גדולים יותר מציינים רזולוציה גבוהה יותר.

המחלקה ZoomChangeEvent

google.maps.ZoomChangeEvent מחלקה

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

כיתה זו תקפה ל-Event.

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

ממשק MapTypeStyle

google.maps.MapTypeStyle ממשק

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

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

ממשק MapMouseEvent

google.maps.MapMouseEvent ממשק

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

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

ממשק IconMouseEvent

google.maps.IconMouseEvent ממשק

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

הממשק הזה פועל ב-MapMouseEvent.

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

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

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

קבועים של MapTypeId

google.maps.MapTypeId קבועים

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

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

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

מחלקה MapTypeRegistry

google.maps.MapTypeRegistry מחלקה

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

כיתה זו תקפה ל-MVCObject.

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

MapTypeRegistry
MapTypeRegistry()
פרמטרים: ללא
הMapTypeRegistry מכיל את האוסף של סוגי המפות המותאמים אישית שזמינים למפה לשימוש בה. ממשק ה-API נעזר במרשם הזה כדי לספק, לדוגמה, את רשימת סוגי המפות הזמינים בפקדים.
set
set(id, mapType)
פרמטרים: 
  • idstring מזהה של MapType שיש להוסיף למרשם.
  • mapTypeMapType|* אובייקט 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"). למידע נוסף, אפשר לעיין במאמר בנושא ספריות ב-API של JavaScript במפות.

TrafficLayer
TrafficLayer([opts])
פרמטרים: 
שכבה שמציגה את מצב התנועה הנוכחי בכביש.
getMap
getMap()
פרמטרים: ללא
הערך המוחזר:  Map
מחזירה את המפה שבה מוצגת השכבה הזו.
setMap
setMap(map)
פרמטרים: 
ערך החזרה: ללא
הצגת השכבה במפה שצוינה. אם קובעים במפה את הערך 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"). למידע נוסף, אפשר לעיין במאמר בנושא ספריות ב-API של JavaScript במפות.

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

מחלקה BicyclingLayer

google.maps.BicyclingLayer מחלקה

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

כיתה זו תקפה ל-MVCObject.

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

BicyclingLayer
BicyclingLayer()
פרמטרים: ללא
שכבה שמציגה שבילים ושבילים לאופניים ומורידה בדרגה כבישים גדולים.
getMap
getMap()
פרמטרים: ללא
הערך המוחזר:  Map
מחזירה את המפה שבה מוצגת השכבה הזו.
setMap
setMap(map)
פרמטרים: 
ערך החזרה: ללא
הצגת השכבה במפה שצוינה. אם קובעים במפה את הערך 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"). למידע נוסף, אפשר לעיין במאמר בנושא ספריות ב-API של JavaScript במפות.

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.