Service

המחלקה StreetViewService

class google.maps.StreetViewService
library "streetView"

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

const {StreetViewService} = await google.maps.importLibrary("streetView");

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

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

ערכי StreetViewStatus קבועים

constants google.maps.StreetViewStatus
ספרייה "streetView"

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

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג StreetViewStatusString.

const {StreetViewStatus} = await google.maps.importLibrary("streetView");

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

ממשק StreetViewLocationRequest

ממשק google.maps.StreetViewLocationRequest

בקשה ל-Street View שתישלח עם getPanorama. ‫StreetViewLocationRequest מאפשר לחפש פנורמה של Street View במיקום מסוים.

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

ממשק StreetViewPanoRequest

ממשק google.maps.StreetViewPanoRequest

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

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

הממשק StreetViewResponse

ממשק google.maps.StreetViewResponse

התגובה נפתרה עבור Promise מ-StreetViewService.getPanorama.

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

ממשק StreetViewLocation

ממשק google.maps.StreetViewLocation

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

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

קבועים של StreetViewPreference

constants google.maps.StreetViewPreference
ספרייה "streetView"

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

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג StreetViewPreferenceString.

const {StreetViewPreference} = await google.maps.importLibrary("streetView");

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

קבועים של StreetViewSource

constants google.maps.StreetViewSource
ספרייה "streetView"

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

אפשר להשתמש בקבועים האלה גם כמחרוזות. ב-TypeScript, המחרוזות המילוליות מוגדרות לפי הסוג StreetViewSourceString.

const {StreetViewSource} = await google.maps.importLibrary("streetView");

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

הממשק StreetViewPanoramaData

ממשק google.maps.StreetViewPanoramaData

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

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

ממשק StreetViewLink

ממשק google.maps.StreetViewLink

אוסף של הפניות לתמונות פנורמיות סמוכות ב-Street View.

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