Kiểu bản đồ mới sắp xuất hiện trên Nền tảng Google Maps. Bản cập nhật này để tạo kiểu bản đồ bao gồm một bảng màu mặc định mới và các cải tiến về trải nghiệm bản đồ cũng như khả năng hữu dụng. Tất cả kiểu bản đồ sẽ được cập nhật tự động vào tháng 3 năm 2025. Để biết thêm thông tin về phạm vi cung cấp và cách chọn tham gia sớm hơn, hãy xem bài viết Kiểu bản đồ mới cho Nền tảng Google Maps.

Trang này được dịch bởi Cloud Translation API.

Ảnh toàn cảnh StreetView

lớp công khai StreetViewPanorama mở rộng Đối tượng

Đây là lớp chính của tính năng Chế độ xem đường phố trong SDK Google Maps dành cho Android và là điểm truy cập cho tất cả các phương thức liên quan đến ảnh toàn cảnh của Chế độ xem đường phố. Bạn không thể tạo thực thể cho đối tượng StreetViewPanorama trực tiếp, thay vào đó, bạn phải lấy đối tượng qua phương thức #getStreetViewPanoramaAsync() trên StreetViewPanoramaFragment hoặc StreetViewPanoramaView mà bạn đã thêm vào ứng dụng.

Lưu ý: Tương tự như đối tượng View, bạn chỉ có thể đọc và sửa đổi StreetViewPanorama từ luồng chính. Việc gọi các phương thức StreetViewPanorama từ một chuỗi khác sẽ dẫn đến một ngoại lệ.

Hướng dẫn cho nhà phát triển

Để bắt đầu sử dụng SDK Google Maps dành cho Android, hãy đọc hướng dẫn cho nhà phát triển SDK Google Maps dành cho Android .

Tóm tắt lớp lồng ghép

giao diện	StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener	Trình nghe khi StreetViewtoànCamera thay đổi
giao diện	StreetViewPanorama.OnStreetViewPanoramaChangeListener	Trình nghe khi ảnh toàn cảnh của Chế độ xem đường phố tải một ảnh toàn cảnh mới
giao diện	StreetViewPanorama.OnStreetViewPanoramaClickListener	Giao diện gọi lại khi người dùng nhấn vào ảnh toàn cảnh.
giao diện	StreetViewPanorama.OnStreetViewPanoramaLongClickListener	Giao diện gọi lại khi người dùng nhấn và giữ ảnh toàn cảnh.

Tóm tắt phương thức công khai

void	animateTo(máy ảnh StreetViewPanoramaCamera, thời lượng dài) Thay đổi vị trí, hướng và mức thu phóng hiện tại của máy ảnh thành một vị trí nhất định trong một khoảng thời gian cụ thể
StreetViewPanoramaLocation	Hàm getLocation() Trả về vị trí hiện tại của người dùng và thông tin liên quan đến ảnh toàn cảnh liền kề của ảnh toàn cảnh hiện tại.
StreetViewPanoramaCamera	Hàm getPanoramaCamera() Trả về hướng và mức thu phóng hiện tại
boolean	isPanningGesturesEnabled() Trả về xem có bật cử chỉ kéo cho người dùng hay không
boolean	Hàm isStreetNamesEnabled() Trả về xem tên đường phố có xuất hiện trên ảnh toàn cảnh hay không
boolean	Hàm isUserNavigationEnabled() Trả về việc có bật tính năng điều hướng cho người dùng hay không.
boolean	isZoomGesturesEnabled() Trả về việc liệu cử chỉ thu phóng có được bật cho người dùng hay không
Điểm	orientationToPoint(hướng StreetViewPanoramaOrientation) Trả về vị trí màn hình tương ứng với một hướng (`StreetViewPanoramaOrientation`).
StreetViewPanoramaOrientation	pointToOrientation(Điểm điểm) Trả về hướng tương ứng với một vị trí màn hình.
khoảng trống cuối cùng	setOnStreetViewPanoramaCameraChangeListener(trình nghe StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener) Đặt lệnh gọi lại được gọi khi máy ảnh thay đổi
khoảng trống cuối cùng	setOnStreetViewPanoramaChangeListener(trình nghe StreetViewPanorama.OnStreetViewPanoramaChangeListener) Đặt một lệnh gọi lại được gọi khi toàn cảnh thay đổi
khoảng trống cuối cùng	setOnStreetViewPanoramaClickListener(trình nghe StreetViewPanorama.OnStreetViewPanoramaClickListener) Đặt một lệnh gọi lại được gọi khi người dùng nhấn vào ảnh toàn cảnh.
khoảng trống cuối cùng	setOnStreetViewPanoramaLongClickListener(trình nghe StreetViewPanorama.OnStreetViewPanoramaLongClickListener) Đặt lệnh gọi lại được gọi khi người dùng nhấn và giữ ảnh toàn cảnh.
void	setPanningGesturesEnabled(boolean enabledPaned) Đặt xem người dùng có thể sử dụng cử chỉ kéo hay không
void	setPosition(Chuỗi panoId) Đặt Chế độ xem phố toàn cảnh vào một vị trí cụ thể
void	setPosition(vị trí LatLng) Đặt Chế độ xem phố toàn cảnh vào một vị trí cụ thể
void	setPosition(vị trí LatLng, nguồn StreetViewSource) Đặt Chế độ xem phố toàn cảnh vào một vị trí cụ thể
void	setPosition(vị trí LatLng, bán kính int, nguồn StreetViewSource) Đặt Chế độ xem phố toàn cảnh vào một vị trí cụ thể
void	setPosition(vị trí LatLng, bán kính int) Đặt Chế độ xem phố toàn cảnh vào một vị trí cụ thể
void	setStreetNamesEnabled(boolean enabledStreetNames) Đặt liệu người dùng có thể nhìn thấy tên đường phố trên ảnh toàn cảnh hay không
void	setUserNavigationEnabled(boolean enabledUserNavigation) Đặt liệu người dùng có thể di chuyển đến một ảnh toàn cảnh khác hay không
void	setZoomGesturesEnabled(boolean enableZoom) Thiết lập xem người dùng có thể sử dụng cử chỉ thu phóng hay không

Tóm tắt phương thức kế thừa

Trong lớp java.lang.Object

boolean	bằng(Đối tượng arg0)
lớp cuối cùng<?>	getClass()
int	hashCode()
khoảng trống cuối cùng	notify()
khoảng trống cuối cùng	notifyAll()
Chuỗi	toString()
khoảng trống cuối cùng	chờ(long arg0, int arg1)
khoảng trống cuối cùng	chờ(long arg0)
khoảng trống cuối cùng	wait()

Phương thức công khai

công khai khoảng trống animateTo (máy ảnh StreetViewPanoramaCamera, thời lượng dài)

Thay đổi vị trí, hướng và mức thu phóng hiện tại của máy ảnh thành một vị trí nhất định trong một khoảng thời gian cụ thể

Các tham số

máy ảnh	Vị trí máy ảnh để tạo hiệu ứng chuyển động
duration	Khoảng thời gian (tính bằng mili giây) cần để chuyển từ vị trí hiện tại của máy ảnh sang vị trí đã cho

công khai StreetViewPanoramaLocation getLocation ()

Trả về vị trí hiện tại của người dùng và thông tin liên quan đến ảnh toàn cảnh liền kề của ảnh toàn cảnh hiện tại.

Trả bóng

Vị trí hiện tại của người dùng

công khai StreetViewPanoramaCamera getPanoramaCamera ()

Trả về hướng và mức thu phóng hiện tại

Trả bóng

Camera hiện tại

boolean công khai isPanningGesturesEnabled ()

Trả về xem có bật cử chỉ kéo cho người dùng hay không

Trả bóng

true nếu cử chỉ kéo đang bật

công khai boolean isStreetNamesEnabled ()

Trả về xem tên đường phố có xuất hiện trên ảnh toàn cảnh hay không

Trả bóng

true nếu tên đường phố xuất hiện

boolean công khai isUserNavigationEnabled ()

Trả về việc có bật tính năng điều hướng cho người dùng hay không. Điều này bao gồm việc nhấn đúp cũng như sử dụng các đường liên kết điều hướng

Trả bóng

true nếu tính năng điều hướng đang bật

công khai boolean isZoomGesturesEnabled ()

Trả về việc liệu cử chỉ thu phóng có được bật cho người dùng hay không

Trả bóng

true nếu cử chỉ thu phóng được bật

công khai Điểm orientationToPoint (hướngStreetViewPanoramaOrientation)

Trả về vị trí màn hình tương ứng với một hướng (StreetViewPanoramaOrientation). Vị trí màn hình tính bằng pixel màn hình (không phải pixel hiển thị) so với phía trên cùng bên trái của ảnh toàn cảnh Chế độ xem đường phố (không phải của toàn bộ màn hình).

Các tham số

hướng	`StreetViewPanoramaOrientation` trên ảnh toàn cảnh của Chế độ xem đường phố để chuyển đổi thành vị trí trên màn hình.

Trả bóng

Một Point đại diện cho vị trí màn hình bằng pixel trên màn hình. Trả về null nếu không thể chiếu hướng trên màn hình (ví dụ: phía sau trường nhìn của người dùng)

công khai StreetViewPanoramaOrientation pointToOrientation (Điểm điểm)

Trả về hướng tương ứng với một vị trí màn hình. Vị trí trên màn hình được chỉ định bằng pixel trên màn hình (không phải pixel hiển thị) so với góc trên cùng bên trái của ảnh toàn cảnh Chế độ xem đường phố (không phải phía trên cùng bên trái của toàn bộ màn hình).

Các tham số

điểm	Một `Point` trên màn hình (tính bằng pixel).

Trả bóng

StreetViewPanoramaOrientation tương ứng với point trên màn hình, hoặc null nếu ảnh toàn cảnh của Chế độ xem đường phố chưa được khởi chạy hoặc nếu điểm đã cho không phải là một điểm hợp lệ trên màn hình

công khai cuối cùng khoảng trống setOnStreetViewPanoramaCameraChangeListener (StreetViewPanorama.OnStreetViewPanoramaCameraChangeListener

Đặt lệnh gọi lại được gọi khi máy ảnh thay đổi

Các tham số

trình nghe	Lệnh gọi lại được bật khi camera thay đổi. Để huỷ đặt lệnh gọi lại, hãy dùng `null`.

công khai cuối cùng khoảng trống setOnStreetViewPanoramaChangeListener (StreetViewPanorama.OnStreetViewPanoramaChangeListener)

Đặt một lệnh gọi lại được gọi khi toàn cảnh thay đổi

Các tham số

trình nghe	Lệnh gọi lại được bật khi ảnh toàn cảnh thay đổi. Để huỷ đặt lệnh gọi lại, hãy sử dụng `null`.

công khai cuối cùng khoảng trống setOnStreetViewPanoramaClickListener (StreetViewPanorama.OnStreetViewPanoramaClickListener)

Đặt một lệnh gọi lại được gọi khi người dùng nhấn vào ảnh toàn cảnh.

Các tham số

trình nghe	Lệnh gọi lại được bật khi người dùng nhấn vào ảnh toàn cảnh. Để huỷ đặt lệnh gọi lại, hãy sử dụng `null`.

công khai cuối cùng khoảng trống setOnStreetViewPanoramaLongClickListener (StreetViewPanorama.OnStreetViewPanoramaLongClickListener)

Đặt lệnh gọi lại được gọi khi người dùng nhấn và giữ ảnh toàn cảnh.

Các tham số

trình nghe	Lệnh gọi lại được gọi khi người dùng nhấn và giữ chế độ toàn cảnh. Để huỷ đặt lệnh gọi lại, hãy dùng `null`.

công khai khoảng không setPanningGesturesEnabled (boolean enablePanning)

Đặt xem người dùng có thể sử dụng cử chỉ kéo hay không