Service

فئة StreetViewService

class google.maps.StreetViewService
library "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 interface

واجهة 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 معرّف فريد للصورة البانورامية يكون هذا المعرّف ثابتًا خلال الجلسة الواحدة، ولكنه غير ثابت في الجلسات المختلفة.