Rendering

Lớp Lưu trữ toàn cảnh

Lớp google.maps.StreetViewPanorama

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

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

StreetViewPanorama
StreetViewPanorama(container[, opts])
Thông số:
Tạo ảnh toàn cảnh với StreetViewPanoramaOptions đã truyền.
controls
Các tùy chọn điều khiển bổ sung để đính kèm vào ảnh toàn cảnh. Để thêm một tùy chọn điều khiển vào chế độ 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 mà chế độ này sẽ 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 một 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 đó. Không thể lấy tiêu điểm vào 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ợ thiết bị đó, thì ảnh toàn cảnh của Chế độ xem phố sẽ 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ố. Id 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 chụp ảnh toàn cảnh này. Đối với ảnh toàn cảnh Chế độ xem phố trên đường, điều này cũng cho biết hướng đi của ô tô. 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ó thể nhìn thấy. Thông tin này không cho biết liệu hình ảnh Chế độ xem phố có được cung cấp ở vị trí cụ thể 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 nhìn là 180 độ. Phóng to sẽ 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 tùy chỉnh được gọi khi thay đổi ảnh toàn cảnh để tải ảnh toàn cảnh tùy 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ợ thiết bị đó, thì ảnh toàn cảnh của Chế độ xem phố sẽ 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ố:
  • pano: string
Giá trị trả về: Không có
Đặt mã ảnh toàn cảnh hiện tại cho ảnh toàn cảnh của 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ó
Đặt góc nhìn cho toàn cảnh Chế độ xem phố.
setVisible
setVisible(flag)
Thông số:
  • flag: boolean
Giá trị trả về: Không có
Đặt thành true để ảnh toàn cảnh xuất hiện. Nếu bạn đặt thành false, thì ảnh toàn cảnh sẽ bị ẩn dù được nhúng vào bản đồ hay trong <div> của chính bản đồ đó.
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. 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ố:
  • eventEvent 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 ả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. Lưu ý rằng không phải tất cả cá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í toàn cảnh thay đổi. Vị trí thay đổi khi người dùng di chuyển qua 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 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 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 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ị sẽ thay đổi khi người hình mắc áo kéo vào bản đồ, nút đóng được nhấp vào 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 toàn cảnh thay đổi.

Giao diện StreetViewoverviewOptions

Giao diện google.maps.StreetViewPanoramaOptions

Các tuỳ chọn xác định các 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 tùy chọn kiểm soát địa chỉ.
addressControlOptions optional
Các tùy chọn hiển thị cho tùy chọn kiểm soát địa chỉ.
clickToGo optional
Loại: boolean optional
Trạng thái bật/tắt của tính năng nhấp để di chuyển.
controlSize optional
Loại: number optional
Kích thước theo pixel của các tùy chọn đ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 tùy chọ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 API Maps thực hiện. Không tăng tỷ lệ các tùy chọn kiểm soát tùy chỉnh do nhà phát triển tạo ra.
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ẽ hiển thị.
fullscreenControl optional
Loại: boolean optional
Trạng thái bật/tắt của chế độ kiểm soát toàn màn hình.
fullscreenControlOptions optional
Loại: FullscreenControlOptions optional
Các tùy chọn hiển thị để đ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 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 chế độ kiểm soát đường liên kết.
motionTracking optional
Loại: boolean optional
Cho dù theo dõi chuyển động ở trạng thái bật hay tắt, sẽ bật theo mặc định khi có sự 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 thiết. Nhờ đó, POV (góc nhìn) tuân theo hướng của thiết bị. Cách này chủ yếu áp dụng cho các thiết bị di động. Nếu bạn đặt motionTracking thành false trong khi bật motionTrackingControl, thì tùy chọn điều khiển theo dõi chuyển động sẽ xuất hiện nhưng tùy chọn theo dõi đang tắt. Người dùng có thể nhấn vào tùy chọn điều khiển theo dõi chuyển động để bật/tắt tùy chọn này. Nếu bạn đặt motionTracking thành true trong khi yêu cầu quyền 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 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 để 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 chế độ theo dõi chuyển động sẽ tắt khi bạn tắt tính năng theo dõi.
motionTrackingControl optional
Loại: boolean optional
Trạng thái bật/tắt của trình điều khiển theo dõi chuyển động. Được bật theo mặc định khi thiết bị có dữ liệu chuyển động, để chức 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 các thiết bị di động.
motionTrackingControlOptions optional
Tuỳ 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 tùy chọn hiển thị cho điều khiển xoay.
pano optional
Loại: string optional
ID ả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 của máy ảnh, được chỉ định là hướng 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
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 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 của Chế độ xem phố sẽ hiển thị khi tải.
zoom optional
Loại: number optional
Thu phóng toàn cảnh, được chỉ định dưới dạng số. Mức thu phóng bằng 0 sẽ tạo ra 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
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 tùy chọn để hiển thị tùy chọn kiểm soát địa chỉ Chế độ xem phố.

position optional
Loại: ControlPosition optional
Id vị trí Id này được sử dụng để chỉ đị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.

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ệ (chẳng hạn như Thông tin xác thực) chỉ hoạt động khi các tiêu đề cors được đặt thích 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 cùng với cờ này, việc 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 sử dụng trong ảnh toàn cảnh Chế độ xem 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à các ô sẽ hiển thị.
worldSize
Loại: Size
Kích thước (tính bằng pixel) của toàn bộ ảnh toàn cảnh & quot; world"
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 của ô đã chỉ định.
Đây là phương thức tùy chỉnh mà bạn phải triển khai để cung cấp thẻ thông tin tùy chỉnh của mình. API gọi phương thức này, cung cấp các thông số sau:
pano là mã ảnh toàn cảnh của ô Chế độ xem phố.
tileZoom là mức thu phóng của ô.
tileX là tọa độ x của ô.
tileY là tọa độ y của ô.
Phương thức tùy 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

Một điểm xem đối tượng chỉ định hướng máy ảnh ở vị trí ảnh toàn cảnh của Chế độ xem phố. Cách xem được xác định dưới dạng tiêu đề và nội dung đề cử.

heading
Loại: number
Máy ảnh chuyển hướng 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
Góc quay máy ảnh tính theo độ, so với phương tiện 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.

StreetViewCoverageLayer
StreetViewCoverageLayer()
Thông số: Không có
Tạo một bản sao mới của StreetViewCoverageLayer.
getMap
getMap()
Thông số: Không có
Giá trị trả về: Map
Trả về bản đồ nơi 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 đồ đã chỉ định. Nếu bản đồ được đặt thành rỗng, lớp sẽ bị xóa.
Đã kế thừa: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll