Package google.streetview.publish.v1

فهرست مطالب

StreetViewPublishService

عکس‌های ارائه‌شده توسط کاربر را در نمای خیابان منتشر و به هم متصل می‌کند.

BatchDeletePhotos

rpc BatchDeletePhotos( BatchDeletePhotosRequest ) returns ( BatchDeletePhotosResponse )

فهرستی از Photos و ابرداده‌های آن‌ها را حذف می‌کند.

توجه داشته باشید که اگر BatchDeletePhotos ناموفق باشد، یا فیلدهای حیاتی از دست رفته یا یک خطای احراز هویت وجود دارد. حتی اگر BatchDeletePhotos موفقیت آمیز باشد، ممکن است تک تک عکس ها در دسته با مشکل مواجه شوند. این خرابی ها در هر PhotoResponse.status در BatchDeletePhotosResponse.results مشخص شده است. برای خرابی‌های خاصی که ممکن است در هر عکس رخ دهد، به DeletePhoto مراجعه کنید.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

BatchGetPhotos

rpc BatchGetPhotos( BatchGetPhotosRequest ) returns ( BatchGetPhotosResponse )

فراداده دسته Photo مشخص شده را دریافت می کند.

توجه داشته باشید که اگر BatchGetPhotos از کار بیفتد، یا فیلدهای حیاتی از دست رفته یا یک خطای احراز هویت وجود دارد. حتی اگر BatchGetPhotos موفق شود، عکس‌های جداگانه در دسته ممکن است با شکست مواجه شوند. این خرابی ها در هر PhotoResponse.status در BatchGetPhotosResponse.results مشخص شده است. برای خرابی های خاصی که ممکن است در هر عکس رخ دهد GetPhoto را ببینید.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

BatchUpdatePhotos

rpc BatchUpdatePhotos( BatchUpdatePhotosRequest ) returns ( BatchUpdatePhotosResponse )

فراداده Photos ، مانند ژست، ارتباط مکان، اتصالات و غیره را به‌روزرسانی می‌کند. تغییر پیکسل‌های عکس‌ها پشتیبانی نمی‌شود.

توجه داشته باشید که اگر BatchUpdatePhotos ناموفق باشد، یا فیلدهای حیاتی از دست رفته یا یک خطای احراز هویت وجود دارد. حتی اگر BatchUpdatePhotos موفق شود، عکس‌های جداگانه در دسته ممکن است با شکست مواجه شوند. این خرابی ها در هر PhotoResponse.status در BatchUpdatePhotosResponse.results مشخص شده است. برای خرابی های خاصی که ممکن است در هر عکس رخ دهد، به UpdatePhoto مراجعه کنید.

فقط از فیلدهای مشخص شده در قسمت updateMask استفاده می شود. اگر updateMask وجود نداشته باشد، به روز رسانی برای همه فیلدها اعمال می شود.

تعداد پیام های UpdatePhotoRequest در یک BatchUpdatePhotosRequest نباید از 20 تجاوز کند.

توجه: برای به‌روزرسانی Pose.altitude ، Pose.latLngPair نیز باید پر شود. در غیر این صورت، درخواست با شکست مواجه خواهد شد.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ایجاد عکس

rpc CreatePhoto( CreatePhotoRequest ) returns ( Photo )

پس از اینکه مشتری آپلود عکس را با UploadRef برگشتی تمام کرد، CreatePhoto Photo آپلود شده را در نمای خیابان در Google Maps منتشر می کند.

در حال حاضر، تنها راه برای تنظیم عنوان، زیر و بم و رول در CreatePhoto از طریق فراداده Photo Sphere XMP در بایت های عکس است. CreatePhoto فیلدهای pose.heading ، pose.pitch ، pose.roll ، pose.altitude و pose.level را در Pose نادیده می گیرد.

این روش کدهای خطای زیر را برمی گرداند:

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

CreatePhotoSequence

rpc CreatePhotoSequence( CreatePhotoSequenceRequest ) returns ( Operation )

پس از اینکه مشتری آپلود PhotoSequence را با UploadRef برگشتی تمام کرد، CreatePhotoSequence دنباله ای از 360 عکس را از یک ویدیو یا فراداده دستگاه توسعه پذیر (XDM، http://www.xdm.org/ ) استخراج می کند تا در نمای خیابان در Google Maps منتشر شود.

CreatePhotoSequence یک Operation با شناسه PhotoSequence در قسمت Operation.name تنظیم می کند.

این روش کدهای خطای زیر را برمی گرداند:

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

حذف عکس

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 )

فراداده PhotoSequence مشخص شده را از طریق رابط Operation دریافت می کند.

این روش سه نوع پاسخ زیر را برمی گرداند:

  • 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 مراجعه کنید.

لیست عکس ها

rpc ListPhotos( ListPhotosRequest ) returns ( ListPhotosResponse )

تمام Photos هایی که متعلق به کاربر است را فهرست می کند.

توجه: عکس های ایجاد شده اخیر که هنوز در حال نمایه سازی هستند در پاسخ بازگردانده نمی شوند.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload( Empty ) returns ( UploadRef )

یک جلسه آپلود برای شروع آپلود داده های توالی عکس ایجاد می کند. URL آپلود UploadRef بازگشتی برای آپلود داده‌های photoSequence استفاده می‌شود.

پس از تکمیل آپلود، UploadRef با CreatePhotoSequence برای ایجاد ورودی شی PhotoSequence استفاده می شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

StartUpload

rpc StartUpload( Empty ) returns ( UploadRef )

یک جلسه آپلود برای شروع آپلود بایت های عکس ایجاد می کند. این روش از URL آپلود 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 مراجعه کنید.

به روز رسانی عکس

rpc UpdatePhoto( UpdatePhotoRequest ) returns ( Photo )

ابرداده های یک Photo مانند ژست، ارتباط مکان، اتصالات و غیره را به روز می کند. تغییر پیکسل های یک عکس پشتیبانی نمی شود.

فقط از فیلدهای مشخص شده در قسمت updateMask استفاده می شود. اگر updateMask وجود نداشته باشد، به روز رسانی برای همه فیلدها اعمال می شود.

این روش کدهای خطای زیر را برمی گرداند:

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

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

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

BatchDeletePhotosRequest

درخواست حذف چندین Photos

زمینه های
photo_ids[]

string

ضروری. شناسه Photos درخواست‌های HTTP GET به نحو زیر برای پارامتر درخواست URL نیاز دارند: photoIds=<id1>&photoIds=<id2>&... .

BatchDeletePhotosResponse

پاسخ به حذف دسته ای یک یا چند Photos .

زمینه های
status[]

Status

وضعیت عملیات حذف یک Photo در درخواست دسته ای.

درخواست BatchGetPhotos

درخواست دریافت یک یا چند Photos . به صورت پیش فرض

  • URL دانلود را برای بایت های عکس بر نمی گرداند.

مولفه های:

  • اگر URL دانلود برای بایت‌های عکس بازگردانده شود، view .
زمینه های
photo_ids[]

string

ضروری. شناسه Photos برای درخواست های HTTP GET، پارامتر جستجوی URL باید photoIds=<id1>&photoIds=<id2>&... باشد.

view

PhotoView

ضروری. مشخص می کند که آیا URL دانلود برای بایت های عکس باید در پاسخ عکس بازگردانده شود یا خیر.

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 .

درخواست BatchUpdatePhotos

درخواست به روز رسانی فراداده عکس ها. به روز رسانی پیکسل عکس ها پشتیبانی نمی شود.

زمینه های
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 .

نوع ورودی

فرم های ورودی PhotoSequence .

Enums
INPUT_TYPE_UNSPECIFIED مشخص نشده است. سرور google.rpc.Code.INVALID_ARGUMENT را برمی گرداند.
VIDEO ویدیو 360.
XDM فراداده دستگاه توسعه پذیر، http://www.xdm.org

DeletePhotoRequest

درخواست حذف یک Photo

زمینه های
photo_id

string

ضروری. شناسه Photo .

DeletePhotoSequenceRequest

درخواست حذف PhotoSequence .

زمینه های
sequence_id

string

ضروری. شناسه PhotoSequence .

GetPhotoRequest

درخواست دریافت Photo

به صورت پیش فرض

  • URL دانلود را برای بایت های عکس بر نمی گرداند.

مولفه های:

  • اگر URL دانلود برای بایت‌های عکس بازگردانده شود، view .
زمینه های
photo_id

string

ضروری. شناسه Photo .

view

PhotoView

ضروری. مشخص می کند که آیا URL دانلود برای بایت های عکس باید در پاسخ Photo بازگردانده شود یا خیر.

language_code

string

کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. اگر language_code نامشخص باشد، از اولویت زبان کاربر برای سرویس‌های Google استفاده می‌شود.

GetPhotoSequenceRequest

درخواست دریافت PhotoSequence .

به صورت پیش فرض

مولفه های:

  • اگر URL دانلود برای PhotoSequence برگردانده شد، کنترل‌ها را view .
زمینه های
sequence_id

string

ضروری. شناسه دنباله عکس.

view
(deprecated)

PhotoView

مشخص می‌کند که آیا URL دانلود برای دنباله عکس باید در download_url عکس‌های جداگانه در پاسخ PhotoSequence بازگردانده شود.

توجه: در حال حاضر اجرا نشده است.

filter

string

اختیاری. عبارت فیلتر. به عنوان مثال: published_status=PUBLISHED .

فیلترهای پشتیبانی شده عبارتند از: published_status . برای اطلاعات بیشتر به https://google.aip.dev/160 مراجعه کنید.

جزئیات GpsDataGapFailure

جزئیات مربوط به Processing FailureReason#GPS_DATA_GAP. اگر چندین شکاف داده GPS وجود داشته باشد، تنها موردی که بیشترین مدت زمان را دارد در اینجا گزارش می شود.

زمینه های
gap_duration

Duration

مدت زمان شکاف در داده های GPS که پیدا شد.

gap_start_time

Duration

زمان نسبی (از شروع پخش جریانی ویدیو) زمانی که فاصله شروع شد.

ایمو

داده های IMU از سنسورهای دستگاه.

زمینه های
accel_mpsps[]

Measurement3d

اندازه گیری شتاب سنج بر حسب متر/ثانیه^2 با افزایش مُهر زمانی از دستگاه ها.

gyro_rps[]

Measurement3d

اندازه گیری ژیروسکوپ بر حسب رادیان/ثانیه با افزایش مُهر زمانی دستگاه ها.

mag_ut[]

Measurement3d

اندازه‌گیری‌های مغناطیس‌سنج میدان مغناطیسی در میکروتسلا (uT) با افزایش مُهر زمانی از دستگاه‌ها.

اندازه گیری 3d

نمونه اندازه گیری سه بعدی عمومی

زمینه های
capture_time

Timestamp

مهر زمانی اندازه گیری IMU.

x

float

اندازه گیری سنسور در محور x.

y

float

اندازه گیری سنسور در محور y.

z

float

اندازه گیری سنسور در محور z.

جزئیات ImuDataGapFailure

جزئیات مربوط به ProcessingFailureReason#IMU_DATA_GAP. اگر چندین شکاف داده IMU وجود داشته باشد، تنها موردی که بیشترین مدت زمان را دارد در اینجا گزارش می شود.

زمینه های
gap_duration

Duration

مدت زمان شکاف در داده های IMU که پیدا شد.

gap_start_time

Duration

زمان نسبی (از شروع پخش جریانی ویدیو) زمانی که فاصله شروع شد.

InsufficientGpsFailureDetails

جزئیات مربوط به Processing FailureReason#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

اختیاری. مقدار nextPageToken از درخواست قبلی ListPhotoSequences در صورت وجود بازگردانده شده است.

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="نمونه یک عبارت.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

درخواست فهرست کردن همه عکس‌هایی که متعلق به کاربر ارسال کننده درخواست است.

به صورت پیش فرض

  • URL دانلود را برای بایت های عکس بر نمی گرداند.

مولفه های:

  • اگر URL دانلود برای بایت‌های عکس بازگردانده شود، view .
  • pageSize حداکثر تعداد عکس‌هایی که باید برگردانده شوند را تعیین می‌کند.
  • pageToken مقدار توکن صفحه بعدی است که از درخواست قبلی ListPhotos در صورت وجود بازگردانده شده است.
  • filter اجازه می دهد تا با یک پارامتر مشخص فیلتر شود. "placeId" تنها پارامتری است که در حال حاضر پشتیبانی می شود.
زمینه های
view

PhotoView

ضروری. مشخص می‌کند که آیا URL دانلود برای بایت‌های عکس‌ها باید در پاسخ عکس‌ها بازگردانده شود یا خیر.

page_size

int32

اختیاری. حداکثر تعداد عکس برای بازگشت. pageSize باید غیر منفی باشد. اگر pageSize صفر باشد یا ارائه نشده باشد، از اندازه صفحه پیش فرض 100 استفاده می شود. اگر تعداد عکس‌های متعلق به کاربر کمتر از pageSize باشد، ممکن است تعداد عکس‌های برگردانده شده در پاسخ کمتر از pageSize باشد.

page_token

string

اختیاری. مقدار nextPageToken از درخواست قبلی ListPhotos در صورت وجود برگردانده شده است.

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

زمان نسبی (از شروع پخش ویدئو) که یک قاب داخلی پیدا شد.

عکس

Photo برای ذخیره عکس های 360 همراه با متادیتای عکس استفاده می شود.

زمینه های
photo_id

PhotoId

ضروری. فقط خروجی هنگام به روز رسانی یک عکس ضروری است. خروجی فقط هنگام ایجاد عکس. شناسه عکس که در بین تمام عکس های گوگل بی نظیر است.

upload_reference

UploadRef

فقط ورودی هنگام ایجاد عکس ضروری است. فقط ورودی URL منبعی که بایت های عکس در آن آپلود می شوند.

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 Maps، چه این عکس منتشر شده باشد یا رد شده باشد.

MapsPublishStatus

وضعیت انتشار عکس در Google Maps.

Enums
UNSPECIFIED_MAPS_PUBLISH_STATUS وضعیت عکس مشخص نیست.
PUBLISHED این عکس از طریق نقشه گوگل برای عموم منتشر می شود.
REJECTED_UNKNOWN عکس به دلیل نامعلومی رد شده است.

وضعیت انتقال

وضعیت انتقال حقوق

Enums
TRANSFER_STATUS_UNKNOWN وضعیت این انتقال مشخص نیست.
NEVER_TRANSFERRED این عکس هرگز در انتقال نبوده است.
PENDING این انتقال عکس آغاز شده است، اما گیرنده هنوز پاسخی نداده است.
COMPLETED انتقال عکس انجام شد و این عکس به گیرنده منتقل شد.
REJECTED گیرنده این انتقال عکس را رد کرد.
EXPIRED انتقال عکس قبل از اینکه گیرنده اقدامی انجام دهد منقضی شد.
CANCELLED فرستنده این انتقال عکس را لغو کرد.
RECEIVED_VIA_TRANSFER گیرنده این عکس را به دلیل انتقال حقوق در اختیار دارد.

PhotoId

شناسه یک Photo

زمینه های
id

string

یک شناسه منحصر به فرد برای یک عکس.

PhotoResponse

بار پاسخ برای یک Photo واحد در عملیات دسته‌ای از جمله BatchGetPhotos و BatchUpdatePhotos .

زمینه های
status

Status

وضعیت عملیات دریافت یا به‌روزرسانی یک عکس واحد در درخواست دسته‌ای.

photo

Photo

منبع Photo ، در صورت موفقیت آمیز بودن درخواست.

عکس دنباله

دنباله ای از عکس های 360 به همراه متادیتا.

زمینه های
id

string

فقط خروجی شناسه منحصر به فرد برای دنباله عکس. اگر آپلود به صورت ناهمزمان انجام شود، این همچنین به عنوان یک شناسه عملیات طولانی مدت عمل می کند.

photos[]

Photo

فقط خروجی عکس هایی با افزایش زمان

upload_reference

UploadRef

فقط ورودی هنگام ایجاد توالی عکس مورد نیاز است. نام منبعی که بایت های دنباله عکس (به شکل ویدیو) در آن آپلود می شوند.

capture_time_override

Timestamp

اختیاری. زمان مطلقی که دنباله عکس شروع به گرفتن می کند. اگر دنباله عکس یک ویدیو است، این زمان شروع ویدیو است. اگر این فیلد در ورودی پر شده باشد، زمان ضبط ویدیو یا فایل XDM را لغو می کند.

upload_time

Timestamp

فقط خروجی زمانی که این توالی عکس در سرویس فروشگاه uSV ایجاد شد.

raw_gps_timeline[]

Pose

فقط ورودی اندازه‌گیری‌های جی‌پی‌اس خام با افزایش مُهرهای زمانی از دستگاه که با هر عکس همگام‌سازی نمی‌شوند. از این اندازه گیری های خام برای استنباط وضعیت هر فریم استفاده می شود. هنگامی که InputType VIDEO است و اندازه‌گیری‌های GPS خام در مسیر فراداده حرکت دوربین (CAMM) نیست، در ورودی مورد نیاز است. اگر اندازه‌گیری‌های خام GPS هم در خط زمانی raw_gps_time و هم در مسیر فراداده حرکت دوربین (CAMM) ارائه شده باشد، کاربر می‌تواند با استفاده از gps_source اولویت داشته باشد.

gps_source

GpsSource

فقط ورودی اگر هر دو raw_gps_timeline و Camera Motion Metadata Track (CAMM) دارای اندازه‌گیری‌های GPS هستند، مشخص کنید کدام یک اولویت دارد.

imu

Imu

فقط ورودی داده های سه محوری IMU برای مجموعه. اگر این داده ها برای قرار دادن در درخواست خیلی بزرگ است، باید در مسیر CAMM برای ویدیو قرار داده شود. این داده در صورت وجود، همیشه بر داده های CAMM معادل اولویت دارد.

processing_state

ProcessingState

فقط خروجی وضعیت پردازش این دنباله.

failure_reason

ProcessingFailureReason

فقط خروجی اگر این دنباله دارای processing_state = FAILED باشد، دلیل عدم موفقیت آن را در بر خواهد داشت. اگر processing_state مقدار دیگری باشد، این فیلد تنظیم نخواهد شد.

failure_details

ProcessingFailureDetails

فقط خروجی اگر این دنباله دارای failure_reason تنظیم شده باشد، ممکن است حاوی جزئیات بیشتری درباره شکست باشد.

distance_meters

double

فقط خروجی فاصله محاسبه شده دنباله عکس بر حسب متر.

sequence_bounds

LatLngBounds

فقط خروجی یک جعبه مستطیل شکل که هر تصویر را در این توالی عکس محصور می کند.

view_count

int64

فقط خروجی تعداد کل بازدیدهایی که تمامی تصاویر منتشر شده در این PhotoSequence دریافت کرده اند.

filename

string

فقط خروجی نام فایل آپلود. مسیر دایرکتوری را شامل نمی شود. فقط در صورتی در دسترس است که دنباله روی پلتفرمی آپلود شده باشد که نام فایل را ارائه می‌کند.

منبع جی پی اس

منبع اولیه اندازه گیری GPS

Enums
PHOTO_SEQUENCE GPS در raw_gps_timeline در صورت وجود اولویت دارد.
CAMERA_MOTION_METADATA_TRACK GPS در مسیر فراداده حرکت دوربین (CAMM) در صورت وجود اولویت دارد.

PhotoView

مشخص می کند که کدام نمای Photo در پاسخ قرار گیرد.

Enums
BASIC پاسخ های سرور شامل URL دانلود برای بایت های عکس نمی شود. مقدار پیش فرض
INCLUDE_DOWNLOAD_URL پاسخ های سرور شامل URL دانلود برای بایت های عکس است.

محل

فراداده مکان برای یک موجودیت.

زمینه های
place_id

string

شناسه مکان، همانطور که در https://developers.google.com/places/place-id توضیح داده شده است.

name

string

فقط خروجی نام مکان، بومی سازی شده به language_code.

language_code

string

فقط خروجی زبان_کد که نام با آن بومی سازی شده است. این باید زبان_کد مشخص شده در درخواست باشد، اما ممکن است بازگشتی باشد.

ژست

اندازه گیری حالت خام برای یک موجودیت.

زمینه های
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 مطابقت دارند. سمت قطب نما، در مرکز عکس در درجه در جهت عقربه های ساعت از شمال اندازه گیری می شود. مقدار باید >=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() . پلتفرم های دیگر روش های متفاوتی برای به دست آوردن تخمین های دقت مشابه دارند.

Processing FailureDetails

جزئیات بیشتر به همراه فهرست ProcessingFailureReason. انتظار می رود این پیام همیشه همراه با ProcessingFailureReason استفاده شود و مقدار یکی از تنظیم شده در این پیام باید با FailureReason مطابقت داشته باشد.

زمینه های
details فیلد اتحادیه فقط یک مجموعه از جزئیات تنظیم خواهد شد و باید با شماره مربوطه در ProcessingFailureReason مطابقت داشته باشد. details فقط می تواند یکی از موارد زیر باشد:
insufficient_gps_details

InsufficientGpsFailureDetails

InsufficientGpsFailureDetails را ببینید.

gps_data_gap_details

GpsDataGapFailureDetails

به جزئیات GpsDataGapFailure مراجعه کنید.

imu_data_gap_details

ImuDataGapFailureDetails

ImuDataGapFailureDetails را ببینید.

not_outdoors_details

NotOutdoorsFailureDetails

NotOutdoorsFailureDetails را ببینید.

no_overlap_gps_details

NoOverlapGpsFailureDetails

NoOverlapGpsFailureDetails را ببینید.

Processing FailureReason

دلایل احتمالی این PhotoSequence پردازش نشد.

Enums
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 داده های متحرک کافی نیست.

Processing State

وضعیت پردازش دنباله. ایالت ها به شرح زیر حرکت می کنند:

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

دنباله ممکن است از هر حالتی به FAILED منتقل شود. علاوه بر این، یک توالی پردازش شده ممکن است در هر زمانی دوباره پردازش شود.

Enums
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}"