Lớp StreetViewService
lớp
google.maps.StreetViewService
thư viện "streetView"
Đối tượng StreetViewService thực hiện tìm kiếm dữ liệu Chế độ xem đường phố.
const {StreetViewService} = await google.maps.importLibrary("streetView");
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ụ Chế độ xem đường phố. |
Phương thức | |
|---|---|
getPanorama |
getPanorama(request[, callback])Tham 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ố đượ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
thư viện "streetView"
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 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
Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại StreetViewStatusString.
const {StreetViewStatus} = await google.maps.importLibrary("streetView");
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, nhưng chưa rõ lý do chính xác khiến yêu cầu không thành công. |
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 về 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 ở Chế độ xem đường phố tại một vị trí cụ thể.
Thuộc tính | |
|---|---|
location
không bắt buộc |
Loại:
LatLng|LatLngLiteral optionalChỉ định vị trí để tìm ảnh toàn cảnh trong Chế độ xem đường phố. |
preference
không bắt buộc |
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 đẹp nhất trong bán kính. |
radius
không bắt buộc |
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. |
không bắt buộc |
Loại:
StreetViewSource optionalMặc định:
StreetViewSource.DEFAULTChỉ định nguồn ảnh toàn cảnh cần tìm kiếm. Ví dụ: điều này cho phép hạn chế tìm kiếm chỉ đối với ảnh toàn cảnh ngoài trời. |
sources
không bắt buộc |
Loại:
Iterable<StreetViewSource> optionalMặc định: [
StreetViewSource.DEFAULT]Chỉ định nguồn ảnh toàn cảnh cần tìm kiếm. Ví dụ: điều này cho phép hạn chế tìm kiếm chỉ đối với ả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 được chỉ định.
Thuộc tính | |
|---|---|
pano
không bắt buộc |
Loại:
string optionalChỉ định mã nhận dạng ảnh toàn cảnh cần tìm. |
StreetViewResponse
giao diện
google.maps.StreetViewResponse
Phản hồi được phân giải cho một Promise từ StreetViewService.getPanorama.
Thuộc tính | |
|---|---|
data |
Loại:
StreetViewPanoramaDataBiểu diễn ả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 trong 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
không bắt buộc |
Loại:
string optionalMột chuỗi được bản địa hoá mô tả vị trí. |
latLng
không bắt buộc |
Loại:
LatLng optionalVĩ độ và kinh độ của ảnh toàn cảnh. |
shortDescription
không bắt buộc |
Loại:
string optionalNội dung mô tả ngắn về vị trí. |
Hằng số StreetViewPreference
hằng số
google.maps.StreetViewPreference
thư viện "streetView"
Các lựa chọn ưu tiên trả về kết quả tìm kiếm là ảnh toàn cảnh trong Chế độ xem đường phố gần nhất với vị trí yêu cầu hoặc ảnh toàn cảnh được coi là có nhiều khả năng nhất là ảnh mà người dùng muốn xem. 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.
Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại StreetViewPreferenceString.
const {StreetViewPreference} = await google.maps.importLibrary("streetView");
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à nội dung mà người dùng muốn xem. Kết quả phù hợp 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ư địa đ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 trong Chế độ xem đường phố có khoảng cách ngắn nhất từ vị trí được cung cấp. Cách này chỉ hiệu quả trong một bán kính giới hạn. Bán kính đề xuất là 1 km trở xuống. |
Hằng số StreetViewSource
hằng số
google.maps.StreetViewSource
thư viện "streetView"
Giá trị nhận dạng để giới hạn nội dung 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'.
Bạn cũng có thể sử dụng các hằng số này dưới dạng chuỗi. Trong TypeScript, giá trị cố định kiểu chuỗi được xác định bằng loại StreetViewSourceString.
const {StreetViewSource} = await google.maps.importLibrary("streetView");
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 ở các nguồn cụ thể. |
GOOGLE |
Giới hạn phạm vi tìm kiếm trong Chế độ xem đường phố ở các bộ sưu tập chính thức của Google. |
OUTDOOR |
Giới hạn phạm vi tìm kiếm trong Chế độ xem đường phố ở các bộ sưu tập ngoài trời. Bộ sưu tập trong nhà không có trong kết quả tìm kiếm. Cũng xin lưu ý rằng kết quả tìm kiếm chỉ trả về những ảnh toàn cảnh có thể xác định được là trong nhà hay ngoài trời. Ví dụ: PhotoSpheres không được trả về vì không biết chúng ở 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:
StreetViewTileDataChỉ định các ô tuỳ chỉnh cho ảnh toàn cảnh này. |
copyright
không bắt buộc |
Loại:
string optionalChỉ định văn bản bản quyền cho ảnh toàn cảnh này. |
imageDate
không bắt buộc |
Loại:
string optionalChỉ đị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
không bắt buộc |
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
không bắt buộc |
Loại:
StreetViewLocation optionalChỉ đị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
Tập hợp các tệp đối chiếu với ảnh toàn cảnh liền kề trong Chế độ xem đường phố.
Thuộc tính | |
|---|---|
description
không bắt buộc |
Loại:
string optionalMột chuỗi được bản địa hoá mô tả đường liên kết. |
heading
không bắt buộc |
Loại:
number optionalTiêu đề của đường liên kết. |
pano
không bắt buộc |
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. |