Service

فئة StreetViewService

google.maps.StreetViewService class

يُجري عنصر StreetViewService عمليات بحث عن بيانات "التجوّل الافتراضي".

يمكنك الوصول إليه من خلال الاتصال بالرقم const {StreetViewService} = await google.maps.importLibrary("streetView"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الشركة المصنِّعة
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 الثوابت

الحالة التي يعرضها StreetViewService عند اكتمال طلب "التجوّل الافتراضي". ويمكن تحديدها حسب القيمة أو باستخدام اسم الثابت. على سبيل المثال، 'OK' أو google.maps.StreetViewStatus.OK.

يمكنك الوصول إليه من خلال الاتصال بالرقم const {StreetViewStatus} = await google.maps.importLibrary("streetView"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الثوابت
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	تم إيقافها نهائيًا: استخدِم sources بدلاً منها. النوع:  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	النوع:  StreetViewPanoramaData تمثيل بانوراما

واجهة 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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الثوابت
BEST	عرض البانوراما في "التجوّل الافتراضي" التي يُرجّح أن تكون هي ما يريد المستخدم رؤيته يتم تحديد أفضل نتيجة من خلال الخوارزميات استنادًا إلى أبحاث المستخدمين والمَعلمات، مثل نقاط الاهتمام التي تم التعرّف عليها وجودة الصورة والمسافة من الموقع الجغرافي المحدّد.
NEAREST	عرض البانوراما في "التجوّل الافتراضي" الأقرب إلى الموقع الجغرافي المقدَّم ولا تعمل هذه الطريقة بشكل جيد إلا ضمن نطاق محدود. يُفضَّل أن يكون شعاع النطاق الجغرافي 1 كيلومتر أو أقل.

StreetViewSource الثوابت

google.maps.StreetViewSource الثوابت

معرّفات لتقتصر عمليات البحث في "التجوّل الافتراضي" على مصادر محدّدة يتم تحديد هذه القيم كسلسلة. مثلاً: 'outdoor'

يمكنك الوصول إليه من خلال الاتصال بالرقم const {StreetViewSource} = await google.maps.importLibrary("streetView"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.

الثوابت
DEFAULT	يتم استخدام المصادر التلقائية لميزة "التجوّل الافتراضي"، ولن تقتصر عمليات البحث على مصادر معيّنة.
GOOGLE	حصر عمليات البحث في "التجوّل الافتراضي" بمجموعات Google الرسمية
OUTDOOR	حصر عمليات البحث في "التجوّل الافتراضي" بمجموعات الصور في الهواء الطلق لا يتم تضمين المجموعات الداخلية في نتائج البحث. يُرجى العلم أيضًا أنّ البحث لا يعرض سوى الصور البانورامية التي يمكن تحديد ما إذا كانت داخلية أو خارجية. على سبيل المثال، لا يتم عرض صور بانورامية 360 درجة لأنّه لا يمكن تحديد ما إذا كانت داخلية أو خارجية.

واجهة StreetViewPanoramaData

google.maps.StreetViewPanoramaData واجهة

تمثيل بانورامي تم إرجاعه من مقدّم الخدمة ويتم تحديده باستخدام registerPanoProvider.

الخصائص
tiles	النوع:  StreetViewTileData تحدّد هذه السمة المربّعات المخصّصة لهذا المشهد البانورامي.
copyright optional	النوع:  string optional لتحديد نص حقوق الطبع والنشر لهذه البانوراما
imageDate optional	النوع:  string optional تُحدِّد السنة والشهر اللذين تمّت فيهما الحصول على الصور في هذه البانوراما. سلسلة التاريخ بالتنسيق YYYY-MM.
links optional	النوع:  Array<StreetViewLink> optional تُحدِّد روابط التنقّل إلى الصور البانورامية المجاورة.
location optional	النوع:  StreetViewLocation optional تُحدِّد البيانات الوصفية للموقع الجغرافي لهذا المشهد البانورامي.

واجهة StreetViewLink

google.maps.StreetViewLink واجهة

مجموعة من الإشارات إلى الصور البانورامية المجاورة في "التجوّل الافتراضي"

الخصائص
description optional	النوع:  string optional سلسلة مترجَمة تصف الرابط
heading optional	النوع:  number optional عنوان الرابط.
pano optional	النوع:  string optional معرّف فريد للصورة البانورامية يكون هذا المعرّف ثابتًا خلال جلسة معيّنة، ولكنّه غير ثابت على مستوى جميع الجلسات.