Ả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

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

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