Service

فئة StreetViewService

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

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {StreetViewService} = await google.map.importLibrary("streetView"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

الشركة المصنِّعة
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.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {StreetViewStatus} = await google.map.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 تلقائي: 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.

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {StreetViewPreference} = await google.map.importLibrary("streetView"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

الثوابت
BEST	اعرض بانوراما التجوّل ثلاثي الأبعاد التي يُحتمل أن تكون هي ما يريد المستخدم رؤيتها. يتم تحديد أفضل نتيجة من خلال خوارزميات تستند إلى أبحاث المستخدمين والمعلمات مثل نقاط الاهتمام المميزة، وجودة الصورة، والمسافة من الموقع المحدد.
NEAREST	اعرض بانوراما صورة الشارع التي تُعد أقصر مسافة من الموقع المقدم. لا تعمل هذه الطريقة إلا في نطاق جغرافي محدود. نصف القطر الموصى به هو 1 كم أو أقل.

ثوابت StreetViewSource

google.maps.StreetViewSource ثوابت

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

عند استخدام v=beta، يمكن الوصول إليه من خلال الاتصال بـ const {StreetViewSource} = await google.map.importLibrary("streetView"). راجع المكتبات في واجهة برمجة تطبيقات جافا سكريبت للخرائط.

الثوابت
DEFAULT	يستخدم المصادر الافتراضية لميزة التجوّل الافتراضي، ولن تقتصر عمليات البحث على مصادر معينة.
OUTDOOR	يقصر عمليات البحث في التجوّل الافتراضي على المجموعات الخارجية. لا يتم تضمين المجموعات الداخلية في نتائج البحث. لاحظ أيضًا أن البحث لا يعرض إلا الصور البانورامية حيث يمكن تحديد ما إذا كانت في أماكن داخلية أو خارجية. على سبيل المثال، لا يتم عرض PhotoSpheres لأنه غير معروف سواء كانت في الداخل أو في الهواء الطلق.

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

واجهة 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

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

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