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

الفئة العامة StreetViewPanorama توسّع الكائن

هذه هي الفئة الرئيسية لميزة "التجوّل الافتراضي" في حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" على أجهزة Android، وهي نقطة الدخول لجميع الطرق ذات الصلة بالصور البانورامية لميزة "التجوّل الافتراضي". لا يمكنك إنشاء مثيل لكائن StreetViewPanorama مباشرةً، بل عليك الحصول على واحد من طريقة #getStreetViewPanoramaAsync() في StreetViewPanoramaFragment أو StreetViewPanoramaView أضفتها إلى تطبيقك.

ملاحظة: كما هو الحال مع كائن View، لا يمكن قراءة StreetViewPanorama وتعديله إلا من سلسلة التعليمات الرئيسية. وسيؤدي طلب طُرق StreetViewPanorama من سلسلة محادثات أخرى إلى تطبيق استثناء.

دليل المطوِّر

لبدء استخدام حزمة تطوير البرامج (SDK) لتطبيق "خرائط Google" لنظام التشغيل Android، عليك قراءة دليل المطوِّر SDK لخرائط Google لنظام التشغيل Android .

ملخص الفئة المدمَجة

واحدة	StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener		أداة معالجة عند تغيير كاميرا StreetViewPanoramacamera
واحدة	StreetViewPanorama.OnStreetViewPanoramaChangeListener		مستمع عند تحميل بانوراما جديدة في "التجوّل الافتراضي"
واحدة	StreetViewPanorama.OnStreetViewPanoramaClickListener		واجهة معاودة الاتصال عندما ينقر المستخدم على الصورة البانورامية
واحدة	StreetViewPanorama.OnStreetViewPanoramaLongClickListener		واجهة معاودة الاتصال عندما يضغط المستخدم مع الاستمرار على الصورة البانورامية

ملخّص الطريقة العلنية

void	animateTo(كاميرا StreetViewPanoramaCamera، لمدة طويلة) يغيّر موضع الكاميرا والاتجاه والتكبير/التصغير الحالي إلى موضع معين خلال مدة محددة
StreetViewPanoramaLocation	getLocation() لعرض الموقع الحالي للمستخدم ومعلومات بخصوص الصور البانورامية المجاورة للبانوراما الحالية
StreetViewPanoramaCamera	getPanoramaCamera() لعرض الاتجاه والتكبير/التصغير الحالي
boolean	isPanningGesturesEnabled() عرض ما إذا كانت إيماءات العرض الشامل مفعّلة للمستخدم أم لا
boolean	isStreetNamesEnabled() لعرض ما إذا كانت أسماء الشوارع تظهر في البانوراما أم لا
boolean	isUserNavigationEnabled() يعرض ما إذا كان التنقل مفعَّلاً للمستخدم أم لا.
boolean	isZoomGesturesEnabled() عرض ما إذا كانت إيماءات التكبير/التصغير مفعّلة للمستخدم أم لا
نقطة	orientationToPoint(اتجاه StreetViewPanoramaOrientation) لعرض موقع الشاشة الذي يتوافق مع الاتجاه (StreetViewPanoramaOrientation).
StreetViewPanoramaOrientation	pointToOrientation(نقطة واحدة) تعرض الاتجاه الذي يتوافق مع موقع الشاشة.
الفراغ الأخير	setOnStreetViewPanoramaCameraChangeListener(StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener) يتم ضبط هذا الخيار ليتم استدعاءه عند تغيير الكاميرا.
الفراغ الأخير	setOnStreetViewPanoramaChangeListener(StreetViewPanorama.OnStreetViewPanoramaChangeListener مستمع) لضبط معاودة الاتصال التي يتم استدعاؤها عند تغيير البانوراما
الفراغ الأخير	setOnStreetViewPanoramaClickListener(StreetViewPanorama.OnStreetViewPanoramaClickListener) لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على البانوراما.
الفراغ الأخير	setOnStreetViewPanoramaLongClickListener(StreetViewPanorama.OnStreetViewPanoramaLongClickListener) لضبط معاودة الاتصال التي يتم استدعاءها عند الضغط مع الاستمرار على الصورة البانورامية.
void	setPanningGesturesEnabled(منطقيةenablePanning) لتعيين ما إذا كان المستخدم قادرًا على استخدام إيماءات العرض الشامل أم لا
void	setPosition(سلسلة panoId) تعيين بانوراما التجوّل الافتراضي على موقع معين
void	setPosition(موضع LatLng) تعيين بانوراما التجوّل الافتراضي على موقع معين
void	setPosition(موضع LatLng، مصدر StreetViewSource) تعيين بانوراما التجوّل الافتراضي على موقع معين
void	setPosition(موضع LatLng، int radius، مصدر StreetViewSource) تعيين بانوراما التجوّل الافتراضي على موقع معين
void	setPosition(موضع LatLng، نصف القطر الداخلي) تعيين بانوراما التجوّل الافتراضي على موقع معين
void	setStreetNamesEnabled(منطقي cannot translate) لتعيين ما إذا كان يمكن للمستخدم رؤية أسماء الشوارع في الصور البانورامية
void	setUserNavigationEnabled(منطقي إجراءات تفعيل User Navigation) لتعيين ما إذا كان المستخدم قادرًا على الانتقال إلى بانوراما أخرى
void	setZoomGesturesEnabled(منطقية تفعيل Zoom) تحدِّد هذه السياسة ما إذا كان المستخدم قادرًا على استخدام إيماءات التكبير/التصغير.

ملخّص الطريقة المكتسبة

من الفئة java.lang.Object

boolean	equals(كائن arg0)
الفئة النهائية<?>	getClass()
int	hashCode()
الفراغ الأخير	notify()
الفراغ الأخير	notifyAll()
سلسلة	toString()
الفراغ الأخير	انتظار(long arg0, int arg1)
الفراغ الأخير	انتظار(طول طويل arg0)
الفراغ الأخير	نحن()

الطرق العامة

إبطال علني animateTo (كاميرا StreetViewPanoramaCamera، مدة طويلة)

يغيّر موضع الكاميرا والاتجاه والتكبير/التصغير الحالي إلى موضع معين خلال مدة محددة

المَعلمات

كاميرا	موضع الكاميرا للتحريك إلى
المدة	المدة الزمنية بالملي ثانية التي يستغرقها الانتقال من موضع الكاميرا الحالي إلى الموضع المحدّد

متاح للجميع StreetViewPanoramaLocation getLocation ()

لعرض الموقع الحالي للمستخدم ومعلومات بخصوص الصور البانورامية المجاورة للبانوراما الحالية

المرتجعات

• الموقع الجغرافي الحالي للمستخدم

عامة StreetViewPanoramaCamera getPanoramaCamera ()

لعرض الاتجاه والتكبير/التصغير الحالي

المرتجعات

• الكاميرا الحالية

عام منطقي isPanningGesturesEnabled ()

عرض ما إذا كانت إيماءات العرض الشامل مفعّلة للمستخدم أم لا

المرتجعات

• true في حال تفعيل إيماءات العرض الشامل

public منطقي isStreetNamesEnabled ()

لعرض ما إذا كانت أسماء الشوارع تظهر في البانوراما أم لا

المرتجعات

• true إذا تم عرض أسماء الشوارع

عامة منطقية isUserNavigationEnabled ()

يعرض ما إذا كان التنقل مفعَّلاً للمستخدم أم لا. ويشمل ذلك النقر مرّتين بالإضافة إلى استخدام روابط التنقّل.

المرتجعات

• true إذا كان التنقّل مفعَّلاً

عامة منطقية isZoomGesturesEnabled ()

عرض ما إذا كانت إيماءات التكبير/التصغير مفعّلة للمستخدم أم لا

المرتجعات

• true إذا تم تفعيل إيماءات التكبير/التصغير

عامة نقطة orientationToPoint (اتجاه StreetViewPanoramaOrientation)

لعرض موقع شاشة يتوافق مع الاتجاه (StreetViewPanoramaOrientation). يكون موقع الشاشة بوحدات بكسل الشاشة (وليس وحدات بكسل العرض) بالنسبة إلى الجزء العلوي الأيمن من بانوراما التجوّل الافتراضي (وليس للشاشة بأكملها).

المَعلمات

الاتجاه	StreetViewPanoramaOrientation في بانوراما "التجوّل الافتراضي" لتحويلها إلى موقع جغرافي للشاشة.

المرتجعات

• تمثّل هذه السمة Point موقع الشاشة بوحدات بكسل الشاشة. عرض null إذا تعذّر عرض الاتجاه على الشاشة (مثلاً، خلف مجال الرؤية للمستخدم)

عامة StreetViewPanoramaOrientation pointToOrientation (نقطة نقطة)

تعرض الاتجاه الذي يتوافق مع موقع الشاشة. يتم تحديد موقع الشاشة ببكسل الشاشة (وليس وحدات بكسل العرض) بالنسبة إلى الجزء العلوي الأيمن من بانوراما "التجوّل الافتراضي" (وليس في الجزء العلوي الأيمن من الشاشة بأكملها).

المَعلمات

نقطة واحدة	Point على الشاشة بوحدات بكسل الشاشة.

المرتجعات

• تمثّل هذه السمة StreetViewPanoramaOrientation المقابلة لـ point على الشاشة، أو null إذا لم يتم إعداد بانوراما "التجوّل الافتراضي" أو إذا كانت النقطة المحددة ليست نقطة صالحة على الشاشة.

علني أخير لا setOnStreetViewPanoramaCameraChangeListener (StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener)

يتم ضبط هذا الخيار ليتم استدعاءه عند تغيير الكاميرا.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي تم استدعاءه عند تغيير الكاميرا. لإلغاء ضبط معاودة الاتصال، استخدِم null.

أخير علني باطء setOnStreetViewPanoramaChangeListener (StreetViewPanorama.OnStreetViewPanoramaChangeListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاؤها عند تغيير البانوراما

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي تم استدعاؤه عند تغيير البانوراما. لإلغاء ضبط معاودة الاتصال، استخدِم null.

حدث أخير علني setOnStreetViewPanoramaClickListener (مستمع لـStreetViewPanorama.OnStreetViewPanoramaClickListener)

لضبط معاودة الاتصال التي يتم استدعاؤها عند النقر على البانوراما.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال الذي تم استدعاؤه عند النقر على البانوراما. لإلغاء ضبط معاودة الاتصال، استخدِم null.

حدث أخير علني setOnStreetViewPanoramaLongClickListener (StreetViewPanorama.OnStreetViewPanoramaLongClickListener مستمع)

لضبط معاودة الاتصال التي يتم استدعاءها عند الضغط مع الاستمرار على الصورة البانورامية.

المَعلمات

أداة معالجة الحدث	معاودة الاتصال التي يتم استدعاؤها عند الضغط مع الاستمرار على الصورة البانورامية. لإلغاء ضبط عملية معاودة الاتصال، استخدِم null.

إبطال عام setPanningGesturesEnabled (boolean enablePanning)

لتعيين ما إذا كان المستخدم قادرًا على استخدام إيماءات العرض الشامل أم لا

المَعلمات

enablePanning	true إذا كان مسموحًا للمستخدمين باستخدام إيماءات العرض الشامل

public void setPosition (String panoId)

تعيين بانوراما التجوّل الافتراضي على موقع معين

المَعلمات

panoId	رقم تعريف بانوراما للموقع الجغرافي المطلوب

إلغاء عام setPosition (LatLng)

تعيين بانوراما التجوّل الافتراضي على موقع معين

المَعلمات

الموضع	خط العرض وخط الطول للموقع المطلوب

إلغاء عام setPosition (LatLng، StreetViewSource)

تعيين بانوراما التجوّل الافتراضي على موقع معين

المَعلمات

الموضع	خط العرض وخط الطول للموقع المطلوب
source	يحدد مصدر StreetViewSource مصدر الصور البانورامية للبحث

إلغاء عام setPosition (LatLng وint radius وStreetViewSource)

تعيين بانوراما التجوّل الافتراضي على موقع معين

المَعلمات

الموضع	خط العرض وخط الطول للموقع المطلوب
نطاق جغرافي	نصف القطر الذي يتم تحديده بالمتر، ويحدّد المنطقة المطلوب البحث فيها عن بانوراما، في مركز على خط العرض وخط الطول المحدَّدين
source	يحدد مصدر StreetViewSource مصدر الصور البانورامية للبحث

إلغاء عام setPosition (LatLng position, int radius)

تعيين بانوراما التجوّل الافتراضي على موقع معين

المَعلمات

الموضع	خط العرض وخط الطول للموقع المطلوب
نطاق جغرافي	نصف القطر الذي يتم تحديده بالمتر، ويحدّد المنطقة المطلوب البحث فيها عن بانوراما، في مركز على خط العرض وخط الطول المحدَّدين

إلغاء عام setStreetNamesEnabled (boolean enableStreetNames)

لتعيين ما إذا كان يمكن للمستخدم رؤية أسماء الشوارع في الصور البانورامية

المَعلمات

enableStreetNames	true إذا كان بإمكان المستخدمين رؤية أسماء الشوارع في الصور البانورامية

خطأ عام setUserNavigationEnabled (boolean enableUserNavigation)

لتعيين ما إذا كان المستخدم قادرًا على الانتقال إلى بانوراما أخرى

المَعلمات

enableUserNavigation	true إذا تم السماح للمستخدمين بالانتقال إلى بانوراما أخرى

إلغاء علني setZoomGesturesEnabled (boolean enableZoom)

تحدِّد هذه السياسة ما إذا كان المستخدم قادرًا على استخدام إيماءات التكبير/التصغير.

المَعلمات

enableZoom	true إذا كان يُسمح للمستخدمين باستخدام إيماءات التكبير/التصغير