Service

فئة StreetViewService

صف واحد (google.maps.StreetViewService)

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

يمكنك الوصول من خلال الاتصال على الرقم const {StreetViewService} = await google.maps.importLibrary("streetView"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
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"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
BEST إرجاع الصورة البانورامية "التجوّل الافتراضي" التي يُرجَّح أن تكون ما يريد المستخدم مشاهدته. يتم تحديد أفضل نتيجة بواسطة خوارزميات تستند إلى أبحاث المستخدم ومعاملاته مثل نقاط الاهتمام التي يتم التعرف عليها وجودة الصور والمسافة من موقع معين.
NEAREST إرجاع الصورة البانورامية للتجوُّل الافتراضي التي تكون أقصر مسافة من الموقع المقدم. ولا ينجح هذا الإجراء إلا في نطاق جغرافي محدود. النطاق الجغرافي الموصى به هو 1 كيلومتر أو أقل.

القيم الثابتة في StreetViewSource

google.maps.StreetViewSource ثابت

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

يمكنك الوصول من خلال الاتصال على الرقم const {StreetViewSource} = await google.maps.importLibrary("streetView"). يمكنك الاطّلاع على المكتبات في Maps JavaScript API.
DEFAULT يستخدم المصادر التلقائية لميزة "التجوّل الافتراضي"، ولن تقتصر عمليات البحث على مصادر محدَّدة.
GOOGLE يقتصر عمليات البحث في "التجوّل الافتراضي" على المجموعات الرسمية في Google.
OUTDOOR حصر عمليات البحث في "التجوّل الافتراضي" على المجموعات الخارجية. لا تظهر المجموعات الداخلية في نتائج البحث. لاحظ أيضًا أن البحث لا يعرض سوى الصور البانورامية حيث يمكن تحديد ما إذا كانت هذه الصور داخلية أو في الهواء الطلق. على سبيل المثال، لا يتم إرجاع الصور البانورامية لأنّها غير معروفة ما إذا كانت داخلية أو في الهواء الطلق.

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