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 đường phố.
Truy cập bằng cách gọi const {StreetViewService} = await google.maps.importLibrary("streetView")
. Xem phần Thư viện trong API Maps JavaScript.
Hàm dựng | |
---|---|
StreetViewService |
StreetViewService() Thông số: Không có
Tạo StreetViewService , cung cấp giao diện cho dữ liệu được lưu trữ trong dịch vụ Chế độ xem đường phố. |
Phương thức | |
---|---|
getPanorama |
getPanorama(request[, callback]) Thông số:
Giá trị trả về:
Promise<StreetViewResponse> Truy xuất StreetViewPanoramaData cho một ảnh toàn cảnh khớp với yêu cầu truy vấn Chế độ xem đường 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 do StreetViewService
trả về khi hoàn tất yêu cầu Chế độ xem đường phố. Bạn có thể chỉ định các hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. 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 API Maps JavaScript.
Hằng số | |
---|---|
OK |
Yêu cầu đã thành công. |
UNKNOWN_ERROR |
Không thể xử lý thành công yêu cầu này, nhưng không xác định được lý do chính xác. |
ZERO_RESULTS |
Không tìm thấy ảnh toàn cảnh nào khớp với tiêu chí tìm kiếm. |
Giao diện StreetViewLocationRequest
Giao diện google.maps.StreetViewLocationRequest
Yêu cầu Chế độ xem đường phố sẽ được gửi bằng getPanorama
. StreetViewLocationRequest
cho phép bạn tìm kiếm ảnh toàn cảnh Chế độ xem đường phố tại một vị trí cụ thể.
Thuộc tính | |
---|---|
location optional |
Loại:
LatLng|LatLngLiteral optional Chỉ định vị trí để tìm kiếm ảnh toàn cảnh trên Chế độ xem đường phố. |
preference optional |
Loại:
StreetViewPreference optional Đặt lựa chọn ưu tiên cho ảnh toàn cảnh cần tìm trong bán kính: ảnh gần nhất với vị trí đã cung cấp hoặc ảnh tốt nhất trong bán kính. |
radius optional |
Loại:
number optional Mặc định:
50 Đặt bán kính tính bằng mét để tìm ảnh toàn cảnh. |
|
Loại:
StreetViewSource optional Mặc định:
StreetViewSource.DEFAULT Chỉ định nguồn của ảnh toàn cảnh để tìm kiếm. Ví dụ: bạn có thể đặt giới hạn chỉ tìm kiếm ảnh toàn cảnh ngoài trời. |
sources optional |
Loại:
Iterable<StreetViewSource> optional Mặc định: [
StreetViewSource.DEFAULT ]Chỉ định nguồn của ảnh toàn cảnh để tìm kiếm. Ví dụ: bạn có thể đặt giới hạn chỉ tìm kiếm ảnh toàn cảnh ngoài trời. Việc đặt nhiều nguồn sẽ được đánh giá là giao điểm của các nguồn đó. |
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 đã chỉ định.
Thuộc tính | |
---|---|
pano optional |
Loại:
string optional Chỉ định mã nhận dạng ảnh toàn cảnh cần tìm. |
Giao diện StreetViewResponse
Giao diện google.maps.StreetViewResponse
Phản hồi đã được phân giải cho một Lời hứa từ StreetViewService.getPanorama
.
Thuộc tính | |
---|---|
data |
Loại:
StreetViewPanoramaData Biểu thị ảnh toàn cảnh. |
Giao diện StreetViewLocation
Giao diện google.maps.StreetViewLocation
Hình ảnh đại diện cho một vị trí trong ảnh toàn cảnh trên Chế độ xem đường phố.
Thuộc tính | |
---|---|
pano |
Loại:
string Giá trị nhận dạng duy nhất của ảnh toàn cảnh. Giá trị này ổn định trong một phiên nhưng không ổn định giữa các phiên. |
description optional |
Loại:
string optional Chuỗi đã bản địa hoá mô tả vị trí. |
latLng optional |
Loại:
LatLng optional Vị trí latlng của ảnh toàn cảnh. |
shortDescription optional |
Loại:
string optional Nội dung mô tả ngắn về vị trí. |
Hằng số StreetViewPreference
Hằng số google.maps.StreetViewPreference
Các tuỳ chọn làm cho kết quả tìm kiếm có xu hướng trả về một ảnh toàn cảnh Chế độ xem đường phố gần nhất với vị trí yêu cầu hoặc một ảnh toàn cảnh được coi là có nhiều khả năng nhất là nội dung mà người dùng muốn xem. Chỉ định các hằng này theo giá trị hoặc bằng cách sử dụng tên của hằng. 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 API Maps JavaScript.
Hằng số | |
---|---|
BEST |
Trả về hình ảnh toàn cảnh trên Chế độ xem đường phố được coi là hình ảnh mà người dùng muốn xem nhất. 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à các thông số như điểm yêu thích được nhận dạng, chất lượng hình ảnh và khoảng cách từ vị trí đã cho. |
NEAREST |
Trả về ảnh toàn cảnh Chế độ xem đường phố có khoảng cách ngắn nhất từ vị trí được cung cấp. Phương thức này chỉ hoạt động tốt trong một bán kính giới hạn. Bán kính đề 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 nội dung tìm kiếm trên Chế độ xem đường 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 API Maps JavaScript.
Hằng số | |
---|---|
DEFAULT |
Sử dụng các nguồn mặc định của Chế độ xem đường phố, nội dung tìm kiếm sẽ không bị giới hạn ở một số nguồn cụ thể. |
GOOGLE |
Giới hạn nội dung tìm kiếm trên Chế độ xem đường phố ở các bộ sưu tập chính thức của Google. |
OUTDOOR |
Giới hạn nội dung tìm kiếm trên Chế độ xem đường phố ở các 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, hãy lưu ý rằng tính năng tìm kiếm chỉ trả về những bức ảnh toàn cảnh mà bạn có thể xác định được là trong nhà hay ngoài trời. Ví dụ: Ảnh toàn cảnh 360 độ không được trả về vì không xác định được ảnh đó được chụp trong nhà hay ngoài trời. |
Giao diện StreetViewPanoramaData
Giao diện google.maps.StreetViewPanoramaData
Biểu thị ảnh toàn cảnh được trả về từ nhà cung cấp được xác định bằng registerPanoProvider
.
Thuộc tính | |
---|---|
tiles |
Loại:
StreetViewTileData Chỉ định thẻ thông tin tuỳ 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 mà hình ảnh trong ảnh toàn cảnh này được thu thập. Chuỗi ngày ở định dạng YYYY-MM. |
links optional |
Loại:
Array<StreetViewLink> optional Chỉ định các đường liên kết điều hướng đến ảnh toàn cảnh liền kề. |
location optional |
Loại:
StreetViewLocation optional Chỉ đị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
Một tập hợp các tệp tham chiếu đến ảnh toàn cảnh Chế độ xem đường phố liền kề.
Thuộc tính | |
---|---|
description optional |
Loại:
string optional Chuỗi đã 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 của ảnh toàn cảnh. Mã nhận dạng này ổn định trong một phiên nhưng không ổn định giữa các phiên. |