הודעה: בקרוב תהיה אפשרות להשתמש בסגנון חדש למפות הבסיס בפלטפורמה של מפות Google. העדכון הזה לסגנון המפה כולל ערכת צבעים חדשה שמוגדרת כברירת מחדל, סיכות מודרניות ושיפורים בחוויית השימוש במפה ובממשק שלה. כל סגנונות המפה יתעדכנו באופן אוטומטי במרץ 2025. מידע נוסף על הזמינות ועל האופן שבו אפשר להביע הסכמה מוקדם יותר זמין במאמר סגנון מפה חדש בפלטפורמה של מפות Google.

דף זה תורגם על ידי Cloud Translation API.

Rendering

הכיתה StreetViewPanorama

google.maps.StreetViewPanorama class

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

הכיתה הזו היא תת-מחלקה של MVCObject.

אפשר לגשת אליו באמצעות חיוג למספר const {StreetViewPanorama} = await google.maps.importLibrary("streetView"). ספריות ב-Maps JavaScript API

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

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

Methods
`focus`	`focus()` פרמטרים: ללא ערך המוחזר: None הגדרת המיקוד ב-`StreetViewPanorama` הזה. מומלץ להשתמש בשיטה הזו יחד עם אירוע `visible_changed` כדי לוודא ש-`StreetViewPanorama` גלוי לפני שמגדירים את המיקוד בו. אי אפשר להתמקד ב-`StreetViewPanorama` שלא גלוי.
`getLinks`	`getLinks()` פרמטרים: ללא ערך המוחזר: `Array<StreetViewLink>` הפונקציה מחזירה את קבוצת הקישורים לניווט בפנורמה של Street View.
`getLocation`	`getLocation()` פרמטרים: ללא ערך המוחזר: `StreetViewLocation` הפונקציה מחזירה את המיקום ב-Street View של הפנורמה הנוכחית.
`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` ערך המוחזר: None מגדירים את ספק הפנורמה המותאם אישית שנקרא בזמן שינוי הפנורמה כדי לטעון פנורמות בהתאמה אישית.
`setLinks`	`setLinks(links)` פרמטרים: `links`: `Array<StreetViewLink>` ערך המוחזר: None הגדרת קבוצת קישורי הניווט לפנורמה של Street View.
`setMotionTracking`	`setMotionTracking(motionTracking)` פרמטרים: `motionTracking`: `boolean` ערך המוחזר: None הגדרת המצב של מכשיר מעקב התנועה. אם `true` כשהמשתמש מזיז פיזית את המכשיר והדפדפן תומך בכך, התמונה הפנורמית של Street View עוקבת אחרי התנועות הפיזיות.
`setOptions`	`setOptions(options)` פרמטרים: `options`: `StreetViewPanoramaOptions optional` ערך המוחזר: None הגדרת אוסף של צמדי מפתח/ערך.
`setPano`	`setPano(pano)` פרמטרים: `pano`: `string` ערך המוחזר: None הגדרת מזהה הפנורמה הנוכחי של הפנורמה ב-Street View.
`setPosition`	`setPosition(latLng)` פרמטרים: `latLng`: `LatLng\|LatLngLiteral optional` ערך המוחזר: None מגדיר את המיקום הנוכחי של `LatLng` לתמונה הפנורמית של Street View.
`setPov`	`setPov(pov)` פרמטרים: `pov`: `StreetViewPov` ערך המוחזר: None הגדרת נקודת המבט של התמונה הפנורמית ב-Street View.
`setVisible`	`setVisible(flag)` פרמטרים: `flag`: `boolean` ערך המוחזר: None מגדירים את הערך `true` כדי שהפנורמה תהיה גלויה. אם הערך שמוגדר הוא `false`, התצוגה הפנורמית תוסתר גם אם היא מוטמעת במפה וגם אם היא נמצאת ב-`<div>` משלה.
`setZoom`	`setZoom(zoom)` פרמטרים: `zoom`: `number` ערך המוחזר: None הגדרת רמת הזום של התמונה הפנורמית. מרחק התצוגה המרבי הוא רמה 0, שבה שדה הראייה הוא 180 מעלות. ככל שמגדילים את הזום, רמת הזום עולה.
עובר בירושה: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

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

הממשק StreetViewPanoramaOptions

ממשק google.maps.StreetViewPanoramaOptions

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

מאפיינים
`addressControl optional`	סוג: `boolean optional` המצב המופעל/מושבת של אמצעי הבקרה של הכתובת.
`addressControlOptions optional`	סוג: `StreetViewAddressControlOptions optional` אפשרויות התצוגה של אמצעי הבקרה של הכתובת.
`clickToGo optional`	סוג: `boolean optional` ברירת מחדל: `true` המצב המופעל/מושבת של 'קליק כדי לעבור'. לא רלוונטי לפנורמות בהתאמה אישית.
`controlSize optional`	סוג: `number optional` הגודל בפיקסלים של פקדי הבקרה שמופיעים בתמונה הפנורמית. צריך לספק את הערך הזה ישירות כשיוצרים את התמונה הפנורמית. עדכון הערך הזה בשלב מאוחר יותר עלול להעביר את אמצעי הבקרה למצב לא מוגדר. חלה רק על אמצעי הבקרה שנוצרו על ידי Maps API עצמו. לא מתבצעת התאמה לעומס של אמצעי בקרה מותאמים אישית שנוצרו על ידי מפתחים.
`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` מצב המעקב אחר תנועה (מופעל או מושבת). מופעל כברירת מחדל כשהפקד של מעקב אחר תנועה נמצא, והמשתמש העניק הרשאה או שהיא לא נדרשת, כך שזווית הצילום (נקודת המבט) תהיה בהתאם לכיוון המכשיר. הבעיה הזו רלוונטית בעיקר למכשירים ניידים. אם `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` אפשרויות התצוגה של פקדי המרחק מהתצוגה.

הממשק StreetViewAddressControlOptions

ממשק google.maps.StreetViewAddressControlOptions

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

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

הממשק PanoProviderOptions

ממשק google.maps.PanoProviderOptions

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

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

מאפיינים

cors optional

סוג: boolean optional

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

ממשק StreetViewTileData

ממשק google.maps.StreetViewTileData

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

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

Methods
`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 של תמונת המשבצת.

Methods

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 class

שכבה שמציגה את המיקומים שבהם התכונה Street View זמינה.

הכיתה הזו היא תת-מחלקה של MVCObject.

אפשר לגשת אליו באמצעות חיוג למספר const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView"). ספריות ב-Maps JavaScript API

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

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

Rendering

הכיתה StreetViewPanorama

יצרן

מאפיינים

Methods

אירועים

הממשק StreetViewPanoramaOptions

מאפיינים

הממשק StreetViewAddressControlOptions

מאפיינים

הממשק PanoProviderOptions

מאפיינים

ממשק StreetViewTileData

מאפיינים

Methods

ממשק StreetViewPov

מאפיינים

הכיתה StreetViewCoverageLayer

יצרן

Methods