סיווג מפה
google.maps.Map
מחלקה
כיתה זו תקפה ל-MVCObject
.
גישה באמצעות חיוג אל const {Map} = await google.maps.importLibrary("maps")
. למידע נוסף, אפשר לעיין במאמר בנושא ספריות ב-API של JavaScript במפות.
יצרן | |
---|---|
Map |
Map(mapDiv[, opts]) פרמטרים:
יוצר מפה חדשה בתוך מאגר ה-HTML, שהוא בדרך כלל רכיב DIV . |
קבועים | |
---|---|
DEMO_MAP_ID |
מזהה מפה שיכול לשמש לדוגמאות קוד שנדרש להן מזהה מפה. מזהה המפה הזה לא מיועד לשימוש באפליקציות בסביבת ייצור, ואי אפשר להשתמש בו בתכונות שמחייבות הגדרה של הענן (כמו Cloud Styling). |
תכונות | |
---|---|
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 . במפות וקטוריות עם הטיה או כותרת שאינן אפס, גבולות קווי הרוחב/אורך המוחזרים מייצגים את התיבה התוחמת הקטנה ביותר שכוללת את האזור הגלוי של אזור התצוגה במפה. 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 ה-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) פרמטרים:
ערך החזרה: ללא
שינוי של מרכז המפה לפי המרחק הנתון בפיקסלים. אם המרחק קטן גם מהרוחב וגם מהגובה של המפה, המעבר יהיה חלק מונפש. שימו לב שמערכת הקואורדינטות של המפה גדלה ממערב למזרח (בערכי 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
|
אירועים | |
---|---|
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() ארגומנטים: ללא
האירוע הזה מופעל כשהמאפיין של שינוי מרחק התצוגה במפה משתנה. |
|
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 הפעלה/השבתה של מרחק התצוגה והמרכז לאחר לחיצה כפולה. מופעל כברירת מחדל. הערה: המאפיין הזה לא מומלץ. כדי להשבית את הגדלת התצוגה לאחר לחיצה כפולה, אפשר להשתמש במאפיין |
|
סוג:
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 יטפל בתנועות במפה. ערכים מותרים:
|
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. |
|
סוג:
boolean 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 , משבית את ההתקרבות במפה באמצעות גלגל הגלילה של העכבר. גלגל הגלילה מופעל כברירת מחדל. הערה: המאפיין הזה לא מומלץ. כדי להשבית את שינוי מרחק התצוגה באמצעות גלגל הגלילה, ניתן להשתמש במאפיין |
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:
|
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 מסיר מהיעד מעבד אירוע שנרשם בעבר ב-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 |
כללי הסגנון שיש להחיל על התכונות והרכיבים שנבחרו במפה. הכללים יוחלו לפי הסדר שתציינו במערך הזה. לקבלת הנחיות בנוגע לשימוש ולערכים המותרים, אפשר לעיין בחומר העזר בנושא סגנונות. |
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) פרמטרים:
ערך החזרה: ללא
מגדיר את הרישום כך שישייך את מזהה המחרוזת שהועברה ל-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. |