Service

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ố:  request:  StreetViewLocationRequest|StreetViewPanoRequest callback:  function(StreetViewPanoramaData optional, StreetViewStatus): void optional 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 optional Chỉ đị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 optional Mặc định: 50 Đặt bán kính (tính bằng mét) để tìm ảnh toàn cảnh.
source optional	Không dùng nữa: Thay vào đó, hãy sử dụng sources. 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 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> 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 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 optional Chỉ đị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:  StreetViewPanoramaData Hì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:  string Giá 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 optional Một chuỗi được bản địa hoá mô tả vị trí.
latLng optional	Loại:  LatLng optional 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 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:  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 chụ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

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 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 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.