Rendering

שיעור StreetViewPanorama

כיתה google.maps.StreetViewPanorama

מציגה את הפנורמה של LatLng או מזהה פנורמה נתון. אובייקט StreetViewPanorama מספק "Viewer" ל-Street View, והוא יכול להיות עצמאי בתוך <div> נפרד או להיות משויך לMap.

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

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

יצרן
StreetViewPanorama	StreetViewPanorama(container[, opts]) פרמטרים:  container:  HTMLElement opts:  StreetViewPanoramaOptions optional יוצר פנורמה עם StreetViewPanoramaOptions שעברו.

נכסים
controls	סוג:  Array<MVCArray<HTMLElement>> פקדים נוספים לצירוף לפנורמה. כדי להוסיף פקד לפנורמה, מוסיפים את <div> של הפקד ל-MVCArray המתאים ל-ControlPosition שבו יש לעבד אותו.

שיטות
focus	focus() פרמטרים: ללא ערך החזרה: אין מגדיר את המיקוד בStreetViewPanorama הזה. מומלץ להשתמש בשיטה הזו יחד עם אירוע visible_changed כדי לוודא שהשדה StreetViewPanorama גלוי לפני שמגדירים את המיקוד שלו. לא ניתן לטרגט StreetViewPanorama שאינו גלוי.
getLinks	getLinks() פרמטרים: ללא ערך החזרה:  Array<StreetViewLink> מחזירה את קבוצת קישורי הניווט של הפנורמה של Street View.
getLocation	getLocation() פרמטרים: ללא ערך החזרה:  StreetViewLocation מחזירה את ה-StreetViewLocation של הפנורמה הנוכחית.
getMotionTracking	getMotionTracking() פרמטרים: ללא ערך החזרה:  boolean מחזירה את המצב של עוקב התנועה. אם true כשהמשתמש מפעיל את המכשיר באופן פיזי והדפדפן תומך בו, הפנורמה של Street View עוקבת אחר התנועות הפיזיות.
getPano	getPano() פרמטרים: ללא ערך החזרה:  string מחזירה את מזהה הפנורמה הנוכחי של הפנורמה של Street View. המזהה הזה יציב רק בסשן הנוכחי של הדפדפן.
getPhotographerPov	getPhotographerPov() פרמטרים: ללא ערך החזרה:  StreetViewPov מחזירה את הכותרת והגובה של הצלם בעת צילום הפנורמה הזו. בתמונות פנורמיות של Street View בכביש, אפשר לראות גם את כיוון הנסיעה של הרכב. הנתונים האלה זמינים אחרי האירוע pano_changed.
getPosition	getPosition() פרמטרים: ללא ערך החזרה:  LatLng|null מחזירה את המיקום הנוכחי של LatLng לפנורמה של Street View.
getPov	getPov() פרמטרים: ללא ערך החזרה:  StreetViewPov מחזירה את נקודת המבט הנוכחית של הפנורמה של Street View.
getStatus	getStatus() פרמטרים: ללא ערך החזרה:  StreetViewStatus מחזירה את הסטטוס של הפנורמה לאחר השלמת הבקשה setPosition() או setPano().
getVisible	getVisible() פרמטרים: ללא ערך החזרה:  boolean מחזירה true אם אפשר לראות את הפנורמה. היא לא מציינת אם תמונות Street View זמינות במיקום שצוין.
getZoom	getZoom() פרמטרים: ללא ערך החזרה:  number מחזירה את רמת הזום של הפנורמה. תמונה עם התרחקות מלאה היא רמה 0, שבה שדה הראייה הוא 180 מעלות. הגדלת התצוגה מעלה את רמת הזום.
registerPanoProvider	registerPanoProvider(provider[, opt_options]) פרמטרים:  provider:  function(string): (StreetViewPanoramaData optional) opt_options:  PanoProviderOptions optional ערך החזרה: אין הגדרת הספק של תמונות פנורמה מותאמות אישית, שנקראה 'שינוי תמונה פנורמית', כדי לטעון תמונות פנורמה מותאמות אישית.
setLinks	setLinks(links) פרמטרים:  links:  Array<StreetViewLink> ערך החזרה: אין מגדירה את קבוצת קישורי הניווט של תמונת הפנורמה ב-Street View.
setMotionTracking	setMotionTracking(motionTracking) פרמטרים:  motionTracking:  boolean ערך החזרה: אין הגדרת המצב של כלי המעקב אחר תנועה. אם true כשהמשתמש מפעיל את המכשיר באופן פיזי והדפדפן תומך בו, הפנורמה של Street View עוקבת אחר התנועות הפיזיות.
setOptions	setOptions(options) פרמטרים:  options:  StreetViewPanoramaOptions optional ערך החזרה: אין מגדירה אוסף של צמדי מפתח/ערך.
setPano	setPano(pano) פרמטרים:  pano:  string ערך החזרה: אין מגדיר את מזהה הפנורמה הנוכחי של תמונת הפנורמה ב-Street View.
setPosition	setPosition(latLng) פרמטרים:  latLng:  LatLng|LatLngLiteral optional ערך החזרה: אין הגדרת המיקום הנוכחי של LatLng לפנורמה של Street View.
setPov	setPov(pov) פרמטרים:  pov:  StreetViewPov ערך החזרה: אין מגדירה את נקודת המבט של הפנורמה של Street View.
setVisible	setVisible(flag) פרמטרים:  flag:  boolean ערך החזרה: אין מוגדר ל-true כדי להפוך את הפנורמה לגלויה. אם המדיניות מוגדרת כ-false, הפנורמה תוסתר בין אם היא מוטמעת במפה או ב-<div> שלה.
setZoom	setZoom(zoom) פרמטרים:  zoom:  number ערך החזרה: אין מגדירה את רמת הזום של הפנורמה. תמונה עם התרחקות מלאה היא רמה 0, שבה שדה הראייה הוא 180 מעלות. הגדלת התצוגה מעלה את רמת הזום.
הועבר בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

אירועים
closeclick	function(event) ארגומנטים:  event:  Event האירוע הופעל. האירוע הזה מופעל כשלוחצים על לחצן הסגירה.
pano_changed	function() ארגומנטים: ללא האירוע הזה מופעל כשמזהה הפנורמה של הפנורמה משתנה. הפנורמה עשויה להשתנות כאשר המשתמש מנווט בין הפנורמה או המיקום מוגדר באופן ידני. לתשומת ליבך, לא כל שינויי המיקום מפעילים pano_changed.
position_changed	function() ארגומנטים: ללא האירוע הזה מופעל כאשר המיקום של הפנורמה משתנה. המיקום משתנה כשהמשתמש מנווט בפנורמה או שהמיקום מוגדר באופן ידני.
pov_changed	function() ארגומנטים: ללא האירוע הזה מופעל כשנקודת המבט של הפנורמה משתנה. נקודת המבט משתנה כשגובה התצוגה, מרחק התצוגה או הכותרת.
resize	function() ארגומנטים: ללא המפתחים צריכים להפעיל את האירוע הזה בתמונת הפנורמה כשגודל ה-div שלו ישתנה: google.maps.event.trigger(panorama, 'resize').
status_changed	function() ארגומנטים: ללא האירוע הזה מופעל אחרי כל חיפוש פנורמה לפי מזהה או מיקום, דרך setPosition() או setPano().
visible_changed	function() ארגומנטים: ללא האירוע הזה מופעל כאשר הרשאות הגישה של הפנורמה משתנות. הרשאות הגישה משתנות כשגרירה אטב-איש גוררת אל המפה, כשלוחצים על לחצן הסגירה או כשמתבצעת קריאה אל setVisible().
zoom_changed	function() ארגומנטים: ללא האירוע הזה מופעל כשרמת הזום של הפנורמה משתנה.

ממשק StreetViewPanoramaOptions

ממשק google.maps.StreetViewPanoramaOptions

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

נכסים
addressControl optional	סוג:  boolean optional מצב ההפעלה/השבתה של פקד הכתובת.
addressControlOptions optional	סוג:  StreetViewAddressControlOptions optional אפשרויות התצוגה של פקד הכתובת.
clickToGo optional	סוג:  boolean optional ברירת מחדל: true המצב מופעל/מושבת של קליק להפעלה. לא רלוונטי לתצוגות פנורמה מותאמות אישית.
controlSize optional	סוג:  number optional הגודל בפיקסלים של הפקדים שמופיעים בפנורמה. יש לספק את הערך הזה ישירות בעת יצירת הפנורמה, עדכון ערך זה מאוחר יותר עשוי להביא את הפקדים למצב לא מוגדר. המדיניות קובעת רק את אמצעי הבקרה שבוצעו על ידי ה-API של מפות Google. אין התאמה לפקדים מותאמים אישית שנוצרו על ידי המפתח.
disableDefaultUI optional	סוג:  boolean optional הפעלה/השבתה של כל ממשק המשתמש המוגדר כברירת מחדל. ניתן לבטל בנפרד.
disableDoubleClickZoom optional	סוג:  boolean optional ברירת מחדל: true הפעלה/השבתה של שינוי מרחק התצוגה בלחיצה כפולה.
enableCloseButton optional	סוג:  boolean optional ברירת מחדל: false אם הלחצן true מופיע, לחצן הסגירה מוצג.
fullscreenControl optional	סוג:  boolean optional המצב מופעל/מושבת של הפקד במסך מלא.
fullscreenControlOptions optional	סוג:  FullscreenControlOptions optional אפשרויות התצוגה של הפקד מסך מלא.
imageDateControl optional	סוג:  boolean optional המצב מופעל/מושבת של בקרת התאריכים לצירוף תמונות. האפשרות מושבתת כברירת מחדל.
linksControl optional	סוג:  boolean optional המצב המופעל/מושבת של פקדי הקישורים.
motionTracking optional	סוג:  boolean optional האם מעקב התנועה מופעל או מושבת. מופעל כברירת מחדל כאשר פקד מעקב התנועה קיים וההרשאה ניתנה על ידי משתמש או שאינה נדרשת, כך שנקודת המבט (POP) מוצגת בהתאם לכיוון המכשיר. זה רלוונטי בעיקר למכשירים ניידים. אם המדיניות motionTracking מוגדרת לערך false כל עוד ההגדרה motionTrackingControl מופעלת, המעקב אחר התנועה יופיע, אבל המעקב יושבת. המשתמש יכול להקיש על הפקד למעקב אחר תנועה כדי להחליף את מצב האפשרות הזו. אם motionTracking מקבל את הערך true בזמן שנדרשת הרשאה, אבל עדיין לא נשלחה בקשה, בקרת המעקב אחר התנועה תופיע, אבל המעקב כבוי. המשתמש יכול להקיש על הבקרה למעקב אחר תנועה כדי לבקש הרשאה. אם המדיניות motionTracking מוגדרת לערך true כל עוד ההרשאה נדחתה על ידי משתמש, נראה שפקד המעקב אחר תנועה מושבת כשהמעקב מושבת.
motionTrackingControl optional	סוג:  boolean optional המצב מופעל/מושבת של הפקד של מעקב התנועה. האפשרות הזו מופעלת כברירת מחדל כשהמכשיר כולל נתוני תנועה, כך שהפקד מופיע במפה. זה רלוונטי בעיקר למכשירים ניידים.
motionTrackingControlOptions optional	סוג:  MotionTrackingControlOptions optional אפשרויות התצוגה עבור הפקד של מעקב התנועה.
panControl optional	סוג:  boolean optional המצב המופעל/מושבת של פקד ההזזה.
panControlOptions optional	סוג:  PanControlOptions optional אפשרויות התצוגה של הזזת החלונית.
pano optional	סוג:  string optional מזהה הפנורמה, שאותו יש להגדיר בעת ציון פנורמה מותאמת אישית.
position optional	סוג:  LatLng|LatLngLiteral optional המיקום LatLng של הפנורמה ב-Street View.
pov optional	סוג:  StreetViewPov optional כיוון המצלמה, מוגדר ככותרת וגובה, עבור הפנורמה.
scrollwheel optional	סוג:  boolean optional ברירת מחדל: true אם המדיניות false מושבתת, שינוי מרחק התצוגה של גלגל הגלילה ב-Street View מושבת.
showRoadLabels optional	סוג:  boolean optional ברירת מחדל: true הצגת שמות הרחובות בפנורמה. אם לא מגדירים את הערך הזה, או אם מגדירים אותו לערך true, שמות הרחובות מוצגים בפנורמה. אם ההגדרה היא false, שמות הרחובות לא מוצגים.
visible optional	סוג:  boolean optional אם מופיע true, הפנורמה של Street View נראית לעין בזמן הטעינה.
zoom optional	סוג:  number optional הזום של הפנורמה, מצוינת כמספר. זום של 0 מעניק שדה ראייה של 180 מעלות.
zoomControl optional	סוג:  boolean optional המצב מופעל/מושבת של פקד הזום.
zoomControlOptions optional	סוג:  ZoomControlOptions optional אפשרויות התצוגה של פקד הזום.

ממשק StreetViewAddressControlOption

ממשק google.maps.StreetViewAddressControlOptions

אפשרויות העיבוד של פקד הכתובת ב-Street View.

נכסים
position optional	סוג:  ControlPosition optional מזהה מיקום. המזהה הזה משמש לציון מיקום הפקד במפה. מיקום ברירת המחדל הוא TOP_LEFT.

ממשק PanoProviderOptions

ממשק google.maps.PanoProviderOptions

אפשרויות לספק מותאם אישית של תמונות Pano.

נכסים
cors optional	סוג:  boolean optional אם המאפיין מוגדר, הרינדור ישתמש בטכנולוגיות (כמו webgl) שפועלות רק כשהכותרות של cors מוגדרות כראוי בתמונות שסופקו. המשימה של המפתח היא להציג את התמונות באופן תקין בשילוב עם הסימון הזה, מה שעלול לגרום לשגיאות אבטחה.

ממשק StreetViewTileData

ממשק google.maps.StreetViewTileData

מאפייני קבוצת האריחים שבה משתמשים בפנורמה של Street View.

נכסים
centerHeading	סוג:  number הכותרת (במעלות) במרכז האריחים הפנורמיים.
tileSize	סוג:  Size הגודל (בפיקסלים) שבו יתבצע עיבוד המשבצות.
worldSize	סוג:  Size הגודל (בפיקסלים) של "העולם" של כל הפנורמה.

שיטות

getTileUrl

getTileUrl(pano, tileZoom, tileX, tileY) פרמטרים:  pano:  string tileZoom:  number tileX:  number tileY:  number ערך החזרה:  string קבלת כתובת ה-URL של תמונת המשבצת עבור המשבצת שצוינה. זוהי שיטה מותאמת אישית שצריך להטמיע כדי לספק משבצות בהתאמה אישית. ה-API קורא לשיטה הזו ומספק את הפרמטרים הבאים: pano הוא מזהה הפנורמה של משבצת Street View. tileZoom היא רמת המרחק מהתצוגה של המשבצת. tileX הוא קואורדינטת ה-x של המשבצת. tileY הוא קואורדינטת ה-y של המשבצת. השיטה המותאמת אישית חייבת להחזיר את כתובת ה-URL של תמונת המשבצת.

הממשק של StreetViewPov

ממשק google.maps.StreetViewPov

אובייקט של נקודת מבט שמציין את כיוון המצלמה במיקום הפנורמי של Street View. נקודת המבט מוגדרת ככותרת וגובה הצליל.

נכסים
heading	סוג:  number כיוון המצלמה במעלות ביחס לצפון true. צפון אמיתי הוא 0°, מזרח הוא 90°, דרום 180°, מערב הוא 270°.
pitch	סוג:  number גובה הקרנה של המצלמה במעלות, ביחס לרכב של Street View. נע בין 90° (ישירות למעלה) ל-90°- (ישירות למטה).

המחלקה StreetViewCoverageLayer

כיתה google.maps.StreetViewCoverageLayer

שכבה שממחישה את המיקומים שבהם Street View זמין.

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

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

יצרן
StreetViewCoverageLayer	StreetViewCoverageLayer() פרמטרים: ללא יצירת מכונה חדשה של StreetViewCoverageLayer.

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