Service

فئة StreetViewService

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

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

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

StreetViewService
StreetViewService()
المَعلمات: لا شيء
يتم إنشاء StreetViewService، الذي يوفر واجهة للبيانات المخزَّنة في خدمة "التجوّل الافتراضي".
getPanorama
getPanorama(request[, callback])
المَعلمات: 
قيمة الإرجاع:  Promise<StreetViewResponse>
يسترد StreetViewPanoramaData صورة بانوراما تتطابق مع طلب طلب بحث "التجوّل الافتراضي" المزوّد. يتم تمرير StreetViewPanoramaData إلى معاودة الاتصال المقدَّمة.

الثبات حالة التجوّل الافتراضي

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" البحث عن صورة بانوراما 360 درجة عبر "التجوّل الافتراضي" في موقع جغرافي محدد.

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 عرض بانوراما "التجوّل الافتراضي" التي أقصر مسافة من الموقع الجغرافي المقدَّم. وهذه الميزة لا تعمل إلا داخل نطاق جغرافي محدود. النطاق الجغرافي المقترَح هو كيلومتر واحد أو أقل.

الثبات الثابت في StreetViewSource

google.maps.StreetViewSource ثابت

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

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

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

مجموعة من المراجع لصور بانوراما 360 درجة المجاورة للتجوّل الافتراضي.

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