Lớp StreetViewService
Lớp google.maps.StreetViewService
Một đối tượng StreetViewService
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 Thư viện trong API JavaScript Maps.
Hàm dựng | |
---|---|
StreetViewService |
StreetViewService() Tham số: Không có
Tạo một StreetViewService , cung cấp giao diện với dữ liệu được lưu trữ trong dịch vụ Chế độ xem đường phố. |
Phương thức | |
---|---|
getPanorama |
getPanorama(request[, callback]) Các 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 đườ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 được StreetViewService
trả về khi hoàn tất một yêu cầu về Chế độ xem đường phố. Bạn có thể chỉ định các biến này theo giá trị hoặc bằng cách sử dụng tên 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 Thư viện trong API JavaScript Maps.
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 lý do chính xác cho lỗi này chưa được xác định. |
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 Chế độ xem đường phố sẽ được gửi cùng với getPanorama
. StreetViewLocationRequest
cho phép bạn tìm kiếm ảnh toàn cảnh của 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í nơi tìm kiếm ảnh toàn cảnh trong Chế độ xem đường phố. |
preference optional |
Loại:
StreetViewPreference optional Đặt một lựa chọn ưu tiên cho ảnh toàn cảnh mà bạn sẽ tìm thấy trong bán kính: địa điểm gần nhất với vị trí được cung cấp hoặc địa điểm phù hợp nhất trong phạm vi 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 mà bạn muốn tìm kiế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ụ: điều này cho phép hạn chế 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 các nguồn của ảnh toàn cảnh để tìm kiếm. Ví dụ: điều này cho phép hạn chế 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à phần giao nhau của các nguồn đó. |
Giao diện StreetViewPanoRequest
Giao diện google.maps.StreetViewPanoRequest
StreetViewPanoRequest
được dùng cù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 toàn cảnh cần tìm kiếm. |
Giao diện StreetViewResponse
Giao diện google.maps.StreetViewResponse
Phản hồi đã được giải quyết cho một Lời hứa của StreetViewService.getPanorama
.
Thuộc tính | |
---|---|
data |
Loại:
StreetViewPanoramaData Ảnh đại diện của một ả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 của 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. Mã này ổn định trong một phiên nhưng không ổn định trong các phiên. |
description optional |
Loại:
string optional Chuỗi được bản địa hoá mô tả vị trí. |
latLng optional |
Loại:
LatLng optional K.độ 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 lựa chọn làm lệch kết quả tìm kiếm khi trả về ảnh toàn cảnh trong Chế độ xem đường phố gần vị trí yêu cầu nhất hoặc ảnh toàn cảnh được coi là có nhiều khả năng nhất là nội dung người dùng muốn xem. Hãy chỉ định các biến này theo giá trị hoặc bằng cách sử 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 Thư viện trong API JavaScript Maps.
Hằng số | |
---|---|
BEST |
Trả về ảnh toàn cảnh trong Chế độ xem đường phố, được xem là có nhiều khả năng nhất là những gì 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 về người dùng và các thông số như các địa điểm yêu thích được công nhận, chất lượng ảnh và khoảng cách từ vị trí đó. |
NEAREST |
Trả về khoảng cách ngắn nhất từ vị trí đã cung cấp trong Chế độ xem đường phố. Cấu hình này chỉ hoạt động trong phạm vi 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 các lượt tìm kiếm trong 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 Thư viện trong API JavaScript Maps.
Hằng số | |
---|---|
DEFAULT |
Sử dụng các nguồn mặc định của Chế độ xem đường phố, các lượt tìm kiếm sẽ không bị giới hạn ở các nguồn cụ thể. |
GOOGLE |
Giới hạn tìm kiếm trong Chế độ xem đường phố đối với các bộ sưu tập chính thức của Google. |
OUTDOOR |
Giới hạn số lượt tìm kiếm trong Chế độ xem đường phố đối với các bộ sưu tập ngoài trời. Các bộ sưu tập trong nhà không có trong kết quả tìm kiếm. Ngoài ra, xin lưu ý rằng tính năng tìm kiếm chỉ trả về ảnh toàn cảnh khi có thể xác định được là ảnh đ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 đang ở trong nhà hay ngoài trời. |
Giao diện StreetViewPanoramaData
Giao diện google.maps.StreetViewPanoramaData
Ảnh đại diện của ảnh toàn cảnh được trả về từ trình cung cấp được xác định bằng registerPanoProvider
.
Thuộc tính | |
---|---|
tiles |
Loại:
StreetViewTileData Chỉ định các ô 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 có dạng YYYY-MM. |
links optional |
Loại:
Array<StreetViewLink> optional Chỉ định các liên kết điều hướng đến các ả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
Bộ sưu tập tham chiếu đến ảnh toàn cảnh liền kề của Chế độ xem đường phố.
Thuộc tính | |
---|---|
description optional |
Loại:
string optional Chuỗi được bản địa hoá mô tả 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ã này ổn định trong một phiên nhưng không ổn định trong các phiên. |