Method: photoSequence.create

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

photoSequence.create یک Operation با PhotoSequence ID در قسمت Operation.name برمی‌گرداند.

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

درخواست HTTP

POST https://streetviewpublish.googleapis.com/v1/photoSequence

URL از دستور GRPC Transcoding استفاده می کند.

پارامترهای پرس و جو

مولفه های
inputType

enum ( InputType )

ضروری. فرم ورودی PhotoSequence .

درخواست بدن

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

بدن پاسخگو

در صورت موفقیت آمیز بودن، بدنه پاسخ حاوی نمونه جدیدی از Operation است.

محدوده مجوز

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

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

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

عکس دنباله

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

نمایندگی JSON
{
  "id": string,
  "photos": [
    {
      object (Photo)
    }
  ],
  "uploadReference": {
    object (UploadRef)
  },
  "captureTimeOverride": string,
  "uploadTime": string,
  "rawGpsTimeline": [
    {
      object (Pose)
    }
  ],
  "gpsSource": enum (GpsSource),
  "imu": {
    object (Imu)
  },
  "processingState": enum (ProcessingState),
  "failureReason": enum (ProcessingFailureReason),
  "failureDetails": {
    object (ProcessingFailureDetails)
  },
  "distanceMeters": number,
  "sequenceBounds": {
    object (LatLngBounds)
  },
  "viewCount": string,
  "filename": string
}
زمینه های
id

string

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

photos[]

object ( Photo )

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

uploadReference

object ( UploadRef )

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

captureTimeOverride

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

uploadTime

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

rawGpsTimeline[]

object ( Pose )

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

gpsSource

enum ( GpsSource )

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

imu

object ( Imu )

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

processingState

enum ( ProcessingState )

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

failureReason

enum ( ProcessingFailureReason )

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

failureDetails

object ( ProcessingFailureDetails )

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

distanceMeters

number

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

sequenceBounds

object ( LatLngBounds )

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

viewCount

string ( int64 format)

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

filename

string

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

منبع جی پی اس

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

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

Imu

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

نمایندگی JSON
{
  "accelMpsps": [
    {
      object (Measurement3d)
    }
  ],
  "gyroRps": [
    {
      object (Measurement3d)
    }
  ],
  "magUt": [
    {
      object (Measurement3d)
    }
  ]
}
زمینه های
accelMpsps[]

object ( Measurement3d )

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

gyroRps[]

object ( Measurement3d )

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

magUt[]

object ( Measurement3d )

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

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

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

نمایندگی JSON
{
  "captureTime": string,
  "x": number,
  "y": number,
  "z": number
}
زمینه های
captureTime

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

x

number

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

y

number

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

z

number

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

Processing State

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

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

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

Enums
PROCESSING_STATE_UNSPECIFIED وضعیت نامشخص است، این مقدار پیش فرض است.
PENDING این سکانس هنوز پردازش را آغاز نکرده است.
PROCESSING دنباله در حال حاضر در حال پردازش است.
PROCESSED توالی پردازش از جمله موقعیت پالایش را به پایان رسانده است.
FAILED پردازش توالی ناموفق بود. برای جزئیات بیشتر به FailureReason مراجعه کنید.

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 FailureDetails

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

نمایندگی JSON
{

  // Union field details can be only one of the following:
  "insufficientGpsDetails": {
    object (InsufficientGpsFailureDetails)
  },
  "gpsDataGapDetails": {
    object (GpsDataGapFailureDetails)
  },
  "imuDataGapDetails": {
    object (ImuDataGapFailureDetails)
  },
  "notOutdoorsDetails": {
    object (NotOutdoorsFailureDetails)
  },
  "noOverlapGpsDetails": {
    object (NoOverlapGpsFailureDetails)
  }
  // End of list of possible types for union field details.
}
زمینه های
details فیلد اتحادیه فقط یک مجموعه از جزئیات تنظیم خواهد شد و باید با شماره مربوطه در ProcessingFailureReason مطابقت داشته باشد. details فقط می تواند یکی از موارد زیر باشد:
insufficientGpsDetails

object ( InsufficientGpsFailureDetails )

InsufficientGpsFailureDetails را ببینید.

gpsDataGapDetails

object ( GpsDataGapFailureDetails )

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

imuDataGapDetails

object ( ImuDataGapFailureDetails )

ImuDataGapFailureDetails را ببینید.

notOutdoorsDetails

object ( NotOutdoorsFailureDetails )

NotOutdoorsFailureDetails را ببینید.

noOverlapGpsDetails

object ( NoOverlapGpsFailureDetails )

NoOverlapGpsFailureDetails را ببینید.

InsufficientGpsFailureDetails

جزئیات مربوط به Processing FailureReason#INSUFFICIENT_GPS.

نمایندگی JSON
{
  "gpsPointsFound": integer
}
زمینه های
gpsPointsFound

integer

تعداد نقاط GPS که در ویدیو پیدا شد.

جزئیات GpsDataGapFailure

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

نمایندگی JSON
{
  "gapDuration": string,
  "gapStartTime": string
}
زمینه های
gapDuration

string ( Duration format)

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

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

gapStartTime

string ( Duration format)

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

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

جزئیات ImuDataGapFailure

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

نمایندگی JSON
{
  "gapDuration": string,
  "gapStartTime": string
}
زمینه های
gapDuration

string ( Duration format)

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

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

gapStartTime

string ( Duration format)

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

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

NotOutdoorsFailureDetails

جزئیات مربوط به ProcessingFailureReason#NOT_OUTDOORS. اگر چندین قاب داخلی پیدا شد، اولین فریم در اینجا ثبت می شود.

نمایندگی JSON
{
  "startTime": string
}
زمینه های
startTime

string ( Duration format)

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

مدت زمان در ثانیه با حداکثر نه رقم کسری که با ' s ' ختم می شود. مثال: "3.5s" .

NoOverlapGpsFailureDetails

جزئیات مربوط به PhotoSequenceProcessingFailureReason#NO_OVERLAP_GPS.

نمایندگی JSON
{
  "gpsStartTime": string,
  "gpsEndTime": string,
  "videoStartTime": string,
  "videoEndTime": string
}
زمینه های
gpsStartTime

string ( Timestamp format)

زمان ثبت اولین نقطه GPS.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

gpsEndTime

string ( Timestamp format)

زمان آخرین نقطه GPS ثبت شده

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

videoStartTime

string ( Timestamp format)

زمان شروع ویدیو

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

videoEndTime

string ( Timestamp format)

زمان پایان ویدیو

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

LatLngBounds

یک مستطیل در مختصات جغرافیایی.

نمایندگی JSON
{
  "southwest": {
    object (LatLng)
  },
  "northeast": {
    object (LatLng)
  }
}
زمینه های
southwest

object ( LatLng )

گوشه جنوب غربی این محدوده.

northeast

object ( LatLng )

گوشه شمال شرقی این محدوده.

نوع ورودی

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

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