סיווג מפה
google.maps.Map
סיווג
הכיתה הזו משתרעת על פני
MVCObject
.
ניתן לגשת באמצעות חיוג אל const {Map} = await google.maps.importLibrary("maps")
. ראה ספריות ב-Maps JavaScript API.
יצרן | |
---|---|
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 גבולות קו הרוחב/אורך אזור התצוגה הנוכחי.מחזירה את גבולות קווי הרוחב/Lng של אזור התצוגה הנוכחי. אם ניתן לראות יותר מעותק אחד של העולם, טווח הגבולות הוא בין 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 the mapDiv של המפה. |
getFeatureLayer |
getFeatureLayer(featureType) פרמטרים:
הערך המוחזר:
FeatureLayer מחזירה את FeatureLayer של FeatureType הספציפי. חובה להפעיל FeatureLayer במסוף Google Cloud. אם FeatureLayer של המאפיין FeatureType שצוין לא קיים במפה הזו, או אם סגנון מבוסס-נתונים לא זמין (אין מזהה מפה, אין משבצות וקטורים ואין FeatureLayer מופעל בסגנון המפה), מתועדת שגיאה והתוצאה FeatureLayer.isAvailable שמתקבלת תהיה FALSE. |
getHeading |
getHeading() פרמטרים: ללא
הערך המוחזר:
number|undefined מחזירה את כיוון המצפן של המפה. ערך הכותרת נמדד במעלות (בכיוון השעון) מהכיוון הקרדינלי צפון. אם המפה עדיין לא אותחלה, התוצאה היא undefined . |
getHeadingInteractionEnabled |
getHeadingInteractionEnabled() פרמטרים: ללא
הערך המוחזר:
boolean|null מחזירה אם אינטראקציות של כותרות מופעלות. האפשרות הזו תקפה רק כשהמפה היא מפה וקטורית. אם המדיניות לא מוגדרת בקוד, ייעשה שימוש בהגדרות הענן למזהה המפה (אם הן זמינות). |
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 . |
getTiltInteractionEnabled |
getTiltInteractionEnabled() פרמטרים: ללא
הערך המוחזר:
boolean|null מחזירה אם אינטראקציות הטיה מופעלות. האפשרות הזו תקפה רק כשהמפה היא מפה וקטורית. אם המדיניות לא מוגדרת בקוד, ייעשה שימוש בהגדרות הענן למזהה המפה (אם הן זמינות). |
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) פרמטרים:
ערך החזרה: ללא
מגדיר את כיוון המצפן עבור מפה שנמדדת במעלות מכיוון צפון כבד. עבור מפות רסטר, שיטה זו חלה רק על תמונות אוויריות. |
setHeadingInteractionEnabled |
setHeadingInteractionEnabled(headingInteractionEnabled) פרמטרים:
ערך החזרה: ללא
המדיניות הזו קובעת אם אינטראקציות של כותרות מופעלות. האפשרות הזו תקפה רק כשהמפה היא מפה וקטורית. אם המדיניות לא מוגדרת בקוד, ייעשה שימוש בהגדרות הענן למזהה המפה (אם הן זמינות). |
setMapTypeId |
setMapTypeId(mapTypeId) פרמטרים:
ערך החזרה: ללא
|
setOptions |
setOptions(options) פרמטרים:
ערך החזרה: ללא
|
setRenderingType |
setRenderingType(renderingType) פרמטרים:
ערך החזרה: ללא
מגדיר את סוג הרינדור הנוכחי של המפה. |
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 . פעולה זו עלולה להוביל להשפעות בלתי צפויות. |
setTiltInteractionEnabled |
setTiltInteractionEnabled(tiltInteractionEnabled) פרמטרים:
ערך החזרה: ללא
הגדרה זו קובעת אם אינטראקציות של הטיה מופעלות. האפשרות הזו תקפה רק כשהמפה היא מפה וקטורית. אם המדיניות לא מוגדרת בקוד, ייעשה שימוש בהגדרות הענן למזהה המפה (אם הן זמינות). |
setZoom |
setZoom(zoom) פרמטרים:
ערך החזרה: ללא
הגדרת מרחק התצוגה של המפה. |
עברה בירושה:
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() ארגומנטים: ללא
האירוע הזה מופעל כשתכונת המרחק מהתצוגה במפה משתנה. |
|
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 הפעלה/השבתה של מרחק התצוגה והמרכז לאחר לחיצה כפולה. מופעל כברירת מחדל. הערה: המאפיין הזה לא מומלץ. כדי להשבית את שינוי מרחק התצוגה בלחיצה כפולה, אפשר להשתמש במאפיין |
|
סוג:
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 הכותרת של צילומי אוויר במעלות נמדדה בכיוון השעון בכיוון הקרדינל צפוני. הכותרות מוצמדות לזווית הזמינה הקרובה ביותר עבורה יש תמונה זמינה. |
headingInteractionEnabled optional |
סוג:
boolean optional ברירת מחדל:
false האם המפה צריכה לאפשר למשתמש לשלוט על כיוון המצלמה (סיבוב). האפשרות הזו תקפה רק כשהמפה היא מפה וקטורית. אם המדיניות לא מוגדרת בקוד, ייעשה שימוש בהגדרות הענן למזהה המפה (אם הן זמינות). |
isFractionalZoomEnabled optional |
סוג:
boolean optional ברירת מחדל:
true למפות וקטוריות ו-false למפות רסטרהאם לאפשר שינוי של מרחק התצוגה במפה. כדי לדעת מתי נקבעה ברירת המחדל, יש להאזין ל isfractionalzoomenabled_changed . |
keyboardShortcuts optional |
סוג:
boolean optional אם בוחרים את הערך false , המפה לא נשלטת באמצעות המקלדת. מקשי הקיצור מופעלים כברירת מחדל. |
mapId optional |
סוג:
string optional מזהה המפה של המפה. לא ניתן להגדיר את הפרמטר הזה או לשנות אותו לאחר יצירת מפה. אפשר להשתמש ב- Map.DEMO_MAP_ID כדי לנסות תכונות שנדרש להן מזהה מפה אבל לא מחייבות הפעלה בענן. |
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. |
|
סוג:
boolean optional המצב המופעל/מושבת של פקד ההזזה. |
|
סוג:
PanControlOptions optional אפשרויות התצוגה של הפקד 'הזזה'. |
renderingType optional |
סוג:
RenderingType optional ברירת מחדל:
RenderingType.RASTER האם המפה צריכה להיות מפת רסטר או מפה וקטורית. לא ניתן להגדיר את הפרמטר הזה או לשנות אותו לאחר יצירת מפה. אם המדיניות לא מוגדרת, סוג הרינדור (אם זמין) ייקבע על ידי תצורת הענן למזהה המפה. הערה: ייתכן שמפות וקטוריות לא יהיו זמינות בכל המכשירים והדפדפנים, והמפה תחזור למפת רסטר לפי הצורך. |
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 (למשל, מפה מסוג שאינו של 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 . פעולה זו עלולה להוביל להשפעות בלתי צפויות. |
tiltInteractionEnabled optional |
סוג:
boolean optional ברירת מחדל:
false האם יש לאפשר למשתמשים לשלוט בהטיית המצלמה במפה. האפשרות הזו תקפה רק כשהמפה היא מפה וקטורית. אם המדיניות לא מוגדרת בקוד, ייעשה שימוש בהגדרות הענן למזהה המפה (אם הן זמינות). |
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" heading-interaction-disabled map-id="string" rendering-type="vector" tilt-interaction-disabled zoom="number"></gmp-map>
הכיתה הזו משתרעת על פני
HTMLElement
.
במחלקה הזו מוטמעת MapElementOptions
.
ניתן לגשת באמצעות חיוג אל const {MapElement} = await google.maps.importLibrary("maps")
. ראה ספריות ב-Maps JavaScript API.
יצרן | |
---|---|
MapElement |
MapElement([options]) פרמטרים:
|
תכונות | |
---|---|
center |
סוג:
LatLng|LatLngLiteral optional קו האורך או הרוחב של מרכז המפה.
מאפיין HTML:
|
headingInteractionDisabled |
סוג:
boolean optional ברירת מחדל:
false האם המפה צריכה לאפשר למשתמש לשלוט על כיוון המצלמה (סיבוב). האפשרות הזו תקפה רק כשהמפה היא מפה וקטורית. אם המדיניות לא מוגדרת בקוד, ייעשה שימוש בהגדרות הענן למזהה המפה (אם הן זמינות).
מאפיין HTML:
|
innerMap |
סוג:
Map הפניה ל- Map שבו משתמש MapElement באופן פנימי. |
mapId |
סוג:
string optional מזהה המפה של המפה. לא ניתן להגדיר את הפרמטר הזה או לשנות אותו לאחר יצירת מפה. אפשר להשתמש ב-
Map.DEMO_MAP_ID כדי לנסות תכונות שנדרש להן מזהה מפה אבל לא מחייבות הפעלה בענן.מאפיין HTML:
|
renderingType |
סוג:
RenderingType optional ברירת מחדל:
RenderingType.VECTOR האם המפה צריכה להיות מפת רסטר או מפה וקטורית. לא ניתן להגדיר את הפרמטר הזה או לשנות אותו לאחר יצירת מפה. אם המדיניות לא מוגדרת, סוג הרינדור (אם זמין) ייקבע על ידי תצורת הענן למזהה המפה. הערה: ייתכן שמפות וקטוריות לא יהיו זמינות בכל המכשירים והדפדפנים, והמפה תחזור למפת רסטר לפי הצורך.
מאפיין HTML:
|
tiltInteractionDisabled |
סוג:
boolean optional ברירת מחדל:
false האם יש לאפשר למשתמשים לשלוט בהטיית המצלמה במפה. האפשרות הזו תקפה רק כשהמפה היא מפה וקטורית. אם המדיניות לא מוגדרת בקוד, ייעשה שימוש בהגדרות הענן למזהה המפה (אם הן זמינות).
מאפיין 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 |
headingInteractionDisabled optional |
סוג:
boolean optional |
mapId optional |
סוג:
string optional |
renderingType optional |
סוג:
RenderingType optional |
tiltInteractionDisabled optional |
סוג:
boolean 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 |
כללי הסגנון שיש להחיל על תכונות ורכיבי המפה שנבחרו. הכללים יוחלו לפי הסדר שציינתם במערך הזה. הנחיות לגבי שימוש וערכים מותרים זמינים בחומר העזר בנושא סגנונות. |
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) פרמטרים:
ערך החזרה: ללא
מגדירה את הרישום כך שישייך את מזהה המחרוזת שהועברה ל-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. |
isWebGLOverlayViewAvailable optional |
סוג:
boolean optional אם true, המפה הזו מוגדרת כראוי כדי לאפשר את השימוש ב- WebGLOverlayView . |