Maps

סיווג מפה

google.maps.Map סיווג

הכיתה הזו משתרעת על פני MVCObject.

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

Map
Map(mapDiv[, opts])
פרמטרים: 
  • mapDivHTMLElement המפה תעבור עיבוד כדי למלא את הרכיב הזה.
  • optsMapOptions optional אפשרויות
יוצר מפה חדשה בתוך מאגר ה-HTML הנתון, שהוא בדרך כלל רכיב DIV.
DEMO_MAP_ID מזהה מפה שיכול לשמש לדוגמאות קוד שנדרש להן מזהה מפה. מזהה המפה הזה לא מיועד לשימוש באפליקציות בסביבת ייצור ואי אפשר להשתמש בו בתכונות שמחייבות הגדרה בענן (כמו Cloud Styling).
controls
פקדים נוספים שאפשר לצרף למפה. כדי להוסיף פקד למפה, צריך להוסיף את ה-<div> של הפקד ל-MVCArray שתואם ל-ControlPosition שבו הוא צריך להיות מוצג.
data
סוג:  Data
מופע של Data, המקושר למפה. אפשר להוסיף תכונות לאובייקט Data הזה כדי להציג אותן בנוחות במפה הזו.
mapTypes
סוג:  MapTypeRegistry
רישום של MapType מופעים לפי מזהה מחרוזת.
overlayMapTypes
סוג:  MVCArray<MapType optional>
סוגי מפות נוספים שניתן להציג כשכבת-על. סוגי מפות שמוצגים בשכבת-על יוצגו מעל למפת הבסיס שאליה הם מצורפים, לפי הסדר שבו הם מופיעים במערך overlayMapTypes (שכבות-על עם ערכי אינדקס גבוהים יותר מוצגות לפני שכבות-על עם ערכי אינדקס נמוכים יותר).
fitBounds
fitBounds(bounds[, padding])
פרמטרים: 
  • boundsLatLngBounds|LatLngBoundsLiteral גבולות להצגה.
  • paddingnumber|Padding optional מרווח בפיקסלים. הגבולות יהיו מתאימים לחלק של המפה שיישאר לאחר הסרת המרווח הפנימי. ערך של מספר יניב את אותו מרווח פנימי בכל 4 הצדדים. צריך לציין כאן את הערך 0 כדי ליצור אידמפוטנטיות של fitBounds עם התוצאה של getBounds.
ערך החזרה: ללא
מגדיר את אזור התצוגה כך שיכיל את הגבולות הנתונים.
הערה: כשהמפה מוגדרת לערך display: none, הפונקציה fitBounds קוראת את גודל המפה כ-0x0, ולכן לא מבצעת שום פעולה. כדי לשנות את אזור התצוגה בזמן שהמפה מוסתרת, צריך להגדיר את המפה לערך visibility: hidden וכך לוודא שגודל המפה של div יהיה זהה. עבור מפות וקטוריות, השיטה הזו מגדירה את ההטיה והכותרת של המפה לערכי ברירת המחדל של אפס. קריאה לשיטה זו עשויה לגרום לאנימציה חלקה בזמן שהמפה מזיזת את המפה ומשנה את מרחק התצוגה כדי להתאים לגבולות. אם השיטה הזו יוצרת אנימציה או לא, תלויה בהיוריסטיקה פנימית.
getBounds
getBounds()
פרמטרים: ללא
ערך החזרה:  LatLngBounds|undefined גבולות קו הרוחב/אורך אזור התצוגה הנוכחי.
מחזירה את גבולות קווי הרוחב/Lng של אזור התצוגה הנוכחי. אם ניתן לראות יותר מעותק אחד של העולם, טווח הגבולות הוא בין 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 the 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)
פרמטרים: 
ערך החזרה: ללא
שינוי מרכז המפה לאזור 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)
ארגומנטים: 
האירוע הזה מופעל כשהמשתמש לוחץ על המפה. אירוע MapMouseEvent עם מאפיינים עבור המיקום שעליו לוחצים מוחזר אלא אם כן לוחצים על סמל מקום. במקרה כזה מוחזר 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
צבע המשמש לרקע של div המפה. הצבע הזה יהיה גלוי כאשר המשבצות עדיין לא נטענו כתבניות המשתמש. ניתן להגדיר את האפשרות הזו רק כשהמפה מאותחלת.
center optional
סוג:  LatLng|LatLngLiteral optional
מרכז המפה הראשוני.
clickableIcons optional
סוג:  boolean optional
ברירת מחדל: true
כאשר false, לא ניתן ללחוץ על סמלי המפה. סמל מפה מייצג נקודת עניין, או נקודת עניין.
controlSize optional
סוג:  number optional
הגודל בפיקסלים של הפקדים שמופיעים במפה. יש לספק את הערך הזה ישירות בזמן יצירת המפה. עדכון הערך הזה מאוחר יותר עשוי להעביר את הפקדים למצב undefined. חל רק על אמצעי הבקרה שהוגדרו על ידי ה-API של מפות Google עצמו. לא ניתן להתאים לעומס את אמצעי הבקרה המותאמים אישית שנוצרו על ידי המפתח.
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
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
אפשרויות התצוגה של הפקד 'הזזה'.

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 (למשל, מפה מסוג שאינו של Google 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. פעולה זו עלולה להוביל להשפעות בלתי צפויות.
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"). ראה ספריות ב-Maps JavaScript API.

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.
default
אפשר ליצור רכיבים לשימוש חוזר סביב רכיבי האינטרנט של JavaScript במפות Google, כמו AdvancedMarkerElement, באמצעות רכיבים מותאמים אישית. כברירת מחדל, רכיבים מותאמים אישית שנוספים ישירות אל MapElement ימוקמו ויעובדו ב-MapPanes.overlayMouseTarget. עם זאת, ניתן יהיה להציב מחדש את רכיבי האינטרנט של Maps JavaScript API, במשבצות הפנימיות של MapElement.
BetaaddEventListener
addEventListener(type, listener[, options])
פרמטרים: 
  • typestring מחרוזת תלוית אותיות רישיות שמייצגת את סוג האירוע שצריך להאזין לו.
  • listenerEventListener|EventListenerObject האובייקט שמקבל התראה. השדה הזה חייב להיות פונקציה או אובייקט עם שיטת HandEvent
  • optionsboolean|AddEventListenerOptions optional ראה אפשרויות. אירועים בהתאמה אישית תומכים רק ב-capture וב-passive.
הערך המוחזר:  void
מגדירה פונקציה שתיקרא בכל פעם שהאירוע שצוין מועבר ליעד. ראו את addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • typestring מחרוזת שמציינת את סוג האירוע שעבורו יש להסיר האזנה לאירוע.
  • 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"). ראה ספריות ב-Maps JavaScript API.

ממשק 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

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

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"). ראה ספריות ב-Maps JavaScript API.

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"). ראה ספריות ב-Maps JavaScript API.

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"). ראה ספריות ב-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.