Lớp StreetViewToàn cảnh
Lớp google.maps.StreetViewPanorama
Hiển thị ảnh toàn cảnh của một LatLng
hoặc ID toàn cảnh nhất định. Đối tượng StreetViewPanorama
cung cấp một "thành phần hiển thị" (View) có thể xem riêng trong <div>
hoặc được liên kết với Map
.
Lớp này mở rộng MVCObject
.
Khi sử dụng v=beta
, bạn có thể truy cập vào bằng cách gọi const {StreetViewPanorama} = await google.map.importLibrary("streetView")
. Xem phần Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
StreetViewPanorama |
StreetViewPanorama(container[, opts]) Thông số:
Tạo một ảnh toàn cảnh với StreetViewPanoramaOptions được truyền. |
Thuộc tính | |
---|---|
controls |
Loại:
Array<MVCArray<HTMLElement>> Các điều khiển bổ sung để đính kèm vào ảnh toàn cảnh. Để thêm một thành phần điều khiển vào ảnh toàn cảnh, hãy thêm <div> của thành phần điều khiển đó vào MVCArray tương ứng với ControlPosition mà thành phần hiển thị đó sẽ được hiển thị. |
Phương pháp | |
---|---|
focus |
focus() Thông số: Không có
Giá trị trả về: Không có
Đặt tiêu điểm vào StreetViewPanorama này. Bạn nên cân nhắc sử dụng phương thức này cùng với sự kiện visible_changed để đảm bảo rằng StreetViewPanorama hiển thị trước khi đặt tiêu điểm vào phương thức đó. StreetViewPanorama không hiển thị không thể lấy tiêu điểm. |
getLinks |
getLinks() Thông số: Không có
Giá trị trả về:
Array<StreetViewLink> Trả về tập hợp các đường liên kết điều hướng cho ảnh toàn cảnh trong Chế độ xem phố. |
getLocation |
getLocation() Thông số: Không có
Giá trị trả về:
StreetViewLocation Trả về StreetViewLocation của ảnh toàn cảnh hiện tại. |
getMotionTracking |
getMotionTracking() Thông số: Không có
Giá trị trả về:
boolean Trả về trạng thái của bộ theo dõi chuyển động. Nếu true khi người dùng di chuyển thiết bị và trình duyệt hỗ trợ, Chế độ xem toàn cảnh của Chế độ xem phố theo dõi chuyển động vật lý. |
getPano |
getPano() Thông số: Không có
Giá trị trả về:
string Trả về mã ảnh toàn cảnh hiện tại cho ảnh toàn cảnh của Chế độ xem phố. Mã này chỉ ổn định trong phiên hiện tại của trình duyệt. |
getPhotographerPov |
getPhotographerPov() Thông số: Không có
Giá trị trả về:
StreetViewPov Trả về tiêu đề và cao độ của nhiếp ảnh gia khi ảnh toàn cảnh này được chụp. Đối với ảnh toàn cảnh trong Chế độ xem phố trên đường, điều này cũng cho biết ô tô đang đi theo hướng nào. Dữ liệu này sẽ có sau sự kiện pano_changed . |
getPosition |
getPosition() Thông số: Không có
Giá trị trả về:
LatLng Trả về vị trí LatLng hiện tại cho ảnh toàn cảnh của Chế độ xem phố. |
getPov |
getPov() Thông số: Không có
Giá trị trả về:
StreetViewPov Trả về điểm xem hiện tại cho ảnh toàn cảnh của Chế độ xem phố. |
getStatus |
getStatus() Thông số: Không có
Giá trị trả về:
StreetViewStatus Trả về trạng thái của ảnh toàn cảnh khi hoàn tất yêu cầu setPosition() hoặc setPano() . |
getVisible |
getVisible() Thông số: Không có
Giá trị trả về:
boolean Trả về true nếu ảnh toàn cảnh được hiển thị. Chế độ này không chỉ định việc hình ảnh trong Chế độ xem phố có xuất hiện tại vị trí đã chỉ định hay không. |
getZoom |
getZoom() Thông số: Không có
Giá trị trả về:
number Trả về mức thu phóng của ảnh toàn cảnh. Thu nhỏ hoàn toàn là cấp 0, trong đó trường xem là 180 độ. Phóng to sẽ làm tăng mức thu phóng. |
registerPanoProvider |
registerPanoProvider(provider[, opt_options]) Thông số:
Giá trị trả về: Không có
Đặt trình cung cấp ảnh toàn cảnh tuỳ chỉnh được gọi khi thay đổi ảnh toàn cảnh để tải ảnh toàn cảnh tuỳ chỉnh. |
setLinks |
setLinks(links) Thông số:
Giá trị trả về: Không có
Đặt tập hợp các đường liên kết điều hướng cho ảnh toàn cảnh của Chế độ xem phố. |
setMotionTracking |
setMotionTracking(motionTracking) Thông số:
Giá trị trả về: Không có
Đặt trạng thái của trình theo dõi chuyển động. Nếu true khi người dùng di chuyển thiết bị và trình duyệt hỗ trợ, Chế độ xem toàn cảnh của Chế độ xem phố theo dõi chuyển động vật lý. |
setOptions |
setOptions(options) Thông số:
Giá trị trả về: Không có
Đặt một tập hợp các cặp khoá-giá trị. |
setPano |
setPano(pano) Thông số:
Giá trị trả về: Không có
Đặt mã ảnh toàn cảnh hiện tại cho ảnh toàn cảnh Chế độ xem phố. |
setPosition |
setPosition(latLng) Thông số:
Giá trị trả về: Không có
Đặt vị trí LatLng hiện tại cho ảnh toàn cảnh của Chế độ xem phố. |
setPov |
setPov(pov) Thông số:
Giá trị trả về: Không có
Thiết lập điểm xem cho ảnh toàn cảnh của Chế độ xem phố. |
setVisible |
setVisible(flag) Thông số:
Giá trị trả về: Không có
Đặt thành true để hiển thị ảnh toàn cảnh. Nếu được đặt thành false , ảnh toàn cảnh sẽ bị ẩn dù được nhúng trong bản đồ hay trong <div> của chính bản đồ đó. |
setZoom |
setZoom(zoom) Thông số:
Giá trị trả về: Không có
Đặt mức thu phóng của ảnh toàn cảnh. Thu nhỏ hoàn toàn là cấp 0, trong đó trường xem là 180 độ. Phóng to sẽ làm tăng mức thu phóng. |
Kế thừa:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
Sự kiện | |
---|---|
closeclick |
function(event) Đối số:
Sự kiện này được kích hoạt khi người dùng nhấp vào nút đóng. |
pano_changed |
function() Đối số: Không có
Sự kiện này được kích hoạt khi mã ảnh toàn cảnh của ảnh toàn cảnh thay đổi. Ảnh toàn cảnh có thể thay đổi khi người dùng di chuyển qua ảnh toàn cảnh hoặc vị trí được đặt thủ công. Vui lòng lưu ý không phải tất cả thay đổi về vị trí đều kích hoạt pano_changed . |
position_changed |
function() Đối số: Không có
Sự kiện này được kích hoạt khi vị trí của ảnh toàn cảnh thay đổi. Vị trí thay đổi khi người dùng điều hướng trong toàn cảnh hoặc vị trí được đặt theo cách thủ công. |
pov_changed |
function() Đối số: Không có
Sự kiện này được kích hoạt khi điểm nhìn của ảnh toàn cảnh thay đổi. Điểm xem thay đổi khi cao độ, thu phóng hoặc tiêu đề thay đổi. |
resize |
function() Đối số: Không có
Nhà phát triển nên kích hoạt sự kiện này trên ảnh toàn cảnh khi div thay đổi kích thước: google.maps.event.trigger(panorama, 'resize') . |
status_changed |
function() Đối số: Không có
Sự kiện này được kích hoạt sau mỗi lần tra cứu ảnh toàn cảnh theo mã nhận dạng hoặc vị trí, thông qua setPosition() hoặc setPano() . |
visible_changed |
function() Đối số: Không có
Sự kiện này được kích hoạt khi chế độ hiển thị toàn cảnh thay đổi. Chế độ hiển thị thay đổi khi Người hình mắc áo được kéo vào bản đồ, nút đóng được nhấp hoặc setVisible() được gọi. |
zoom_changed |
function() Đối số: Không có
Sự kiện này được kích hoạt khi mức thu phóng của ảnh toàn cảnh thay đổi. |
Giao diện StreetViewGlOptions
Giao diện google.maps.StreetViewPanoramaOptions
Các tuỳ chọn xác định thuộc tính của một đối tượng StreetViewPanorama
.
Thuộc tính | |
---|---|
addressControl optional |
Loại:
boolean optional Trạng thái bật/tắt của tùy chọn kiểm soát địa chỉ. |
addressControlOptions optional |
Loại:
StreetViewAddressControlOptions optional Các lựa chọn hiển thị để kiểm soát địa chỉ. |
clickToGo optional |
Loại:
boolean optional Mặc định:
true Trạng thái nhấp để bật/tắt của tính năng nhấp để di chuyển. Không áp dụng cho ảnh toàn cảnh tuỳ chỉnh. |
controlSize optional |
Loại:
number optional Kích thước theo pixel của các nút điều khiển xuất hiện trên ảnh toàn cảnh. Giá trị này phải được cung cấp trực tiếp khi tạo Toàn cảnh, việc cập nhật giá trị này sau có thể chuyển các thành phần điều khiển sang trạng thái không xác định. Chỉ chi phối các biện pháp kiểm soát do chính Maps API thực hiện. Không điều chỉnh được các quyền kiểm soát tùy chỉnh do nhà phát triển tạo. |
disableDefaultUI optional |
Loại:
boolean optional Bật/tắt tất cả giao diện người dùng mặc định. Có thể bị ghi đè riêng. |
disableDoubleClickZoom optional |
Loại:
boolean optional Mặc định:
true Bật/tắt tính năng thu phóng khi nhấp đúp. |
enableCloseButton optional |
Loại:
boolean optional Mặc định:
false Nếu true , nút đóng sẽ xuất hiện. |
fullscreenControl optional |
Loại:
boolean optional Trạng thái bật/tắt của chế độ điều khiển toàn màn hình. |
fullscreenControlOptions optional |
Loại:
FullscreenControlOptions optional Các tuỳ chọn hiển thị để kiểm soát toàn màn hình. |
imageDateControl optional |
Loại:
boolean optional Trạng thái bật/tắt của tùy chọn kiểm soát ngày thu thập hình ảnh. Tắt theo mặc định. |
linksControl optional |
Loại:
boolean optional Trạng thái bật/tắt của tùy chọn kiểm soát đường liên kết này. |
motionTracking optional |
Loại:
boolean optional Theo dõi chuyển động ở trạng thái bật hay tắt. Được bật theo mặc định khi có sự điều khiển của tính năng theo dõi chuyển động và người dùng có quyền hay không cần thiết để POV (điểm xem) tuân theo hướng của thiết bị. Cách này chủ yếu áp dụng cho thiết bị di động. Nếu bạn đặt motionTracking thành false khi bật motionTrackingControl , thì chế độ điều khiển theo dõi chuyển động sẽ xuất hiện nhưng tính năng theo dõi sẽ tắt. Người dùng có thể nhấn vào chế độ điều khiển theo dõi chuyển động để bật/tắt tuỳ chọn này. Nếu bạn đặt motionTracking thành true khi cần quyền này nhưng chưa yêu cầu, thì chế độ điều khiển theo dõi chuyển động sẽ xuất hiện nhưng tính năng theo dõi sẽ tắt. Người dùng có thể nhấn vào chế độ điều khiển theo dõi chuyển động để yêu cầu quyền. Nếu bạn đặt motionTracking thành true khi người dùng từ chối cấp quyền, thì chế độ kiểm soát việc theo dõi chuyển động sẽ tắt khi bạn theo dõi. |
motionTrackingControl optional |
Loại:
boolean optional Trạng thái bật/tắt của chế độ điều khiển theo dõi chuyển động. Bật theo mặc định khi thiết bị có dữ liệu chuyển động để điều khiển xuất hiện trên bản đồ. Cách này chủ yếu áp dụng cho thiết bị di động. |
motionTrackingControlOptions optional |
Loại:
MotionTrackingControlOptions optional Các lựa chọn hiển thị cho điều khiển theo dõi chuyển động. |
panControl optional |
Loại:
boolean optional Trạng thái bật/tắt của tính năng điều khiển xoay. |
panControlOptions optional |
Loại:
PanControlOptions optional Các tuỳ chọn hiển thị để điều khiển việc xoay. |
pano optional |
Loại:
string optional Mã ảnh toàn cảnh nên được đặt khi chỉ định ảnh toàn cảnh tùy chỉnh. |
position optional |
Loại:
LatLng|LatLngLiteral optional Vị trí LatLng của ảnh toàn cảnh trong Chế độ xem phố. |
pov optional |
Loại:
StreetViewPov optional Hướng máy ảnh, được chỉ định là tiêu đề và cao độ, cho ảnh toàn cảnh. |
scrollwheel optional |
Loại:
boolean optional Mặc định:
true Nếu false , hãy tắt tính năng thu phóng con lăn trong Chế độ xem phố. |
showRoadLabels optional |
Loại:
boolean optional Mặc định:
true Hiển thị tên đường phố trên toàn cảnh. Nếu giá trị này không được chỉ định hoặc được đặt thành true , thì tên đường phố sẽ xuất hiện trên ảnh toàn cảnh. Nếu bạn đặt chính sách này thành false , thì tên đường phố sẽ không xuất hiện. |
visible optional |
Loại:
boolean optional Nếu true , ảnh toàn cảnh trong Chế độ xem phố được hiển thị khi tải. |
zoom optional |
Loại:
number optional Thu phóng ảnh toàn cảnh, được chỉ định dưới dạng số. Mức thu phóng bằng 0 cung cấp Trường nhìn 180 độ. |
zoomControl optional |
Loại:
boolean optional Trạng thái bật/tắt của chế độ điều khiển thu phóng. |
zoomControlOptions optional |
Loại:
ZoomControlOptions optional Các tuỳ chọn hiển thị cho điều khiển thu phóng. |
Giao diện StreetViewAddressControlOptions
Giao diện google.maps.StreetViewAddressControlOptions
Các cách hiển thị quyền kiểm soát địa chỉ Chế độ xem phố.
Thuộc tính | |
---|---|
position optional |
Loại:
ControlPosition optional Id vị trí Mã này được dùng để xác định vị trí của tùy chọn điều khiển trên bản đồ. Vị trí mặc định là TOP_LEFT . |
Giao diện PanoProviderOptions
Giao diện google.maps.PanoProviderOptions
Các tuỳ chọn cho Nhà cung cấp Pano tuỳ chỉnh.
Thuộc tính | |
---|---|
cors optional |
Loại:
boolean optional Nếu được đặt, trình kết xuất sẽ sử dụng các công nghệ (như Bộ nhớ đệm) chỉ hoạt động khi các tiêu đề cors được đặt phù hợp trên các hình ảnh được cung cấp. Nhà phát triển có nhiệm vụ phân phát hình ảnh chính xác cùng với cờ này. Việc này có thể dẫn đến lỗi SecurityErrors. |
Giao diện StreetViewTileData
Giao diện google.maps.StreetViewTileData
Các thuộc tính của bộ ô được sử dụng trong ảnh toàn cảnh trong Chế độ xem phố.
Thuộc tính | |
---|---|
centerHeading |
Loại:
number Tiêu đề (tính bằng độ) ở giữa ô toàn cảnh. |
tileSize |
Loại:
Size Kích thước (tính bằng pixel) mà thẻ thông tin sẽ hiển thị. |
worldSize |
Loại:
Size Kích thước (tính bằng pixel) của toàn bộ "thế giới" của ảnh toàn cảnh. |
Phương pháp | |
---|---|
getTileUrl |
getTileUrl(pano, tileZoom, tileX, tileY) Thông số:
Giá trị trả về:
string Lấy URL hình ảnh thẻ thông tin cho thẻ thông tin được chỉ định. Đây là phương thức tuỳ chỉnh mà bạn phải triển khai để cung cấp thẻ thông tin tuỳ chỉnh. API gọi phương thức này, với điều kiện cung cấp các thông số sau: pano là mã nhận dạng ảnh toàn cảnh của ô Chế độ xem phố.tileZoom là mức thu phóng của thẻ thông tin.tileX là toạ độ x của ô.tileY là toạ độ y của thẻ thông tin.Phương thức tuỳ chỉnh của bạn phải trả về URL cho hình ảnh thẻ thông tin. |
Giao diện StreetViewPov
Giao diện google.maps.StreetViewPov
Một điểm xem đối tượng chỉ định hướng của máy ảnh tại vị trí của ảnh toàn cảnh trong Chế độ xem phố. Điểm xem được định nghĩa là tiêu đề và cao độ.
Thuộc tính | |
---|---|
heading |
Loại:
number Máy ảnh di chuyển theo độ so với true về phía bắc. Đúng về phía bắc là 0 °, phía đông là 90 °, phía nam là 180 °, phía tây là 270 °. |
pitch |
Loại:
number Cao độ máy ảnh theo độ, so với xe xem phố. Phạm vi từ 90° (trực tiếp lên trên) đến -90° (trực tiếp xuống dưới). |
Lớp StreetViewCoverageLayer
Lớp google.maps.StreetViewCoverageLayer
Một lớp minh họa các vị trí có Chế độ xem phố.
Lớp này mở rộng MVCObject
.
Khi sử dụng v=beta
, bạn có thể truy cập vào bằng cách gọi const {StreetViewCoverageLayer} = await google.map.importLibrary("streetView")
. Xem phần Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
StreetViewCoverageLayer |
StreetViewCoverageLayer() Thông số: Không có
Tạo một thực thể mới của StreetViewCoverageLayer . |
Phương pháp | |
---|---|
getMap |
getMap() Thông số: Không có
Giá trị trả về:
Map Trả về bản đồ mà lớp này được hiển thị. |
setMap |
setMap(map) Thông số:
Giá trị trả về: Không có
Hiển thị lớp trên bản đồ được chỉ định. Nếu bản đồ được đặt thành giá trị rỗng, thì lớp này sẽ bị xoá. |
Kế thừa:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|