המחלקה 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 |
סוג:
Array<MVCArray<HTMLElement>>פקדים נוספים שאפשר לצרף לתצוגת הפנורמה. כדי להוסיף פקד לתצוגת הפנורמה, מוסיפים את ה- <div> של הפקד ל-MVCArray שתואם ל-ControlPosition שבו רוצים להציג אותו. |
Methods | |
|---|---|
focus |
focus()פרמטרים: אין
הערך המוחזר: אין
המיקוד עובר אל StreetViewPanorama. כדאי לשקול להשתמש בשיטה הזו יחד עם אירוע visible_changed כדי לוודא ש-StreetViewPanorama גלוי לפני שמתמקדים בו. אי אפשר להתמקד בStreetViewPanorama שלא גלוי. |
getLinks |
getLinks()פרמטרים: אין
ערך מוחזר:
Array<StreetViewLink optional>|nullהפונקציה מחזירה את קבוצת קישורי הניווט של הפנורמה ב-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])פרמטרים:
הערך המוחזר: אין
הגדרת ספק הפנורמה המותאם אישית שנקרא בשינוי פנורמה כדי לטעון פנורמות מותאמות אישית. |
setLinks |
setLinks(links)פרמטרים:
הערך המוחזר: אין
הגדרת קבוצת קישורי הניווט לפנורמה ב-Street View. |
setMotionTracking |
setMotionTracking(motionTracking)פרמטרים:
הערך המוחזר: אין
מגדיר את המצב של מעקב התנועה. אם true כשהמשתמש מזיז את המכשיר פיזית והדפדפן תומך בכך, הפנורמה ב-Street View עוקבת אחרי התנועות הפיזיות. |
setOptions |
setOptions(options)פרמטרים:
הערך המוחזר: אין
מגדירה אוסף של צמדי מפתח/ערך. |
setPano |
setPano(pano)פרמטרים:
הערך המוחזר: אין
מגדירה את מזהה הפנורמה הנוכחי של הפנורמה ב-Street View. |
setPosition |
setPosition(latLng)פרמטרים:
הערך המוחזר: אין
מגדיר את המיקום הנוכחי של LatLng לתמונה הפנורמית ב-Street View. |
setPov |
setPov(pov)פרמטרים:
הערך המוחזר: אין
מגדירה את נקודת המבט של הפנורמה ב-Street View. |
setVisible |
setVisible(flag)פרמטרים:
הערך המוחזר: אין
מגדירים את הערך true כדי להציג את הפנורמה. אם המדיניות מוגדרת לערך false, התצוגה הפנורמית תוסתר, גם אם היא מוטמעת במפה וגם אם היא מוטמעת ב-<div> משלה. |
setZoom |
setZoom(zoom)פרמטרים:
הערך המוחזר: אין
הגדרת רמת הזום של הפנורמה. רמה 0 היא תצוגה מוקטנת לגמרי, שבה שדה הראייה הוא 180 מעלות. הגדלת התצוגה מגדילה את רמת הזום. |
עברו בירושה:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
אירועים | |
|---|---|
closeclick |
function(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
אופציונלי |
סוג:
boolean optionalהמצב (מופעל/מושבת) של פקד הכתובת. |
addressControlOptions
אופציונלי |
סוג:
StreetViewAddressControlOptions optionalאפשרויות התצוגה של פקד הכתובת. |
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
אופציונלי |
סוג:
MotionTrackingControlOptions optionalאפשרויות התצוגה של אמצעי הבקרה למעקב תנועה. |
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הגודל (בפיקסלים) של "העולם" של הפנורמה כולה. |
Methods | |
|---|---|
getTileUrl |
getTileUrl(pano, tileZoom, tileX, tileY)פרמטרים:
ערך מוחזר:
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. |
Methods | |
|---|---|
getMap |
getMap()פרמטרים: אין
ערך מוחזר:
Map|nullמחזירה את המפה שבה מוצגת השכבה הזו. |
setMap |
setMap(map)פרמטרים:
ערך מוחזר:
undefinedהפונקציה מעבדת את השכבה במפה שצוינה. אם המפה מוגדרת כ-null, השכבה תוסר. |
עברו בירושה:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |