Service

‫StreetViewService class

google.maps.StreetViewService class

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

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

יצרן
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 מועבר לקריאה החוזרת שצוינה.

StreetViewStatus constants

google.maps.StreetViewStatus constants

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

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

Constants
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	הוצא משימוש: במקומו צריך להשתמש ב-sources. סוג:  StreetViewSource optional ברירת מחדל: StreetViewSource.DEFAULT מציינת את המקור של תמונות פנורמה לחיפוש. לדוגמה, אפשר להגביל את החיפוש רק לפנורמות של מקומות בחוץ.
sources optional	סוג:  Iterable<StreetViewSource> optional ברירת מחדל: [StreetViewSource.DEFAULT] מציינת את המקורות של תמונות פנורמה לחיפוש. לדוגמה, אפשר להגביל את החיפוש רק לפנורמות של מקומות בחוץ. אם מגדירים כמה מקורות, המערכת תבדוק את החיתוך של המקורות האלה.

‫StreetViewPanoRequest interface

google.maps.StreetViewPanoRequest ממשק

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

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

‫StreetViewResponse interface

google.maps.StreetViewResponse ממשק

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

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

‫StreetViewLocation interface

google.maps.StreetViewLocation ממשק

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

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

StreetViewPreference constants

google.maps.StreetViewPreference constants

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

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

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

StreetViewSource constants

google.maps.StreetViewSource constants

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

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

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

ממשק 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 interface

google.maps.StreetViewLink ממשק

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

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