索引
StreetViewPublishService
(介面)BatchDeletePhotosRequest
(訊息)BatchDeletePhotosResponse
(訊息)BatchGetPhotosRequest
(訊息)BatchGetPhotosResponse
(訊息)BatchUpdatePhotosRequest
(訊息)BatchUpdatePhotosResponse
(訊息)Connection
(訊息)CreatePhotoRequest
(訊息)CreatePhotoSequenceRequest
(訊息)CreatePhotoSequenceRequest.InputType
(列舉)DeletePhotoRequest
(訊息)DeletePhotoSequenceRequest
(訊息)GetPhotoRequest
(訊息)GetPhotoSequenceRequest
(訊息)GpsDataGapFailureDetails
(訊息)Imu
(訊息)Imu.Measurement3d
(訊息)ImuDataGapFailureDetails
(訊息)InsufficientGpsFailureDetails
(訊息)LatLngBounds
(訊息)Level
(訊息)ListPhotoSequencesRequest
(訊息)ListPhotoSequencesResponse
(訊息)ListPhotosRequest
(訊息)ListPhotosResponse
(訊息)NoOverlapGpsFailureDetails
(訊息)NotOutdoorsFailureDetails
(訊息)Photo
(訊息)Photo.MapsPublishStatus
(列舉)Photo.TransferStatus
(列舉)PhotoId
(訊息)PhotoResponse
(訊息)PhotoSequence
(訊息)PhotoSequence.GpsSource
(列舉)PhotoView
(列舉)Place
(訊息)Pose
(訊息)ProcessingFailureDetails
(訊息)ProcessingFailureReason
(列舉)ProcessingState
(列舉)UpdatePhotoRequest
(訊息)UploadRef
(訊息)
StreetViewPublishService
在街景服務上發布並連結使用者提供的相片。
BatchDeletePhotos |
---|
刪除 請注意,如果
|
BatchGetPhotos |
---|
取得指定 請注意,如果
|
BatchUpdatePhotos |
---|
更新 請注意,如果 系統只會使用
|
CreatePhoto |
---|
在用戶端使用傳回的 目前在 CreatePhoto 中要設定方向、提案及翻轉的唯一方法,就是透過相片位元組中的 3MP XMP 中繼資料。CreatePhoto 會忽略 Pose 中的 這個方法會傳回下列錯誤代碼:
|
CreatePhotoSequence |
---|
用戶端完成傳回
這個方法會傳回下列錯誤代碼:
|
DeletePhoto |
---|
刪除 這個方法會傳回下列錯誤代碼:
|
DeletePhotoSequence |
---|
刪除 這個方法會傳回下列錯誤代碼:
|
GetPhoto |
---|
取得指定 這個方法會傳回下列錯誤代碼:
|
GetPhotoSequence |
---|
透過 這個方法會傳回下列三種回應類型:
這個方法會傳回下列錯誤代碼:
|
ListPhotoSequences |
---|
按照 CreatePhotoSequence 時間戳記順序遞減排序,列出屬於使用者的所有
|
ListPhotos |
---|
列出使用者的所有
|
StartPhotoSequenceUpload |
---|
建立上傳工作階段,以開始上傳相片序列資料。回傳的 上傳完成後,會搭配使用
|
StartUpload |
---|
建立上傳工作階段,開始上傳相片位元組。此方法會使用所傳回 除了 https://support.google.com/maps/answer/7012050?ref_topic=6275604 中註明的相片規定外,相片也必須符合以下規定:
上傳完成後,該方法會搭配
|
UpdatePhoto |
---|
更新 系統只會使用 這個方法會傳回下列錯誤代碼:
|
BatchDeletePhotosRequest
要求刪除多個Photos
。
欄位 | |
---|---|
photo_ids[] |
必要欄位。 |
BatchDeletePhotosResponse
對一或多個「Photos
」進行批次刪除的回應。
欄位 | |
---|---|
status[] |
這項作業狀態,用於刪除批次要求中的單一 |
BatchGetPhotosRequest
要求取得一或多個 Photos
。根據預設
- 不會傳回相片位元組的下載網址。
參數:
view
可控制是否要傳回相片位元組的下載網址。
欄位 | |
---|---|
photo_ids[] |
必要欄位。 |
view |
必要欄位。指定是否應在相片回應中傳回相片位元組的下載網址。 |
language_code |
選用設定。BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如未指定 language_code,系統會根據使用者在 Google 服務的語言偏好設定。 |
BatchGetPhotosResponse
對批次取得 Photos
的回應。
欄位 | |
---|---|
results[] |
每個要求的 |
BatchUpdatePhotosRequest
要求更新相片的中繼資料。不支援更新相片的像素。
欄位 | |
---|---|
update_photo_requests[] |
必要欄位。 |
BatchUpdatePhotosResponse
對一或多個 Photos
中繼資料的批次更新做出回應。
欄位 | |
---|---|
results[] |
按照要求的順序更新個別 |
情感交流
連結是指來源相片與目的地相片的連結。
欄位 | |
---|---|
target |
必要欄位。從所含相片到其他相片的目的地。 |
CreatePhotoRequest
要求建立 Photo
。
欄位 | |
---|---|
photo |
必要欄位。要建立的相片。 |
CreatePhotoSequenceRequest
要求在影片中建立 PhotoSequence
。
欄位 | |
---|---|
photo_sequence |
必要欄位。 |
input_type |
必要欄位。 |
InputType
PhotoSequence
的輸入形式。
列舉 | |
---|---|
INPUT_TYPE_UNSPECIFIED |
未指定,伺服器會傳回 google.rpc.Code.INVALID_ARGUMENT 。 |
VIDEO |
360 度影片。 |
XDM |
可擴充裝置中繼資料 (http://www.xdm.org) |
DeletePhotoRequest
要求刪除 Photo
。
欄位 | |
---|---|
photo_id |
必要欄位。 |
DeletePhotoSequenceRequest
要求刪除 PhotoSequence
。
欄位 | |
---|---|
sequence_id |
必要欄位。 |
GetPhotoRequest
要求取得 Photo
。
根據預設
- 不會傳回相片位元組的下載網址。
參數:
view
可控制是否要傳回相片位元組的下載網址。
欄位 | |
---|---|
photo_id |
必要欄位。 |
view |
必要欄位。指定是否應在 |
language_code |
BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如未指定 language_code,系統會根據使用者在 Google 服務的語言偏好設定。 |
GetPhotoSequenceRequest
要求取得 PhotoSequence
。
根據預設
- 不會傳回
PhotoSequence
的下載網址。
參數:
view
可控制是否要傳回PhotoSequence
的下載網址。
欄位 | |
---|---|
sequence_id |
必要欄位。相片序列的 ID。 |
view |
指定是否應在
|
filter |
選用設定。篩選運算式。例如 支援的篩選器如下: |
GpsDataGapFailureDetails
與 ProcessingFailureReason#GPS_DATA_GAP 相關的詳細資料。如果 GPS 資料有多個差距,這裡只會列出持續時間最長的差距。
欄位 | |
---|---|
gap_duration |
GPS 資料中發現的間隔時間。 |
gap_start_time |
間隔開始時的相對時間 (從影片串流開始開始)。 |
伊穆文
裝置感應器產生的 IMU 資料。
欄位 | |
---|---|
accel_mpsps[] |
加速計的測量單位為公尺/秒^2,隨著裝置的時間戳記增加。 |
gyro_rps[] |
陀螺儀測量值以弧度/秒為單位,同時增加裝置的時間戳記。 |
mag_ut[] |
磁場的磁場測量單位為微特斯拉 (uT),同時提高裝置的時間戳記。 |
評估 3 天
一般 3D 測量範例。
欄位 | |
---|---|
capture_time |
IMU 測量的時間戳記。 |
x |
X 軸的感應器測量值。 |
y |
Y 軸的感應器測量值。 |
z |
感應器測量結果的 Z 軸。 |
ImuDataGapFailureDetails
與 ProcessingFailureReason#IMU_DATA_GAP 相關詳細資料。如有多個 IMU 資料落差,這裡只會顯示持續時間最長的 IMU 資料。
欄位 | |
---|---|
gap_duration |
所發現 IMU 資料中的差距持續時間。 |
gap_start_time |
間隔開始時的相對時間 (從影片串流開始開始)。 |
InsufficientGpsFailureDetails
與 ProcessingFailureReason#INSUFFICIENT_GPS 相關的詳細資料。
欄位 | |
---|---|
gps_points_found |
在影片中找到的 GPS 點數量。 |
LatLngBounds
地理座標中的矩形。
欄位 | |
---|---|
southwest |
這些界限的西南角。 |
northeast |
這些邊界的東北角。 |
等級
等級資訊,包含等級編號及其對應名稱。
欄位 | |
---|---|
number |
選用設定。用於訂購的樓層編號。0 代表地面高度,1 表示地面上的最高樓層,-1 表示地面下的第一樓層。但也可以不是整數值。 |
name |
必要欄位。指派給這個等級的名稱,上限為 3 個字元。如果發生電梯,請思考電梯按鈕在樓層上標示的方式。 |
ListPhotoSequencesRequest
要求列出屬於傳送要求的使用者的所有相片序列。
參數:
pageSize
會決定要傳回的相片序列數量上限。pageToken
是先前的ListPhotoSequences
要求 (如有) 傳回的下一個網頁權杖值。
欄位 | |
---|---|
page_size |
選用設定。要傳回的相片序列數量上限。 |
page_token |
選用設定。先前的 |
filter |
選用設定。篩選運算式。例如 支援的篩選器如下: |
ListPhotoSequencesResponse
回應以列出使用者的所有相片序列。
欄位 | |
---|---|
photo_sequences[] |
使用 傳回的項目數量上限取決於要求中的 清單中的每個項目都可以有三種可能的狀態
|
next_page_token |
用來擷取下一頁結果的符記;如果清單中沒有其他結果,這一欄就會留空。 |
ListPhotosRequest
要求列出使用者傳送要求的所有相片。
根據預設
- 不會傳回相片位元組的下載網址。
參數:
view
可控制是否要傳回相片位元組的下載網址。pageSize
可決定要傳回的相片數量上限。pageToken
是先前的ListPhotos
要求 (如有) 傳回的下一個網頁權杖值。filter
可讓您依指定參數進行篩選。「placeId」是目前唯一支援的參數。
欄位 | |
---|---|
view |
必要欄位。指定是否應在 Google 相簿回應中傳回相片位元組的下載網址。 |
page_size |
選用設定。要傳回的相片數量上限。 |
page_token |
選用設定。先前的 |
filter |
選用設定。篩選運算式。例如 支援的篩選器如下: |
language_code |
選用設定。BCP-47 語言代碼,例如「en-US」或「sr-Latn」。詳情請參閱 http://www.unicode.org/reports/tr35/#Unicode_locale_identifier。如未指定 language_code,系統會根據使用者在 Google 服務的語言偏好設定。 |
ListPhotosResponse
回應至清單,列出使用者的所有相片。
欄位 | |
---|---|
photos[] |
相片清單。要求中的 |
next_page_token |
用來擷取下一頁結果的符記;如果清單中沒有其他結果,這一欄就會留空。 |
NoOverlapGpsFailureDetails
PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS 相關詳情。
欄位 | |
---|---|
gps_start_time |
首次記錄 GPS 點的時間。 |
gps_end_time |
上次記錄 GPS 點的時間。 |
video_start_time |
影片開始時間。 |
video_end_time |
影片結束時間。 |
NotOutdoorsFailureDetails
ProcessingFailureReason#NOT_OUTDOORS 的詳細資料。如果系統偵測到多個室內影格,這裡就會記錄第一個影格。
欄位 | |
---|---|
start_time |
偵測到室內影格時的相對時間 (從影片串流開始開始)。 |
相片
相片可用來儲存 360 度相片和相片中繼資料。
欄位 | |
---|---|
photo_id |
必要欄位。僅供輸出。更新相片時必填。只在建立相片時輸出。相片的 ID,在 Google 的所有相片中都是獨一無二的。 |
upload_reference |
僅限輸入。製作相片時必須提供。僅限輸入。上傳相片位元組的目標資源網址。 |
download_url |
僅供輸出。相片位元組的下載網址。只有在 |
thumbnail_url |
僅供輸出。顯示指定相片預覽畫面的縮圖網址。 |
share_link |
僅供輸出。相片的分享連結。 |
pose |
選用設定。相片中的姿勢。 |
connections[] |
選用設定。與其他相片的連結。連結代表這張相片與其他相片的連結。 |
capture_time |
選用設定。拍照的絕對時間。如果相片沒有 EXIF 時間戳記,系統會使用這項資訊設定相片中繼資料中的時間戳記。 |
upload_time |
僅供輸出。上傳圖片的時間。 |
places[] |
選用設定。這張相片所屬的地點。 |
view_count |
僅供輸出。相片的觀看次數。 |
transfer_status |
僅供輸出。這張相片的權利轉移狀態。 |
maps_publish_status |
僅供輸出。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 |
相片的專屬 ID。 |
PhotoResponse
批次作業中的單一 Photo
回應酬載,包括 BatchGetPhotos
和 BatchUpdatePhotos
。
欄位 | |
---|---|
status |
針對批次要求取得或更新單一相片的作業狀態。 |
photo |
|
PhotoSequence
一系列的 360 度相片和中繼資料。
欄位 | |
---|---|
id |
僅供輸出。相片序列的專屬 ID。如果以非同步方式進行上傳,這也會是長時間執行的作業 ID。 |
photos[] |
僅供輸出。時間戳記持續增加的相片。 |
upload_reference |
僅限輸入。建立相片序列時必填。上傳相片序列位元組的資源名稱 (以影片的形式呈現)。 |
capture_time_override |
選用設定。開始拍攝相片序列的絕對時間。如果相片序列是影片,這就是影片開始時間。如果這個欄位已填入輸入內容,就會覆寫影片或 XDM 檔案中的拍攝時間。 |
upload_time |
僅供輸出。此相片序列在 uSV Store 服務中建立的時間。 |
raw_gps_timeline[] |
僅限輸入。原始 GPS 測量結果的時間戳記增加,但裝置不是與每張相片同步的時間增加。這些原始測量結果將用來推測每個影格的姿勢。如果 InputType 為「VIDEO」,且原始 GPS 測量結果不在相機動態中繼資料追蹤 (CAMM) 中,就必須輸入。如果 raw_gps_timeline 和相機動作中繼資料追蹤 (CAMM) 提供了原始 GPS 測量結果,使用者可利用 gps_source 指出何者的優先順序。 |
gps_source |
僅限輸入。如果 raw_gps_timeline 和相機動作中繼資料追蹤 (CAMM) 皆包含 GPS 測量資料,請指出何者的優先順序較高。 |
imu |
僅限輸入。收集的三軸 IMU 資料。如果這項資料過大,無法包含在要求中,則應加入影片的 CAMM 追蹤中。如有資料,系統一律會優先採用這些資料,而非對等的 CAMM 資料。 |
processing_state |
僅供輸出。此序列的處理狀態。 |
failure_reason |
僅供輸出。如果這個序列的 process_state = FAILED,將說明失敗原因。如果 process_state 是任何其他值,就不會設定這個欄位。 |
failure_details |
僅供輸出。如果此序列已設定 |
distance_meters |
僅供輸出。相片序列的計算距離 (以公尺為單位)。 |
sequence_bounds |
僅供輸出。這個矩形方塊會封裝相片序列中的所有圖片。 |
view_count |
僅供輸出。這個 PhotoSequence 中所有已發布的圖片獲得的總瀏覽次數。 |
filename |
僅供輸出。上傳作業的檔案名稱。不含目錄路徑。只有在序列平台上傳於提供檔案名稱的平台上時,才能使用此功能。 |
GpsSource
主要 GPS 測量結果。
列舉 | |
---|---|
PHOTO_SEQUENCE |
系統會優先採用 raw_gps_timeline 中的 GPS (如果有的話)。 |
CAMERA_MOTION_METADATA_TRACK |
系統會優先採用相機動態中繼資料追蹤 (CAMM) 中的 GPS。 |
PhotoView
指定要在回應中加入的 Photo
檢視畫面。
列舉 | |
---|---|
BASIC |
伺服器回應不包含相片位元組的下載網址。預設值。 |
INCLUDE_DOWNLOAD_URL |
伺服器回應會附上相片位元組的下載網址。 |
地點
放置實體的中繼資料。
欄位 | |
---|---|
place_id |
地點 ID,詳情請參閱 https://developers.google.com/places/place-id。 |
name |
僅供輸出。地點的名稱,已本地化為 language_code。 |
language_code |
僅供輸出。做為名稱本地化時所用的 language_code。這應該是要求中指定的 language_code,但也可以是備用項。 |
姿勢
特定實體的原始姿勢測量結果。
欄位 | |
---|---|
lat_lng_pair |
該姿勢的經緯度組合,說明如下:https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng 時,如未提供經緯度組合,系統會使用 EXIF 標頭中的地理位置。 |
altitude |
姿勢高於 WGS84 橢球體的高度。NaN 表示尚未測量的數量。 |
heading |
下列與相片中心相關的姿勢參數。必須與 https://developers.google.com/streetview/spherical-metadata 相符。指南針方向,以相片中心由北方順時針測量的角度,以度為單位。值必須介於 >=0 至 360 之間。NaN 表示尚未測量的數量。 |
pitch |
傾斜 (以度為單位)。值必須介於 >=-90 且 <= 90 之間。-90 值表示直接往下看,值 90 表示直接向上查詢。NaN 表示尚未測量的數量。 |
roll |
旋轉 (以度為單位)。值必須介於 >= 0 至 360 之間。值為 0 表示水平線的水平。NaN 表示尚未測量的數量。 |
gps_record_timestamp_unix_epoch |
GPS 記錄的執行時間,採用世界標準時間 (UTC)。 |
level |
用於設定垂直導覽的樓層 (建築物中的樓層)。 |
accuracy_meters |
此姿勢的預估水平準確率,以公尺為單位的信賴水準為 68% (一個標準差)。舉例來說,在 Android 上,可以使用以下方法取得這個值:https://developer.android.com/reference/android/location/Location#getAccuracy()。其他平台有多種不同的方法,用來估算準確度。 |
ProcessingFailureDetails
處理失敗原因列舉的其他詳細資料。這則訊息一律應與 ProcessingFailureReason 搭配使用,而這則訊息中設定的其中一個值應符合 FailureReason。
欄位 | |
---|---|
聯集欄位 details 。系統只會設定一組詳細資料,且必須符合 ProcessingFailureReason 中對應的列舉。details 只能是下列其中一項: |
|
insufficient_gps_details |
請參閱 InufficientGpsFailureDetails。 |
gps_data_gap_details |
請參閱 GpsDataGapFailureDetails。 |
imu_data_gap_details |
請參閱 ImuDataGapFailureDetails。 |
not_outdoors_details |
請參閱 NotOutdoorsFailureDetails。 |
no_overlap_gps_details |
請參閱 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 |
必要欄位。包含新中繼資料的 |
update_mask |
必要欄位。可識別待更新相片中繼資料欄位的遮罩。如果沒有,則在這項要求中,舊的 下列欄位有效:
|
UploadRef
上傳媒體檔案參考資料。
欄位 | |
---|---|
聯集欄位 file_source 。必要欄位。file_source 只能是下列其中一項: |
|
upload_url |
每位使用者的上傳參考資料不得重複。格式如下:「https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}」 |