Lớp StreetViewService
Lớp google.maps.StreetViewService
Đối tượng StreetViewService
thực hiện tìm kiếm dữ liệu Chế độ xem phố.
Truy cập bằng cách gọi const {StreetViewService} = await google.maps.importLibrary("streetView")
. Xem phần Thư viện trong Maps JavaScript API.
Hàm dựng | |
---|---|
StreetViewService |
StreetViewService() Thông số: Không có
Tạo một StreetViewService , cung cấp giao diện cho dữ liệu được lưu trữ trong dịch vụ Chế độ xem phố. |
Phương pháp | |
---|---|
getPanorama |
getPanorama(request[, callback]) Thông số:
Giá trị trả về:
Promise<StreetViewResponse> Truy xuất StreetViewPanoramaData cho ảnh toàn cảnh khớp với yêu cầu truy vấn Chế độ xem phố đã cung cấp. StreetViewPanoramaData được truyền đến lệnh gọi lại đã cung cấp. |
Hằng số StreetViewStatus
Hằng số google.maps.StreetViewStatus
Trạng thái mà StreetViewService
trả về khi hoàn thành yêu cầu Chế độ xem phố. Bạn có thể chỉ định các giá trị này theo giá trị hoặc bằng cách sử dụng tên của hằng số. Ví dụ: 'OK'
hoặc google.maps.StreetViewStatus.OK
.
Truy cập bằng cách gọi const {StreetViewStatus} = await google.maps.importLibrary("streetView")
. Xem phần Thư viện trong Maps JavaScript API.
Các hằng số | |
---|---|
OK |
Yêu cầu thành công. |
UNKNOWN_ERROR |
Không thể xử lý yêu cầu thành công, nhưng vẫn chưa xác định được lý do chính xác cho lỗi. |
ZERO_RESULTS |
Không tìm thấy ảnh toàn cảnh nào phù hợp với tiêu chí tìm kiếm. |
Giao diện StreetViewLocationRequest
Giao diện google.maps.StreetViewLocationRequest
Yêu cầu của Chế độ xem phố sẽ được gửi bằng getPanorama
. StreetViewLocationRequest
cho phép bạn tìm thông tin về toàn cảnh của Chế độ xem phố tại một vị trí được chỉ định.
Thuộc tính | |
---|---|
location optional |
Loại:
LatLng|LatLngLiteral optional Chỉ định vị trí tìm kiếm ảnh toàn cảnh trong Chế độ xem phố. |
preference optional |
Loại:
StreetViewPreference optional Đặt lựa chọn ưu tiên để tìm ảnh toàn cảnh trong bán kính: vị trí gần nhất với vị trí được cung cấp hoặc vị trí tốt nhất trong bán kính. |
radius optional |
Loại:
number optional Mặc định:
50 Đặt bán kính theo mét để tìm kiếm ảnh toàn cảnh. |
source optional |
Loại:
StreetViewSource optional Mặc định:
StreetViewSource.DEFAULT Chỉ định nguồn ảnh toàn cảnh để tìm kiếm. Ví dụ: thao tác này cho phép hạn chế tìm kiếm ảnh toàn cảnh ngoài trời. |
Giao diện StreetViewPanoRequest
Giao diện google.maps.StreetViewPanoRequest
StreetViewPanoRequest
được dùng với getPanorama
để tìm ảnh toàn cảnh có mã nhận dạng được chỉ định.
Thuộc tính | |
---|---|
pano optional |
Loại:
string optional Chỉ định mã nhận dạng CEC cần tìm. |
Giao diện StreetViewResponse
Giao diện google.maps.StreetViewResponse
Phản hồi đã được giải quyết cho Lời hứa từ StreetViewService.getPanorama
.
Thuộc tính | |
---|---|
data |
Loại:
StreetViewPanoramaData Hình ảnh mô tả toàn cảnh. |
Giao diện StreetViewLocation
Giao diện google.maps.StreetViewLocation
Một hình ảnh thể hiện về một vị trí trong ảnh toàn cảnh của Chế độ xem phố.
Thuộc tính | |
---|---|
pano |
Loại:
string Giá trị nhận dạng duy nhất cho ảnh toàn cảnh. Mức độ ổn định này trong một phiên hoạt động nhưng không ổn định trong các phiên hoạt động. |
description optional |
Loại:
string optional Một chuỗi đã được bản địa hoá mô tả vị trí. |
latLng optional |
Loại:
LatLng optional Độ trễ của ảnh toàn cảnh. |
shortDescription optional |
Loại:
string optional Mô tả ngắn về vị trí. |
Hằng số StreetViewPreference
Hằng số google.maps.StreetViewPreference
Các lựa chọn làm sai lệch kết quả tìm kiếm về việc trả về ảnh toàn cảnh trong Chế độ xem phố gần vị trí yêu cầu nhất hoặc ảnh toàn cảnh được xem là có nhiều khả năng là nội dung mà người dùng muốn xem. Bạn có thể chỉ định các giá trị này theo giá trị hoặc bằng cách dùng tên của hằng số. Ví dụ: 'best'
hoặc google.maps.StreetViewPreference.BEST
.
Truy cập bằng cách gọi const {StreetViewPreference} = await google.maps.importLibrary("streetView")
. Xem phần Thư viện trong Maps JavaScript API.
Các hằng số | |
---|---|
BEST |
Trả về ảnh toàn cảnh trong Chế độ xem phố được coi là có nhiều khả năng là nội dung người dùng muốn xem. Kết quả tốt nhất được xác định bằng thuật toán dựa trên nghiên cứu người dùng và thông số như điểm quan tâm được công nhận, chất lượng hình ảnh và khoảng cách từ vị trí đã cho. |
NEAREST |
Trả về ảnh toàn cảnh trong Chế độ xem phố mà quãng đường ngắn nhất từ vị trí được cung cấp. Tính năng này chỉ hoạt động tốt trong bán kính giới hạn. Bán kính được đề xuất là từ 1 km trở xuống. |
Hằng số StreetViewSource
Hằng số google.maps.StreetViewSource
Giá trị nhận dạng để giới hạn số lượt tìm kiếm trong Chế độ xem phố ở các nguồn đã chọn. Các giá trị này được chỉ định dưới dạng chuỗi. Ví dụ: 'outdoor'
.
Truy cập bằng cách gọi const {StreetViewSource} = await google.maps.importLibrary("streetView")
. Xem phần Thư viện trong Maps JavaScript API.
Các hằng số | |
---|---|
DEFAULT |
Sử dụng các nguồn mặc định của Chế độ xem phố, các tìm kiếm sẽ không bị giới hạn ở các nguồn cụ thể. |
OUTDOOR |
Giới hạn tìm kiếm trong Chế độ xem phố trong bộ sưu tập ngoài trời. Các bộ sưu tập trong nhà không được đưa vào kết quả tìm kiếm. Ngoài ra, xin lưu ý rằng kết quả tìm kiếm chỉ trả về những ảnh toàn cảnh mà bạn có thể xác định xem chúng đang ở trong nhà hay ngoài trời. Ví dụ: PhotoSpheres không được trả về vì không xác định được chúng là trong nhà hay ngoài trời. |
Giao diện StreetViewAmbientData
Giao diện google.maps.StreetViewPanoramaData
Giá trị thể hiện ảnh toàn cảnh được trả về từ nhà cung cấp đã xác định bằng registerPanoProvider
.
Thuộc tính | |
---|---|
tiles |
Loại:
StreetViewTileData Chỉ định các ô tùy chỉnh cho ảnh toàn cảnh này. |
copyright optional |
Loại:
string optional Chỉ định văn bản bản quyền cho ảnh toàn cảnh này. |
imageDate optional |
Loại:
string optional Chỉ định năm và tháng thu thập hình ảnh trong ảnh toàn cảnh này. Chuỗi ngày có dạng YYYY-MM. |
links optional |
Loại:
Array<StreetViewLink> optional Chỉ định liên kết điều hướng đến ảnh toàn cảnh liền kề. |
location optional |
Loại:
StreetViewLocation optional Xác định siêu dữ liệu vị trí cho ảnh toàn cảnh này. |
Giao diện StreetViewLink
Giao diện google.maps.StreetViewLink
Bộ sưu tập tham chiếu đến các ảnh chụp nhanh liên quan đến Chế độ xem phố.
Thuộc tính | |
---|---|
description optional |
Loại:
string optional Một chuỗi đã được bản địa hoá mô tả đường liên kết. |
heading optional |
Loại:
number optional Tiêu đề của đường liên kết. |
pano optional |
Loại:
string optional Giá trị nhận dạng duy nhất cho ảnh toàn cảnh. Mã này ổn định trong một phiên nhưng không ổn định trong các phiên. |