Service

מחלקה StreetViewService

מחלקה google.maps.StreetViewService

אובייקט StreetViewService מבצע חיפושים אחר נתוני Street View.

אפשר לקבל גישה על ידי התקשרות ל-const {StreetViewService} = await google.maps.importLibrary("streetView"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

יצרן
StreetViewService	StreetViewService() פרמטרים: ללא יצירת StreetViewService, המספקת ממשק לנתונים המאוחסנים בשירות Street View.

שיטות
getPanorama	getPanorama(request[, callback]) פרמטרים:  request:  StreetViewLocationRequest|StreetViewPanoRequest callback:  function(StreetViewPanoramaData optional, StreetViewStatus): void optional ערך החזרה:  Promise<StreetViewResponse> מאחזר את הפונקציה StreetViewPanoramaData עבור פנורמה שתואמת לבקשת השאילתה שסופקה ב-Street View. הפרמטר StreetViewPanoramaData מועבר לקריאה חוזרת (callback) שצוינה.

קבועים ל-StreetViewStatus

google.maps.StreetViewStatus קבועים

הסטטוס שמוחזר על ידי StreetViewService בסיום בקשת Street View. אפשר לציין אותם באמצעות ערך או באמצעות השם של הקבוע. לדוגמה, 'OK' או google.maps.StreetViewStatus.OK.

אפשר לקבל גישה על ידי התקשרות ל-const {StreetViewStatus} = await google.maps.importLibrary("streetView"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

קבועים
OK	הבקשה הצליחה.
UNKNOWN_ERROR	לא ניתן היה לעבד את הבקשה בהצלחה, אבל הסיבה המדויקת לכישלון לא ידועה.
ZERO_RESULTS	לא נמצאו פנורמות שתואמות לקריטריוני החיפוש.

הממשק של StreetViewLocationRequest

ממשק google.maps.StreetViewLocationRequest

בקשת Street View לשליחה באמצעות getPanorama. StreetViewLocationRequest מאפשר לך לחפש פנורמה של Street View במיקום שצוין.

נכסים
location optional	סוג:  LatLng|LatLngLiteral optional מציינת את המיקום שבו יש לחפש תמונת פנורמה ב-Street View.
preference optional	סוג:  StreetViewPreference optional מגדיר העדפה אשר עליה להתקבל הרדיוס ברדיוס: זה הקרוב ביותר למיקום שצוין או המתאים ביותר ברדיוס.
radius optional	סוג:  number optional ברירת מחדל: 50 מגדיר רדיוס במטרים שבהם יש לחפש פנורמה.
source optional	סוג:  StreetViewSource optional ברירת מחדל: StreetViewSource.DEFAULT מציינת את מקור הפנורמות לחיפוש. כך, לדוגמה, תהיה הגבלה על חיפוש נופים פנורמיים בחוץ בלבד.

הממשק של StreetViewPanoRequest

ממשק google.maps.StreetViewPanoRequest

הפונקציה StreetViewPanoRequest משמשת לאיתור getPanorama כדי לאתר תמונת פנורמה עם המזהה שצוין.

נכסים
pano optional	סוג:  string optional מציין את מזהה הפנורמה לחיפוש.

הממשק של StreetViewResponse

ממשק google.maps.StreetViewResponse

התגובה סומנה להבטחה של StreetViewService.getPanorama.

נכסים
data	סוג:  StreetViewPanoramaData ייצוג של פנורמה.

הממשק של StreetViewLocation

ממשק google.maps.StreetViewLocation

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

נכסים
pano	סוג:  string מזהה ייחודי עבור הפנורמה. הוא יציב בביקור אבל לא יציב בכל הסשנים.
description optional	סוג:  string optional מחרוזת המותאמת למיקום.
latLng optional	סוג:  LatLng optional הנחל הפנורמי
shortDescription optional	סוג:  string optional תיאור קצר של המיקום.

קבועים StreetViewהעדפות

google.maps.StreetViewPreference קבועים

אפשרויות שמסובבות את תוצאת החיפוש כדי להחזיר תמונת פנורמה ב-Street View שקרובה יותר למיקום הבקשה, או פנורמה שנחשבת סבירה ביותר למה שהמשתמש רוצה לראות. צריך לציין את הערכים האלה לפי ערך, או להשתמש בשם הקבוע. לדוגמה, 'best' או google.maps.StreetViewPreference.BEST.

אפשר לקבל גישה על ידי התקשרות ל-const {StreetViewPreference} = await google.maps.importLibrary("streetView"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

קבועים
BEST	החזר את הפנורמה של Street View שנחשבת סבירה ביותר למה שהמשתמש רוצה לראות. התוצאה הטובה ביותר נקבעת על ידי אלגוריתמים המבוססים על מחקר משתמשים ופרמטרים כגון נקודות עניין מוכרות, איכות תמונה ומרחק מהמיקום הנתון.
NEAREST	יש להחזיר את הפנורמה של Street View למרחק הקצר ביותר מהמיקום שצוין. הכלי פועל היטב ברדיוס מוגבל. הרדיוס המומלץ הוא קילומטר אחד או פחות.

קבועים StreetViewSource

google.maps.StreetViewSource קבועים

מזהים שמגבילים את החיפושים ב-Street View למקורות שנבחרו. הערכים האלה מצוינים כמחרוזות. לדוגמה: 'outdoor'.

אפשר לקבל גישה על ידי התקשרות ל-const {StreetViewSource} = await google.maps.importLibrary("streetView"). יש לעיין בספריות ב-API של מפות Google ל-JavaScript.

קבועים
DEFAULT	שימוש במקורות ברירת המחדל של Street View, החיפושים לא יוגבלו למקורות ספציפיים.
OUTDOOR	הגבלת חיפושים ב-Street View באוספים חיצוניים. קולקציות מקורות לא נכללות בתוצאות החיפוש. כמו כן, שימו לב שהחיפוש מחזיר פנורמות רק כשאפשר לקבוע אם הן בפנים או בחוץ. לדוגמה, תמונות PhotoSpheres לא מוחזרות כי לא ידוע אם הן בפנים או בחוץ.

הממשק של StreetViewPanoramaData

ממשק google.maps.StreetViewPanoramaData

ייצוג של פנורמה שמוחזרת מהספק שמוגדר באמצעות registerPanoProvider.

נכסים
tiles	סוג:  StreetViewTileData קביעת המשבצות המותאמות אישית עבור הפנורמות האלה.
copyright optional	סוג:  string optional קביעת הטקסט של זכויות היוצרים עבור פנורמה זו.
imageDate optional	סוג:  string optional מציין את השנה והחודש שבהם התקבלו התמונות הפנורמיות האלה. מחרוזת התאריך היא בפורמט YYYY-MM.
links optional	סוג:  Array<StreetViewLink> optional מציינת את קישורי הניווט לפנורמות סמוכות.
location optional	סוג:  StreetViewLocation optional המדיניות מציינת את המטא-נתונים של המיקום עבור הפנורמה הזו.

הממשק של StreetViewLink

ממשק google.maps.StreetViewLink

אוסף של קובצי עזר לתמונות פנורמה של Street View.

נכסים
description optional	סוג:  string optional מחרוזת מקומית שמתארת את הקישור.
heading optional	סוג:  number optional כותרת הקישור.
pano optional	סוג:  string optional מזהה ייחודי עבור הפנורמה. המזהה הזה יציב לאורך ביקור, אבל אינו יציב בסשנים.