Service

فئة StreetViewService

google.maps.StreetViewService صف

ينفّذ الكائن StreetViewService عمليات بحث عن بيانات "التجوّل الافتراضي".

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

الشركة المصنِّعة
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").
اطّلِع على المكتبات في Maps JavaScript API.

الثوابت
OK	تم تنفيذ الطلب بنجاح.
UNKNOWN_ERROR	تعذّرت معالجة الطلب بنجاح، ولكن السبب الدقيق لهذا التعذّر غير معروف.
ZERO_RESULTS	لم يتم العثور على صور بانورامية تطابق معايير البحث.

واجهة StreetViewLocationRequest

google.maps.StreetViewLocationRequest interface

طلب "التجوّل الافتراضي" الذي سيتم إرساله باستخدام 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 interface

google.maps.StreetViewPanoRequest interface

يتم استخدام StreetViewPanoRequest مع getPanorama للعثور على صورة بانورامية بمعرّف محدّد.

الخصائص
pano optional	النوع:  string optional تحدّد هذه السمة معرّف الصورة البانورامية المطلوب البحث عنه.

StreetViewResponse interface

google.maps.StreetViewResponse interface

تمت تسوية الردّ لـ Promise من StreetViewService.getPanorama.

الخصائص
data	النوع:  StreetViewPanoramaData تمثيل بانوراما

واجهة StreetViewLocation

google.maps.StreetViewLocation interface

تمثيل لموقع جغرافي في بانوراما "التجوّل الافتراضي"

الخصائص
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	يقتصر البحث في "التجوّل الافتراضي" على المجموعات التي تم التقاطها في الأماكن المفتوحة. لا يتم تضمين المجموعات الداخلية في نتائج البحث. يُرجى العِلم أيضًا أنّ البحث لا يعرض سوى الصور البانورامية التي يمكن تحديد ما إذا كانت في مكان داخلي أو خارجي. على سبيل المثال، لا يتم عرض صور PhotoSphere لأنّه من غير المعروف ما إذا كانت في مكان مغلق أو مفتوح.

واجهة StreetViewPanoramaData

google.maps.StreetViewPanoramaData interface

تمثّل هذه السمة صورة بانورامية تم عرضها من مقدّم الخدمة باستخدام 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 interface

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

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