فئة 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 لتعيين نطاق جغرافي بالأمتار للبحث عن صورة بانورامية. |
|
النوع:
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 |
عرض بانوراما "التجوّل الافتراضي" التي أقصر مسافة من الموقع الجغرافي المقدَّم. وهذه الميزة لا تعمل إلا داخل نطاق جغرافي محدود. النطاق الجغرافي المقترَح هو كيلومتر واحد أو أقل. |
الثبات الثابت في 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. |
links optional |
النوع:
Array<StreetViewLink> optional لتحديد روابط التنقل لصور بانوراما المجاورة. |
location optional |
النوع:
StreetViewLocation optional لتحديد البيانات الوصفية للموقع لهذه البانوراما. |
واجهة StreetViewLink
واجهة
google.maps.StreetViewLink
مجموعة من المراجع لصور بانوراما 360 درجة المجاورة للتجوّل الافتراضي.
أماكن إقامة | |
---|---|
description optional |
النوع:
string optional سلسلة مترجَمة تصف الرابط |
heading optional |
النوع:
number optional عنوان الرابط. |
pano optional |
النوع:
string optional معرّف فريد للبانوراما. رقم التعريف هذا مستقر خلال الجلسة ولكنه غير مستقر في جميع الجلسات. |