שיעור מפה
כיתה google.maps.Map
הכיתה הזו מרחיבה את
MVCObject
.
כדי לקבל גישה, צריך להתקשר ל-const {Map} = await google.maps.importLibrary("maps")
. כדאי לעיין בספריות בממשק ה-API של מפות Google JavaScript.
יצרן | |
---|---|
Map |
Map(mapDiv[, opts]) פרמטרים:
יוצרת מפה חדשה בתוך מאגר התגים של HTML, שהוא בדרך כלל רכיב DIV . |
מאפיינים | |
---|---|
controls |
סוג:
Array<MVCArray<HTMLElement>> פקדים נוספים לצירוף למפה. כדי להוסיף פקד למפה, צריך להוסיף את ה- <div> של הפקד ל-MVCArray שתואם ל-ControlPosition שבו רוצים לעבד אותו. |
data |
סוג:
Data מופע של Data , המקושר למפה. ניתן להוסיף תכונות לאובייקט Data הזה כדי להציג אותן בנוחות במפה הזו. |
mapTypes |
סוג:
MapTypeRegistry מרשם של MapType מופעים לפי מזהה מחרוזת. |
overlayMapTypes |
סוגי מפות נוספים לשכבות-על. סוגי שכבות-העל יוצגו מעל למפת הבסיס שאליה הם מצורפים, בסדר שבו הם מופיעים במערך overlayMapTypes (שכבות-על עם ערכי אינדקס גבוהים יותר יוצגו לפני שכבות-על עם ערכי אינדקס נמוכים יותר). |
שיטות | |
---|---|
fitBounds |
fitBounds(bounds[, padding]) פרמטרים:
ערך החזרה: אין
הגדרת אזור התצוגה כך שיכלול את הגבולות הנתונים. הערה: כשהמפה מוגדרת לערך display: none , הפונקציה fitBounds קוראת את גודל המפה כ-0x0, ולכן לא מבצעת פעולות. כדי לשנות את אזור התצוגה בזמן שהמפה מוסתרת, צריך להגדיר את המפה visibility: hidden כך שגודל ה-div של המפה יהיה בפועל. עבור מפות וקטוריות, שיטה זו מגדירה את ההטיה והכותרת של המפה לערכי ברירת המחדל שלהן. קריאה לשיטה זו עלולה לגרום לאנימציה חלקה להזיז את המפה ולשנות את מרחק התצוגה בהתאם לגבולות. ההחלטה אם השיטה הזו מונפשת תלויה בשיטת היוריסטיקה פנימית. |
getBounds |
getBounds() פרמטרים: ללא
ערך החזרה:
LatLngBounds|undefined גבולות הרוחב/אורך של אזור התצוגה הנוכחי.מחזירה את גבולות הרוחב/אורך של אזור התצוגה הנוכחי. אם ניתן לראות יותר מעותק אחד של העולם, הגבול מוגדר בטווח שבין -180 ל-180 מעלות, כולל. אם המפה לא הופעלה עדיין או שמרכז המרחק מהתצוגה לא הוגדר, התוצאה היא undefined . במפות וקטוריות עם הטיה או כותרת שאינה אפס, גבולות קו הרוחב/lng שמוחזרים מייצגים את התיבה הקטנה ביותר שכוללת את האזור הגלוי של אזור התצוגה של המפה. ניתן לעיין ב-MapCanvasProjection.getVisibleRegion כדי לברר מהו האזור המדויק של אזור התצוגה במפה. |
getCenter |
getCenter() פרמטרים: ללא
ערך החזרה:
LatLng|undefined |
getClickableIcons |
getClickableIcons() פרמטרים: ללא
ערך החזרה:
boolean|undefined מחזירה את הקליקביליות של סמלי המפה. סמל המפה מייצג נקודת עניין, שנקראת גם נקודת עניין. אם הערך המוחזר הוא true , אפשר ללחוץ על הסמלים במפה. |
getDatasetFeatureLayer |
getDatasetFeatureLayer(datasetId) פרמטרים:
ערך החזרה:
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) פרמטרים:
ערך החזרה: אין
משנה את מרכז המפה לפי המרחק הנתון בפיקסלים. אם המרחק קטן מהרוחב ומהגובה של המפה, המעבר כולל אנימציה חלקה. הערה: מערכת קואורדינטות המפה עולה ממערב למזרח (לערכי x) ומצפון לדרום (לערכי y). |
panTo |
panTo(latLng) פרמטרים:
ערך החזרה: אין
משנה את מרכז המפה ל- LatLng הנתון. אם השינוי קטן מהרוחב ומהגובה של המפה, המעבר כולל אנימציה חלקה. |
panToBounds |
panToBounds(latLngBounds[, padding]) פרמטרים:
ערך החזרה: אין
הזזה של המפה לפי הסכום המינימלי הנדרש להכיל את LatLngBounds הנתון. אין זה ערובה לכך שיהיו במפה גבולות, מלבד העובדה שהמפה תזוז כדי להציג כמה שיותר גבולות בתוך {currentMapSizeInPx} - {padding} . לגבי מפות של רשת נקודות או של וקטורים, התצוגה, ההטיה והכותרת של המפה לא ישתנו. |
setCenter |
setCenter(latlng) פרמטרים:
ערך החזרה: אין
|
setClickableIcons |
setClickableIcons(value) פרמטרים:
ערך החזרה: אין
קובעת אם סמלי המפה יהיו קליקביליים או לא. סמל המפה מייצג נקודת עניין, שנקראת גם נקודת עניין. כדי להשבית את אפשרות הקליק על סמלי מפה, יש להעביר לשיטה הזו את הערך false . |
setHeading |
setHeading(heading) פרמטרים:
ערך החזרה: אין
מגדיר את כותרת המצפן עבור מפה שנמדדת במעלות מצפון. במפות רסטר, שיטה זו רלוונטית רק לצילומי אוויר. |
setMapTypeId |
setMapTypeId(mapTypeId) פרמטרים:
ערך החזרה: אין
|
setOptions |
setOptions(options) פרמטרים:
ערך החזרה: אין
|
setStreetView |
setStreetView(panorama) פרמטרים:
ערך החזרה: אין
קישור של StreetViewPanorama למפה. פנורמה זו עוקפת את ברירת המחדל של StreetViewPanorama , ומאפשרת למפה להיות קשורה לפנורמה חיצונית מחוץ למפה. אם תגדירו את הפנורמה כ-null , תבוצע החלפה של ברירת המחדל לפנורמה המוטמעת. |
setTilt |
setTilt(tilt) פרמטרים:
ערך החזרה: אין
עבור מפות וקטוריות, מגדיר את זווית השכיחות של המפה. הערכים המותרים מוגבלים בהתאם לרמת הזום של המפה. עבור מפות של רשת נקודות, מגדירה את התנהגות המעבר האוטומטי לזווית של המפה. הערכים המותרים היחידים הם 0 ו-45 . setTilt(0) גורם למפה להשתמש תמיד במבט על תקורה ב-0° ללא קשר לרמת הזום ולאזור התצוגה. setTilt(45) גורם לזווית ההטיה לעבור באופן אוטומטי ל-45 בכל פעם שתמונות של 45° זמינות לרמת התצוגה הנוכחית ואזור התצוגה, וחזרה ל-0 כשאין תמונות 45° (זו התנהגות ברירת המחדל). תמונות ב-45° זמינות רק לסוגי מפות satellite ו-hybrid , במיקומים מסוימים וברמות מסוימות של מרחק מתצוגה. הערה: getTilt מחזירה את זווית ההטיה הנוכחית, ולא את הערך שהוגדר על ידי setTilt . מאחר ש-getTilt ו-setTilt מתייחסים לשני דברים שונים, אל תעשו bind() את המאפיין tilt . הפעולה הזו עלולה להוביל להשפעות לא צפויות. |
setZoom |
setZoom(zoom) פרמטרים:
ערך החזרה: אין
מגדיר את המרחק מהתצוגה במפה. |
הועבר בירושה:
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() ארגומנטים: ללא
האירוע הזה מופעל כאשר נכס הזום במפה משתנה. |
|
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 הפעלה/השבתה של הזום ומרכז המסך בלחיצה כפולה. מופעל כברירת מחדל. הערה: הנכס הזה לא מומלץ. כדי להשבית את הזום בלחיצה כפולה, ניתן להשתמש בנכס |
|
סוג:
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 מטפל בתנועות במפה. ערכים מותרים:
|
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 מושבתת, שינוי מרחק התצוגה במפה באמצעות גלגל גלילה של העכבר. גלגל הגלילה מופעל כברירת מחדל. הערה: הנכס הזה לא מומלץ. כדי להשבית את הזום באמצעות גלגל הגלילה, אפשר להשתמש במאפיין |
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:
|
innerMap |
סוג:
Map הפניה ל- Map שבה MapElement משתמש באופן פנימי. |
mapId |
סוג:
string optional מאפיין HTML:
|
zoom |
סוג:
number optional מאפיין HTML:
|
שיטות | |
---|---|
addEventListener |
addEventListener(type, listener[, options]) פרמטרים:
ערך החזרה:
void מגדירה פונקציה שתופיע בכל פעם שהאירוע שצוין יועבר ליעד. ראו addEventListener |
removeEventListener |
removeEventListener(type, listener[, options]) פרמטרים:
ערך החזרה:
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 |
כללי הסגנון שיחולו על התכונות והרכיבים שנבחרו במפה. הכללים מוחלים לפי הסדר שציינת במערך. לקבלת הנחיות שימוש וערכים מותרים, יש לעיין בחומר העזר בנושא סגנון. |
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) פרמטרים:
ערך החזרה: אין
מגדיר את הרישום כך שישייך את מזהה המחרוזת שהועבר אל סוג המפה שהועבר. |
הועבר בירושה:
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. |