Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

Street View

เลือกแพลตฟอร์ม: Android iOS JavaScript

Google Street View ให้มุมมองพาโนรามา 360 องศาจากถนนที่กำหนดทั่วพื้นที่ให้บริการ

วิดีโอนี้แสดงวิธีใช้บริการ Street View เพื่อให้ผู้ใช้ได้สัมผัสประสบการณ์เสมือนจริงของที่อยู่บนแผนที่ ซึ่งจะช่วยให้ผู้ใช้เข้าใจบริบทที่เกี่ยวข้องเกี่ยวกับปลายทางหรือสถานที่ที่สนใจ

พื้นที่ให้บริการที่พร้อมใช้งานผ่าน Google Maps Android API v2 จะเหมือนกับพื้นที่ให้บริการของแอป Google Maps ในอุปกรณ์ Android อ่านเพิ่มเติมเกี่ยวกับ Street View และดูพื้นที่ที่รองรับใน แผนที่แบบอินเทอร์แอกทีฟได้ที่ หัวข้อเกี่ยวกับ Street View

คลาส StreetViewPanorama จะจำลองภาพพาโนรามา Street View ในแอปพลิเคชัน ภายใน UI ของคุณ ระบบจะแสดงภาพพาโนรามาด้วย ออบเจ็กต์ StreetViewPanoramaFragment หรือ StreetViewPanoramaView

ตัวอย่างโค้ด

ที่เก็บ ApiDemos ใน GitHub มี ตัวอย่างที่แสดงให้เห็นถึงการใช้ Street View

ตัวอย่าง Kotlin:

StreetViewPanoramaBasicDemoActivity: พื้นฐานการใช้ Street View
StreetViewPanoramaEventsDemoActivity: การฟังเหตุการณ์
StreetViewPanoramaNavigationDemoActivity: การควบคุมพาโนรามาใน Street View ผ่านโปรแกรม
StreetViewPanoramaOptionsDemoActivity: การเปลี่ยนตัวเลือก UI และ ท่าทางสัมผัส
StreetViewPanoramaViewDemoActivity: การใช้ StreetViewPanoramaView (แทน Fragment)
SplitStreetViewPanoramaAndMapDemoActivity: การใช้ กิจกรรมที่แสดง Street View และแผนที่

ตัวอย่าง Java:

StreetViewPanoramaBasicDemoActivity: พื้นฐานการใช้ Street View
StreetViewPanoramaEventsDemoActivity: การฟังเหตุการณ์
StreetViewPanoramaNavigationDemoActivity: การควบคุมพาโนรามาใน Street View ผ่านโปรแกรม
StreetViewPanoramaOptionsDemoActivity: การเปลี่ยนตัวเลือก UI และ ท่าทางสัมผัส
StreetViewPanoramaViewDemoActivity: การใช้ StreetViewPanoramaView (แทน Fragment)
SplitStreetViewPanoramaAndMapDemoActivity: การสร้าง กิจกรรมที่แสดง Street View และแผนที่

ภาพรวมของ Street View ใน Maps SDK สำหรับ Android

Maps SDK สำหรับ Android มีบริการ Street View สำหรับรับและจัดการรูปภาพที่ใช้ใน Google Street View ระบบจะแสดงผลรูปภาพเป็นภาพพาโนรามา

ภาพพาโนรามาใน Street View แต่ละภาพเป็นรูปภาพหรือชุดรูปภาพที่ให้มุมมอง 360 องศาเต็มรูปแบบจากตำแหน่งเดียว รูปภาพเป็นไปตามการฉายภาพแบบ Equirectangular (Plate Carrée) ซึ่งมีมุมมองแนวนอน 360 องศา (มุมมองรอบด้าน) และมุมมองแนวตั้ง 180 องศา (จากด้านบนลงด้านล่าง) ภาพพาโนรามา 360 องศาที่ได้จะกำหนดการฉายภาพบนทรงกลมโดยมีรูปภาพห่อหุ้มพื้นผิว 2 มิติของทรงกลมนั้น

StreetViewPanorama มีโปรแกรมดูที่แสดงภาพพาโนรามาเป็นทรงกลมโดยมีกล้องอยู่ตรงกลาง คุณสามารถจัดการ StreetViewPanoramaCamera เพื่อควบคุมการซูม และการวางแนว (การเอียงและทิศทาง) ของกล้อง

เริ่มต้นใช้งาน

ตั้งค่าโปรเจ็กต์

ทำตามคู่มือเริ่มต้นใช้งานเพื่อตั้งค่าโปรเจ็กต์ Android สำหรับ Maps SDK สำหรับ Android

ตรวจสอบความพร้อมใช้งานของพาโนรามาใน Street View ก่อนเพิ่มพาโนรามา

ไลบรารีของไคลเอ็นต์ SDK ของบริการ Google Play มีตัวอย่าง Street View 2-3 ตัวอย่างที่คุณสามารถนำเข้าไปยังโปรเจ็กต์และใช้เป็นพื้นฐานในการพัฒนาได้ ดูคำแนะนำในการนำเข้าตัวอย่างได้ในส่วนบทนำ

ไลบรารีของยูทิลิตี Maps SDK สำหรับ Android เป็นไลบรารีโอเพนซอร์สของคลาสที่มีประโยชน์สำหรับ แอปพลิเคชันที่หลากหลาย ที่เก็บ GitHub มียูทิลิตีข้อมูลเมตาของ Street View ยูทิลิตีนี้จะตรวจสอบว่า Street View รองรับตำแหน่งหนึ่งๆ หรือไม่ คุณสามารถหลีกเลี่ยงข้อผิดพลาดเมื่อเพิ่มพาโนรามาใน Street View ลงในแอป Android ได้โดยการเรียกใช้ยูทิลิตีข้อมูลเมตานี้ และเพิ่มพาโนรามาใน Street View เฉพาะในกรณีที่การตอบกลับเป็น OK

ใช้ API

ทำตามวิธีการด้านล่างเพื่อเพิ่มภาพพาโนรามา Street View ลงใน Fragment ของ Android ซึ่งเป็นวิธีที่ง่ายที่สุดในการเพิ่ม Street View ลงในแอปพลิเคชัน จากนั้นอ่านเพิ่มเติมเกี่ยวกับ Fragment, View และการปรับแต่งภาพพาโนรามา

เพิ่มพาโนรามาใน Street View

ทำตามขั้นตอนด้านล่างเพื่อเพิ่มพาโนรามาใน Street View เช่นภาพนี้

สรุปขั้นตอน

เพิ่มออบเจ็กต์ Fragment ลงใน Activity ที่จะจัดการ พาโนรามาใน Street View วิธีที่ง่ายที่สุดคือ เพิ่มองค์ประกอบ <fragment> ลงในไฟล์เลย์เอาต์สำหรับ Activity
ใช้ OnStreetViewPanoramaReadyCallback อินเทอร์เฟซ และใช้เมธอด Callback onStreetViewPanoramaReady(StreetViewPanorama) เพื่อรับแฮนเดิลไปยังออบเจ็กต์ StreetViewPanorama
เรียกใช้ getStreetViewPanoramaAsync() ใน Fragment เพื่อลงทะเบียน Callback

รายละเอียดเพิ่มเติมเกี่ยวกับแต่ละขั้นตอนมีดังนี้

เพิ่ม Fragment

เพิ่มองค์ประกอบ <fragment> ลงในไฟล์เลย์เอาต์ของ Activity เพื่อกำหนดออบเจ็กต์ Fragment ในองค์ประกอบนี้ ให้ตั้งค่าแอตทริบิวต์ class เป็น com.google.android.gms.maps.StreetViewPanoramaFragment (หรือ SupportStreetViewPanoramaFragment)

ตัวอย่าง Fragment ในไฟล์เลย์เอาต์

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

เพิ่มโค้ด Street View

หากต้องการใช้พาโนรามาใน Street View ภายในแอป คุณจะต้องใช้ OnStreetViewPanoramaReadyCallback อินเทอร์เฟซ และตั้งค่าอินสแตนซ์ของ Callback ในออบเจ็กต์ StreetViewPanoramaFragment หรือ StreetViewPanoramaView บทแนะนำนี้ใช้ StreetViewPanoramaFragment เนื่องจากเป็นวิธีที่ง่ายที่สุดในการเพิ่ม Street View ลงในแอป ขั้นตอนแรกคือการใช้ อินเทอร์เฟซ Callback

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)
    }
}

Java

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)
}

Java

@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);
}

รับแฮนเดิลไปยัง Fragment โดยเรียกใช้ FragmentManager.findFragmentById(), และส่งรหัสทรัพยากรขององค์ประกอบ <fragment> โปรดทราบว่าระบบจะเพิ่มรหัสทรัพยากร R.id.streetviewpanorama ลงในโปรเจ็กต์ Android โดยอัตโนมัติเมื่อคุณสร้างไฟล์เลย์เอาต์

จากนั้นใช้ getStreetViewPanoramaAsync() เพื่อตั้งค่า Callback ใน Fragment

Kotlin

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

Java

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

ใช้วิธีการ Callback onStreetViewPanoramaReady(StreetViewPanorama) เพื่อดึงข้อมูลอินสแตนซ์ StreetViewPanoramaที่ไม่ใช่ Null ซึ่งพร้อมใช้งาน

Kotlin

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

Java

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

ข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าสถานะเริ่มต้น

การกำหนดค่าสถานะเริ่มต้นของภาพพาโนรามา Street View ผ่าน XML ทำไม่ได้ ซึ่งต่างจากแผนที่ อย่างไรก็ตาม คุณสามารถกำหนดค่า ภาพพาโนรามาผ่านโปรแกรมได้โดยส่งออบเจ็กต์ StreetViewPanoramaOptions ที่มีตัวเลือกที่ระบุ

หากใช้ StreetViewPanoramaFragment ให้ใช้ StreetViewPanoramaFragment.newInstance(StreetViewPanoramaOptions options) วิธีการ Factory แบบคงที่เพื่อสร้าง Fragment และส่งตัวเลือกที่กำหนดค่าเอง
หากใช้ StreetViewPanoramaView ให้ใช้ตัวสร้าง StreetViewPanoramaView(Context, StreetViewPanoramaOptions) และส่งตัวเลือกที่กำหนดค่าเอง

Kotlin

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

Java

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

ข้อมูลเพิ่มเติมเกี่ยวกับ StreetViewPanoramaFragment

StreetViewPanoramaFragment เป็นคลาสย่อยของ คลาส Fragment ของ Android และช่วยให้คุณวางพาโนรามาใน Street View ใน Fragment ของ Android ได้ ออบเจ็กต์ StreetViewPanoramaFragment ทำหน้าที่เป็นคอนเทนเนอร์สำหรับภาพพาโนรามา และ ให้สิทธิ์เข้าถึงออบเจ็กต์ StreetViewPanorama

StreetViewPanoramaView

StreetViewPanoramaView ซึ่งเป็นคลาสย่อยของคลาส View ของ Android ช่วยให้คุณวางภาพพาโนรามาใน Street View ใน View ของ Android ได้ View แสดงถึงพื้นที่สี่เหลี่ยมผืนผ้าของหน้าจอ และเป็นหน่วยการสร้างพื้นฐานสำหรับแอปพลิเคชัน Android และวิดเจ็ต ซึ่งคล้ายกับ StreetViewPanoramaFragment นั้น StreetViewPanoramaView ทำหน้าที่เป็นคอนเทนเนอร์ สำหรับภาพพาโนรามา โดยแสดงฟีเจอร์หลักผ่านออบเจ็กต์ StreetViewPanorama ผู้ใช้คลาสนี้ต้องส่งต่อเมธอดวงจรกิจกรรมทั้งหมด เช่น onCreate(), onDestroy(), onResume() และ onPause()) ไปยังเมธอดที่เกี่ยวข้องในคลาส StreetViewPanoramaView

ปรับแต่งฟีเจอร์ที่ผู้ใช้ควบคุมได้

โดยค่าเริ่มต้น ผู้ใช้จะใช้ฟีเจอร์ต่อไปนี้ได้เมื่อดูพาโนรามาใน Street View ได้แก่ การแพน การซูม และการเดินทางไปยังภาพพาโนรามาที่อยู่ติดกัน คุณสามารถเปิดและปิดใช้ท่าทางสัมผัสที่ผู้ใช้ควบคุมได้ ผ่านเมธอดใน StreetViewPanorama การเปลี่ยนแปลงผ่านโปรแกรมยังคงทำได้เมื่อปิดใช้ท่าทางสัมผัส

< > แสดง/ซ่อนเมธอด Java

setPanningGesturesEnabled()

กำหนดว่าผู้ใช้จะสามารถปรับการวางแนวกล้องใหม่ได้โดยการ ลากหรือไม่

        mStreetViewPanorama.setPanningGesturesEnabled(false);

setUserNavigationEnabled()

กำหนดว่าผู้ใช้จะสามารถย้ายไปยังภาพพาโนรามาอื่นได้หรือไม่ ผู้ใช้สามารถแตะลิงก์การนำทางครั้งเดียวหรือแตะมุมมอง 2 ครั้งเพื่อ ย้ายไปยังภาพพาโนรามาใหม่

        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

กำหนดตำแหน่งของภาพพาโนรามา

หากต้องการกำหนดตำแหน่งของพาโนรามาใน Street View ให้เรียกใช้ StreetViewPanorama.setPosition() และส่ง LatLng นอกจากนี้ คุณยังส่ง radius และ source เป็นพารามิเตอร์ที่ไม่บังคับได้ด้วย

รัศมีมีประโยชน์หากคุณต้องการขยายหรือจำกัดพื้นที่ที่ Street View จะค้นหาภาพพาโนรามาที่ตรงกัน รัศมี 0 หมายความว่าภาพพาโนรามาต้องลิงก์กับ LatLng ที่ระบุอย่างแน่นอน รัศมีเริ่มต้นคือ 50 เมตร หากมีภาพพาโนรามามากกว่า 1 ภาพในพื้นที่ที่ตรงกัน API จะแสดงผลภาพที่ตรงกันมากที่สุด

แหล่งที่มามีประโยชน์หากคุณต้องการจำกัดให้ Street View ค้นหาเฉพาะภาพพาโนรามาที่อยู่กลางแจ้ง โดยค่าเริ่มต้น ภาพพาโนรามาใน Street View อาจอยู่ภายในสถานที่ต่างๆ เช่น พิพิธภัณฑ์ อาคารสาธารณะ คาเฟ่ และธุรกิจ โปรดทราบว่าภาพพาโนรามากลางแจ้งอาจไม่มีสำหรับตำแหน่งที่ระบุ

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)

Java

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)
}

Java

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

ซูมเข้าและออก

คุณสามารถเปลี่ยนระดับการซูมผ่านโปรแกรมได้โดยการตั้งค่า StreetViewPanoramaCamera.zoom การตั้งค่าการซูมเป็น 1.0 จะขยายรูปภาพ 2 เท่า

ข้อมูลโค้ดต่อไปนี้ใช้ StreetViewPanoramaCamera.Builder() เพื่อสร้างกล้องใหม่ที่มีการเอียงและทิศทางของกล้องที่มีอยู่ ขณะเดียวกันก็เพิ่มการซูม 50%

Kotlin

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

Java

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

กำหนดการวางแนวกล้อง (มุมมอง)

คุณสามารถกำหนดการวางแนวกล้อง Street View's orientation ได้โดยการตั้งค่าทิศทางและการเอียงใน StreetViewPanoramaCamera

ทิศทาง: ทิศทางที่กล้องชี้ไป โดยระบุเป็นองศา ตามเข็มนาฬิกาจากทิศเหนือจริงรอบๆ ตำแหน่งของกล้อง ทิศเหนือจริงคือ 0 ทิศตะวันออกคือ 90 ทิศใต้คือ 180 และทิศตะวันตกคือ 270
การเอียง: การเอียงแกน Y ขึ้นหรือลง ช่วงคือ -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()

Java

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()

Java

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)

Java

// 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);

รูปภาพต่อไปนี้แสดงผลลัพธ์เมื่อคุณกำหนดเวลาให้ภาพเคลื่อนไหวด้านบนทำงานทุกๆ 2, 000 มิลลิวินาทีโดยใช้ Handler.postDelayed()

Street View จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ

ตัวอย่างโค้ด

ภาพรวมของ Street View ใน Maps SDK สำหรับ Android

เริ่มต้นใช้งาน

ตั้งค่าโปรเจ็กต์

ตรวจสอบความพร้อมใช้งานของพาโนรามาใน Street View ก่อนเพิ่มพาโนรามา

ใช้ API

เพิ่มพาโนรามาใน Street View

เพิ่ม Fragment

เพิ่มโค้ด Street View

Kotlin

Java

Kotlin

Java

Kotlin

Java

Kotlin

Java

ข้อมูลเพิ่มเติมเกี่ยวกับการกำหนดค่าสถานะเริ่มต้น

Kotlin

Java

ข้อมูลเพิ่มเติมเกี่ยวกับ StreetViewPanoramaFragment

StreetViewPanoramaView

ปรับแต่งฟีเจอร์ที่ผู้ใช้ควบคุมได้

กำหนดตำแหน่งของภาพพาโนรามา

Kotlin

Java

Kotlin

Java

ซูมเข้าและออก

Kotlin

Java

กำหนดการวางแนวกล้อง (มุมมอง)

Kotlin

Java

Kotlin

Java

สร้างภาพเคลื่อนไหวของการเคลื่อนไหวของกล้อง

Kotlin

Java

Street View