Rendering

Lớp StreetViewPanorama

class google.maps.StreetViewPanorama extends MVCObject
library "streetView"

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.

const {StreetViewPanorama} = await google.maps.importLibrary("streetView");
StreetViewPanorama
StreetViewPanorama(container[, opts])
Tham 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 chế độ điều khiển vào ảnh toàn cảnh, hãy thêm <div> của chế độ điều khiển vào MVCArray tương ứng với ControlPosition nơi chế độ điều khiển đó sẽ được hiển thị.
focus
focus()
Tham 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 đó. Không thể lấy tiêu điểm cho 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ợ, thì Ảnh toàn cảnh trong Chế độ xem đường phố sẽ theo dõi các chuyển động vật lý.
getPano
getPano()
Tham số: Không có
Giá trị trả về: string
Trả về 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ố. 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()
Tham số: Không có
Giá trị trả về: StreetViewPov
Trả về hướng và độ dốc của nhiếp ảnh gia khi chụp ảnh toàn cảnh này. Đối với ảnh toàn cảnh trong Chế độ xem đường phố trên đường, thông tin này cũng cho biết hướng di chuyển của ô tô. 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 ảnh toàn cảnh hiển thị. Tham số này không chỉ định liệu hình ảnh trong Chế độ xem đường phố có sẵn tại 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. Mức thu nhỏ hoàn toàn là mức 0, 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])
Tham số:
Giá trị trả về: Không có
Đặt 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)
Tham 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ợ, thì Ảnh toàn cảnh trong Chế độ xem đường phố sẽ theo dõi các chuyển động vật lý.
setOptions
setOptions(options)
Tham 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)
Tham 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)
Tham số:
Giá trị trả về: 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)
Tham số:
Giá trị trả về: Không có
Đặt điểm xem cho ảnh toàn cảnh trong Chế độ xem đường phố.
setVisible
setVisible(flag)
Tham số:
  • flag: boolean
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 cho dù được nhúng trong bản đồ hay trong <div> riêng.
setZoom
setZoom(zoom)
Tham số:
  • zoom: number
Giá trị trả về: Không có
Đặt mức thu phóng của ảnh toàn cảnh. Mức thu nhỏ hoàn toàn là mức 0, trong đó trường nhìn là 180 độ. Thao tác phóng to sẽ làm tăng mức thu phóng.
Được kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll
closeclick
function(event)
Đối số:
  • event: Event optional Sự kiện đã được 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 ảnh toàn cảnh thay đổi. Ảnh toàn cảnh có thể thay đổi khi người dùng di chuyển trong ảnh toàn cảnh hoặc khi 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í sẽ 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 xem của ảnh toàn cảnh thay đổi. Góc nhìn sẽ thay đổi khi độ nghiêng, mức thu phóng 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 của ảnh 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 Pegman đượ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
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt của chế độ kiểm soát địa chỉ.
addressControlOptions
không bắt buộc
Các lựa chọn hiển thị cho thành phần điều khiển địa chỉ.
clickToGo
không bắt buộc
Loại: boolean optional
Mặc định: true
Trạng thái 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
không bắt buộc
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 đó có thể khiến các chế độ điều khiển chuyển sang trạng thái không xác định. Chỉ chi phối các chế độ điều khiển 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
không bắt buộc
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 lẻ.
disableDoubleClickZoom
không bắt buộc
Loại: boolean optional
Mặc định: true
Bật/tắt tính năng thu phóng khi nhấp đúp.
enableCloseButton
không bắt buộc
Loại: boolean optional
Mặc định: false
Nếu true, nút đóng sẽ xuất hiện.
fullscreenControl
không bắt buộc
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
không bắt buộc
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
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt của chế độ kiểm soát ngày thu nạp hình ảnh. Tắt theo mặc định.
linksControl
không bắt buộc
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
không bắt buộc
Loại: boolean optional
Cho biết tính năng theo dõi chuyển động đang bật hay tắt. Tính năng này được bật theo mặc định khi có chế độ kiểm soát theo dõi chuyển động và người dùng đã cấp quyền hoặc không cần cấp quyền, nhờ đó góc nhìn (POV) sẽ 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 motionTracking được đặt thành false trong khi motionTrackingControl đang bật, 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 motionTracking được đặt thành true trong khi quyền được yêu cầu nhưng chưa được yêu cầu, thì chế độ kiểm soát 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ế độ kiểm soát 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 và tính năng theo dõi cũng bị tắt.
motionTrackingControl
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt của chế độ kiểm soát theo dõi chuyển động. Được bật theo mặc định khi thiết bị có dữ liệu chuyển động, nhờ đó, nút điều khiển sẽ 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
không bắt buộc
Các lựa chọn hiển thị cho chế độ kiểm soát theo dõi chuyển động.
panControl
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt của chế độ điều khiển kéo.
panControlOptions
không bắt buộc
Loại: PanControlOptions optional
Các tuỳ chọn hiển thị cho nút điều khiển xoay.
pano
không bắt buộc
Loại: string optional
Mã nhận dạng ảnh toàn cảnh, cần được đặt khi chỉ định ảnh toàn cảnh tuỳ chỉnh.
position
không bắt buộc
Loại: LatLng|LatLngLiteral optional
Vị trí LatLng của ảnh toàn cảnh trong Chế độ xem đường phố.
pov
không bắt buộc
Loại: StreetViewPov optional
Hướng của camera, được chỉ định là hướng và độ dốc, cho ảnh toàn cảnh.
scrollwheel
không bắt buộc
Loại: boolean optional
Mặc định: true
Nếu false, thì sẽ tắt tính năng thu phóng bằng bánh xe cuộn trong Chế độ xem đường phố.
showRoadLabels
không bắt buộc
Loại: boolean optional
Mặc định: true
Hiển thị tên đường phố trên ảnh toàn cảnh. Nếu bạn không chỉ định giá trị này hoặc đặt 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 xuất hiện.
visible
không bắt buộc
Loại: boolean optional
Nếu true, ảnh toàn cảnh trong Chế độ xem đường phố sẽ hiển thị khi tải.
zoom
không bắt buộc
Loại: number optional
Mức thu phóng của ảnh toàn cảnh, được chỉ định dưới dạng một số. Mức thu phóng 0 cho Trường nhìn 180 độ.
zoomControl
không bắt buộc
Loại: boolean optional
Trạng thái bật/tắt của chế độ điều khiển thu phóng.
zoomControlOptions
không bắt buộc
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 lựa chọn để hiển thị thành phần điều khiển địa chỉ của Chế độ xem đường phố.
position
không bắt buộc
Loại: ControlPosition optional
Mã vị trí. Mã 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 lựa chọn cho Nhà cung cấp ảnh toàn cảnh tuỳ chỉnh.
cors
không bắt buộc
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 thích hợp trên hình ảnh được cung cấp. Nhà phát triển có nhiệm vụ phân phát hình ảnh một cách 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 nhóm ô được dùng trong ảnh toàn cảnh trong Chế độ xem đường phố.
centerHeading
Loại: number
Hướng (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à các ô sẽ được kết xuất.
worldSize
Loại: Size
Kích thước (tính bằng pixel) của "thế giới" toàn cảnh.
getTileUrl
getTileUrl(pano, tileZoom, tileX, tileY)
Tham số:
  • pano: string
  • tileZoom: number
  • tileX: number
  • tileY: number
Giá trị trả về: string
Lấy URL hình ảnh ô cho ô được chỉ định.
Đây là một phương thức tuỳ chỉnh mà bạn phải triển khai để cung cấp các ô tuỳ chỉnh. Lệnh gọi API gọi phương thức này, cung cấp các tham số sau:
pano là mã nhận dạng ảnh toàn cảnh của ô Chế độ xem đường phố.
tileZoom là mức thu phóng của ô.
tileX là toạ độ x của ô.
tileY là toạ độ y của ô.
Phương thức tuỳ chỉnh của bạn phải trả về URL cho hình ảnh ô.

Giao diện StreetViewPov

giao diện google.maps.StreetViewPov

Đối tượng điểm nhìn chỉ định hướng của camera tại vị trí của ảnh toàn cảnh trong Chế độ xem đường phố. Góc nhìn được xác định bằng hướng và độ cao.
heading
Loại: number
Hướng của camera tính bằng độ so với hướng bắc true. Hướng chính bắc là 0°, hướng đông là 90°, hướng nam là 180°, hướng tây là 270°.
pitch
Loại: number
Độ nghiêng của camera tính bằng độ, so với xe chụp ảnh cho Chế độ xem đường phố. Phạm vi từ 90° (hướng thẳng lên trên) đến -90° (hướng thẳng xuống dưới).

Lớp StreetViewCoverageLayer

class google.maps.StreetViewCoverageLayer extends MVCObject
library "streetView"

Một lớp minh hoạ những vị trí có thể dùng Chế độ xem đường phố.

const {StreetViewCoverageLayer} = await google.maps.importLibrary("streetView");
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 đồ mà lớp này hiển thị.
setMap
setMap(map)
Tham số:
  • map: Map optional
Giá trị trả về: undefined
Hiển thị lớp trên bản đồ được chỉ định. Nếu bản đồ được đặt thành rỗng, thì lớp này sẽ bị xoá.
Được kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll