3D Maps

Map3DElement class

מחלקה google.maps.maps3d.Map3DElement

‫Map3DElement הוא ממשק HTML לתצוגת מפה בתלת-ממד. שימו לב שצריך להגדיר את mode כדי שהמפה התלת-ממדית תתחיל להופיע.

רכיב בהתאמה אישית:
<gmp-map-3d center="lat,lng,altitude" default-ui-hidden description="string" gesture-handling="auto" heading="number" internal-usage-attribution-ids="id1 id2" map-id="string" max-altitude="number" max-heading="number" max-tilt="number" min-altitude="number" min-heading="number" min-tilt="number" mode="hybrid" range="number" roll="number" tilt="number" default-ui-disabled></gmp-map-3d>

המחלקה הזו מרחיבה את HTMLElement.

המחלקה הזו מטמיעה את Map3DElementOptions.

כדי לקבל גישה, צריך לקרוא ל: const {Map3DElement} = await google.maps.importLibrary("maps3d").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

יצרן
Map3DElement	Map3DElement([options]) פרמטרים:  options:  Map3DElementOptions optional

מאפיינים
bounds	סוג:  LatLngBounds|LatLngBoundsLiteral optional כשהאפשרות הזו מוגדרת, היא מגבילה את מיקום המצלמה לגבולות קווי הרוחב/האורך שצוינו. חשוב לזכור שאובייקטים מחוץ לגבולות עדיין מוצגים. הגבולות יכולים להגביל גם את קו האורך וגם את קו הרוחב, או להגביל רק את קו הרוחב או רק את קו האורך. כדי להגדיר גבולות של קווי רוחב בלבד, צריך להשתמש בקווי אורך מערביים ומזרחיים של -180 ו-180, בהתאמה. כדי להגדיר גבולות של קווי אורך בלבד, צריך להשתמש בקווי הרוחב הצפוניים והדרומיים 90 ו--90, בהתאמה.
center	סוג:  LatLngAltitude|LatLngAltitudeLiteral optional מרכז המפה, שמוצג כ-LatLngAltitude, כאשר הגובה הוא במטרים מעל פני הקרקע. שימו לב שזה לא בהכרח המיקום של המצלמה, כי השדה range משפיע על המרחק של המצלמה ממרכז המפה. אם לא מגדירים את המדיניות, ברירת המחדל היא {lat: 0, lng: 0, altitude: 63170000}. הגובה המקסימלי המותר הוא 63,170,000 מטרים (רדיוס כדור הארץ כפול 10). מאפיין HTML: <gmp-map-3d center="lat,lng,altitude"></gmp-map-3d>
defaultUIHidden	סוג:  boolean optional ברירת המחדל: false כשהערך הוא true, כל לחצני ברירת המחדל של ממשק המשתמש מוסתרים. מאפיין HTML: <gmp-map-3d default-ui-hidden></gmp-map-3d>
description	סוג:  string optional אם תספקו תיאור נגישות (למשל, לשימוש עם קוראי מסך), הוא יתווסף למפה עם הערך שסיפקתם. מאפיין HTML: <gmp-map-3d description="string"></gmp-map-3d>
gestureHandling	סוג:  GestureHandling optional ברירת המחדל: GestureHandling.GREEDY ההגדרה הזו קובעת את הטיפול בתנועות משותפות. כשההגדרה היא COOPERATIVE, צריך להשתמש במקשי צירוף או בתנועות בשתי אצבעות כדי לגלול במפה. כשהערך הוא GREEDY, אי אפשר לגלול את הדף המארח מאירועי משתמש ברכיב המפה. כשהמדיניות מוגדרת לערך AUTO, הטיפול בתנועה נקבע לפי יכולת הגלילה של דף המארח. מאפיין HTML: <gmp-map-3d gesture-handling="auto"></gmp-map-3d> <gmp-map-3d gesture-handling="cooperative"></gmp-map-3d> <gmp-map-3d gesture-handling="greedy"></gmp-map-3d>
heading	סוג:  number optional כיוון המצפן של המפה, במעלות, כאשר הצפון הוא אפס. כשאין הטיה, כל גלגול יתפרש ככיוון. מאפיין HTML: <gmp-map-3d heading="number"></gmp-map-3d>
internalUsageAttributionIds	סוג:  Iterable<string> optional מוסיף מזהה שיוך שימוש למאתחל, שעוזר ל-Google להבין אילו ספריות ודוגמאות מועילות למפתחים, כמו שימוש בספריית מקבצי סמנים. כדי לבטל את ההסכמה לשליחת מזהה השיוך של השימוש, אפשר למחוק את המאפיין הזה. יישלחו רק ערכים ייחודיים. יכול להיות שהמערכת תתעלם משינויים בערך הזה אחרי יצירת המופע. מאפיין HTML: <gmp-map-3d internal-usage-attribution-ids="id1 id2"></gmp-map-3d>
language	סוג:  string optional השפה שבה המערכת תנסה להציג את המפה הבסיסית. כברירת מחדל, השפה תהיה השפה שהמפתח ביקש כשטען את Maps JavaScript API.
mapId	סוג:  string optional מציין מזהה מפה שישמש לאחזור סגנון מפה מבוסס-ענן בשביל המפה. אין להגדיר את זה אחרי שהמפה אותחלה. לכן אנחנו מוודאים שהמאפיין mapId מוגדר רק במהלך האתחול, ולא מפרסמים אותו בערוצים שגלויים לכולם. מאפיין HTML: <gmp-map-3d map-id="string"></gmp-map-3d>
maxAltitude	סוג:  number optional הגובה המקסימלי מעל פני הקרקע שיוצג במפה. ערך תקין הוא בין 0 ל-63170000 מטרים (רדיוס כדור הארץ כפול 10). מאפיין HTML: <gmp-map-3d max-altitude="number"></gmp-map-3d>
maxHeading	סוג:  number optional הזווית המקסימלית של הכיוון (סיבוב) של המפה. ערך תקין הוא בין 0 ל-360 מעלות. ‫minHeading ו-maxHeading מייצגים מרווח של פחות מ- מעלות או שווה ל-360 מעלות שבו תנועות הראש יאושרו. ‫minHeading = 180 ו-maxHeading = 90 יאפשרו כיוון ב-[0, 90] וכיוון ב-[180, 360]. ‫minHeading = 90 ו-maxHeading = 180 יאפשרו כותרת ב-[90, 180]. מאפיין HTML: <gmp-map-3d max-heading="number"></gmp-map-3d>
maxTilt	סוג:  number optional זווית הפגיעה המקסימלית של המפה. ערך תקין הוא בין 0 ל-90 מעלות. מאפיין HTML: <gmp-map-3d max-tilt="number"></gmp-map-3d>
minAltitude	סוג:  number optional הגובה המינימלי מעל פני הקרקע שיוצג במפה. ערך תקין הוא בין 0 ל-63170000 מטרים (רדיוס כדור הארץ כפול 10). מאפיין HTML: <gmp-map-3d min-altitude="number"></gmp-map-3d>
minHeading	סוג:  number optional זווית הכיוון (הסיבוב) המינימלית של המפה. ערך תקין הוא בין 0 ל-360 מעלות. ‫minHeading ו-maxHeading מייצגים מרווח של פחות מ- מעלות או שווה ל-360 מעלות שבו תנועות הראש יאושרו. ‫minHeading = 180 ו-maxHeading = 90 יאפשרו כיוון ב-[0, 90] וכיוון ב-[180, 360]. ‫minHeading = 90 ו-maxHeading = 180 יאפשרו כותרת ב-[90, 180]. מאפיין HTML: <gmp-map-3d min-heading="number"></gmp-map-3d>
minTilt	סוג:  number optional זווית הפגיעה המינימלית של המפה. ערך תקין הוא בין 0 ל-90 מעלות. מאפיין HTML: <gmp-map-3d min-tilt="number"></gmp-map-3d>
mode	סוג:  MapMode optional מציין את המצב שבו המפה תוצג. אם לא מגדירים את המאפיין, המפה לא תוצג. מאפיין HTML: <gmp-map-3d mode="hybrid"></gmp-map-3d> <gmp-map-3d mode="satellite"></gmp-map-3d>
range	סוג:  number optional המרחק מהמצלמה למרכז המפה, במטרים. מאפיין HTML: <gmp-map-3d range="number"></gmp-map-3d>
region	סוג:  string optional האזור שבו המערכת תנסה להציג את נקודות העניין במפה הבסיסית. כברירת מחדל, האזור יהיה זה שהמפתח ביקש כשטען את Maps JavaScript API.
roll	סוג:  number optional הסיבוב של המצלמה סביב וקטור התצוגה במעלות. כדי לפתור אי-בהירויות, כשאין הטיה, כל גלגול יפורש ככיוון. מאפיין HTML: <gmp-map-3d roll="number"></gmp-map-3d>
tilt	סוג:  number optional ההטיה של וקטור התצוגה של המצלמה במעלות. וקטור תצוגה שמביט ישירות למטה אל כדור הארץ יהיה עם הטיה של אפס מעלות. וקטור תצוגה שמצביע הרחק מכדור הארץ יהיה בעל הטיה של 180 מעלות. מאפיין HTML: <gmp-map-3d tilt="number"></gmp-map-3d>
defaultUIDisabled	הוצאה משימוש: במקומה יש להשתמש במדיניות Map3DElement.defaultUIHidden. המאפיין הזה יוסר בגרסה עתידית. סוג:  boolean optional ברירת המחדל: false כשהמדיניות מוגדרת לערך true, כל לחצני ברירת המחדל של ממשק המשתמש מושבתים. לא משבית את אמצעי הבקרה של המקלדת והתנועות. מאפיין HTML: <gmp-map-3d default-ui-disabled></gmp-map-3d>

Methods
addEventListener	addEventListener(type, listener[, options]) פרמטרים:  ‫type:  string מחרוזת תלויית אותיות רישיות שמייצגת את סוג האירוע שרוצים להאזין לו. ‫listener:  EventListener|EventListenerObject האובייקט שמקבל התראה. הערך צריך להיות פונקציה או אובייקט עם השיטה handleEvent ‫options:  boolean|AddEventListenerOptions optional לאפשרויות. אירועים בהתאמה אישית תומכים רק ב-capture וב-passive. ערך מוחזר:  void מגדירה פונקציה שתופעל בכל פעם שהאירוע שצוין יועבר ליעד. אפשר לעיין במאמר בנושא addEventListener.
flyCameraAround	flyCameraAround(options) פרמטרים:  options:  FlyAroundAnimationOptions ערך מוחזר:  אין השיטה הזו מזיזה את המצלמה במסלול מעגלי סביב מיקום נתון למשך זמן נתון. אפשר לחזור על האנימציה FlyAroundAnimationOptions.repeatCount פעמים. המצלמה תזוז בכיוון השעון. השיטה היא אסינכרונית כי אנימציות יכולות להתחיל רק אחרי שהמפה נטענה במידה מינימלית. השיטה מחזירה ערך אחרי שהאנימציה מתחילה. אם מספר הפעמים של FlyAroundAnimationOptions.repeatCount הוא אפס, לא יתרחש סיבוב והאנימציה תסתיים מיד אחרי שהיא תתחיל.
flyCameraTo	flyCameraTo(options) פרמטרים:  options:  FlyToAnimationOptions ערך מוחזר:  אין השיטה הזו מזיזה את המצלמה באופן פרבולי מהמיקום הנוכחי למיקום סופי נתון, במשך זמן נתון. השיטה היא אסינכרונית כי אנימציות יכולות להתחיל רק אחרי שהמפה נטענה במידה מינימלית. השיטה מחזירה ערך אחרי שהאנימציה מתחילה.
removeEventListener	removeEventListener(type, listener[, options]) פרמטרים:  type:  string מחרוזת שמציינת את סוג האירוע שעבורו צריך להסיר רכיב event listener. ‫listener:  EventListener|EventListenerObject רכיב ה-event listener של הגורם המטפל באירועים שרוצים להסיר מיעד האירוע. ‫options:  boolean|EventListenerOptions optional לאפשרויות. ערך מוחזר:  void הסרה מהיעד של רכיב event listener שנרשם בעבר באמצעות addEventListener. מידע נוסף זמין במאמר removeEventListener.
stopCameraAnimation	stopCameraAnimation() פרמטרים:  אין ערך מוחזר:  אין השיטה הזו עוצרת כל אנימציית מעוף שפועלת. המצלמה נשארת במיקום שבו היא נמצאת באמצע האנימציה, ולא עוברת לנקודת הסיום. השיטה היא אסינכרונית כי אנימציות יכולות להתחיל או להפסיק רק אחרי שהמפה נטענה במידה מסוימת. השיטה מחזירה את הערך אחרי שהאנימציה נעצרת.

אירועים
gmp-animationend	function(animationEndEvent) ארגומנטים:  animationEndEvent:  Event האירוע הזה מופעל כשאנימציית המעוף מסתיימת. האירוע הזה מבעבע דרך עץ ה-DOM.
gmp-centerchange	function(centerChangeEvent) ארגומנטים:  centerChangeEvent:  Event האירוע הזה מופעל כשמאפיין המרכז של Map3DElement משתנה.
gmp-click	function(clickEvent) ארגומנטים:  clickEvent:  LocationClickEvent|PlaceClickEvent האירוע הזה מופעל כשלוחצים על הרכיב Map3DElement.
gmp-error	function(mapInitializationErrorEvent) ארגומנטים:  mapInitializationErrorEvent:  Event האירוע הזה מופעל כשהמפה לא מצליחה לבצע אתחול.
gmp-headingchange	function(headingChangeEvent) ארגומנטים:  headingChangeEvent:  Event האירוע הזה מופעל כשמאפיין הכיוון של Map3DElement משתנה.
gmp-map-id-error	function(mapIdErrorEvent) ארגומנטים:  mapIdErrorEvent:  Event האירוע הזה מופעל כשהמאפיין mapId של Map3DElement לא תקין.
gmp-rangechange	function(rangeChangeEvent) ארגומנטים:  rangeChangeEvent:  Event האירוע הזה מופעל כשמאפיין הטווח של Map3DElement משתנה.
gmp-rollchange	function(rollChangeEvent) ארגומנטים:  rollChangeEvent:  Event האירוע הזה מופעל כשמאפיין הגלגול של Map3DElement משתנה.
gmp-steadychange	function(steadyChangeEvent) ארגומנטים:  steadyChangeEvent:  SteadyChangeEvent האירוע הזה מופעל כשהמצב היציב של Map3DElement משתנה.
gmp-tiltchange	function(tiltChangeEvent) ארגומנטים:  tiltChangeEvent:  Event האירוע הזה מופעל כשמאפיין ההטיה של Map3DElement משתנה.

ממשק Map3DElementOptions

ממשק google.maps.maps3d.Map3DElementOptions

אובייקט Map3DElementOptions משמש להגדרת המאפיינים שאפשר להגדיר ב-Map3DElement.

מאפיינים
bounds optional	סוג:  LatLngBounds|LatLngBoundsLiteral optional Map3DElement.bounds.
center optional	סוג:  LatLngAltitude|LatLngAltitudeLiteral optional Map3DElement.center.
defaultUIDisabled optional	הוצאה משימוש: במקומה יש להשתמש במדיניות Map3DElement.defaultUIHidden. המאפיין הזה יוסר בגרסה עתידית. סוג:  boolean optional Map3DElement.defaultUIDisabled.
defaultUIHidden optional	סוג:  boolean optional Map3DElement.defaultUIHidden.
description optional	סוג:  string optional Map3DElement.description.
gestureHandling optional	סוג:  GestureHandling optional Map3DElement.gestureHandling.
heading optional	סוג:  number optional Map3DElement.heading.
internalUsageAttributionIds optional	סוג:  Iterable<string> optional Map3DElement.internalUsageAttributionIds.
language optional	סוג:  string optional Map3DElement.language.
mapId optional	סוג:  string optional Map3DElement.mapId.
maxAltitude optional	סוג:  number optional Map3DElement.maxAltitude.
maxHeading optional	סוג:  number optional Map3DElement.maxHeading.
maxTilt optional	סוג:  number optional Map3DElement.maxTilt.
minAltitude optional	סוג:  number optional Map3DElement.minAltitude.
minHeading optional	סוג:  number optional Map3DElement.minHeading.
minTilt optional	סוג:  number optional Map3DElement.minTilt.
mode optional	סוג:  MapMode optional Map3DElement.mode.
range optional	סוג:  number optional Map3DElement.range.
region optional	סוג:  string optional Map3DElement.region.
roll optional	סוג:  number optional Map3DElement.roll.
tilt optional	סוג:  number optional Map3DElement.tilt.

קבועים של MapMode

google.maps.maps3d.MapMode קבועים

מציין את המצב שבו המפה תוצג.

כדי לקבל גישה, צריך לקרוא ל: const {MapMode} = await google.maps.importLibrary("maps3d").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

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

קבועים של GestureHandling

google.maps.maps3d.GestureHandling קבועים

מציין איך לטפל באירועי תנועה ברכיב המפה.

כדי לקבל גישה, צריך לקרוא ל: const {GestureHandling} = await google.maps.importLibrary("maps3d").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

קבועים
AUTO	כך המפה יכולה לבחור אם להשתמש בטיפול בתנועות מסוג cooperative או greedy. זוהי פעולת ברירת המחדל אם לא צוין אחרת. הפעולה הזו תגרום למפה להיכנס למצב שיתופי אם המפה שולטת בהורה הגלילה שלה (בדרך כלל הדף המארח) עד למצב שבו המשתמש לא יכול לגלול מהמפה לתוכן אחר.
COOPERATIVE	האפשרות הזו מאלצת מצב שיתופי, שבו נדרשים מקשי צירוף או תנועות בשתי אצבעות כדי לגלול במפה.
GREEDY	האפשרות הזו מאלצת מצב חמדני, שבו אי אפשר לגלול את הדף המארח מאירועי משתמש ברכיב המפה.

ממשק FlyAroundAnimationOptions

ממשק google.maps.maps3d.FlyAroundAnimationOptions

אפשרויות התאמה אישית של האנימציה FlyCameraAround.

מאפיינים
camera	סוג:  CameraOptions הנקודה המרכזית שאליה המצלמה צריכה להסתכל במהלך אנימציית המסלול. שימו לב שהכיוון של המפה ישתנה כשהמצלמה תקיף את נקודת המרכז הזו.
durationMillis optional	סוג:  number optional משך הזמן של מחזור אנימציה אחד באלפיות השנייה.
repeatCount optional	סוג:  number optional מציין את מספר הפעמים שהאנימציה תחזור על עצמה. אם המספר הוא אפס, האנימציה תסתיים מיד אחרי שהיא תתחיל.
rounds optional	הוצאה משימוש: במקומה יש להשתמש במדיניות FlyAroundAnimationOptions.repeatCount. סוג:  number optional מספר הסיבובים סביב המרכז במשך הזמן הנתון. ההגדרה הזו קובעת את מהירות הסיבוב הכללית. אם תעבירו מספר שלילי לסיבובים, המצלמה תסתובב נגד כיוון השעון במקום בכיוון השעון שמוגדר כברירת מחדל.

ממשק FlyToAnimationOptions

ממשק google.maps.maps3d.FlyToAnimationOptions

אפשרויות התאמה אישית של האנימציה FlyCameraTo.

מאפיינים
endCamera	סוג:  CameraOptions המיקום שאליו המצלמה צריכה לפנות בסוף האנימציה.
durationMillis optional	סוג:  number optional משך הזמן של האנימציה באלפיות השנייה. אם משך הזמן הוא 0, המצלמה תעבור ישירות למיקום הסופי.

ממשק CameraOptions

ממשק google.maps.maps3d.CameraOptions

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

מאפיינים
center optional	סוג:  LatLngAltitude|LatLngAltitudeLiteral optional Map3DElement.center.
heading optional	סוג:  number optional Map3DElement.heading.
range optional	סוג:  number optional Map3DElement.range.
roll optional	סוג:  number optional Map3DElement.roll.
tilt optional	סוג:  number optional Map3DElement.tilt.

המחלקה SteadyChangeEvent

מחלקה google.maps.maps3d.SteadyChangeEvent

האירוע הזה נוצר ממעקב אחר מצב יציב של Map3DElement. האירוע הזה מבעבע דרך עץ ה-DOM.

המחלקה הזו מרחיבה את Event.

כדי לקבל גישה, צריך לקרוא ל: const {SteadyChangeEvent} = await google.maps.importLibrary("maps3d").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

מאפיינים
isSteady	סוג:  boolean מציין אם Map3DElement יציב (כלומר, כל העיבוד של הסצנה הנוכחית הושלם) או לא.

המחלקה LocationClickEvent

מחלקה google.maps.maps3d.LocationClickEvent

האירוע הזה נוצר בלחיצה על Map3DElement.

המחלקה הזו מרחיבה את Event.

כדי לקבל גישה, צריך לקרוא ל: const {LocationClickEvent} = await google.maps.importLibrary("maps3d").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

מאפיינים
position	סוג:  LatLngAltitude optional קו הרוחב, קו האורך והגובה שהיו מתחת לסמן כשהאירוע התרחש. חשוב לזכור שברמות פחות מפורטות, הנתונים שיוחזרו יהיו פחות מדויקים. בנוסף, אם לוחצים על פני המים ממיקום גבוה יותר של המצלמה, יכול להיות שיוצג גובה קרקעית הים. האירוע הזה מבעבע דרך עץ ה-DOM.

המחלקה PlaceClickEvent

מחלקה google.maps.maps3d.PlaceClickEvent

האירוע הזה נוצר בלחיצה על סמל של מקום בMap3DElement. כדי למנוע את הצגת ברירת המחדל של החלון הקופץ, צריך להפעיל את ה-method‏ preventDefault() באירוע הזה כדי למנוע את הטיפול בו על ידי Map3DElement.

המחלקה הזו מרחיבה את LocationClickEvent.

כדי לקבל גישה, צריך לקרוא ל: const {PlaceClickEvent} = await google.maps.importLibrary("maps3d").
מידע נוסף מופיע בדף ספריות ב-Maps JavaScript API.

מאפיינים
placeId	סוג:  string מזהה המקום של התכונה במפה.
בירושה: position

Methods
fetchPlace	fetchPlace() פרמטרים:  אין ערך מוחזר:  Promise<Place> הפונקציה מאחזרת Place למזהה המקום הזה. באובייקט Place שנוצר, המאפיין id יאוכלס. אפשר לבקש שדות נוספים בהמשך דרך Place.fetchFields(), בכפוף להפעלה ולחיוב הרגילים של Places API. ה-promise נדחה אם הייתה שגיאה באחזור של Place.