Method: photoSequence.create

بعد أن ينتهي العميل من تحميل PhotoSequence باستخدام UploadRef الذي تم إرجاعه، يستخرج photoSequence.create سلسلة من الصور بزاوية 360 درجة من فيديو أو بيانات وصفية للأجهزة القابلة للتوسيع (XDM، http://www.xdm.org/) ليتم نشرها على "التجوّل الافتراضي" في "خرائط Google".

تعرض الدالة photoSequence.create Operation، مع ضبط معرّف PhotoSequence في الحقل Operation.name.

تُرجع هذه الطريقة رموز الخطأ التالية:

طلب HTTP

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

يستخدم عنوان URL بنية تحويل الترميز إلى gRPC.

مَعلمات طلب البحث

المعلمات
inputType

enum (InputType)

الحقل مطلوب. تمثّل هذه السمة نموذج الإدخال الخاص بـ PhotoSequence.

نص الطلب

يحتوي نص الطلب على مثال PhotoSequence.

نص الاستجابة

إذا كانت الاستجابة ناجحة، سيحتوي نصها على مثال تم إنشاؤه حديثًا Operation.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

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

لمزيد من المعلومات، يُرجى الاطّلاع على OAuth 2.0 Overview.

PhotoSequence

تسلسل من الصور بزاوية 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.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
uploadTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه إنشاء تسلسل الصور هذا في خدمة uSV Store.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
rawGpsTimeline[]

object (Pose)

الإدخال فقط قياسات نظام تحديد المواقع العالمي (GPS) الأولية مع طوابع زمنية متزايدة من الجهاز غير المتزامنة مع كل صورة سيتم استخدام هذه القياسات الأولية لاستنتاج وضع كل إطار. مطلوب في الإدخال عندما يكون InputType هو VIDEO ولا تكون قياسات نظام تحديد المواقع العالمي (GPS) الأولية في مسار بيانات الحركة في الكاميرا (CAMM). يمكن للمستخدم تحديد الأولوية باستخدام gpsSource إذا تم توفير قياسات نظام تحديد المواقع العالمي (GPS) الأولية في كلّ من rawGpsTimeline وCamera Motion Metadata Track (CAMM).
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

النتائج فقط. اسم الملف الذي تم تحميله لا يتضمّن مسار الدليل. لا يتوفّر هذا الخيار إلا إذا تم تحميل التسلسل على منصة توفّر اسم الملف.

GpsSource

المصدر الأساسي لقياسات نظام تحديد المواقع العالمي (GPS)

عمليات التعداد
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) مع زيادة الطوابع الزمنية من الأجهزة.

Measurement3d

مثال على قياس ثلاثي الأبعاد عام

تمثيل JSON 
{
  "captureTime": string,
  "x": number,
  "y": number,
  "z": number
}
الحقول
captureTime

string (Timestamp format)

الطابع الزمني لقياس وحدة القياس بالقصور الذاتي

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
x

number

قياس المستشعر على المحور x
y

number

قياس أداة الاستشعار على المحور y
z

number

قياس المستشعر على المحور z

ProcessingState

حالة معالجة التسلسل. تنتقل الحالات على النحو التالي:

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

قد تنتقل السلسلة إلى الحالة FAILED من أي حالة أخرى. بالإضافة إلى ذلك، يمكن إعادة معالجة تسلسل تمت معالجته في أي وقت.

عمليات التعداد
PROCESSING_STATE_UNSPECIFIED الحالة غير محدّدة، وهذه هي القيمة التلقائية.
PENDING لم تبدأ السلسلة في المعالجة بعد.
PROCESSING التسلسل قيد المعالجة حاليًا.
PROCESSED اكتملت معالجة التسلسل، بما في ذلك تحسين الموضع.
FAILED تعذّرت معالجة التسلسل. راجِع FailureReason لمزيد من التفاصيل.

ProcessingFailureReason

الأسباب المحتملة لتعذُّر معالجة PhotoSequence

عمليات التعداد
PROCESSING_FAILURE_REASON_UNSPECIFIED لم يتم تحديد سبب الخطأ، وهذه هي القيمة التلقائية.
LOW_RESOLUTION درجة دقة إطار الفيديو منخفضة جدًا.
DUPLICATE تم تحميل هذا الفيديو من قبل.
INSUFFICIENT_GPS عدد نقاط نظام تحديد المواقع العالمي (GPS) قليل جدًا.
NO_OVERLAP_GPS عدم التداخل بين الإطار الزمني لمسار نظام تحديد المواقع العالمي (GPS) والإطار الزمني للفيديو
INVALID_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 بيانات وحدة القياس بالقصور الذاتي (مقياس التسارع والجيروسكوب وما إلى ذلك) غير صالحة. قد تكون الحقول المطلوبة (س أو ص أو ع أو الوقت) غير متوفّرة، أو قد لا تكون منسَّقة بشكل صحيح، أو قد تكون هناك أي مشكلة أخرى تمنع أنظمتنا من تحليلها.
INSUFFICIENT_IMU عدد نقاط وحدة القياس بالقصور الذاتي قليل جدًا.
INSUFFICIENT_OVERLAP_TIME_SERIES عدم كفاية التداخل في الإطار الزمني بين نظام تحديد المواقع العالمي (GPS) ووحدة القياس بالقصور الذاتي (IMU) وبيانات السلسلة الزمنية الأخرى
IMU_DATA_GAP تتضمّن بيانات وحدة القياس بالقصور الذاتي (مقياس التسارع والجيروسكوب وما إلى ذلك) فجوات تزيد مدتها عن 0.1 ثانية.
UNSUPPORTED_CAMERA الكاميرا غير متوافقة.
NOT_OUTDOORS كانت بعض اللقطات في أماكن مغلقة، وهو أمر غير مسموح به.
INSUFFICIENT_VIDEO_FRAMES لا تتوفّر إطارات فيديو كافية.
INSUFFICIENT_MOVEMENT لا تتوفّر بيانات كافية عن الحركة.
MAST_DOWN السارية متجهة للأسفل.
CAMERA_COVERED الكاميرا محجوبة.

ProcessingFailureDetails

تفاصيل إضافية مصاحبة لتعداد ProcessingFailureReason. من المتوقّع دائمًا استخدام هذه الرسالة مع ProcessingFailureReason، ويجب أن تتطابق قيمة oneof التي تم ضبطها في هذه الرسالة مع 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)

اطّلِع على GpsDataGapFailureDetails.
imuDataGapDetails

object (ImuDataGapFailureDetails)

اطّلِع على ImuDataGapFailureDetails.
notOutdoorsDetails

object (NotOutdoorsFailureDetails)

اطّلِع على NotOutdoorsFailureDetails.
noOverlapGpsDetails

object (NoOverlapGpsFailureDetails)

اطّلِع على NoOverlapGpsFailureDetails.

InsufficientGpsFailureDetails

تفاصيل ذات صلة بـ ProcessingFailureReason#INSUFFICIENT_GPS

تمثيل JSON 
{
  "gpsPointsFound": integer
}
الحقول
gpsPointsFound

integer

عدد نقاط نظام تحديد المواقع العالمي (GPS) التي تم العثور عليها في الفيديو

GpsDataGapFailureDetails

تفاصيل متعلّقة بالخطأ ProcessingFailureReason#GPS_DATA_GAP إذا كانت هناك عدة فجوات في بيانات نظام تحديد المواقع العالمي (GPS)، سيتم الإبلاغ هنا عن الفجوة الأطول مدةً فقط.

تمثيل JSON 
{
  "gapDuration": string,
  "gapStartTime": string
}
الحقول
gapDuration

string (Duration format)

مدة الفجوة في بيانات نظام تحديد المواقع العالمي (GPS) التي تم العثور عليها

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"
gapStartTime

string (Duration format)

الوقت النسبي (من بداية بث الفيديو) الذي بدأ فيه الفاصل

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "s". مثال: "3.5s"

ImuDataGapFailureDetails

تفاصيل متعلّقة بـ ProcessingFailureReason#IMU_DATA_GAP. إذا كانت هناك فجوات متعدّدة في بيانات وحدة القياس بالقصور الذاتي، سيتم الإبلاغ هنا عن الفجوة الأطول مدةً فقط.

تمثيل JSON 
{
  "gapDuration": string,
  "gapStartTime": string
}
الحقول
gapDuration

string (Duration format)

مدة الفجوة التي تم رصدها في بيانات وحدة القياس بالقصور الذاتي

مدة بالثواني مع ما يصل إلى تسعة أرقام كسور، وتنتهي بـ "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

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
gpsEndTime

string (Timestamp format)

وقت آخر نقطة GPS تم تسجيلها

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
videoStartTime

string (Timestamp format)

وقت بدء الفيديو

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
videoEndTime

string (Timestamp format)

وقت انتهاء الفيديو

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".

LatLngBounds

مستطيل بالإحداثيات الجغرافية

تمثيل JSON 
{
  "southwest": {
    object (LatLng)
  },
  "northeast": {
    object (LatLng)
  }
}
الحقول
southwest

object (LatLng)

الزاوية الجنوبية الغربية لهذه الحدود
northeast

object (LatLng)

الزاوية الشمالية الشرقية لهذه الحدود

InputType

أشكال الإدخال في PhotoSequence

عمليات التعداد
INPUT_TYPE_UNSPECIFIED لم يتم تحديد أي قيمة. سيعرض الخادم google.rpc.Code.INVALID_ARGUMENT.
VIDEO فيديو 360
XDM Extensible Device Metadata، http://www.xdm.org