Package google.streetview.publish.v1

索引

StreetViewPublishService

在街景服務上發布並連結使用者提供的相片。

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

刪除 Photos 清單及其中繼資料。

請注意,如果 BatchDeletePhotos 失敗,可能是缺少重要欄位或發生驗證錯誤。即使 BatchDeletePhotos 成功,批次中的個別相片仍可能失敗。這些失敗作業會於 BatchDeletePhotosResponse.results 的每個 PhotoResponse.status 中指明。如要瞭解每張相片可能發生的特定錯誤情形,請參閱 DeletePhoto

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

取得指定 Photo 批次的中繼資料。

請注意,如果 BatchGetPhotos 失敗,可能是缺少重要欄位或發生驗證錯誤。即使 BatchGetPhotos 成功,批次中的個別相片仍可能失敗。這些失敗作業會於 BatchGetPhotosResponse.results 的每個 PhotoResponse.status 中指明。如要瞭解每張相片可能發生的特定錯誤情形,請參閱 GetPhoto

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

更新 Photos 的中繼資料,例如姿勢、地點關聯、連結等。不支援變更相片的像素。

請注意,如果 BatchUpdatePhotos 失敗,可能是缺少重要欄位或發生驗證錯誤。即使 BatchUpdatePhotos 成功,批次中的個別相片仍可能失敗。這些失敗作業會於 BatchUpdatePhotosResponse.results 的每個 PhotoResponse.status 中指明。如要瞭解每張相片可能發生的特定錯誤情形,請參閱 UpdatePhoto

系統只會使用 updateMask 欄位中指定的欄位。如果未顯示 updateMask,則更新內容會套用至所有欄位。

BatchUpdatePhotosRequest 中的 UpdatePhotoRequest 訊息數量不得超過 20。

注意:如要更新 Pose.altitude,還必須填寫 Pose.latLngPair。否則要求就會失敗。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

在用戶端使用傳回的 UploadRef 上傳相片後,CreatePhoto 會將上傳的 Photo 發布至 Google 地圖的街景服務。

目前在 CreatePhoto 中要設定方向、提案及翻轉的唯一方法,就是透過相片位元組中的 3MP XMP 中繼資料。CreatePhoto 會忽略 Pose 中的 pose.headingpose.pitchpose.rollpose.altitudepose.level 欄位。

這個方法會傳回下列錯誤代碼:

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

用戶端完成傳回 UploadRefPhotoSequence 後,CreatePhotoSequence 會從影片或可擴充的裝置中繼資料 (XDM,http://www.xdm.org/) 擷取一系列 360 度相片,並發布至 Google 地圖。

CreatePhotoSequence 會傳回 Operation,且 Operation.name 欄位已設定 PhotoSequence ID。

這個方法會傳回下列錯誤代碼:

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

刪除 Photo 及其中繼資料。

這個方法會傳回下列錯誤代碼:

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

刪除 PhotoSequence 及其中繼資料。

這個方法會傳回下列錯誤代碼:

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

取得指定 Photo 的中繼資料。

這個方法會傳回下列錯誤代碼:

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

透過 Operation 介面取得指定 PhotoSequence 的中繼資料。

這個方法會傳回下列三種回應類型:

  • Operation.done = false (如果 PhotoSequence 的處理作業尚未完成)。
  • Operation.done = true 且會填入 Operation.error (如果處理中發生錯誤)。
  • Operation.done = true;Operation.response 遭到推測,其中包含 PhotoSequence 訊息。

這個方法會傳回下列錯誤代碼:

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

按照 CreatePhotoSequence 時間戳記順序遞減排序,列出屬於使用者的所有 PhotoSequences

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

列出使用者的所有 Photos

注意:如果最近建立的相片仍在建立索引,回應中就不會傳回。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

建立上傳工作階段,以開始上傳相片序列資料。回傳的 UploadRef 上傳網址會用來上傳 photoSequence 的資料。

上傳完成後,會搭配使用 UploadRefCreatePhotoSequence 來建立 PhotoSequence 物件項目。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

StartUpload

rpc StartUpload(Empty) returns (UploadRef)

建立上傳工作階段,開始上傳相片位元組。此方法會使用所傳回 UploadRef 的上傳網址,為 Photo 上傳位元組。

除了 https://support.google.com/maps/answer/7012050?ref_topic=6275604 中註明的相片規定外,相片也必須符合以下規定:

上傳完成後,該方法會搭配 CreatePhoto 使用 UploadRef 來建立 Photo 物件項目。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

更新 Photo 的中繼資料,例如姿勢、地點關聯、連結等。不支援變更相片的像素。

系統只會使用 updateMask 欄位中指定的欄位。如果未顯示 updateMask,則更新內容會套用至所有欄位。

這個方法會傳回下列錯誤代碼:

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/streetviewpublish

詳情請參閱 OAuth 2.0 總覽

BatchDeletePhotosRequest

要求刪除多個Photos

欄位
photo_ids[]

string

必要欄位。Photos 的 ID。HTTP GET 要求需要使用以下的網址查詢參數語法:photoIds=<id1>&photoIds=<id2>&...

BatchDeletePhotosResponse

對一或多個「Photos」進行批次刪除的回應。

欄位
status[]

Status

這項作業狀態,用於刪除批次要求中的單一 Photo

BatchGetPhotosRequest

要求取得一或多個 Photos。根據預設

  • 不會傳回相片位元組的下載網址。

參數:

  • view 可控制是否要傳回相片位元組的下載網址。
欄位
photo_ids[]

string

必要欄位。Photos 的 ID。如果是 HTTP GET 要求,網址查詢參數應為 photoIds=<id1>&photoIds=<id2>&...

view

PhotoView

必要欄位。指定是否應在相片回應中傳回相片位元組的下載網址。

language_code

string

選用設定。BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如未指定 language_code,系統會根據使用者在 Google 服務的語言偏好設定。

BatchGetPhotosResponse

對批次取得 Photos 的回應。

欄位
results[]

PhotoResponse

每個要求的 Photo 結果清單,按照 BatchGetPhotos 中的要求順序排列。

BatchUpdatePhotosRequest

要求更新相片的中繼資料。不支援更新相片的像素。

欄位
update_photo_requests[]

UpdatePhotoRequest

必要欄位。UpdatePhotoRequests 清單。

BatchUpdatePhotosResponse

對一或多個 Photos 中繼資料的批次更新做出回應。

欄位
results[]

PhotoResponse

按照要求的順序更新個別 Photo 的結果清單。

情感交流

連結是指來源相片與目的地相片的連結。

欄位
target

PhotoId

必要欄位。從所含相片到其他相片的目的地。

CreatePhotoRequest

要求建立 Photo

欄位
photo

Photo

必要欄位。要建立的相片。

CreatePhotoSequenceRequest

要求在影片中建立 PhotoSequence

欄位
photo_sequence

PhotoSequence

必要欄位。PhotoSequence即可建立。

input_type

InputType

必要欄位。PhotoSequence 的輸入形式。

InputType

PhotoSequence 的輸入形式。

列舉
INPUT_TYPE_UNSPECIFIED 未指定,伺服器會傳回 google.rpc.Code.INVALID_ARGUMENT
VIDEO 360 度影片。
XDM 可擴充裝置中繼資料 (http://www.xdm.org)

DeletePhotoRequest

要求刪除 Photo

欄位
photo_id

string

必要欄位。Photo 的 ID。

DeletePhotoSequenceRequest

要求刪除 PhotoSequence

欄位
sequence_id

string

必要欄位。PhotoSequence 的 ID。

GetPhotoRequest

要求取得 Photo

根據預設

  • 不會傳回相片位元組的下載網址。

參數:

  • view 可控制是否要傳回相片位元組的下載網址。
欄位
photo_id

string

必要欄位。Photo 的 ID。

view

PhotoView

必要欄位。指定是否應在 Photo 回應中傳回相片位元組的下載網址。

language_code

string

BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如未指定 language_code,系統會根據使用者在 Google 服務的語言偏好設定。

GetPhotoSequenceRequest

要求取得 PhotoSequence

根據預設

參數:

欄位
sequence_id

string

必要欄位。相片序列的 ID。

view
(deprecated)

PhotoView

指定是否應在 PhotoSequence 回應中,以個別相片的 download_url 傳回相片序列的下載網址。

注意:目前尚未執行。

filter

string

選用設定。篩選運算式。例如 published_status=PUBLISHED

支援的篩選器如下:published_status。詳情請參閱 https://google.aip.dev/160

GpsDataGapFailureDetails

與 ProcessingFailureReason#GPS_DATA_GAP 相關的詳細資料。如果 GPS 資料有多個差距,這裡只會列出持續時間最長的差距。

欄位
gap_duration

Duration

GPS 資料中發現的間隔時間。

gap_start_time

Duration

間隔開始時的相對時間 (從影片串流開始開始)。

伊穆文

裝置感應器產生的 IMU 資料。

欄位
accel_mpsps[]

Measurement3d

加速計的測量單位為公尺/秒^2,隨著裝置的時間戳記增加。

gyro_rps[]

Measurement3d

陀螺儀測量值以弧度/秒為單位,同時增加裝置的時間戳記。

mag_ut[]

Measurement3d

磁場的磁場測量單位為微特斯拉 (uT),同時提高裝置的時間戳記。

評估 3 天

一般 3D 測量範例。

欄位
capture_time

Timestamp

IMU 測量的時間戳記。

x

float

X 軸的感應器測量值。

y

float

Y 軸的感應器測量值。

z

float

感應器測量結果的 Z 軸。

ImuDataGapFailureDetails

與 ProcessingFailureReason#IMU_DATA_GAP 相關詳細資料。如有多個 IMU 資料落差,這裡只會顯示持續時間最長的 IMU 資料。

欄位
gap_duration

Duration

所發現 IMU 資料中的差距持續時間。

gap_start_time

Duration

間隔開始時的相對時間 (從影片串流開始開始)。

InsufficientGpsFailureDetails

與 ProcessingFailureReason#INSUFFICIENT_GPS 相關的詳細資料。

欄位
gps_points_found

int32

在影片中找到的 GPS 點數量。

LatLngBounds

地理座標中的矩形。

欄位
southwest

LatLng

這些界限的西南角。

northeast

LatLng

這些邊界的東北角。

等級

等級資訊,包含等級編號及其對應名稱。

欄位
number

double

選用設定。用於訂購的樓層編號。0 代表地面高度,1 表示地面上的最高樓層,-1 表示地面下的第一樓層。但也可以不是整數值。

name

string

必要欄位。指派給這個等級的名稱,上限為 3 個字元。如果發生電梯,請思考電梯按鈕在樓層上標示的方式。

ListPhotoSequencesRequest

要求列出屬於傳送要求的使用者的所有相片序列。

參數:

  • pageSize 會決定要傳回的相片序列數量上限。
  • pageToken 是先前的 ListPhotoSequences 要求 (如有) 傳回的下一個網頁權杖值。
欄位
page_size

int32

選用設定。要傳回的相片序列數量上限。pageSize 不得為負數。如果 pageSize 為零或未提供,則使用預設頁面大小 100。如果相符項目的數量少於 pageSize,回應中傳回的相片序列數量可能會少於 pageSize。這個 API 目前尚未執行,但正在處理中。

page_token

string

選用設定。先前的 ListPhotoSequences 要求 (如果有的話) 傳回的 nextPageToken 值。

filter

string

選用設定。篩選運算式。例如 imagery_type=SPHERICAL

支援的篩選器如下:imagery_typeprocessing_statemin_latitudemax_latitudemin_longitudemax_longitudefilename_querymin_capture_time_seconds、`max_capture_time_seconds。詳情請參閱 https://google.aip.dev/160。在檔案名稱查詢中,應以「詞組」的形式傳送,才能支援多個字詞和特殊字元,方法是加上逸出引號。範例:filename_query="example of aphrase.mp4"

ListPhotoSequencesResponse

回應以列出使用者的所有相片序列。

欄位
photo_sequences[]

Operation

使用 Operation 介面的相片序列清單。

傳回的項目數量上限取決於要求中的 pageSize 欄位。

清單中的每個項目都可以有三種可能的狀態

  • Operation.done = false (如果 PhotoSequence 的處理作業尚未完成)。
  • Operation.done = true 且會填入 Operation.error (如果處理中發生錯誤)。
  • Operation.done = true,Operation.response 則包含 PhotoSequence 訊息,在每個序列中,只有 Id 會填入。
next_page_token

string

用來擷取下一頁結果的符記;如果清單中沒有其他結果,這一欄就會留空。

ListPhotosRequest

要求列出使用者傳送要求的所有相片。

根據預設

  • 不會傳回相片位元組的下載網址。

參數:

  • view 可控制是否要傳回相片位元組的下載網址。
  • pageSize 可決定要傳回的相片數量上限。
  • pageToken 是先前的 ListPhotos 要求 (如有) 傳回的下一個網頁權杖值。
  • filter 可讓您依指定參數進行篩選。「placeId」是目前唯一支援的參數。
欄位
view

PhotoView

必要欄位。指定是否應在 Google 相簿回應中傳回相片位元組的下載網址。

page_size

int32

選用設定。要傳回的相片數量上限。pageSize 不得為負數。如果 pageSize 為零或未提供,則使用預設頁面大小 100。如果使用者的相片數量少於 pageSize,回應中傳回的相片數量可能少於 pageSize 張。

page_token

string

選用設定。先前的 ListPhotos 要求 (如果有的話) 傳回的 nextPageToken 值。

filter

string

選用設定。篩選運算式。例如 placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw

支援的篩選器如下:placeIdmin_latitudemax_latitudemin_longitudemax_longitude。詳情請參閱 https://google.aip.dev/160

language_code

string

選用設定。BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如未指定 language_code,系統會根據使用者在 Google 服務的語言偏好設定。

ListPhotosResponse

回應至清單,列出使用者的所有相片。

欄位
photos[]

Photo

相片清單。要求中的 pageSize 欄位會決定傳回的項目數量。

next_page_token

string

用來擷取下一頁結果的符記;如果清單中沒有其他結果,這一欄就會留空。

NoOverlapGpsFailureDetails

PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS 相關詳情。

欄位
gps_start_time

Timestamp

首次記錄 GPS 點的時間。

gps_end_time

Timestamp

上次記錄 GPS 點的時間。

video_start_time

Timestamp

影片開始時間。

video_end_time

Timestamp

影片結束時間。

NotOutdoorsFailureDetails

ProcessingFailureReason#NOT_OUTDOORS 的詳細資料。如果系統偵測到多個室內影格,這裡就會記錄第一個影格。

欄位
start_time

Duration

偵測到室內影格時的相對時間 (從影片串流開始開始)。

相片

相片可用來儲存 360 度相片和相片中繼資料。

欄位
photo_id

PhotoId

必要欄位。僅供輸出。更新相片時必填。只在建立相片時輸出。相片的 ID,在 Google 的所有相片中都是獨一無二的。

upload_reference

UploadRef

僅限輸入。製作相片時必須提供。僅限輸入。上傳相片位元組的目標資源網址。

download_url

string

僅供輸出。相片位元組的下載網址。只有在 GetPhotoRequest.view 設為 PhotoView.INCLUDE_DOWNLOAD_URL 時,才會設定此欄位。

thumbnail_url

string

僅供輸出。顯示指定相片預覽畫面的縮圖網址。

pose

Pose

選用設定。相片中的姿勢。

connections[]

Connection

選用設定。與其他相片的連結。連結代表這張相片與其他相片的連結。

capture_time

Timestamp

選用設定。拍照的絕對時間。如果相片沒有 EXIF 時間戳記,系統會使用這項資訊設定相片中繼資料中的時間戳記。

upload_time

Timestamp

僅供輸出。上傳圖片的時間。

places[]

Place

選用設定。這張相片所屬的地點。

view_count

int64

僅供輸出。相片的觀看次數。

transfer_status

TransferStatus

僅供輸出。這張相片的權利轉移狀態。

maps_publish_status

MapsPublishStatus

僅供輸出。Google 地圖中的狀態:這張相片是否已發布或遭到拒絕。

MapsPublishStatus

相片在 Google 地圖中發布的狀態。

列舉
UNSPECIFIED_MAPS_PUBLISH_STATUS 相片的狀態不明。
PUBLISHED 相片會透過 Google 地圖對外公開。
REJECTED_UNKNOWN 相片已因不明原因遭拒。

TransferStatus

權利轉移狀態。

列舉
TRANSFER_STATUS_UNKNOWN 未指定這項轉移作業的狀態。
NEVER_TRANSFERRED 這張相片未曾轉移過。
PENDING 相片轉移作業已啟動,但接收者尚未回應。
COMPLETED 相片轉移作業已完成,且相片已轉移給收件者。
REJECTED 收件者拒絕了這張相片轉移要求。
EXPIRED 相片轉移作業已在接收者採取行動前過期。
CANCELLED 傳送者已取消這張相片轉移作業。
RECEIVED_VIA_TRANSFER 這部影片因版權轉移限製而擁有這張相片。

PhotoId

Photo 的 ID。

欄位
id

string

相片的專屬 ID。

PhotoResponse

批次作業中的單一 Photo 回應酬載,包括 BatchGetPhotosBatchUpdatePhotos

欄位
status

Status

針對批次要求取得或更新單一相片的作業狀態。

photo

Photo

Photo 資源 (如果要求成功)。

PhotoSequence

一系列的 360 度相片和中繼資料。

欄位
id

string

僅供輸出。相片序列的專屬 ID。如果以非同步方式進行上傳,這也會是長時間執行的作業 ID。

photos[]

Photo

僅供輸出。時間戳記持續增加的相片。

upload_reference

UploadRef

僅限輸入。建立相片序列時必填。上傳相片序列位元組的資源名稱 (以影片的形式呈現)。

capture_time_override

Timestamp

選用設定。開始拍攝相片序列的絕對時間。如果相片序列是影片,這就是影片開始時間。如果這個欄位已填入輸入內容,就會覆寫影片或 XDM 檔案中的拍攝時間。

upload_time

Timestamp

僅供輸出。此相片序列在 uSV Store 服務中建立的時間。

raw_gps_timeline[]

Pose

僅限輸入。原始 GPS 測量結果的時間戳記增加,但裝置不是與每張相片同步的時間增加。這些原始測量結果將用來推測每個影格的姿勢。如果 InputType 為「VIDEO」,且原始 GPS 測量結果不在相機動態中繼資料追蹤 (CAMM) 中,就必須輸入。如果 raw_gps_timeline 和相機動作中繼資料追蹤 (CAMM) 提供了原始 GPS 測量結果,使用者可利用 gps_source 指出何者的優先順序。

gps_source

GpsSource

僅限輸入。如果 raw_gps_timeline 和相機動作中繼資料追蹤 (CAMM) 皆包含 GPS 測量資料,請指出何者的優先順序較高。

imu

Imu

僅限輸入。收集的三軸 IMU 資料。如果這項資料過大,無法包含在要求中,則應加入影片的 CAMM 追蹤中。如有資料,系統一律會優先採用這些資料,而非對等的 CAMM 資料。

processing_state

ProcessingState

僅供輸出。此序列的處理狀態。

failure_reason

ProcessingFailureReason

僅供輸出。如果這個序列的 process_state = FAILED,將說明失敗原因。如果 process_state 是任何其他值,就不會設定這個欄位。

failure_details

ProcessingFailureDetails

僅供輸出。如果此序列已設定 failure_reason,這可能會包含失敗的其他詳細資料。

distance_meters

double

僅供輸出。相片序列的計算距離 (以公尺為單位)。

sequence_bounds

LatLngBounds

僅供輸出。這個矩形方塊會封裝相片序列中的所有圖片。

view_count

int64

僅供輸出。這個 PhotoSequence 中所有已發布的圖片獲得的總瀏覽次數。

filename

string

僅供輸出。上傳作業的檔案名稱。不含目錄路徑。只有在序列平台上傳於提供檔案名稱的平台上時,才能使用此功能。

GpsSource

主要 GPS 測量結果。

列舉
PHOTO_SEQUENCE 系統會優先採用 raw_gps_timeline 中的 GPS (如果有的話)。
CAMERA_MOTION_METADATA_TRACK 系統會優先採用相機動態中繼資料追蹤 (CAMM) 中的 GPS。

PhotoView

指定要在回應中加入的 Photo 檢視畫面。

列舉
BASIC 伺服器回應不包含相片位元組的下載網址。預設值。
INCLUDE_DOWNLOAD_URL 伺服器回應會附上相片位元組的下載網址。

地點

放置實體的中繼資料。

欄位
place_id

string

地點 ID,詳情請參閱 https://developers.google.com/places/place-id

name

string

僅供輸出。地點的名稱,已本地化為 language_code。

language_code

string

僅供輸出。做為名稱本地化時所用的 language_code。這應該是要求中指定的 language_code,但也可以是備用項。

姿勢

特定實體的原始姿勢測量結果。

欄位
lat_lng_pair

LatLng

該姿勢的經緯度組合,說明如下:https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng 時,如未提供經緯度組合,系統會使用 EXIF 標頭中的地理位置。Photo如果相片或 EXIF 標頭中未提供經緯度組合,相片作業會失敗。

altitude

double

姿勢高於 WGS84 橢球體的高度。NaN 表示尚未測量的數量。

heading

double

下列與相片中心相關的姿勢參數。必須與 https://developers.google.com/streetview/spherical-metadata 相符。指南針方向,以相片中心由北方順時針測量的角度,以度為單位。值必須介於 >=0 至 360 之間。NaN 表示尚未測量的數量。

pitch

double

傾斜 (以度為單位)。值必須介於 >=-90 且 <= 90 之間。-90 值表示直接往下看,值 90 表示直接向上查詢。NaN 表示尚未測量的數量。

roll

double

旋轉 (以度為單位)。值必須介於 >= 0 至 360 之間。值為 0 表示水平線的水平。NaN 表示尚未測量的數量。

gps_record_timestamp_unix_epoch

Timestamp

GPS 記錄的執行時間,採用世界標準時間 (UTC)。

level

Level

用於設定垂直導覽的樓層 (建築物中的樓層)。

accuracy_meters

float

此姿勢的預估水平準確率,以公尺為單位的信賴水準為 68% (一個標準差)。舉例來說,在 Android 上,可以使用以下方法取得這個值:https://developer.android.com/reference/android/location/Location#getAccuracy()。其他平台有多種不同的方法,用來估算準確度。

ProcessingFailureDetails

處理失敗原因列舉的其他詳細資料。這則訊息一律應與 ProcessingFailureReason 搭配使用,而這則訊息中設定的其中一個值應符合 FailureReason。

欄位
聯集欄位 details。系統只會設定一組詳細資料,且必須符合 ProcessingFailureReason 中對應的列舉。details 只能是下列其中一項:
insufficient_gps_details

InsufficientGpsFailureDetails

請參閱 InufficientGpsFailureDetails。

gps_data_gap_details

GpsDataGapFailureDetails

請參閱 GpsDataGapFailureDetails。

imu_data_gap_details

ImuDataGapFailureDetails

請參閱 ImuDataGapFailureDetails。

not_outdoors_details

NotOutdoorsFailureDetails

請參閱 NotOutdoorsFailureDetails。

no_overlap_gps_details

NoOverlapGpsFailureDetails

請參閱 NoOverlapGpsFailureDetails。

ProcessingFailureReason

這個PhotoSequence無法處理的可能原因。

列舉
PROCESSING_FAILURE_REASON_UNSPECIFIED 未指定失敗原因,這是預設值。
LOW_RESOLUTION 影片畫面解析度過低。
DUPLICATE 這部影片先前已上傳。
INSUFFICIENT_GPS GPS 點太少。
NO_OVERLAP_GPS GPS 軌跡的時段和影片的時間範圍之間沒有重疊。
INVALID_GPS GPS 無效 (例如,所有 GPS 點都在 (0,0) 處)
FAILED_TO_REFINE_POSITIONS 相片順序無法正確顯示在世界上。
TAKEDOWN 這個序列是因違反政策而遭到移除。
CORRUPT_VIDEO 影片檔案損毀或無法解碼。
INTERNAL 基礎系統發生永久錯誤。
INVALID_VIDEO_FORMAT 此影片格式無效或系統不支援。
INVALID_VIDEO_DIMENSIONS 發現無效的圖片長寬比。
INVALID_CAPTURE_TIME 拍攝時間無效。時間戳記是來自未來的時間。
GPS_DATA_GAP GPS 資料包含的時間差超過 5 秒。
JUMPY_GPS GPS 資料過於複雜,無法處理。
INVALID_IMU IMU (加速計、陀螺儀等) 資料無效。這些必要欄位可能缺少必要欄位 (x、y、z 或時間),也可能是格式有誤,或是出現其他導致系統無法剖析的問題。
INSUFFICIENT_IMU IMU 點數太少。
INSUFFICIENT_OVERLAP_TIME_SERIES GPS、IMU 和其他時間序列資料的時間範圍重疊不足。
IMU_DATA_GAP IMU (加速計、陀螺儀等) 資料所涵蓋的間隔時間超過 0.1 秒。
UNSUPPORTED_CAMERA 不支援相機。
NOT_OUTDOORS 部分影格為室內,但系統不支援這類影格。
INSUFFICIENT_VIDEO_FRAMES 視訊畫面不足。
INSUFFICIENT_MOVEMENT 移動資料不足。

ProcessingState

序列的處理狀態。狀態的移動方式如下:

     +-------------------------+
     |                         |
 +---v---+  +----------+  +----+----+
 |PENDING+-->PROCESSING+-->PROCESSED|
 +---+---+  +----+-----+  +----+----+
     |           |             |
     |        +--v---+         |
     +-------->FAILED<---------+
              +------+

序列可能會從任何狀態移至「失敗」。此外,我們也可能隨時重新處理處理過的序列。

列舉
PROCESSING_STATE_UNSPECIFIED 未指定狀態,此為預設值。
PENDING 序列尚未開始處理。
PROCESSING 序列目前正在處理中。
PROCESSED 序列已處理完畢,包括修正位置。
FAILED 序列處理失敗。詳情請參閱 FailureReason。

UpdatePhotoRequest

要求更新 Photo 的中繼資料。不支援更新相片的像素。

欄位
photo

Photo

必要欄位。包含新中繼資料的 Photo 物件。

update_mask

FieldMask

必要欄位。可識別待更新相片中繼資料欄位的遮罩。如果沒有,則在這項要求中,舊的 Photo 中繼資料會完全替換為新的 Photo 中繼資料。如果指定無效欄位,更新就會失敗。以逗號分隔的清單可指定多個欄位。

下列欄位有效:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

注意:如果 updateMask 包含重複欄位,整組重複值都會替換為新內容。舉例來說,如果 updateMask 包含 connections,而 UpdatePhotoRequest.photo.connections 為空白,則系統會移除所有連線。

UploadRef

上傳媒體檔案參考資料。

欄位
聯集欄位 file_source。必要欄位。file_source 只能是下列其中一項:
upload_url

string

每位使用者的上傳參考資料不得重複。格式如下:「https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}」