Service

סיווג StreetViewService

google.maps.StreetViewService סיווג

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

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

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

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

התגובה טופלה להבטחה מאת 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 שנמצאת במרחק הקצר ביותר מהמיקום שצוין. התכונה הזו פועלת היטב רק ברדיוס מוגבל. הרדיוס המומלץ הוא 1 ק"מ או פחות.

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

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