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

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

Rendering

המחלקה StreetViewPanorama

google.maps.StreetViewPanorama סיווג

מציג את תמונת הפנורמה עבור 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` שבו יש לעבד אותו.

שיטות
`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` הפעלה או השבתה של מעקב התנועה. מופעל כברירת מחדל כאשר פקד המעקב אחר התנועה קיים וההרשאה ניתנה על ידי המשתמש או לא נדרשת, כך שה-POV (נקודת המבט) עוקב אחר כיוון המכשיר. עיקרון זה חל בעיקר על מכשירים ניידים. אם המדיניות `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` אם היא מוגדרת, כלי הרינדור ישתמש בטכנולוגיות (כמו webgl) שפועלות רק כשכותרות cors מוגדרות כראוי בתמונות שסופקו. המשימה של המפתח היא להציג את התמונות בצורה נכונה בשילוב עם הדגל הזה, מה שעלול להוביל לשגיאות SecurityErrors.

תכונות

cors optional

סוג: boolean optional

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

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

שיטות

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"). ראה ספריות ב-Maps JavaScript API.

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

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

Rendering

המחלקה StreetViewPanorama

יצרן

תכונות

שיטות

אירועים

הממשק של StreetViewPanoramaOptions

תכונות

ממשק StreetViewAddressControlOptions

תכונות

הממשק של PanoProviderOptions

תכונות

ממשק StreetViewTileData

תכונות

שיטות

הממשק של StreetViewPov

תכונות

הסיווג StreetViewCoverageLayer

יצרן

שיטות