השקת Places UI Kit: ספריית רכיבים מוכנה לשימוש בעלות נמוכה, שמאפשרת לכם להוסיף לכל מפה שתבחרו את ממשק המשתמש המוכר של 'מקומות' במפות Google. כדאי לנסות אותו ולשלוח לנו משוב כדי לעזור לנו לעצב את העתיד של GMP.

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

Rendering

‫StreetViewPanorama class

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

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` המיקום של הפנורמה ב-Street View.`LatLng`
`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 interface

google.maps.StreetViewAddressControlOptions ממשק

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

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

‫PanoProviderOptions interface

google.maps.PanoProviderOptions ממשק

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

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

מאפיינים

cors optional

סוג: boolean optional

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

‫StreetViewTileData interface

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 interface

google.maps.StreetViewPov ממשק

אובייקט של נקודת מבט שמציין את האוריינטציה של המצלמה במיקום של תמונת הפנורמה ב-Street View. נקודת המבט מוגדרת ככיוון וזווית.

מאפיינים
`heading`	סוג: `number` הכיוון של המצלמה במעלות ביחס לצפון `true`. הצפון האמיתי הוא 0°, המזרח הוא 90°, הדרום הוא 180° והמערב הוא 270°.
`pitch`	סוג: `number` זווית המצלמה במעלות, ביחס לכלי הרכב של Street View. הערך נע בין 90° (למעלה) לבין ‎-90°‎ (למטה).

‫StreetViewCoverageLayer class

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 class

יצרן

מאפיינים

Methods

אירועים

‫StreetViewPanoramaOptions interface

מאפיינים

‫StreetViewAddressControlOptions interface

מאפיינים

‫PanoProviderOptions interface

מאפיינים

‫StreetViewTileData interface

מאפיינים

Methods

‫StreetViewPov interface

מאפיינים

‫StreetViewCoverageLayer class

יצרן

Methods

Rendering