التجوّل الافتراضي

اختيار النظام الأساسي: Android‏ iOS‏ JavaScript‏

توفّر ميزة "التجوّل الافتراضي من Google" صورًا بانورامية بزاوية 360 درجة من طرق محدّدة في جميع أنحاء منطقة التغطية.

ميزة مدفوعة: على الرغم من أنّ الطلبات المرسَلة إلى حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android لا يتم تحصيل رسوم مقابلها، سيتم تحصيل رسوم مقابل الطلبات المرسَلة إلى ميزة "التجوّل الافتراضي الديناميكي". لمزيد من التفاصيل، يُرجى الاطّلاع على الفوترة في "منصة خرائط Google".

يوضّح هذا الفيديو كيفية استخدام خدمة "التجوّل الافتراضي" لمنح المستخدمين تجربة واقعية لعنوان على الخريطة، ما يوفّر لهم سياقًا مفيدًا حول وجهتهم أو أي مكان يهتمون به.

التغطية المتاحة من خلال الإصدار الثاني من Google Maps Android API هي نفسها المتاحة لتطبيق "خرائط Google" على جهاز Android. يمكنك الاطّلاع على مزيد من المعلومات عن ميزة "التجوّل الافتراضي" والتعرّف على المناطق التي تتوفّر فيها هذه الميزة على خريطة تفاعلية من خلال الانتقال إلى لمحة عن ميزة "التجوّل الافتراضي".

يمثّل الصف StreetViewPanorama نموذجًا للبانوراما في "التجوّل الافتراضي" في تطبيقك. في واجهة المستخدم، يتم تمثيل الصورة البانورامية باستخدام الكائن StreetViewPanoramaFragment أو StreetViewPanoramaView.

عيّنات تعليمات برمجية

يتضمّن مستودع ApiDemos على GitHub نماذج توضّح كيفية استخدام ميزة "التجوّل الافتراضي".

نماذج Kotlin:

• StreetViewPanoramaBasicDemoActivity: أساسيات استخدام ميزة "التجوّل الافتراضي"
• StreetViewPanoramaEventsDemoActivity: الاستماع إلى الأحداث
• ‫StreetViewPanoramaNavigationDemoActivity: التحكّم في صور بانوراما في "التجوّل الافتراضي" آليًا
• ‫StreetViewPanoramaOptionsDemoActivity: تغيير خيارات واجهة المستخدم والإيماءات
• StreetViewPanoramaViewDemoActivity: استخدام StreetViewPanoramaView (بدلاً من Fragment)
• ‫SplitStreetViewPanoramaAndMapDemoActivity: استخدام نشاط يعرض صورة بانورامية للتجوّل الافتراضي وخريطة

عيّنات Java:

• StreetViewPanoramaBasicDemoActivity: أساسيات استخدام ميزة "التجوّل الافتراضي"
• StreetViewPanoramaEventsDemoActivity: الاستماع إلى الأحداث
• ‫StreetViewPanoramaNavigationDemoActivity: التحكّم في صور بانوراما في "التجوّل الافتراضي" آليًا
• ‫StreetViewPanoramaOptionsDemoActivity: تغيير خيارات واجهة المستخدم والإيماءات
• StreetViewPanoramaViewDemoActivity: استخدام StreetViewPanoramaView (بدلاً من Fragment)
• ‫SplitStreetViewPanoramaAndMapDemoActivity: إنشاء نشاط يعرض صورة بانورامية للتجوّل الافتراضي وخريطة

نظرة عامة على ميزة "التجوّل الافتراضي" في حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android

توفّر حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android خدمة "التجوّل الافتراضي" للحصول على الصور المستخدَمة في ميزة "التجوّل الافتراضي" من Google ومعالجتها. يتم عرض الصور كصور بانورامية.

كل بانوراما في "التجوّل الافتراضي" هي صورة أو مجموعة من الصور توفّر عرضًا كاملاً بزاوية 360 درجة من موقع جغرافي واحد. تتوافق الصور مع الإسقاط متساوي المستطيلات (Plate Carrée)، والذي يحتوي على 360 درجة من العرض الأفقي (التفاف كامل) و180 درجة من العرض الرأسي (من الأعلى إلى الأسفل مباشرة). تحدّد الصورة البانورامية الناتجة بزاوية 360 درجة إسقاطًا على كرة مع التفاف الصورة على السطح ثنائي الأبعاد لتلك الكرة.

StreetViewPanorama يوفّر عارضًا يعرض الصورة البانورامية على شكل كرة مع كاميرا في وسطها. يمكنك استخدام StreetViewPanoramaCamera للتحكّم في التكبير/التصغير واتجاه الكاميرا (الإمالة والاتجاه).

البدء

إعداد مشروع

اتّبِع دليل البدء لإعداد مشروع في "حزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android".

التحقّق من توفّر بانوراما في "التجوّل الافتراضي" قبل إضافة بانوراما

تتضمّن مكتبة برامج حزمة تطوير البرامج (SDK) لخدمات Google Play بعض نماذج "التجوّل الافتراضي" التي يمكنك استيرادها إلى مشروعك واستخدامها كأساس للتطوير. يُرجى الاطّلاع على المقدمة للحصول على إرشادات حول استيراد النماذج.

مكتبة برامج الخدمات الخاصة بحزمة تطوير البرامج بالاستناد إلى بيانات خرائط Google للتطبيقات المتوافقة مع Android هي مكتبة مفتوحة المصدر من الفئات المفيدة لمجموعة من التطبيقات. يتضمّن مستودع GitHub أداة البيانات الوصفية في "التجوّل الافتراضي". تتحقّق هذه الأداة المساعدة مما إذا كان الموقع الجغرافي متوافقًا مع ميزة "التجوّل الافتراضي". يمكنك تجنُّب الأخطاء عند إضافة بانوراما في "التجوّل الافتراضي" إلى تطبيق Android من خلال استدعاء أداة البيانات الوصفية هذه وإضافة بانوراما في "التجوّل الافتراضي" فقط إذا كانت الاستجابة هي OK.

استخدام واجهة برمجة التطبيقات

اتّبِع التعليمات أدناه لإضافة بانوراما في "التجوّل الافتراضي" إلى جزء من Android. هذه هي أبسط طريقة لإضافة "التجوّل الافتراضي" إلى تطبيقك. ثم اقرأ المزيد عن المقاطع والمشاهد وتخصيص البانوراما.

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

اتّبِع الخطوات التالية لإضافة بانوراما في "التجوّل الافتراضي" مثل هذه:

باختصار:

1. أضِف عنصر Fragment إلى Activity الذي سيتعامل مع بانوراما في "التجوّل الافتراضي". أسهل طريقة لإجراء ذلك هي إضافة عنصر <fragment> إلى ملف التنسيق لـ Activity.
2. نفِّذ واجهة OnStreetViewPanoramaReadyCallback واستخدِم طريقة ردّ الاتصال onStreetViewPanoramaReady(StreetViewPanorama) للحصول على مؤشر إلى عنصر StreetViewPanorama.
3. استدعِ getStreetViewPanoramaAsync() في الجزء لتسجيل دالة الاستدعاء.

في ما يلي مزيد من التفاصيل حول كل خطوة.

إضافة جزء

أضِف عنصر <fragment> إلى ملف تنسيق النشاط لتحديد كائن Fragment. في هذا العنصر، اضبط السمة class على com.google.android.gms.maps.StreetViewPanoramaFragment (أو SupportStreetViewPanoramaFragment).

في ما يلي مثال على جزء في ملف تنسيق:

<fragment
    android:name="com.google.android.gms.maps.StreetViewPanoramaFragment"
    android:id="@+id/streetviewpanorama"
    android:layout_width="match_parent"
    android:layout_height="match_parent"/>

إضافة رمز "التجوّل الافتراضي"

للعمل مع بانوراما في "التجوّل الافتراضي" داخل تطبيقك، عليك تنفيذ واجهة OnStreetViewPanoramaReadyCallback وضبط مثيل لعملية الاستدعاء على كائن StreetViewPanoramaFragment أو StreetViewPanoramaView. يستخدم هذا البرنامج التعليمي StreetViewPanoramaFragment، لأنّها أبسط طريقة لإضافة "التجوّل الافتراضي" إلى تطبيقك. الخطوة الأولى هي تنفيذ واجهة رد الاتصال:

Kotlin

class StreetViewActivity :
    AppCompatActivity(),
    OnStreetViewPanoramaReadyCallback {
    // ...
    }

    private fun newView() {
        val sanFrancisco = LatLng(37.754130, -122.447129)
        val view = StreetViewPanoramaView(
            this,
            StreetViewPanoramaOptions().position(sanFrancisco),
        )
    }

    private fun setLocationOfThePanorama(streetViewPanorama: StreetViewPanorama) {
        val sanFrancisco = LatLng(37.754130, -122.447129)

        // Set position with LatLng only.
        streetViewPanorama.setPosition(sanFrancisco)

        // Set position with LatLng and radius.
        streetViewPanorama.setPosition(sanFrancisco, 20)

        // Set position with LatLng and source.
        streetViewPanorama.setPosition(sanFrancisco, StreetViewSource.OUTDOOR)

        // Set position with LaLng, radius and source.
        streetViewPanorama.setPosition(sanFrancisco, 20, StreetViewSource.OUTDOOR)

        streetViewPanorama.location.links.firstOrNull()?.let { link: StreetViewPanoramaLink ->
            streetViewPanorama.setPosition(link.panoId)
        }
    }

    private fun zoom(streetViewPanorama: StreetViewPanorama) {
        val zoomBy = 0.5f
        val camera = StreetViewPanoramaCamera.Builder()
            .zoom(streetViewPanorama.panoramaCamera.zoom + zoomBy)
            .tilt(streetViewPanorama.panoramaCamera.tilt)
            .bearing(streetViewPanorama.panoramaCamera.bearing)
            .build()
    }

    private fun pan(streetViewPanorama: StreetViewPanorama) {
        val panBy = 30f
        val camera = StreetViewPanoramaCamera.Builder()
            .zoom(streetViewPanorama.panoramaCamera.zoom)
            .tilt(streetViewPanorama.panoramaCamera.tilt)
            .bearing(streetViewPanorama.panoramaCamera.bearing - panBy)
            .build()
    }

    private fun tilt(streetViewPanorama: StreetViewPanorama) {
        var tilt = streetViewPanorama.panoramaCamera.tilt + 30
        tilt = if (tilt > 90) 90f else tilt
        val previous = streetViewPanorama.panoramaCamera
        val camera = StreetViewPanoramaCamera.Builder(previous)
            .tilt(tilt)
            .build()
    }

    private fun animate(streetViewPanorama: StreetViewPanorama) {
        // Keeping the zoom and tilt. Animate bearing by 60 degrees in 1000 milliseconds.
        val duration: Long = 1000
        val camera = StreetViewPanoramaCamera.Builder()
            .zoom(streetViewPanorama.panoramaCamera.zoom)
            .tilt(streetViewPanorama.panoramaCamera.tilt)
            .bearing(streetViewPanorama.panoramaCamera.bearing - 60)
            .build()
        streetViewPanorama.animateTo(camera, duration)
    }
}

      

جافا

public class StreetViewActivity extends AppCompatActivity
        implements OnStreetViewPanoramaReadyCallback {
    // ...
    }


    private void newView() {
        LatLng sanFrancisco = new LatLng(37.754130, -122.447129);
        StreetViewPanoramaView view =
                new StreetViewPanoramaView(
                        this, new StreetViewPanoramaOptions().position(sanFrancisco));
    }

    private void setLocationOfThePanorama(StreetViewPanorama streetViewPanorama) {
        LatLng sanFrancisco = new LatLng(37.754130, -122.447129);

        // Set position with LatLng only.
        streetViewPanorama.setPosition(sanFrancisco);

        // Set position with LatLng and radius.
        streetViewPanorama.setPosition(sanFrancisco, 20);

        // Set position with LatLng and source.
        streetViewPanorama.setPosition(sanFrancisco, StreetViewSource.OUTDOOR);

        // Set position with LaLng, radius and source.
        streetViewPanorama.setPosition(sanFrancisco, 20, StreetViewSource.OUTDOOR);

        StreetViewPanoramaLocation location = streetViewPanorama.getLocation();
        if (location != null && location.links != null) {
            streetViewPanorama.setPosition(location.links[0].panoId);
        }
    }

    private void zoom(StreetViewPanorama streetViewPanorama) {
        float zoomBy = 0.5f;
        StreetViewPanoramaCamera camera =
                new StreetViewPanoramaCamera.Builder()
                        .zoom(streetViewPanorama.getPanoramaCamera().zoom + zoomBy)
                        .tilt(streetViewPanorama.getPanoramaCamera().tilt)
                        .bearing(streetViewPanorama.getPanoramaCamera().bearing)
                        .build();
    }

    private void pan(StreetViewPanorama streetViewPanorama) {
        float panBy = 30;
        StreetViewPanoramaCamera camera =
                new StreetViewPanoramaCamera.Builder()
                        .zoom(streetViewPanorama.getPanoramaCamera().zoom)
                        .tilt(streetViewPanorama.getPanoramaCamera().tilt)
                        .bearing(streetViewPanorama.getPanoramaCamera().bearing - panBy)
                        .build();
    }

    private void tilt(StreetViewPanorama streetViewPanorama) {
        float tilt = streetViewPanorama.getPanoramaCamera().tilt + 30;
        tilt = (tilt > 90) ? 90 : tilt;

        StreetViewPanoramaCamera previous = streetViewPanorama.getPanoramaCamera();

        StreetViewPanoramaCamera camera =
                new StreetViewPanoramaCamera.Builder(previous).tilt(tilt).build();
    }

    private void animate(StreetViewPanorama streetViewPanorama) {
        // Keeping the zoom and tilt. Animate bearing by 60 degrees in 1000 milliseconds.
        long duration = 1000;
        StreetViewPanoramaCamera camera =
                new StreetViewPanoramaCamera.Builder()
                        .zoom(streetViewPanorama.getPanoramaCamera().zoom)
                        .tilt(streetViewPanorama.getPanoramaCamera().tilt)
                        .bearing(streetViewPanorama.getPanoramaCamera().bearing - 60)
                        .build();
        streetViewPanorama.animateTo(camera, duration);
    }
}

      

في طريقة onCreate() في Activity، اضبط ملف التنسيق كعرض المحتوى. على سبيل المثال، إذا كان ملف التنسيق يحمل الاسم main.xml، استخدِم هذا الرمز:

Kotlin

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_street_view)
    val streetViewPanoramaFragment =
        supportFragmentManager
            .findFragmentById(R.id.street_view_panorama) as SupportStreetViewPanoramaFragment
    streetViewPanoramaFragment.getStreetViewPanoramaAsync(this)
}

      

جافا

@Override
protected void onCreate(@Nullable Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_street_view);
    SupportStreetViewPanoramaFragment streetViewPanoramaFragment =
            (SupportStreetViewPanoramaFragment)
                    getSupportFragmentManager().findFragmentById(R.id.street_view_panorama);
    streetViewPanoramaFragment.getStreetViewPanoramaAsync(this);
}


      

احصل على اسم معرِّف للجزء من خلال استدعاء FragmentManager.findFragmentById()، وتمرير معرّف المورد لعنصر <fragment> إليه. لاحظ أن معرّف المورد R.id.streetviewpanorama يُضاف تلقائيًا إلى مشروع Android عند إنشاء ملف التخطيط.

بعد ذلك، استخدِم getStreetViewPanoramaAsync() لضبط معاودة الاتصال على الجزء.

Kotlin

val streetViewPanoramaFragment =
    supportFragmentManager
        .findFragmentById(R.id.street_view_panorama) as SupportStreetViewPanoramaFragment
streetViewPanoramaFragment.getStreetViewPanoramaAsync(this)

      

جافا

SupportStreetViewPanoramaFragment streetViewPanoramaFragment =
        (SupportStreetViewPanoramaFragment)
                getSupportFragmentManager().findFragmentById(R.id.street_view_panorama);
streetViewPanoramaFragment.getStreetViewPanoramaAsync(this);

      

ملاحظة: يجب استدعاء getStreetViewPanoramaAsync() من سلسلة التعليمات الرئيسية، وسيتم تنفيذ دالة الاستدعاء في سلسلة التعليمات الرئيسية. إذا لم تكن "خدمات Google Play" مثبّتة على جهاز المستخدم، لن يتم تفعيل دالة الاستدعاء إلى أن يثبّت المستخدم "خدمات Google Play".

استخدِم طريقة رد الاتصال onStreetViewPanoramaReady(StreetViewPanorama) لاسترداد مثيل غير فارغ من StreetViewPanorama جاهز للاستخدام.

Kotlin

override fun onStreetViewPanoramaReady(streetViewPanorama: StreetViewPanorama) {
    val sanFrancisco = LatLng(37.754130, -122.447129)
    streetViewPanorama.setPosition(sanFrancisco)
}

      

جافا

@Override
public void onStreetViewPanoramaReady(StreetViewPanorama streetViewPanorama) {
    LatLng sanFrancisco = new LatLng(37.754130, -122.447129);
    streetViewPanorama.setPosition(sanFrancisco);
}


      

مزيد من المعلومات حول ضبط الحالة الأولية

على عكس الخريطة، لا يمكن ضبط الحالة الأولية لصورة بانوراما في "التجوّل الافتراضي" من خلال ملف XML. ومع ذلك، يمكنك ضبط البانوراما آليًا من خلال تمرير كائن StreetViewPanoramaOptions يحتوي على الخيارات المحدّدة.

• إذا كنت تستخدم StreetViewPanoramaFragment، استخدِم طريقة المصنع الثابتة StreetViewPanoramaFragment.newInstance(StreetViewPanoramaOptions options) لإنشاء الجزء وتمرير الخيارات المخصّصة التي تم ضبطها.
• إذا كنت تستخدم StreetViewPanoramaView، استخدِم الدالة الإنشائية StreetViewPanoramaView(Context, StreetViewPanoramaOptions) وأدخِل الخيارات المخصّصة التي تم ضبطها.

Kotlin

val sanFrancisco = LatLng(37.754130, -122.447129)
val view = StreetViewPanoramaView(
    this,
    StreetViewPanoramaOptions().position(sanFrancisco),
)

      

جافا

LatLng sanFrancisco = new LatLng(37.754130, -122.447129);
StreetViewPanoramaView view =
        new StreetViewPanoramaView(
                this, new StreetViewPanoramaOptions().position(sanFrancisco));

      

مزيد من المعلومات حول StreetViewPanoramaFragment

StreetViewPanoramaFragment هي فئة فرعية من فئة Android Fragment، وتتيح لك وضع بانوراما في "التجوّل الافتراضي" في جزء من Android. تعمل كائنات StreetViewPanoramaFragment كحاويات للصورة البانورامية، وتوفّر إمكانية الوصول إلى كائن StreetViewPanorama.

ملاحظة: تتطلّب حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" لتطبيقات Android المستوى 12 أو مستوى أعلى من واجهة برمجة التطبيقات لإتاحة استخدام عناصر StreetViewPanoramaFragment. إذا كنت تستهدف تطبيقًا أقدم من المستوى 12 لواجهة برمجة التطبيقات، يمكنك الوصول إلى الميزات نفسها من خلال الفئة SupportStreetViewPanoramaFragment. يجب أيضًا تضمين مكتبة الدعم لنظام التشغيل Android.

ملاحظة: لا تتيح حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android استخدام عناصر StreetViewPanoramaFragment متعددة في نشاط واحد.

StreetViewPanoramaView

StreetViewPanoramaView، وهي فئة فرعية من فئة Android View، تتيح لك وضع بانوراما في "التجوّل الافتراضي" في Android View. يمثّل View منطقة مستطيلة على الشاشة، وهو عنصر أساسي في إنشاء تطبيقات Android والتطبيقات المصغّرة. على غرار StreetViewPanoramaFragment، يعمل StreetViewPanoramaView كحاوية للبانوراما، ويعرض الميزات الأساسية من خلال عنصر StreetViewPanorama. على مستخدمي هذه الفئة إعادة توجيه جميع طرق مراحل النشاط، مثل onCreate() وonDestroy() وonResume() وonPause()) إلى الطرق المقابلة في الفئة StreetViewPanoramaView.

ملاحظة: لا تتيح حزمة تطوير البرامج بالاستناد إلى بيانات "خرائط Google" للتطبيقات المتوافقة مع Android استخدام عناصر StreetViewPanoramaView متعدّدة في نشاط واحد.

تخصيص الميزة التي يتحكّم فيها المستخدم

تتوفّر الميزات التالية تلقائيًا للمستخدم عند عرض بانوراما في "التجوّل الافتراضي": التحريك والتكبير والتصغير والانتقال إلى الصور البانورامية المجاورة. يمكنك تفعيل الإيماءات التي يتحكّم فيها المستخدم وإيقافها من خلال الطرق المتاحة على StreetViewPanorama. ولا يزال من الممكن إجراء تغييرات برمجية عند إيقاف الإيماءة.

< > لإظهار/إخفاء طرق Java

setPanningGesturesEnabled()

يحدّد هذا الإعداد ما إذا كان بإمكان المستخدم إعادة توجيه الكاميرا من خلال السحب.

        mStreetViewPanorama.setPanningGesturesEnabled(false);

setUserNavigationEnabled()

يحدّد هذا الإعداد ما إذا كان بإمكان المستخدم الانتقال إلى صورة بانورامية مختلفة. يمكن للمستخدمين النقر مرة واحدة على روابط التنقّل أو النقر مرّتين على العرض للانتقال إلى صورة بانورامية جديدة.

        mStreetViewPanorama.setUserNavigationEnabled(false);

setZoomGesturesEnabled()

تحدّد هذه السمة ما إذا كان بإمكان المستخدم التصغير أو التكبير بإصبعين.

        mStreetViewPanorama.setZoomGesturesEnabled(false);

setStreetNamesEnabled()

تحدّد ما إذا كان بإمكان المستخدم الاطّلاع على أسماء الشوارع المعروضة على الأرض.

        mStreetViewPanorama.setStreetNamesEnabled(false);

< > لإظهار/إخفاء طرق Kotlin

isPanningGesturesEnabled()

يحدّد هذا الإعداد ما إذا كان بإمكان المستخدم إعادة توجيه الكاميرا من خلال السحب.

        streetViewPanorama.isPanningGesturesEnabled = false

isUserNavigationEnabled

يحدّد هذا الإعداد ما إذا كان بإمكان المستخدم الانتقال إلى صورة بانورامية مختلفة. يمكن للمستخدمين النقر مرة واحدة على روابط التنقّل أو النقر مرّتين على العرض للانتقال إلى صورة بانورامية جديدة.

        streetViewPanorama.isUserNavigationEnabled = false

isZoomGesturesEnabled

تحدّد هذه السمة ما إذا كان بإمكان المستخدم التصغير أو التكبير بإصبعين.

        streetViewPanorama.isZoomGesturesEnabled = false

isStreetNamesEnabled

تحدّد ما إذا كان بإمكان المستخدم الاطّلاع على أسماء الشوارع المعروضة على الأرض.

        streetViewPanorama.isStreetNamesEnabled = false

ضبط الموقع الجغرافي للصورة البانورامية

لضبط الموقع الجغرافي للبانوراما في "التجوّل الافتراضي"، يمكنك استدعاء StreetViewPanorama.setPosition()، مع تمرير LatLng. يمكنك أيضًا تمرير radius وsource كمَعلمتَين اختياريتَين.

يكون نصف القطر مفيدًا إذا كنت تريد توسيع أو تضييق المنطقة التي ستبحث فيها ميزة "التجوّل الافتراضي" عن صورة بانورامية مطابقة. يعني نصف القطر 0 أنّه يجب ربط الصورة البانورامية بـ LatLng المحدّد بالضبط. نصف القطر التلقائي هو 50 مترًا. إذا كان هناك أكثر من بانوراما واحدة في المنطقة المطابقة، ستعرض واجهة برمجة التطبيقات أفضل مطابقة.

يكون المصدر مفيدًا إذا كنت تريد تقييد ميزة "التجوّل الافتراضي" للبحث فقط عن الصور البانورامية في الهواء الطلق. بشكل تلقائي، يمكن أن تكون صور بانوراما في "التجوّل الافتراضي" داخل أماكن مثل المتاحف والمباني العامة والمقاهي والأنشطة التجارية. يُرجى العِلم أنّ الصور البانورامية الخارجية قد لا تكون متوفّرة للموقع الجغرافي المحدّد.

Kotlin

val sanFrancisco = LatLng(37.754130, -122.447129)

// Set position with LatLng only.
streetViewPanorama.setPosition(sanFrancisco)

// Set position with LatLng and radius.
streetViewPanorama.setPosition(sanFrancisco, 20)

// Set position with LatLng and source.
streetViewPanorama.setPosition(sanFrancisco, StreetViewSource.OUTDOOR)

// Set position with LaLng, radius and source.
streetViewPanorama.setPosition(sanFrancisco, 20, StreetViewSource.OUTDOOR)

      

جافا

LatLng sanFrancisco = new LatLng(37.754130, -122.447129);

// Set position with LatLng only.
streetViewPanorama.setPosition(sanFrancisco);

// Set position with LatLng and radius.
streetViewPanorama.setPosition(sanFrancisco, 20);

// Set position with LatLng and source.
streetViewPanorama.setPosition(sanFrancisco, StreetViewSource.OUTDOOR);

// Set position with LaLng, radius and source.
streetViewPanorama.setPosition(sanFrancisco, 20, StreetViewSource.OUTDOOR);

      

بدلاً من ذلك، يمكنك ضبط الموقع الجغرافي استنادًا إلى معرّف بانوراما من خلال تمرير panoId إلى StreetViewPanorama.setPosition().

لاسترداد معرّف البانوراما للصور البانورامية المجاورة، استخدِم أولاً getLocation() لاسترداد StreetViewPanoramaLocation. يحتوي هذا العنصر على معرّف البانوراما الحالية ومصفوفة من عناصر StreetViewPanoramaLink، يحتوي كل منها على معرّف بانوراما متصلة بالبانوراما الحالية.

Kotlin

streetViewPanorama.location.links.firstOrNull()?.let { link: StreetViewPanoramaLink ->
    streetViewPanorama.setPosition(link.panoId)
}

      

جافا

StreetViewPanoramaLocation location = streetViewPanorama.getLocation();
if (location != null && location.links != null) {
    streetViewPanorama.setPosition(location.links[0].panoId);
}

      

التكبير والتصغير

يمكنك تغيير مستوى التكبير آليًا من خلال ضبط StreetViewPanoramaCamera.zoom. سيؤدي ضبط التكبير على 1.0 إلى تكبير الصورة بمقدار الضعف.

يستخدم المقتطف التالي StreetViewPanoramaCamera.Builder() لإنشاء كاميرا جديدة مع إمالة الكاميرا الحالية واتجاهها، مع زيادة التكبير بنسبة خمسين بالمائة.

Kotlin

val zoomBy = 0.5f
val camera = StreetViewPanoramaCamera.Builder()
    .zoom(streetViewPanorama.panoramaCamera.zoom + zoomBy)
    .tilt(streetViewPanorama.panoramaCamera.tilt)
    .bearing(streetViewPanorama.panoramaCamera.bearing)
    .build()

      

جافا

float zoomBy = 0.5f;
StreetViewPanoramaCamera camera =
        new StreetViewPanoramaCamera.Builder()
                .zoom(streetViewPanorama.getPanoramaCamera().zoom + zoomBy)
                .tilt(streetViewPanorama.getPanoramaCamera().tilt)
                .bearing(streetViewPanorama.getPanoramaCamera().bearing)
                .build();

      

ضبط اتجاه الكاميرا (وجهة النظر)

يمكنك تحديد اتجاه كاميرا "التجوّل الافتراضي" من خلال ضبط الاتجاه والإمالة على StreetViewPanoramaCamera.

محمل

الاتجاه الذي تشير إليه الكاميرا، ويتم تحديده بالدرجات في اتجاه عقارب الساعة من الشمال الحقيقي، حول موضع الكاميرا. الشمال الحقيقي هو 0، والشرق هو 90، والجنوب هو 180، والغرب هو 270.

إمالة

الإمالة للأعلى أو للأسفل على المحور ص يتراوح النطاق بين -90 و0 و90، حيث يشير -90 إلى النظر إلى الأسفل مباشرةً، و0 إلى التوسّط في الأفق، و90 إلى النظر إلى الأعلى مباشرةً. يتم قياس التباين من درجة الميل التلقائية الأولية للكاميرا، والتي غالبًا ما تكون (ولكن ليس دائمًا) أفقية مسطحة. على سبيل المثال، من المحتمل أن يكون للصورة التي تم التقاطها على تل درجة ميل تلقائية غير أفقية.

يستخدم المقتطف التالي StreetViewPanoramaCamera.Builder() لإنشاء كاميرا جديدة مع تكبير وإمالة الكاميرا الحالية، مع تغيير الاتجاه بمقدار 30 درجة إلى اليسار.

Kotlin

val panBy = 30f
val camera = StreetViewPanoramaCamera.Builder()
    .zoom(streetViewPanorama.panoramaCamera.zoom)
    .tilt(streetViewPanorama.panoramaCamera.tilt)
    .bearing(streetViewPanorama.panoramaCamera.bearing - panBy)
    .build()

      

جافا

float panBy = 30;
StreetViewPanoramaCamera camera =
        new StreetViewPanoramaCamera.Builder()
                .zoom(streetViewPanorama.getPanoramaCamera().zoom)
                .tilt(streetViewPanorama.getPanoramaCamera().tilt)
                .bearing(streetViewPanorama.getPanoramaCamera().bearing - panBy)
                .build();

      

يؤدي المقتطف التالي إلى إمالة الكاميرا للأعلى بمقدار 30 درجة.

Kotlin

var tilt = streetViewPanorama.panoramaCamera.tilt + 30
tilt = if (tilt > 90) 90f else tilt
val previous = streetViewPanorama.panoramaCamera
val camera = StreetViewPanoramaCamera.Builder(previous)
    .tilt(tilt)
    .build()

      

جافا

float tilt = streetViewPanorama.getPanoramaCamera().tilt + 30;
tilt = (tilt > 90) ? 90 : tilt;

StreetViewPanoramaCamera previous = streetViewPanorama.getPanoramaCamera();

StreetViewPanoramaCamera camera =
        new StreetViewPanoramaCamera.Builder(previous).tilt(tilt).build();

      

تحريك حركات الكاميرا

لإضافة تأثيرات متحركة إلى حركات الكاميرا، يمكنك استدعاء StreetViewPanorama.animateTo(). تستكمل الحركة بين سمات الكاميرا الحالية وسمات الكاميرا الجديدة. إذا أردت الانتقال مباشرةً إلى الكاميرا بدون تأثيرات متحركة، يمكنك ضبط المدة على 0.

Kotlin

// Keeping the zoom and tilt. Animate bearing by 60 degrees in 1000 milliseconds.
val duration: Long = 1000
val camera = StreetViewPanoramaCamera.Builder()
    .zoom(streetViewPanorama.panoramaCamera.zoom)
    .tilt(streetViewPanorama.panoramaCamera.tilt)
    .bearing(streetViewPanorama.panoramaCamera.bearing - 60)
    .build()
streetViewPanorama.animateTo(camera, duration)

      

جافا

// Keeping the zoom and tilt. Animate bearing by 60 degrees in 1000 milliseconds.
long duration = 1000;
StreetViewPanoramaCamera camera =
        new StreetViewPanoramaCamera.Builder()
                .zoom(streetViewPanorama.getPanoramaCamera().zoom)
                .tilt(streetViewPanorama.getPanoramaCamera().tilt)
                .bearing(streetViewPanorama.getPanoramaCamera().bearing - 60)
                .build();
streetViewPanorama.animateTo(camera, duration);

      

تعرض الصورة التالية النتيجة عند جدولة الصورة المتحركة أعلاه ليتم تشغيلها كل 2000 ملي ثانية، باستخدام Handler.postDelayed():