Maps

שיעור מפה

כיתה google.maps.Map

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

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

Map
Map(mapDiv[, opts])
פרמטרים: 
  • mapDivHTMLElement עיבוד המפה יתבצע כדי למלא את הרכיב הזה.
  • optsMapOptions optional אפשרויות
יוצרת מפה חדשה בתוך מאגר התגים של HTML, שהוא בדרך כלל רכיב DIV.
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 גבולות הרוחב/אורך של אזור התצוגה הנוכחי.
מחזירה את גבולות הרוחב/אורך של אזור התצוגה הנוכחי. אם ניתן לראות יותר מעותק אחד של העולם, הגבול מוגדר בטווח שבין -180 ל-180 מעלות, כולל. אם המפה לא הופעלה עדיין או שמרכז המרחק מהתצוגה לא הוגדר, התוצאה היא undefined. במפות וקטוריות עם הטיה או כותרת שאינה אפס, גבולות קו הרוחב/lng שמוחזרים מייצגים את התיבה הקטנה ביותר שכוללת את האזור הגלוי של אזור התצוגה של המפה. ניתן לעיין ב-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 המפה של המפה.
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
מחזירה את סוג הרינדור הנוכחי של המפה.
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)
פרמטרים: 
  • panoramaStreetViewPanorama optional התמונה ההיקפית שרוצים לקשר למפה.
ערך החזרה: אין
קישור של StreetViewPanorama למפה. פנורמה זו עוקפת את ברירת המחדל של StreetViewPanorama, ומאפשרת למפה להיות קשורה לפנורמה חיצונית מחוץ למפה. אם תגדירו את הפנורמה כ-null, תבוצע החלפה של ברירת המחדל לפנורמה המוטמעת.
setTilt
setTilt(tilt)
פרמטרים: 
  • tiltnumber
ערך החזרה: אין
עבור מפות וקטוריות, מגדיר את זווית השכיחות של המפה. הערכים המותרים מוגבלים בהתאם לרמת הזום של המפה. עבור מפות של רשת נקודות, מגדירה את התנהגות המעבר האוטומטי לזווית של המפה. הערכים המותרים היחידים הם 0 ו-45. setTilt(0) גורם למפה להשתמש תמיד במבט על תקורה ב-0° ללא קשר לרמת הזום ולאזור התצוגה. setTilt(45) גורם לזווית ההטיה לעבור באופן אוטומטי ל-45 בכל פעם שתמונות של 45° זמינות לרמת התצוגה הנוכחית ואזור התצוגה, וחזרה ל-0 כשאין תמונות 45° (זו התנהגות ברירת המחדל). תמונות ב-45° זמינות רק לסוגי מפות satellite ו-hybrid, במיקומים מסוימים וברמות מסוימות של מרחק מתצוגה. הערה: getTilt מחזירה את זווית ההטיה הנוכחית, ולא את הערך שהוגדר על ידי setTilt. מאחר ש-getTilt ו-setTilt מתייחסים לשני דברים שונים, אל תעשו bind() את המאפיין tilt. הפעולה הזו עלולה להוביל להשפעות לא צפויות.
setZoom
setZoom(zoom)
פרמטרים: 
  • zoomnumber ערכים גדולים יותר של מרחק מתצוגה תואמים לרזולוציה גבוהה יותר.
ערך החזרה: אין
מגדיר את המרחק מהתצוגה במפה.
הועבר בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
DEMO_MAP_ID מזהה מפה שיכול לשמש לדוגמאות קוד שמחייבות מזהה מפה. מזהה המפה הזה לא מיועד לשימוש באפליקציות ייצור ולא ניתן להשתמש בו עבור תכונות שמצריכות הגדרת ענן (כמו Cloud Styling).
bounds_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר גבולות אזור התצוגה השתנו.
center_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר הנכס במרכז המפה משתנה.
click
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהמשתמש לוחץ על המפה. הפונקציה תחזיר את האירוע MapMouseEvent עם מאפיינים של המיקום שעליו המשתמש לחץ, אלא אם לחצתם על סמל של מקום, וכתוצאה מכך יוחזר סמל mouseMouseEvent עם מזהה מקום. IconMouseEvent ו-mapMouseEvent זהים, אבל ל-iconMouseEvent יש שדה מזהה מקום. תמיד אפשר להתייחס לאירוע כ-MapsMouseEvent כשמזהה המקום לא חשוב. אירוע הקליק לא מופעל אם לוחצים על סמן או על חלון מידע.
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()
ארגומנטים: ללא
האירוע הזה מופעל כשסוג הרינדור משתנה.
tilesloaded
function()
ארגומנטים: ללא
אירוע זה מופעל כאשר הטעינה של המשבצות הגלויות מסתיימת.
tilt_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כשנכס ההטיה של המפה משתנה.
zoom_changed
function()
ארגומנטים: ללא
האירוע הזה מופעל כאשר נכס הזום במפה משתנה.
rightclick
function(event)
ארגומנטים: 
האירוע הזה מופעל כשהמשתמש לוחץ לחיצה ימנית על המפה.

הממשק של מיפוי האפשרויות

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

הערה: אמצעי הבקרה לחלונית ההזזה לא זמין בקבוצת אמצעי הבקרה החדשה שהוצגה בגרסה 3.22 של JavaScript במפות Google. כשמשתמשים בגרסה 3.22 ובגרסה 3.23, אפשר להשתמש בקבוצת אמצעי הבקרה הקודמת במקום בבקרות החדשות, וכך להגדיר את התכונה 'הזזת הזזה' כחלק מקבוצת אמצעי הבקרה הישנה. כדאי לעיין בקטע מה חדש בגרסה 3.22 של פקדי המפה.

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

הערה: אמצעי הבקרה לחלונית ההזזה לא זמין בקבוצת אמצעי הבקרה החדשה שהוצגה בגרסה 3.22 של JavaScript במפות Google. כשמשתמשים בגרסה 3.22 ובגרסה 3.23, אפשר להשתמש בקבוצת אמצעי הבקרה הקודמת במקום בבקרות החדשות, וכך להגדיר את התכונה 'הזזת הזזה' כחלק מקבוצת אמצעי הבקרה הישנה. כדאי לעיין בקטע מה חדש בגרסה 3.22 של פקדי המפה.

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 Pegman. אמצעי הבקרה הזה הוא חלק מממשק ברירת המחדל. צריך להגדיר את הערך 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
המצב מופעל/מושבת של פקד הזום.
zoomControlOptions optional
סוג:  ZoomControlOptions optional
אפשרויות התצוגה של פקד הזום.

שיעור ב-MapsElement

כיתה google.maps.MapElement

MapElement הוא תת-מחלקה HTMLElement לעיבוד מפות. לאחר טעינת הספרייה maps, ניתן ליצור מפה ב-HTML. לדוגמה:
<gmp-map center="37.4220656,-122.0840897" zoom="10" map-id="DEMO_MAP_ID"></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 של מפות Google JavaScript.

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>
BetaaddEventListener
addEventListener(type, listener[, options])
פרמטרים: 
  • typestring מחרוזת תלוית אותיות רישיות שמייצגת את סוג האירוע שלגביו רוצים להאזין.
  • listenerEventListener|EventListenerObject האובייקט שמקבל התראה. הערך חייב להיות פונקציה או אובייקט עם method ידיEvent
  • optionsboolean|AddEventListenerOptions optional יש לעיין באפשרויות. אירועים מותאמים אישית תומכים רק ב-capture וב-passive.
ערך החזרה:  void
מגדירה פונקציה שתופיע בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener
BetaremoveEventListener
removeEventListener(type, listener[, options])
פרמטרים: 
  • typestring מחרוזת שמציינת את סוג האירוע שעבורו יש להסיר את ה-event listener.
  • listenerEventListener|EventListenerObject מאזינים של האירוע של הגורם שמפעיל את האירוע כדי להסיר אותו מיעד האירוע.
  • optionsboolean|EventListenerOptions optional הצגת אפשרויות
ערך החזרה:  void
הסרה של event listener שנרשם בעבר עם addEventListener מהיעד. מידע נוסף זמין בקטע removeEventListener

ממשק מיפויElementOptions

ממשק google.maps.MapElementOptions

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

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

הממשק MapsTypeStyle

ממשק google.maps.MapTypeStyle

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

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

הממשק של מיפוי העכבר

ממשק 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() באירוע הזה כדי למנוע הפצתו. מידע נוסף על מזהי מקומות זמין במדריך למפתחים על מקומות Google.

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

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

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

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

קבועים של מיפויTypeId

google.maps.MapTypeId קבועים

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

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

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

מחלקה מיפויTypeRegistry

כיתה google.maps.MapTypeRegistry

מרשם למכונות MapType, שמפתחות הוא מזהה MapType.

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

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

MapTypeRegistry
MapTypeRegistry()
פרמטרים: ללא
MapTypeRegistry מכיל את האוסף של סוגי מפות בהתאמה אישית שזמינים לשימוש במפה. ה-API מתייעץ למרשם זה כאשר הוא מספק את הרשימה של סוגי המפות הזמינים, לדוגמה.
set
set(id, mapType)
פרמטרים: 
  • idstring מזהה של סוג המפה שצריך להוסיף למרשם.
  • mapTypeMapType|* אובייקט MapType להוספה למרשם.
ערך החזרה: אין
מגדיר את הרישום כך שישייך את מזהה המחרוזת שהועבר אל סוג המפה שהועבר.
הועבר בירושה: addListener, bindTo, get, notify, setValues, unbind, unbindAll

הממשק של מיפוי

ממשק 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 של מפות Google 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
מפה שבה יוצג שכבת התנועה.

מחלקה של TRANSLayer

כיתה google.maps.TransitLayer

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

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

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

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

שיעור Bicylinging

כיתה google.maps.BicyclingLayer

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

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

כדי לקבל גישה, צריך להתקשר ל-const {BicyclingLayer} = await google.maps.importLibrary("maps"). כדאי לעיין בספריות בממשק ה-API של מפות Google 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

הממשק של האזור הגלוי

ממשק google.maps.VisibleRegion

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

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

קבועים של RenderingType

google.maps.RenderingType קבועים

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

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

הממשק של מיפוי היכולות

ממשק google.maps.MapCapabilities

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

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