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

מאפיינים

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

שיטות

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` ערך החזרה: `undefined` עיבוד השכבה במפה שצוינה. אם המפה מוגדרת כ-null, השכבה תוסר.
עברה בירושה: `addListener`, `bindTo`, `get`, `notify`, `set`, `setValues`, `unbind`, `unbindAll`

Rendering

StreetViewPanorama כיתה

יצרן

מאפיינים

שיטות

אירועים

StreetViewPanoramaOptions ממשק

מאפיינים

StreetViewAddressControlOptions ממשק

מאפיינים

PanoProviderOptions ממשק

מאפיינים

StreetViewTileData ממשק

מאפיינים

שיטות

StreetViewPov ממשק

מאפיינים

StreetViewCoverageLayer כיתה

יצרן

שיטות