Rendering

המחלקה StreetViewPanorama

class google.maps.StreetViewPanorama extends MVCObject
library "streetView"

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

const {StreetViewPanorama} = await google.maps.importLibrary("streetView");
StreetViewPanorama
StreetViewPanorama(container[, opts])
פרמטרים:
יצירת פנורמה עם StreetViewPanoramaOptions שהועבר.
controls
פקדים נוספים שאפשר לצרף לתצוגת הפנורמה. כדי להוסיף פקד לתצוגת הפנורמה, מוסיפים את ה-<div> של הפקד ל-MVCArray שתואם ל-ControlPosition שבו רוצים להציג אותו.
focus
focus()
פרמטרים: אין
הערך המוחזר: אין
המיקוד עובר אל StreetViewPanorama. כדאי לשקול להשתמש בשיטה הזו יחד עם אירוע visible_changed כדי לוודא ש-StreetViewPanorama גלוי לפני שמתמקדים בו. אי אפשר להתמקד בStreetViewPanorama שלא גלוי.
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])
פרמטרים:
הערך המוחזר: אין
הגדרת ספק הפנורמה המותאם אישית שנקרא בשינוי פנורמה כדי לטעון פנורמות מותאמות אישית.
setMotionTracking
setMotionTracking(motionTracking)
פרמטרים:
  • motionTracking: boolean
הערך המוחזר: אין
מגדיר את המצב של מעקב התנועה. אם true כשהמשתמש מזיז את המכשיר פיזית והדפדפן תומך בכך, הפנורמה ב-Street View עוקבת אחרי התנועות הפיזיות.
setOptions
setOptions(options)
פרמטרים:
הערך המוחזר: אין
מגדירה אוסף של צמדי מפתח/ערך.
setPano
setPano(pano)
פרמטרים:
  • pano: string
הערך המוחזר: אין
מגדירה את מזהה הפנורמה הנוכחי של הפנורמה ב-Street View.
setPosition
setPosition(latLng)
פרמטרים:
הערך המוחזר: אין
מגדיר את המיקום הנוכחי של LatLng לתמונה הפנורמית ב-Street View.
setPov
setPov(pov)
פרמטרים:
הערך המוחזר: אין
מגדירה את נקודת המבט של הפנורמה ב-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 optional האירוע הופעל.
האירוע הזה מופעל כשלוחצים על כפתור הסגירה.
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
אופציונלי
סוג: boolean optional
המצב (מופעל/מושבת) של פקד הכתובת.
addressControlOptions
אופציונלי
אפשרויות התצוגה של פקד הכתובת.
clickToGo
אופציונלי
סוג: boolean optional
ברירת המחדל: true
מצב ההפעלה/ההשבתה של לחיצה למעבר. לא רלוונטי לתמונות פנורמיות בהתאמה אישית.
controlSize
אופציונלי
סוג: number optional
גודל הפקדים שמופיעים בתמונה הפנורמית, בפיקסלים. צריך לספק את הערך הזה ישירות כשיוצרים את התצוגה הפנורמית. אם מעדכנים את הערך הזה מאוחר יותר, יכול להיות שהפקדים יגיעו למצב לא מוגדר. המדיניות הזו חלה רק על אמצעי הבקרה שנוצרו על ידי Maps API עצמו. לא משנה את הגודל של פקדים מותאמים אישית שנוצרו על ידי מפתחים.
disableDefaultUI
אופציונלי
סוג: boolean optional
הפעלה או השבתה של כל ממשק המשתמש שמוגדר כברירת מחדל. אפשר לשנות את ההגדרה הזו לכל משתמש בנפרד.
disableDoubleClickZoom
אופציונלי
סוג: boolean optional
ברירת המחדל: true
הפעלה או השבתה של שינוי מרחק התצוגה בלחיצה כפולה.
enableCloseButton
אופציונלי
סוג: boolean optional
ברירת המחדל: false
אם true, לחצן הסגירה מוצג.
fullscreenControl
אופציונלי
סוג: boolean optional
המצב (מופעל/מושבת) של פקד המסך המלא.
fullscreenControlOptions
אופציונלי
סוג: FullscreenControlOptions optional
אפשרויות התצוגה של פקד המסך המלא.
imageDateControl
אופציונלי
סוג: boolean optional
מצב ההפעלה/ההשבתה של אמצעי הבקרה על תאריך רכישת התמונות. מושבתת כברירת מחדל.
linksControl
אופציונלי
סוג: boolean optional
מצב ההפעלה/ההשבתה של אמצעי הבקרה על הקישורים.
motionTracking
אופציונלי
סוג: boolean optional
אם מעקב התנועה מופעל או מושבת. כברירת מחדל, הוא מופעל כשאמצעי הבקרה של מעקב התנועה קיים והמשתמש נתן הרשאה או שהיא לא נדרשת, כדי שנקודת המבט תעקוב אחרי הכיוון של המכשיר. האפשרות הזו רלוונטית בעיקר למכשירים ניידים. אם המדיניות motionTracking מוגדרת לערך false והמדיניות motionTrackingControl מופעלת, אמצעי הבקרה של מעקב התנועה מופיע אבל המעקב מושבת. המשתמש יכול ללחוץ על אמצעי הבקרה של מעקב התנועה כדי להחליף את המצב של האפשרות הזו. אם המדיניות motionTracking מוגדרת לערך true, ונדרשת הרשאה אבל היא עדיין לא התבקשה, אמצעי הבקרה של מעקב התנועה מופיע אבל המעקב מושבת. המשתמש יכול ללחוץ על אמצעי הבקרה של מעקב התנועה כדי לבקש הרשאה. אם המדיניות motionTracking מוגדרת לערך true והמשתמש דוחה את ההרשאה, אמצעי הבקרה של מעקב התנועה מושבת והמעקב כבוי.
motionTrackingControl
אופציונלי
סוג: boolean optional
מצב ההפעלה/ההשבתה של אמצעי הבקרה למעקב תנועה. האפשרות הזו מופעלת כברירת מחדל כשיש במכשיר נתוני תנועה, כדי שהפקד יופיע במפה. האפשרות הזו רלוונטית בעיקר למכשירים ניידים.
motionTrackingControlOptions
אופציונלי
אפשרויות התצוגה של אמצעי הבקרה למעקב תנועה.
panControl
אופציונלי
סוג: boolean optional
מצב ההפעלה/ההשבתה של פקד ההזזה.
panControlOptions
אופציונלי
סוג: PanControlOptions optional
אפשרויות התצוגה של פקד ההזזה.
pano
אופציונלי
סוג: string optional
מזהה הפנורמה, שצריך להגדיר כשמציינים פנורמה בהתאמה אישית.
position
אופציונלי
סוג: LatLng|LatLngLiteral optional
המיקום של LatLng בפנורמה ב-Street View.
pov
אופציונלי
סוג: StreetViewPov optional
כיוון המצלמה, שצוין ככיוון וזווית, לתצוגת הפנורמה.
scrollwheel
אופציונלי
סוג: boolean optional
ברירת המחדל: true
אם הערך הוא false, גלגלת העכבר לא משמשת לשינוי מרחק התצוגה ב-Street View.
showRoadLabels
אופציונלי
סוג: boolean optional
ברירת המחדל: true
הצגת שמות הרחובות בתמונה הפנורמית. אם לא מציינים את הערך הזה, או אם מגדירים אותו כ-true, שמות הרחובות מוצגים בתצוגה הפנורמית. אם המדיניות מוגדרת לערך false, שמות הרחובות לא מוצגים.
visible
אופציונלי
סוג: boolean optional
אם הערך הוא true, הפנורמה ב-Street View גלויה בזמן הטעינה.
zoom
אופציונלי
סוג: number optional
הזום של הפנורמה, שצוין כמספר. זום של 0 נותן שדה ראייה של 180 מעלות.
zoomControl
אופציונלי
סוג: boolean optional
הסטטוס של פקד הזום (מופעל או מושבת).
zoomControlOptions
אופציונלי
סוג: ZoomControlOptions optional
אפשרויות התצוגה של פקד הזום.

ממשק StreetViewAddressControlOptions

ממשק google.maps.StreetViewAddressControlOptions

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

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

ממשק PanoProviderOptions

ממשק google.maps.PanoProviderOptions

אפשרויות לספק הפנורמה בהתאמה אישית.

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

ממשק 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 קורא ל-method הזו ומספק את הפרמטרים הבאים:
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

class google.maps.StreetViewCoverageLayer extends MVCObject
library "streetView"

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

const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView");
StreetViewCoverageLayer
StreetViewCoverageLayer()
פרמטרים: אין
יוצרת מופע חדש של StreetViewCoverageLayer.
getMap
getMap()
פרמטרים: אין
ערך מוחזר: Map|null
מחזירה את המפה שבה מוצגת השכבה הזו.
setMap
setMap(map)
פרמטרים:
  • map: Map optional
ערך מוחזר: undefined
הפונקציה מעבדת את השכבה במפה שצוינה. אם המפה מוגדרת כ-null, השכבה תוסר.
‫עברו בירושה: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll