Service

کلاس StreetViewService

‫google.maps.StreetViewService کلاس

شیء StreetViewService جستجوها را برای داده‌های «نمای خیابان» انجام می‌دهد.

با تماس با const {StreetViewService} = await google.maps.importLibrary("streetView") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
StreetViewService
StreetViewService()
پارامترها:  هیچ
StreetViewService ایجاد می‌کند که واسطی برای داده‌های ذخیره‌شده در سرویس «نمای خیابان» ارائه می‌دهد.
getPanorama
getPanorama(request[, callback])
پارامترها: 
مقدار برگشتی:  Promise<StreetViewResponse>
StreetViewPanoramaData را برای تمام‌نمایی که با درخواست پُرسمان «نمای خیابان» ارائه‌شده مطابقت دارد بازیابی می‌کند. ‫StreetViewPanoramaData به فراخوان ارائه‌شده ارسال می‌شود.

StreetViewStatus ثابت‌ها

google.maps.StreetViewStatus یادآور همیشگی

وضعیت برگردانده‌شده توسط StreetViewService پس‌از تکمیل درخواست «نمای خیابان». این‌ها را می‌توان با مقدار یا بااستفاده از نام ثابت مشخص کرد. برای مثال، 'OK' یا google.maps.StreetViewStatus.OK.

با تماس با const {StreetViewStatus} = await google.maps.importLibrary("streetView") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
OK درخواست موفقیت‌آمیز بود.
UNKNOWN_ERROR درخواست با موفقیت پردازش نشد، اما دلیل دقیق این مشکل مشخص نیست.
ZERO_RESULTS هیچ سراسرنمایی که با معیارهای جستجو مطابقت داشته باشد پیدا نشد.

میانای StreetViewLocationRequest

میانا google.maps.StreetViewLocationRequest

درخواست «نمای خیابان» برای ارسال با getPanorama. StreetViewLocationRequest به شما امکان می‌دهد سراسرنمای «نمای خیابان» را در مکان مشخصی جستجو کنید.
location optional
نوع:  LatLng|LatLngLiteral optional
مکان جستجوی تمام‌نمای «نمای خیابان» را مشخص می‌کند.
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

نمایش مکان در تمام‌نمای «نمای خیابان».
pano
نوع:  string
شناسه یکتای تمام‌نما. این شناسه در یک جلسه ثابت است اما در جلسات مختلف تغییر می‌کند.
description optional
نوع:  string optional
رشته‌ای بومی‌سازی‌شده که مکان را توصیف می‌کند.
latLng optional
نوع:  LatLng optional
طول و عرض جغرافیایی تمام‌نما.
shortDescription optional
نوع:  string optional
شرح کوتاهی از مکان.

ثابت‌های StreetViewPreference

google.maps.StreetViewPreference یادآور همیشگی

گزینه‌هایی که نتیجه جستجو را به‌سمت برگرداندن تمام‌نمای «نمای خیابان» که نزدیک‌ترین به مکان درخواست است یا تمام‌نمایی که احتمالاً همان چیزی است که کاربر می‌خواهد ببیند، متمایل می‌کند. این‌ها را براساس مقدار یا بااستفاده از نام ثابت مشخص کنید. برای مثال، 'best' یا google.maps.StreetViewPreference.BEST.

با تماس با const {StreetViewPreference} = await google.maps.importLibrary("streetView") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
BEST تمام‌نمای «نمای خیابان» را که احتمالاً همان چیزی است که کاربر می‌خواهد ببیند برمی‌گرداند. بهترین نتیجه را الگوریتم‌ها براساس پژوهش کاربر و پارامترهایی مثل مکان‌های جالب شناخته‌شده، کیفیت تصویر، و فاصله از مکان ارائه‌شده تعیین می‌کنند.
NEAREST تمام‌نمای «نمای خیابان» را که کوتاه‌ترین فاصله را از مکان ارائه‌شده دارد برمی‌گرداند. این ویژگی فقط در شعاع محدودی به‌خوبی کار می‌کند. شعاع توصیه‌شده ۱ کیلومتر یا کمتر است.

ثابت‌های StreetViewSource

google.maps.StreetViewSource یادآور همیشگی

شناسه‌هایی برای محدود کردن جستجوهای «نمای خیابان» به منابع انتخاب‌شده. این مقادیر به‌صورت رشته مشخص می‌شوند. به‌عنوان مثال، 'outdoor'.

با تماس با const {StreetViewSource} = await google.maps.importLibrary("streetView") دسترسی پیدا کنید.
کتابخانه‌ها در Maps JavaScript API را ببینید.
DEFAULT از منابع پیش‌فرض «نمای خیابان» استفاده می‌کند، جستجوها به منابع خاصی محدود نخواهد شد.
GOOGLE جستجوهای «نمای خیابان» را به مجموعه‌های رسمی Google محدود می‌کند.
OUTDOOR جستجوهای «نمای خیابان» را به مجموعه‌های فضای باز محدود می‌کند. مجموعه‌های داخلی در نتایج جستجو گنجانده نمی‌شوند. همچنین توجه داشته باشید که جستجو فقط تمام‌نماهایی را برمی‌گرداند که امکان تعیین داخلی یا خارجی بودن آن‌ها وجود داشته باشد. برای مثال، PhotoSpheres برگردانده نمی‌شود چون مشخص نیست که در فضای بسته است یا فضای باز.

میانای StreetViewPanoramaData

میانا google.maps.StreetViewPanoramaData

نمایش تمام‌نمای برگردانده‌شده از ارائه‌دهنده بااستفاده از registerPanoProvider تعریف شده است.
tiles
کاشی‌های سفارشی را برای این تمام‌نما مشخص می‌کند.
copyright optional
نوع:  string optional
نوشتار حق نشر را برای این تمام‌نما مشخص می‌کند.
imageDate optional
نوع:  string optional
سال و ماهی را که تصاویر این تمام‌نما گرفته شده است مشخص می‌کند. رشته تاریخ به‌صورت YYYY-MM است.
location optional
نوع:  StreetViewLocation optional
فراداده مکان را برای این تمام‌نما مشخص می‌کند.

میانا google.maps.StreetViewLink

مجموعه‌ای از ارجاع‌ها به پانوراماهای مجاور «نمای خیابان».
description optional
نوع:  string optional
رشته‌ای بومی‌سازی‌شده که پیوند را توصیف می‌کند.
heading optional
نوع:  number optional
عنوان پیوند.
pano optional
نوع:  string optional
شناسه یکتای تمام‌نما. این شناسه در یک جلسه ثابت است اما در جلسات مختلف ناپایدار است.