Service

הכיתה StreetViewService

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 מועבר ל-callback שסופק.

קבועים של StreetViewStatus

google.maps.StreetViewStatus קבועים

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

אפשר לגשת אליו באמצעות חיוג למספר const {StreetViewStatus} = await google.maps.importLibrary("streetView"). ספריות ב-Maps JavaScript API

קבועים
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

ממשק google.maps.StreetViewPanoRequest

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

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

הממשק StreetViewResponse

ממשק google.maps.StreetViewResponse

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

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

ממשק StreetViewLocation

ממשק google.maps.StreetViewLocation

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

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

קבועים של StreetViewPreference

google.maps.StreetViewPreference קבועים

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

אפשר לגשת אליו באמצעות חיוג למספר const {StreetViewPreference} = await google.maps.importLibrary("streetView"). ספריות ב-Maps JavaScript API

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

קבועים של StreetViewSource

google.maps.StreetViewSource קבועים

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

אפשר לגשת אליו באמצעות חיוג למספר const {StreetViewSource} = await google.maps.importLibrary("streetView"). ספריות ב-Maps JavaScript API

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

ממשק 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 מזהה ייחודי של התמונה הפנורמית. המזהה הזה יציב במהלך סשן, אבל לא יציב בין סשנים.