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 中設定方向、提案和滾動，目前只能透過相片位元組中的 Photo6 XMP 中繼資料設定。CreatePhoto 會忽略 Pose 中的 pose.heading、pose.pitch、pose.roll、pose.altitude 和 pose.level 欄位。

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

授權範圍

需要下列 OAuth 範圍：

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

詳情請參閱 OAuth 2.0 總覽。
CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

在用戶端使用傳回的 UploadRef 上傳 PhotoSequence 後，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)

列出屬於使用者的所有 PhotoSequences，並依照 CreatePhotoSequence 時間戳記順序遞減排序。

授權範圍

需要下列 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 的資料。

上傳完成後，系統會搭配 CreatePhotoSequence 使用 UploadRef 以建立 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 所示的相片規定外，相片也必須符合以下規定：

上傳完成後，方法會使用 UploadRef 搭配 CreatePhoto 以建立 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 的要求。

預設

參數：

  • view 會控制系統是否傳回 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

裝置感應器提供的 IMU 資料。

欄位
accel_mpsps[]

Measurement3d

加速計測量單位為公尺/秒^2，時間戳記會逐漸增加。
gyro_rps[]

Measurement3d

陀螺儀測量結果 (以弧度/秒為單位) 會增加來自裝置的時間戳記。
mag_ut[]

Measurement3d

磁場的磁力儀測量以微特斯拉 (uT) 為單位，時間戳記會逐漸增加。

成效評估 3d

一般 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 個。目前仍在處理中，但尚未實作。
page_token

string

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

string

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

支援的篩選條件如下：imagery_type、processing_state、min_latitude、max_latitude、min_longitude、max_longitude、filename_query、min_capture_time_seconds、max_capture_time_seconds。詳情請參閱 https://google.aip.dev/160。檔案名稱查詢應以詞組的形式傳送，以便透過新增逸出引號來支援多個字詞和特殊字元。例如：filename_query="Mary.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。

支援的篩選器包括：placeId、min_latitude、max_latitude、min_longitude、max_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 的回應酬載，包括 BatchGetPhotos 和 BatchUpdatePhotos。

欄位
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 和 Camera Motion Metadata Track (CAMM) 同時提供原始 GPS 測量資料，使用者可以使用 gps_source 指出優先採用的信號。
gps_source

GpsSource

僅限輸入。如果 raw_gps_timeline 和相機動作中繼資料追蹤 (CAMM) 都含有 GPS 測量資料，請指明何者的優先順序最高。
imu

Imu

僅限輸入。集合的三軸 IMU 資料。如果資料量過大，無法加入要求，請將這些資料置於影片的 CAMM 音軌中。這類資料的優先順序一律高於對等的 CAMM 資料 (如有)。
processing_state

ProcessingState

僅供輸出。這個序列的處理狀態。
failure_reason

ProcessingFailureReason

僅供輸出。如果這個序列的 processing_state = FAILED，將會包含失敗的原因。如果處理_state 是任何其他值，就不會設定這個欄位。
failure_details

ProcessingFailureDetails

僅供輸出。如果此序列設定了 failure_reason，則其中可能包含失敗的其他詳細資料。
distance_meters

double

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

LatLngBounds

僅供輸出。矩形方塊會封裝此相片序列中的每張圖像。
view_count

int64

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

string

僅供輸出。上傳內容的檔案名稱。不含目錄路徑。只有在序列上傳至提供檔案名稱的平台時，才能使用此屬性。

GpsSource

GPS 測量的主要來源。

列舉
PHOTO_SEQUENCE 如果 GPS 存在，則優先於 raw_gps_timeline。
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 建立 Photo 時，如果未提供經緯度組合，則會使用 EXIF 標頭的地理位置。相片或 exif 標題中未提供經緯度組合，會導致相片處理失敗。
altitude

double

姿勢的高度 (以公尺為單位 WGS84 橢圓球體)。NaN 表示未測得的數量。
heading

double

下列姿勢與相片中心相關的姿勢參數。符合 https://developers.google.com/streetview/spherical-metadata。指南針方向，從相片中心以順時針方向測量，以度為單位。值必須介於 1 至 3 之間。NaN 表示未測得的數量。
pitch

double

俯仰角：從相片中心點以度為單位。值必須介於 1=-90 且 <= 90 之間。-90 值表示直接向下觀看，90 值則代表直接向上查詢。NaN 表示未測得的數量。
roll

double

旋轉，以度為單位。值必須介於 1 至 360 之間。0 代表與地平線的水平。NaN 表示未測得的數量。
gps_record_timestamp_unix_epoch

Timestamp

GPS 記錄時間，自世界標準時間 Epoch 時間。
level

Level

設定垂直導覽的樓層數 (一棟建築物的樓層)。
accuracy_meters

float

這個姿勢的預估水平準確度，以公尺和 68% 的信賴區間 (一個標準差) 為單位。舉例來說，在 Android 上，可透過以下方法取得這個值：https://developer.android.com/reference/android/location/Location#getAccuracy()。其他平台則使用不同的方法取得類似的準確度預估值。

ProcessingFailureDetails

與 ProcessingFailureReason 列舉一起的其他詳細資料。這則訊息一律應搭配 ProcessingFailureReason 使用，而這個訊息中設定的其中一個值應該與 FailureReason 相符。

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

InsufficientGpsFailureDetails

請參閱 InsufficientGpsFailureDetails。
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<---------+
              +------+

序列可能會從任何狀態移至 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}」