Service

فئة StreetViewService

google.maps.StreetViewService class

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

يمكنك الوصول إليه من خلال الاتصال بالرقم const {StreetViewService} = await google.maps.importLibrary("streetView"). اطّلِع على المكتبات في واجهة برمجة تطبيقات JavaScript للخرائط.
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"). اطّلِع على المكتبات في واجهة برمجة تطبيقات 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
النوع:  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
تمثيل بانوراما

واجهة 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.
location optional
النوع:  StreetViewLocation optional
تُحدِّد البيانات الوصفية للموقع الجغرافي لهذا المشهد البانورامي.

google.maps.StreetViewLink واجهة

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