Service

הכיתה StreetViewService

google.maps.StreetViewService class

אובייקט 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 מועבר ל-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
סוג:  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
הייצוג של הפנורמה.

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