Đâ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 | |
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 | |
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
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ớipoint
trên màn hình, hoặcnull
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
Các tham số
enablePanning | true nếu người dùng được phép sử dụng cử chỉ kéo
|
---|
public void setPosition (String panoId)
Đặt Chế độ xem phố toàn cảnh vào một vị trí cụ thể
Các tham số
panoId | Mã toàn cảnh của vị trí mong muốn |
---|
công khai khoảng trống setPosition (vị trí LatLng)
Đặt Chế độ xem phố toàn cảnh vào một vị trí cụ thể
Các tham số
position | Vĩ độ và kinh độ của vị trí mong muốn |
---|
công khai khoảng trống setPosition (vị trí LatLng, nguồn StreetViewSource)
Đặt Chế độ xem phố toàn cảnh vào một vị trí cụ thể
Các tham số
position | Vĩ độ và kinh độ của vị trí mong muốn |
---|---|
source | StreetViewSource chỉ định nguồn của ảnh toàn cảnh để tìm kiếm |
công khai khoảng trống 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ể
Các tham số
position | Vĩ độ và kinh độ của vị trí mong muốn |
---|---|
bán kính | Bán kính (được chỉ định bằng mét) giúp xác định khu vực cần tìm kiếm ảnh toàn cảnh, căn giữa theo vĩ độ và kinh độ đã cho |
source | StreetViewSource chỉ định nguồn của ảnh toàn cảnh để tìm kiếm |
public 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ể
Các tham số
position | Vĩ độ và kinh độ của vị trí mong muốn |
---|---|
bán kính | Bán kính (được chỉ định bằng mét) giúp xác định khu vực cần tìm kiếm ảnh toàn cảnh, căn giữa theo vĩ độ và kinh độ đã cho |
công khai khoảng trống setStreetNamesEnabled (boolean enableStreetNames)
Đặ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
Các tham số
enableStreetNames | true nếu người dùng có thể thấy tên đường trên ảnh toàn cảnh
|
---|
công khai khoảng trống setUserNavigationEnabled (boolean enableUserNavigation)
Đặ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
Các tham số
enableUserNavigation | true nếu người dùng được phép di chuyển đến một ảnh toàn cảnh khác
|
---|
công khai khoảng trống 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
Các tham số
enableZoom | true nếu người dùng được phép sử dụng cử chỉ thu phóng
|
---|