資源:相片
系統會使用相片儲存 360 度相片及相片中繼資料。
JSON 表示法 |
---|
{ "photoId": { object ( |
欄位 | |
---|---|
photoId |
必要欄位。僅供輸出。更新相片時必須提供。僅在建立相片時輸出。相片的 ID,在 Google 的所有相片中都不得重複。 |
uploadReference |
僅限輸入。建立相片時為必填欄位。僅限輸入。上傳相片位元組的資源網址。 |
downloadUrl |
僅供輸出。相片位元組的下載網址。只有在 |
thumbnailUrl |
僅供輸出。顯示指定相片的縮圖網址。 |
shareLink |
僅供輸出。相片的分享連結。 |
pose |
選用設定。相片的正面。 |
connections[] |
選用設定。連線至其他相片。一個連線代表這張相片中的其他相片連結。 |
captureTime |
選用設定。相片拍攝時的絕對時間。如果相片沒有 exif 時間戳記,這會用來設定相片中繼資料中的時間戳記。 以 RFC3339 世界標準時間「Zulu」格式表示的時間戳記,單位為奈及解析度,最多為九位數。範例: |
uploadTime |
僅供輸出。圖片上傳時間。 以 RFC3339 世界標準時間「Zulu」格式表示的時間戳記,單位為奈及解析度,最多為九位數。範例: |
places[] |
選用設定。這張相片所屬的地點。 |
viewCount |
僅供輸出。相片瀏覽次數。 |
transferStatus |
僅供輸出。這張相片的擁有權轉移狀態。 |
mapsPublishStatus |
僅供輸出。「Google 地圖」中的狀態,指出這張相片是否已發布或拒絕。 |
相片 ID
Photo
的 ID。
JSON 表示法 |
---|
{ "id": string } |
欄位 | |
---|---|
id |
相片的專屬 ID。 |
上傳
上傳媒體檔案參考資料。
JSON 表示法 |
---|
{ // Union field |
欄位 | |
---|---|
聯集欄位 file_source 。必要欄位。file_source 只能是下列其中一項: |
|
uploadUrl |
每個使用者的上傳參考資料都不得重複。格式如下:https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference} |
姿勢
實體的原始姿勢測量。
JSON 表示法 |
---|
{ "latLngPair": { object ( |
欄位 | |
---|---|
latLngPair |
姿勢的經緯度座標,詳情請參閱:https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng 建立 |
altitude |
WGS84 橢圓體上方的姿勢 (以公尺為單位)。NaN 表示未測量的數量。 |
heading |
下列 pose 參數與相片的中心有關。與 https://developers.google.com/streetview/spherical-metadata 相符。指南針方向 (以北方為順時針方向)。值必須大於 >=0 且小於 360。NaN 表示未測量的數量。 |
pitch |
圓形,以度為單位,從相片中心測量。值 >=-90 和 <= 90。如果這個值為 -90,代表直接向後看,而 90 值則代表直接查詢。NaN 表示未測量的數量。 |
roll |
滾動 (以度為單位)。值 >= 0 和 <360。值為 0 時,表示水平線水平。NaN 表示未測量的數量。 |
gpsRecordTimestampUnixEpoch |
全球衛星定位系統記錄時間 (世界標準時間) 以 RFC3339 世界標準時間「Zulu」格式表示的時間戳記,單位為奈及解析度,最多為九位數。範例: |
level |
設定垂直導覽的樓層 (建築物的樓層)。 |
accuracyMeters |
此投資的預估水平精確度,單位為 68%,信賴水準為 18 倍 (1 標準偏差)。舉例來說,在 Android 上,這個值 (透過 https://developer.android.com/reference/android/location/Location#getAccuracy()) 提供。在其他平台上,也有一種取得類似準確估算方式的方法。 |
LatLng
代表經緯度組合的物件。以一對雙精準數表示經度度數和緯度度數。除非另有指定,否則這個物件必須符合 WGS84 標準。此外,值必須在正規化範圍內。
JSON 表示法 |
---|
{ "latitude": number, "longitude": number } |
欄位 | |
---|---|
latitude |
緯度度數,必須介於 [-90.0, +90.0] 的範圍之間。 |
longitude |
經度度數,必須介於 [-180.0, +180.0] 的範圍之間。 |
Level
包含樓層編號及其對應的等級資訊。
JSON 表示法 |
---|
{ "number": number, "name": string } |
欄位 | |
---|---|
number |
選用設定。用於訂購的樓層編號。0 表示地面等級,1 表示地面下第一層,-1 表示地面等級的第一層。非整數值即可。 |
name |
必要欄位。指派給這個等級的名稱,長度不得超過 3 個字元。如果有電梯,請使用電梯按鈕為這種等級加上標籤。 |
情感交流
相片是指從來源相片連結到目標相片的連結。
JSON 表示法 |
---|
{
"target": {
object ( |
欄位 | |
---|---|
target |
必要欄位。包含相片與其他相片的連線目的地。 |
地點
放置實體的中繼資料。
JSON 表示法 |
---|
{ "placeId": string, "name": string, "languageCode": string } |
欄位 | |
---|---|
placeId |
請按照 https://developers.google.com/places/place-id 所述的方式加入地點 ID。 |
name |
僅供輸出。地點的名稱,翻譯成語言代碼。 |
languageCode |
僅供輸出。該名稱使用的本地化 Code。這必須是要求中指定的 languageCode,但可能是備用程式碼。 |
傳輸狀態
權利轉移狀態。
列舉 | |
---|---|
TRANSFER_STATUS_UNKNOWN |
未指定這項轉移作業的狀態。 |
NEVER_TRANSFERRED |
這張相片從未轉移完成。 |
PENDING |
這項相片轉移作業已開始,但接收者尚未回覆。 |
COMPLETED |
相片轉移作業已完成,且這張相片已轉移至接收者。 |
REJECTED |
接收者已拒絕這張相片的轉移程序。 |
EXPIRED |
相片轉移要求已過期,因為收件者尚未採取任何行動。 |
CANCELLED |
傳送者已取消這張相片的轉移作業。 |
RECEIVED_VIA_TRANSFER |
相片因版權轉移程序而遭擁有。 |
地圖發布狀態
相片在 Google 地圖中的發布狀態。
列舉 | |
---|---|
UNSPECIFIED_MAPS_PUBLISH_STATUS |
相片狀態不明。 |
PUBLISHED |
相片已透過 Google 地圖公開發布。 |
REJECTED_UNKNOWN |
相片因不明原因而遭拒。 |
方法 |
|
---|---|
|
用戶端上傳含有傳回 UploadRef 的相片後,CreatePhoto 會在 Google 地圖上將上傳的 Photo 發布至街景服務。 |
|
刪除 Photo 及其中繼資料。 |
|
取得指定 Photo 的中繼資料。 |
|
建立上傳工作階段,開始上傳相片位元組。 |
|
更新 Photo 的中繼資料,例如姿勢、地點關聯、連線等。 |