Rendering

Lớp StreetViewPanorama

Lớp google.maps.StreetViewPanorama

Hiển thị ảnh toàn cảnh cho một LatLng hoặc mã nhận dạng ảnh toàn cảnh nhất định. Đối tượng StreetViewPanorama cung cấp một "trình xem" Chế độ xem đường phố có thể độc lập trong một <div> riêng biệt hoặc liên kết với một Map.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {StreetViewPanorama} = await google.maps.importLibrary("streetView"). Xem phần Thư viện trong API Maps JavaScript.
StreetViewPanorama
StreetViewPanorama(container[, opts])
Thông số: 
Tạo ảnh toàn cảnh bằng StreetViewPanoramaOptions đã truyền.
controls
Các chế độ đ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 nơi thành phần điều khiển đó sẽ được hiển thị.
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 StreetViewPanorama hiển thị trước khi đặt tiêu điểm vào đó. Không thể lấy tiêu điểm của một StreetViewPanorama không hiển thị.
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 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ợ việc này, thì Chế độ xem đường phố toàn cảnh sẽ theo dõi các chuyển động thực tế.
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 trong Chế độ xem đường phố. Mã nhận dạng 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ề hướng và độ dốc của người chụp khi chụp ảnh toàn cảnh này. Đối với ảnh toàn cảnh Chế độ xem đường phố trên đường, thông tin này cũng cho biết hướng di chuyển của xe. Dữ liệu này có sẵn sau sự kiện pano_changed.
getPosition
getPosition()
Thông số:  Không có
Giá trị trả về:  LatLng|null
Trả về vị trí LatLng hiện tại cho ảnh toàn cảnh Chế độ xem đường phố.
getPov
getPov()
Thông số:  Không có
Giá trị trả về:  StreetViewPov
Trả về điểm nhìn hiện tại cho ảnh toàn cảnh trong Chế độ xem đường 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 hiển thị. Thông tin này không chỉ định liệu có hình ảnh Chế độ xem đường phố tại vị trí được 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. Cấp 0 là mức thu nhỏ hoàn toàn, trong đó trường nhìn là 180 độ. Thao tác 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.
setMotionTracking
setMotionTracking(motionTracking)
Thông số: 
  • motionTracking:  boolean
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ợ việc này, thì Chế độ xem đường phố toàn cảnh sẽ theo dõi các chuyển động thực tế.
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ố: 
  • pano:  string
Giá trị trả về:  Không có
Đặt mã nhận dạng ảnh toàn cảnh hiện tại cho ảnh toàn cảnh trong Chế độ xem đường 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 Chế độ xem đường phố.
setPov
setPov(pov)
Thông số: 
Giá trị trả về:  Không có
Thiết lập điểm nhìn cho ảnh toàn cảnh trong Chế độ xem đường phố.
setVisible
setVisible(flag)
Thông số: 
  • flag:  boolean
Giá trị trả về:  Không có
Đặt thành true để hiển thị ảnh toàn cảnh. Nếu bạn đặt thành false, ảnh toàn cảnh sẽ bị ẩn cho dù ảnh đó được nhúng trong bản đồ hay trong <div> riêng.
setZoom
setZoom(zoom)
Thông số: 
  • zoom:  number
Giá trị trả về:  Không có
Đặt mức thu phóng của ảnh toàn cảnh. Cấp 0 là mức thu nhỏ hoàn toàn, trong đó trường nhìn là 180 độ. Thao tác phóng to sẽ làm tăng mức thu phóng.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function(event)
Đối số: 
  • event:  Event Sự kiện đã kích hoạt.
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ận dạng pano 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 theo cách thủ công. Xin lưu ý rằng không phải thay đổi vị trí nào cũng 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 di chuyển qua ảnh 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 nhìn thay đổi khi độ dốc, độ phóng to hoặc hướng 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ị của ảnh toàn cảnh thay đổi. Chế độ hiển thị sẽ thay đổi khi bạn kéo Pegman vào bản đồ, nhấp vào nút đóng hoặc gọi setVisible().
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 StreetViewPanoramaOptions

Giao diện google.maps.StreetViewPanoramaOptions

Các tuỳ chọn xác định thuộc tính của đối tượng StreetViewPanorama.
addressControl optional
Loại:  boolean optional
Trạng thái bật/tắt của thành phần điều khiển địa chỉ.
addressControlOptions optional
Các tuỳ chọn hiển thị cho thành phần điều khiển địa chỉ.
clickToGo optional
Loại:  boolean optional
Mặc định: true
Trạng thái bật/tắt tính năng nhấp để chuyển đế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 tính bằng pixel của các nút điều khiển xuất hiện trên ảnh toàn cảnh. Bạn phải cung cấp trực tiếp giá trị này khi tạo ảnh toàn cảnh. Việc cập nhật giá trị này sau này có thể khiến các chế độ điều khiển chuyển sang trạng thái không xác định. Chỉ điều chỉnh các chế độ điều khiển do chính Maps API tạo ra. Không điều chỉnh tỷ lệ các chế độ điều khiển tuỳ 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ể được ghi đè riêng lẻ.
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 là 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ị cho chế độ điều khiển toàn màn hình.
imageDateControl optional
Loại:  boolean optional
Trạng thái bật/tắt của chế độ 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 thành phần điều khiển đường liên kết.
motionTracking optional
Loại:  boolean optional
Liệu tính năng theo dõi chuyển động có đang bật hay tắt. Được bật theo mặc định khi có chế độ điều khiển theo dõi chuyển động và người dùng cấp quyền hoặc không yêu cầu cấp quyền, để POV (góc nhìn) tuân theo hướng của thiết bị. Điều này chủ yếu áp dụng cho thiết bị di động. Nếu bạn đặt motionTracking thành false trong khi bật motionTrackingControl, thì tuỳ chọn đ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 tuỳ chọn điều khiển theo dõi chuyển động để bật/tắt tuỳ chọn này. Nếu motionTracking được đặt thành true trong khi cần có quyền nhưng chưa được 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 đang 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 cấp quyền. Nếu motionTracking được đặt thành true trong khi người dùng từ chối cấp quyền, thì chế độ điều khiển theo dõi chuyển động sẽ bị tắt khi tính năng theo dõi bị tắt.
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 để nút điều khiển xuất hiện trên bản đồ. Điều này chủ yếu áp dụng cho thiết bị di động.
motionTrackingControlOptions optional
Loại:  MotionTrackingControlOptions optional
Các tuỳ chọn hiển thị cho chế độ đ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 nút điều khiển kéo.
panControlOptions optional
Loại:  PanControlOptions optional
Các tuỳ chọn hiển thị cho chế độ điều khiển xoay.
pano optional
Loại:  string optional
Mã nhận dạng ảnh toàn cảnh, bạn cần đặt mã này khi chỉ định ảnh toàn cảnh tuỳ chỉnh.
position optional
Loại:  LatLng|LatLngLiteral optional
Vị trí LatLng của ảnh toàn cảnh trong Chế độ xem đường phố.
pov optional
Loại:  StreetViewPov optional
Hướng máy ảnh, được chỉ định là hướng và độ dốc, 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 phóng to bằng con lăn chuột trong Chế độ xem đường phố.
showRoadLabels optional
Loại:  boolean optional
Mặc định: true
Hiển thị tên đường trên ảnh toàn cảnh. Nếu bạn không chỉ định giá trị này hoặc đặt giá trị này thành true, thì tên đường sẽ xuất hiện trên ảnh toàn cảnh. Nếu bạn đặt thành false, tên đường sẽ không hiển thị.
visible optional
Loại:  boolean optional
Nếu là true, ảnh toàn cảnh trong Chế độ xem đường phố sẽ hiển thị khi tải.
zoom optional
Loại:  number optional
Độ thu phóng của ảnh toàn cảnh, được chỉ định dưới dạng số. Độ thu phóng 0 sẽ cho Trường nhìn 180 độ.
zoomControl optional
Loại:  boolean optional
Trạng thái bật/tắt của nút điều khiển thu phóng.
zoomControlOptions optional
Loại:  ZoomControlOptions optional
Các tuỳ chọn hiển thị cho chế độ điều khiển thu phóng.

Giao diện StreetViewAddressControlOptions

Giao diện google.maps.StreetViewAddressControlOptions

Các tuỳ chọn để kết xuất thành phần điều khiển địa chỉ trên Chế độ xem đường phố.
position optional
Loại:  ControlPosition optional
Mã vị trí. Mã nhận dạng này được dùng để chỉ định vị trí của thành phầ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 ảnh toàn cảnh tuỳ chỉ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ư webgl) chỉ hoạt động khi tiêu đề cors được đặt phù hợp trên hình ảnh được cung cấp. Nhiệm vụ của nhà phát triển là phân phát hình ảnh chính xác kết hợp với cờ này, nếu không có thể dẫn đến SecurityErrors.

Giao diện StreetViewTileData

Giao diện google.maps.StreetViewTileData

Các thuộc tính của tập hợp thẻ thông tin được dùng trong ảnh toàn cảnh Chế độ xem đường phố.
centerHeading
Loại:  number
Tiêu đề (tính bằng độ) ở giữa các ô toàn cảnh.
tileSize
Loại:  Size
Kích thước (tính bằng pixel) mà thẻ thông tin sẽ được kết xuất.
worldSize
Loại:  Size
Kích thước (tính bằng pixel) của "thế giới" của toàn bộ ảnh toàn cảnh.
getTileUrl
getTileUrl(pano, tileZoom, tileX, tileY)
Thông số: 
  • pano:  string
  • tileZoom:  number
  • tileX:  number
  • tileY:  number
Giá trị trả về:  string
Lấy URL hình ảnh thẻ thông tin cho thẻ thông tin đã chỉ định.
Đây là một 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, cung cấp các tham số sau:
pano là mã nhận dạng toàn cảnh của thẻ thông tin Chế độ xem đường phố.
tileZoom là mức thu phóng của thẻ thông tin.
tileX là toạ độ x của thẻ thông tin.
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

Đối tượng điểm nhìn chỉ định hướng của máy ảnh tại vị trí của ảnh toàn cảnh trên Chế độ xem đường phố. Điểm nhìn được xác định là hướng và độ dốc.
heading
Loại:  number
Hướng máy ảnh tính theo độ so với hướng bắc true. Hướng bắc thực là 0°, đông là 90°, nam là 180°, tây là 270°.
pitch
Loại:  number
Độ dốc của máy ảnh tính theo độ, so với xe của chế độ xem đường phố. Dao động 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 hoạ những vị trí có hỗ trợ Chế độ xem đường phố.

Lớp này mở rộng MVCObject.

Truy cập bằng cách gọi const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView"). Xem phần Thư viện trong API Maps JavaScript.
StreetViewCoverageLayer
StreetViewCoverageLayer()
Thông số:  Không có
Tạo một thực thể mới của StreetViewCoverageLayer.
getMap
getMap()
Thông số:  Không có
Giá trị trả về:  Map|null
Trả về bản đồ hiển thị lớp này.
setMap
setMap(map)
Thông số: 
  • map:  Map optional
Giá trị trả về:  undefined
Kết xuất lớp trên bản đồ được chỉ định. Nếu bạn đặt bản đồ thành giá trị rỗng, lớp này sẽ bị xoá.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll