Service

فئة StreetViewService

google.maps.StreetViewService الصف الدراسي

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

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

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

ثوابت StreetViewSource

google.maps.StreetViewSource ثوابت

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

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

واجهة التجوّل الافتراضي البانورامية

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