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 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 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 Thư viện trong API JavaScript Maps.
StreetViewPanorama
StreetViewPanorama(container[, opts])
Các thông số: 
Tạo ảnh toàn cảnh với 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 cần kết xuất.
focus
focus()
Tham số: Không có
Giá trị trả lại hàng: Không có
Đặt tiêu điểm cho 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 nó. Không thể lấy tiêu điểm StreetViewPanorama không hiển thị.
getLocation
getLocation()
Tham 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()
Tham 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ợ thiết bị đó, thì Ảnh toàn cảnh trong Chế độ xem đường phố sẽ theo dõi chuyển động.
getPano
getPano()
Tham 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ã này chỉ ổn định trong phiên hiện tại của trình duyệt.
getPhotographerPov
getPhotographerPov()
Tham 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 của Chế độ xem đường phố trên đường, ảnh này cũng cho biết xe đang di chuyển theo hướng nào. Dữ liệu này sẽ có sau sự kiện pano_changed.
getPosition
getPosition()
Tham 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 trong Chế độ xem đường phố.
getPov
getPov()
Tham số: Không có
Giá trị trả về:  StreetViewPov
Trả về điểm xem hiện tại cho ảnh toàn cảnh trong Chế độ xem đường phố.
getStatus
getStatus()
Tham 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()
Tham số: Không có
Giá trị trả về:  boolean
Trả về true nếu bạn nhìn thấy ảnh toàn cảnh. Chế độ này không chỉ định liệu hình ảnh trong Chế độ xem đường phố có ở vị trí được chỉ định hay không.
getZoom
getZoom()
Tham 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 nhìn là 180 độ. Phóng to sẽ tăng mức thu phóng.
registerPanoProvider
registerPanoProvider(provider[, opt_options])
Các thông số: 
Giá trị trả lại hàng: Không có
Đặt trình cung cấp ảnh toàn cảnh tùy chỉnh được gọi vào thay đổi ảnh toàn cảnh để tải ảnh toàn cảnh tùy chỉnh.
setMotionTracking
setMotionTracking(motionTracking)
Các thông số: 
  • motionTracking:  boolean
Giá trị trả lại hàng: 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ợ thiết bị đó, thì Ảnh toàn cảnh trong Chế độ xem đường phố sẽ theo dõi chuyển động.
setOptions
setOptions(options)
Các thông số: 
Giá trị trả lại hàng: Không có
Thiết lập một tập hợp các cặp khoá-giá trị.
setPano
setPano(pano)
Các thông số: 
  • pano:  string
Giá trị trả lại hàng: Không có
Đặt mã ảnh toàn cảnh hiện tại cho ảnh toàn cảnh trong Chế độ xem đường phố.
setPosition
setPosition(latLng)
Các thông số: 
Giá trị trả lại hàng: Không có
Đặt vị trí LatLng hiện tại cho ảnh toàn cảnh trong Chế độ xem đường phố.
setPov
setPov(pov)
Các thông số: 
Giá trị trả lại hàng: Không có
Đặt điểm xem cho ảnh toàn cảnh trong Chế độ xem đường phố.
setVisible
setVisible(flag)
Các thông số: 
  • flag:  boolean
Giá trị trả lại hàng: 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ù được nhúng trong bản đồ hay trong <div> của chính nó.
setZoom
setZoom(zoom)
Các thông số: 
  • zoom:  number
Giá trị trả lại hàng: 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 nhìn là 180 độ. Phóng to sẽ 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 được kích hoạt.
Sự kiện này được kích hoạt khi 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 id ả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 theo cách thủ công. Xin lưu ý rằng không phải mọi 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 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 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 của nó 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 thông qua setPosition() hoặc setPano() sau mỗi lần tra cứu ảnh toàn cảnh theo mã nhận dạng hoặc vị trí.
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ị 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 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 công cụ kiểm soát địa chỉ.
addressControlOptions optional
Các tuỳ 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 để di chuyển đã bật/tắt. Không áp dụng cho ảnh toàn cảnh tùy 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. Giá trị này phải được cung cấp trực tiếp khi tạo Ảnh toàn cảnh, việc cập nhật giá trị này sau đó có thể đưa các điều khiển về trạng thái không xác định. Chỉ chi phối các chế độ kiểm soát do chính API Maps 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ể 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 là true, thì 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ị để điều khiển chế độ 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 chế độ kiểm soát đường liên kết.
motionTracking optional
Loại:  boolean optional
Bật hay tắt tính năng theo dõi chuyển động. Được bật theo mặc định khi có tính năng điều khiển theo dõi chuyển động và người dùng có cấp quyền hay không, để POV (góc nhìn) tuân theo hướng của thiết bị. Tính năng 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 motionTrackingControl đang bật, thì chế độ theo dõi chuyển động sẽ xuất hiện nhưng chế độ 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 để bật/tắt chế độ này. Nếu bạn đặt motionTracking thành true trong khi cần có quyền nhưng chưa yêu cầu quyền, 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 bị 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 trong khi người dùng từ chối cấp quyền, thì chế độ kiểm soát theo dõi chuyển động sẽ bị tắt khi tính năng theo dõi ở trạng thái tắt.
motionTrackingControl optional
Loại:  boolean optional
Trạng thái bật/tắt của chức năng đ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. Nhờ đó, chế độ điều khiển sẽ xuất hiện trên bản đồ. Tính năng 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 nút đ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 chế độ điều khiển xoay.
panControlOptions optional
Loại:  PanControlOptions optional
Các tuỳ chọn hiển thị cho chế độ điều khiển dịch vụ kéo.
pano optional
Loại:  string optional
Mã ảnh toàn cảnh. Bạn phải đặt mã này khi chỉ định một ả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à 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 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 phố trên ảnh toàn cảnh. Nếu giá trị này không được chỉ định hoặc được đặt thành true, tên đường phố sẽ hiển thị trên ảnh toàn cảnh. Nếu bạn đặt chính sách này thành false, tên đường phố sẽ không hiển thị.
visible optional
Loại:  boolean optional
Nếu giá trị là true, ảnh toàn cảnh của Chế độ xem đường phố sẽ hiển thị khi tải.
zoom optional
Loại:  number optional
Mức thu phóng của ảnh toàn cảnh, được chỉ định dưới dạng số. Thu phó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 tính năng điều khiển thu phóng.
zoomControlOptions optional
Loại:  ZoomControlOptions optional
Các tuỳ chọn hiển thị để điều khiển chế độ thu phóng.

Giao diện StreetViewAddressControlOptions

Giao diện google.maps.StreetViewAddressControlOptions

Các tuỳ chọn kết xuất chế độ điều khiển địa chỉ trong Chế độ xem đường phố.
position optional
Loại:  ControlPosition optional
Mã vị trí. Mã này được dùng để chỉ định vị trí của bộ đ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 lựa chọn cho Nhà cung cấp danh sách phát tuỳ chỉnh.
cors optional
Loại:  boolean optional
Nếu bạn đặt chính sách này, trình kết xuất sẽ sử dụng các công nghệ (như webgl) chỉ hoạt động khi các tiêu đề cor được thiết lập phù hợp trên các 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. Điều này có thể dẫn đến SecurityErrors.

Giao diện StreetViewTileData

Giao diện google.maps.StreetViewTileData

Các thuộc tính của nhóm ô được dùng trong ảnh toàn cảnh của Chế độ xem đường phố.
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à ô sẽ hiển thị.
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)
Các 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à 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à cung cấp các tham số sau:
pano là mã ảnh 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

Một đối tượng điểm xem chỉ định hướng của máy ảnh tại vị trí của ảnh toàn cảnh trong Chế độ xem đường phố. Điểm nhìn được xác định là tiêu đề và độ cao.
heading
Loại:  number
Camera đang hướng theo độ so với true về phía bắc. Đúng là hướng bắc là 0°, hướng đông là 90°, phía nam là 180°, phía tây là 270°.
pitch
Loại:  number
Độ cao của máy ảnh theo độ, so với xe phục vụ chế độ xem đường phố. Dao động từ 90° (trực tiếp lên) đến -90° (trực tiếp xuống).

Lớp StreetViewCoverageLayer

Lớp google.maps.StreetViewCoverageLayer

Lớp minh hoạ các vị trí nơi Chế độ xem đường phố khả dụng.

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 Thư viện trong API JavaScript Maps.
StreetViewCoverageLayer
StreetViewCoverageLayer()
Tham số: Không có
Tạo một thực thể mới của StreetViewCoverageLayer.
getMap
getMap()
Tham số: Không có
Giá trị trả về:  Map|null
Trả về bản đồ nơi lớp này được hiển thị.
setMap
setMap(map)
Các thông số: 
  • map:  Map optional
Giá trị trả lại hàng: Không có
Hiển thị lớp trên bản đồ được chỉ định. Nếu bản đồ được đặt thành rỗng, lớp sẽ bị xoá.
Kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll