- Tài nguyên: Ảnh
- Mã ảnh
- Tải tệp tham chiếu lên
- Tư thế
- LatLng
- Cấp độ
- Kết nối
- Địa điểm
- Trạng thái chuyển
- Trạng thái phát hành bản đồ
- Phương thức
Tài nguyên: Ảnh
Ảnh dùng để lưu trữ ảnh 360 độ cùng với siêu dữ liệu ảnh.
Biểu diễn dưới dạng JSON |
---|
{ "photoId": { object ( |
Các trường | |
---|---|
photoId |
Bắt buộc. Chỉ đầu ra. Bắt buộc khi cập nhật ảnh. Chỉ xuất khi tạo ảnh. Giá trị nhận dạng của ảnh là duy nhất trong số tất cả ảnh trên Google. |
uploadReference |
Chỉ nhập. Bắt buộc khi tạo ảnh. Chỉ nhập. URL tài nguyên nơi các byte ảnh được tải lên. |
downloadUrl |
Chỉ đầu ra. URL tải xuống cho các byte ảnh. Trường này chỉ được đặt khi bạn đặt |
thumbnailUrl |
Chỉ đầu ra. URL hình thu nhỏ để hiển thị bản xem trước của ảnh đã cho. |
shareLink |
Chỉ đầu ra. Đường liên kết chia sẻ của ảnh. |
pose |
Không bắt buộc. Tư thế của bức ảnh. |
connections[] |
Không bắt buộc. Kết nối với các ảnh khác. Kết nối thể hiện liên kết từ ảnh này đến ảnh khác. |
captureTime |
Không bắt buộc. Thời gian tuyệt đối khi ảnh được chụp. Khi ảnh không có dấu thời gian exif, chế độ này dùng để đặt dấu thời gian trong siêu dữ liệu ảnh. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: |
uploadTime |
Chỉ đầu ra. Thời gian tải hình ảnh lên. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: |
places[] |
Không bắt buộc. Những địa điểm có ảnh này. |
viewCount |
Chỉ đầu ra. Số lượt xem ảnh. |
transferStatus |
Chỉ đầu ra. Trạng thái chuyển nhượng quyền đối với ảnh này. |
mapsPublishStatus |
Chỉ đầu ra. Trạng thái trong Google Maps, cho dù ảnh này đã được xuất bản hay bị từ chối. |
Mã ảnh
Giá trị nhận dạng cho Photo
.
Biểu diễn dưới dạng JSON |
---|
{ "id": string } |
Các trường | |
---|---|
id |
Giá trị nhận dạng duy nhất của ảnh. |
Tham khảo Tải lên
Tải lên tham chiếu cho các tệp phương tiện.
Biểu diễn dưới dạng JSON |
---|
{ // Union field |
Các trường | |
---|---|
Trường nhóm file_source . Bắt buộc. file_source chỉ có thể là một trong những loại sau đây: |
|
uploadUrl |
Tham chiếu tải lên phải là duy nhất cho mỗi người dùng. Bản phát hành tuân theo biểu mẫu: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}" |
Tư thế
Đo kiểu dáng thô cho một thực thể.
Biểu diễn dưới dạng JSON |
---|
{ "latLngPair": { object ( |
Các trường | |
---|---|
latLngPair |
Cặp vĩ độ và kinh độ của tư thế, như được giải thích tại đây: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng Khi tạo |
altitude |
Độ cao của tư thế tính bằng mét trên ellipsoid WGS84. NaN biểu thị số lượng không được đo lường. |
heading |
Các thông số tư thế sau liên quan đến trung tâm ảnh. Chúng khớp với https://developers.google.com/streetview/spherical-metadata. Tiêu đề la bàn, được đo tại chính giữa ảnh theo độ theo chiều kim đồng hồ từ hướng Bắc. Giá trị phải >=0 và <360. NaN biểu thị số lượng không được đo lường. |
pitch |
Độ cao, được đo ở chính giữa ảnh theo độ. Giá trị phải >=-90 và <= 90. Giá trị -90 nghĩa là nhìn thẳng xuống và giá trị 90 nghĩa là nhìn thẳng lên trên. NaN biểu thị số lượng không được đo lường. |
roll |
Cuộn, được đo bằng độ. Giá trị phải >= 0 và <360. Giá trị 0 nghĩa là tương đương với đường chân trời. NaN biểu thị số lượng không được đo lường. |
gpsRecordTimestampUnixEpoch |
Thời gian của bản ghi GPS kể từ epoch UTC. Dấu thời gian ở định dạng "Zulu" RFC3339 UTC, với độ phân giải nano giây và tối đa chín chữ số phân số. Ví dụ: |
level |
Tầng (tầng trong tòa nhà) được sử dụng để định cấu hình điều hướng dọc. |
accuracyMeters |
Độ chính xác theo chiều ngang ước tính của tư thế này tính bằng mét với độ tin cậy 68% (một độ lệch chuẩn). Ví dụ: trên Android, giá trị này có sẵn từ phương thức sau: https://developer.android.com/reference/android/location/Location#getaccuracy(). Các nền tảng khác có các phương pháp để ước tính độ chính xác tương tự. |
LatLng
Một đối tượng đại diện cho một cặp vĩ độ/kinh độ. Giá trị này được biểu thị bằng một cặp số đôi để biểu thị vĩ độ và kinh độ. Đối tượng này phải tuân thủ tiêu chuẩn WGS84, trừ khi có quy định khác. Giá trị phải nằm trong phạm vi chuẩn hóa.
Biểu diễn dưới dạng JSON |
---|
{ "latitude": number, "longitude": number } |
Các trường | |
---|---|
latitude |
Vĩ độ theo độ. Giá trị phải nằm trong phạm vi [-90.0, +90.0]. |
longitude |
Kinh độ theo độ. Giá trị này phải nằm trong phạm vi [-180.0, +180.0]. |
Cấp độ
Thông tin cấp chứa số cấp và tên tương ứng của cấp.
Biểu diễn dưới dạng JSON |
---|
{ "number": number, "name": string } |
Các trường | |
---|---|
number |
Không bắt buộc. Số tầng, dùng để đặt hàng. 0 biểu thị độ cao mặt đất, 1 biểu thị độ cao đầu tiên so với mặt đất, -1 biểu thị độ cao đầu tiên so với mặt đất. Giá trị không phải là số nguyên được chấp nhận. |
name |
Bắt buộc. Tên được gán cho Cấp này, giới hạn ở 3 ký tự. Hãy cân nhắc cách gắn nhãn các nút thang máy cho tầng này nếu có thang máy. |
Sự kết nối
Kết nối là liên kết từ ảnh nguồn đến ảnh đích.
Biểu diễn dưới dạng JSON |
---|
{
"target": {
object ( |
Các trường | |
---|---|
target |
Bắt buộc. Điểm đến kết nối từ ảnh chứa đến một ảnh khác. |
Địa điểm
Đặt siêu dữ liệu cho một đối tượng.
Biểu diễn dưới dạng JSON |
---|
{ "placeId": string, "name": string, "languageCode": string } |
Các trường | |
---|---|
placeId |
Giá trị nhận dạng địa điểm, như mô tả trong https://developers.google.com/places/place-id. |
name |
Chỉ đầu ra. Tên của địa điểm, được bản địa hoá sang languageCode. |
languageCode |
Chỉ đầu ra. Mã ngôn ngữ mà tên được bản địa hóa. Đây phải là languageCode được chỉ định trong yêu cầu, nhưng có thể là một mã dự phòng. |
Trạng thái chuyển
Trạng thái chuyển quyền.
Enum | |
---|---|
TRANSFER_STATUS_UNKNOWN |
Chưa chỉ định trạng thái của quá trình chuyển này. |
NEVER_TRANSFERRED |
Ảnh này chưa từng được chuyển. |
PENDING |
Quá trình chuyển ảnh này đã bắt đầu nhưng người nhận chưa phản hồi. |
COMPLETED |
Đã hoàn tất quá trình chuyển ảnh và ảnh này đã được chuyển cho người nhận. |
REJECTED |
Người nhận đã từ chối yêu cầu chuyển ảnh này. |
EXPIRED |
Quá trình chuyển ảnh đã hết hạn trước khi người nhận thực hiện bất kỳ hành động nào. |
CANCELLED |
Người gửi đã huỷ việc chuyển ảnh này. |
RECEIVED_VIA_TRANSFER |
Người nhận sở hữu ảnh này do chuyển nhượng quyền. |
Trạng thái xuất bản trên Maps
Trạng thái xuất bản của ảnh trong Google Maps.
Enum | |
---|---|
UNSPECIFIED_MAPS_PUBLISH_STATUS |
Trạng thái của ảnh không xác định. |
PUBLISHED |
Ảnh được xuất bản công khai thông qua Google Maps. |
REJECTED_UNKNOWN |
Ảnh đã bị từ chối vì lý do không xác định. |
Phương thức |
|
---|---|
|
Sau khi khách hàng hoàn tất việc tải ảnh lên bằng UploadRef được trả về, CreatePhoto sẽ xuất bản Photo đã tải lên Chế độ xem phố trên Google Maps. |
|
Xoá Photo và siêu dữ liệu của tệp đó. |
|
Lấy siêu dữ liệu của Photo được chỉ định. |
|
Tạo một phiên tải lên để bắt đầu tải lên byte ảnh. |
|
Cập nhật siêu dữ liệu của Photo , chẳng hạn như tư thế, mối liên kết địa điểm, mối liên kết, v.v. |