Service

کلاس StreetViewService

کلاس google.maps.StreetViewService
کتابخانه "streetView"

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

const {StreetViewService} = await google.maps.importLibrary("streetView");

سازنده
StreetViewService	StreetViewService() پارامترها: هیچ StreetViewService ایجاد می‌کند که واسطی برای داده‌های ذخیره‌شده در سرویس «نمای خیابان» ارائه می‌دهد.

روش‌ها

getPanorama

getPanorama(request[, callback]) پارامترها: request: StreetViewLocationRequest|StreetViewPanoRequest callback: function(StreetViewPanoramaData optional, StreetViewStatus): void optional مقدار برگشتی: Promise<StreetViewResponse> StreetViewPanoramaData را برای تمام‌نمایی که با درخواست پُرسمان «نمای خیابان» ارائه‌شده مطابقت دارد بازیابی می‌کند. ‫StreetViewPanoramaData به فراخوان ارائه‌شده ارسال می‌شود.

StreetViewStatus ثابت‌ها

ثابت‌ها google.maps.StreetViewStatus کتابخانه
"streetView"

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

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع StreetViewStatusString تعریف می‌شوند.

const {StreetViewStatus} = await google.maps.importLibrary("streetView");

ثابت‌ها
OK	درخواست موفقیت‌آمیز بود.
UNKNOWN_ERROR	درخواست با موفقیت پردازش نشد، اما دلیل دقیق این مشکل مشخص نیست.
ZERO_RESULTS	هیچ سراسرنمایی که با معیارهای جستجو مطابقت داشته باشد پیدا نشد.

میانای StreetViewLocationRequest

میانا google.maps.StreetViewLocationRequest

درخواست «نمای خیابان» برای ارسال با getPanorama. StreetViewLocationRequest به شما امکان می‌دهد سراسرنمای «نمای خیابان» را در مکان مشخصی جستجو کنید.

مشخصات
location اختیاری	نوع: LatLng|LatLngLiteral optional مکان جستجوی تمام‌نمای «نمای خیابان» را مشخص می‌کند.
preference اختیاری	نوع: StreetViewPreference optional اولویت را برای اینکه کدام تمام‌نما باید در شعاع پیدا شود تنظیم می‌کند: نزدیک‌ترین به مکان ارائه‌شده، یا بهترین در شعاع.
radius اختیاری	نوع: number optional پیش‌فرض: 50 شعاعی را برحسب متر تنظیم می‌کند که در آن تمام‌نما جستجو شود.
source اختیاری	منسوخ‌شده: به‌جای آن از sources استفاده کنید. نوع: StreetViewSource optional پیش‌فرض: StreetViewSource.DEFAULT منبع تمام‌نماها را برای جستجو مشخص می‌کند. این کار به شما امکان می‌دهد محدودیت را برای جستجوی فقط تمام‌نماهای فضای باز اعمال کنید.
sources اختیاری	نوع: Iterable<StreetViewSource> optional پیش‌فرض: [StreetViewSource.DEFAULT] منابع سراسرنماها را برای جستجو مشخص می‌کند. این کار به شما امکان می‌دهد محدودیت را برای جستجوی فقط تمام‌نماهای فضای باز اعمال کنید. تنظیم چند منبع به‌عنوان اشتراک آن منابع ارزیابی خواهد شد.

میانای StreetViewPanoRequest

میانا google.maps.StreetViewPanoRequest

از StreetViewPanoRequest به‌همراه getPanorama برای پیدا کردن تمام‌نما با شناسه مشخص‌شده استفاده می‌شود.

مشخصات
pano اختیاری	نوع: string optional شناسه پانورامایی را که باید جستجو شود مشخص می‌کند.

میانای StreetViewResponse

میانا google.maps.StreetViewResponse

پاسخ برای Promise از StreetViewService.getPanorama حل شد.

مشخصات
data	نوع: StreetViewPanoramaData نمایش تمام‌نما.

میانای StreetViewLocation

میانا google.maps.StreetViewLocation

نمایش مکان در تمام‌نمای «نمای خیابان».

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

ثابت‌های StreetViewPreference

ثابت‌ها google.maps.StreetViewPreference کتابخانه
"streetView"

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

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع StreetViewPreferenceString تعریف می‌شوند.

const {StreetViewPreference} = await google.maps.importLibrary("streetView");

ثابت‌ها
BEST	تمام‌نمای «نمای خیابان» را که احتمالاً همان چیزی است که کاربر می‌خواهد ببیند برمی‌گرداند. بهترین نتیجه را الگوریتم‌ها براساس پژوهش کاربر و پارامترهایی مثل مکان‌های جالب شناخته‌شده، کیفیت تصویر، و فاصله از مکان ارائه‌شده تعیین می‌کنند.
NEAREST	تمام‌نمای «نمای خیابان» را که کوتاه‌ترین فاصله را از مکان ارائه‌شده دارد برمی‌گرداند. این ویژگی فقط در شعاع محدودی به‌خوبی کار می‌کند. شعاع توصیه‌شده ۱ کیلومتر یا کمتر است.

ثابت‌های StreetViewSource

ثابت‌ها google.maps.StreetViewSource کتابخانه
"streetView"

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

این ثابت‌ها به‌عنوان رشته نیز قابل‌استفاده هستند. در TypeScript، رشته‌های لفظی با نوع StreetViewSourceString تعریف می‌شوند.

const {StreetViewSource} = await google.maps.importLibrary("streetView");

ثابت‌ها
DEFAULT	از منابع پیش‌فرض «نمای خیابان» استفاده می‌کند، جستجوها به منابع خاصی محدود نخواهد شد.
GOOGLE	جستجوهای «نمای خیابان» را به مجموعه‌های رسمی Google محدود می‌کند.
OUTDOOR	جستجوهای «نمای خیابان» را به مجموعه‌های فضای باز محدود می‌کند. مجموعه‌های داخلی در نتایج جستجو گنجانده نمی‌شوند. همچنین توجه داشته باشید که جستجو فقط تمام‌نماهایی را برمی‌گرداند که امکان تعیین داخلی یا خارجی بودن آن‌ها وجود داشته باشد. برای مثال، PhotoSpheres برگردانده نمی‌شود چون مشخص نیست که در فضای بسته است یا فضای باز.

میانای StreetViewPanoramaData

میانا google.maps.StreetViewPanoramaData

نمایش تمام‌نمای برگردانده‌شده از ارائه‌دهنده بااستفاده از registerPanoProvider تعریف شده است.

مشخصات
tiles	نوع: StreetViewTileData کاشی‌های سفارشی را برای این تمام‌نما مشخص می‌کند.
copyright اختیاری	نوع: string optional نوشتار حق نشر را برای این تمام‌نما مشخص می‌کند.
imageDate اختیاری	نوع: string optional سال و ماهی را که تصاویر این تمام‌نما گرفته شده است مشخص می‌کند. رشته تاریخ به‌صورت YYYY-MM است.
links اختیاری	نوع: Array<StreetViewLink> optional پیوندهای پیمایشی به سراسرنماهای مجاور را مشخص می‌کند.
location اختیاری	نوع: StreetViewLocation optional فراداده مکان را برای این تمام‌نما مشخص می‌کند.

StreetViewLink میانای

میانا google.maps.StreetViewLink

مجموعه‌ای از ارجاع‌ها به پانوراماهای مجاور «نمای خیابان».

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