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 Thư viện trong Maps JavaScript API.
Hàm dựng | |
|---|---|
StreetViewService |
StreetViewService()Tham 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ụ Street View. |
Phương thức | |
|---|---|
getPanorama |
getPanorama(request[, callback])Tham 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ố được 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 một yêu cầu về Chế độ xem đường 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 Thư viện trong Maps JavaScript API.
Hằng số | |
|---|---|
OK |
Yêu cầu đã được thực hiện thành công. |
UNKNOWN_ERROR |
Không xử lý được yêu cầu, nhưng không rõ lý do chính xác gây ra lỗi. |
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
google.maps.StreetViewLocationRequestgiao diện
Yêu cầu về Chế độ xem đường phố sẽ được gửi kèm theo getPanorama. StreetViewLocationRequest cho phép bạn tìm kiếm ảnh toàn cảnh trong Chế độ xem đường phố tại một vị trí cụ thể.
Thuộc tính | |
|---|---|
location optional |
Loại:
LatLng|LatLngLiteral optionalChỉ định vị trí để tìm ảnh toàn cảnh trong 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 vị trí được cung cấp nhất hoặc ảnh phù hợp nhất trong bán kính. |
radius optional |
Loại:
number optionalMặc định:
50Đặt bán kính (tính bằng mét) để tìm ảnh toàn cảnh. |
|
Loại:
StreetViewSource optionalMặc định:
StreetViewSource.DEFAULTChỉ định nguồn của ảnh toàn cảnh để tìm kiếm. Ví dụ: điều này cho phép bạn hạn chế tìm kiếm chỉ ảnh toàn cảnh ngoài trời. |
sources optional |
Loại:
Iterable<StreetViewSource> optionalMặ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 bạn hạn chế tìm kiếm chỉ ảnh toàn cảnh ngoài trời. Việc thiết lập nhiều nguồn sẽ được đánh giá là giao điểm của các nguồn đó. |
Giao diện StreetViewPanoRequest
google.maps.StreetViewPanoRequestgiao diện
StreetViewPanoRequest được dùng với getPanorama để tìm ảnh toàn cảnh có mã nhận dạng cụ thể.
Thuộc tính | |
|---|---|
pano optional |
Loại:
string optionalChỉ định mã nhận dạng toàn cảnh cần tìm. |
Giao diện StreetViewResponse
google.maps.StreetViewResponsegiao diện
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:
StreetViewPanoramaDataHình ảnh minh hoạ về ảnh toàn cảnh. |
Giao diện StreetViewLocation
google.maps.StreetViewLocationgiao diện
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:
stringGiá trị nhận dạng riêng biệ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 optionalMột chuỗi được bản địa hoá mô tả vị trí. |
latLng optional |
Loại:
LatLng optionalLatlng của ảnh toàn cảnh. |
shortDescription optional |
Loại:
string optionalNộ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 thiên về việc trả về một ảnh toàn cảnh Chế độ xem đường phố gần nhất với vị trí được yêu cầu hoặc một ảnh toàn cảnh được coi là có nhiều khả năng là nội dung mà người dùng muốn xem nhất. 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ụ: '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 Maps JavaScript API.
Hằng số | |
|---|---|
BEST |
Trả về ảnh toàn cảnh trong Chế độ xem đường phố được coi là có nhiều khả năng nhất là ảnh mà người dùng muốn xem. Kết quả tốt nhất được xác định bằng các thuật toán dựa trên nghiên cứu người dùng và các thông số như địa điểm đượ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. Tính năng này chỉ hoạt động hiệu quả trong một bán kính giới hạn. Bán kính được đề xuất là 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 cụm 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 Maps JavaScript API.
Hằng số | |
|---|---|
DEFAULT |
Sử dụng các nguồn mặc định của Chế độ xem đường phố, các cụm từ tìm kiếm sẽ không bị giới hạn ở các nguồn cụ thể. |
GOOGLE |
Giới hạn các cụm từ 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 các cụm từ tìm kiếm trong Chế độ xem đường phố đối với bộ sưu tập ngoài trời. Bộ sưu tập trong nhà không xuất hiện trong kết quả tìm kiếm. Xin lưu ý rằng chế độ tìm kiếm này chỉ trả về những ảnh toàn cảnh mà bạn có thể xác định được là ảnh trong nhà hay ngoài trời. Ví dụ: PhotoSphere không được trả về vì không xác định được liệu chúng có ở trong nhà hay ngoài trời. |
Giao diện StreetViewPanoramaData
google.maps.StreetViewPanoramaDatagiao diện
Hình ảnh toàn cảnh do nhà cung cấp trả về, được xác định bằng cách sử dụng registerPanoProvider.
Thuộc tính | |
|---|---|
tiles |
Loại:
StreetViewTileDataChỉ định các ô tuỳ chỉnh cho ảnh toàn cảnh này. |
copyright optional |
Loại:
string optionalChỉ định văn bản bản quyền cho ảnh toàn cảnh này. |
imageDate optional |
Loại:
string optionalChỉ định năm và tháng mà hình ảnh trong ảnh toàn cảnh này được chụp. Chuỗi ngày ở định dạng YYYY-MM. |
links optional |
Loại:
Array<StreetViewLink> optionalChỉ đị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 optionalChỉ định siêu dữ liệu vị trí cho ảnh toàn cảnh này. |
Giao diện StreetViewLink
google.maps.StreetViewLinkgiao diện
Một tập hợp các thông tin tham chiếu đến ảnh toàn cảnh liền kề trong Chế độ xem đường phố.
Thuộc tính | |
|---|---|
description optional |
Loại:
string optionalMột chuỗi được bản địa hoá mô tả đường liên kết. |
heading optional |
Loại:
number optionalTiêu đề của đường liên kết. |
pano optional |
Loại:
string optionalGiá trị nhận dạng riêng biệ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. |