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])
פרמטרים: 
הערך המוחזר:  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
סוג:  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
ייצוג של תמונת פנורמה.

ממשק 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
מציין את המשבצות המותאמות אישית של הפנורמה הזו.
copyright optional
סוג:  string optional
מציין את טקסט זכויות היוצרים של הפנורמה הזו.
imageDate optional
סוג:  string optional
מציין את השנה והחודש שבהם נרכשו התמונות בפנורמה הזו. מחרוזת התאריך היא בצורה YYYY-MM.
location optional
סוג:  StreetViewLocation optional
מציין את המטא-נתונים של המיקום בפנורמה הזו.

ממשק google.maps.StreetViewLink

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