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 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),
  "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)

الإدخال فقط. قياسات نظام تحديد المواقع العالمي (GPS) الأولية التي تتميّز بطابع زمني طويل من الجهاز لم تتم مزامنته مع كل صورة سيتم استخدام هذه القياسات الأولية لاستنتاج وضع كل إطار. يجب الإدخال عندما يكون نوع الإدخال هو VIDEO ولا تكون قياسات نظام تحديد المواقع العالمي (GPS) الأولية في حقل تتبُّع البيانات الوصفية لحركات الكاميرا (CAMM). يمكن للمستخدم الإشارة إلى خيار الأولوية باستخدام gpsSource في حال توفير قياسات نظام تحديد المواقع العالمي (GPS) الأولية في كل من RAWGpsTimeline ومسار البيانات الوصفية لحركة الكاميرا (CAMM).

gpsSource

enum (GpsSource)

الإدخال فقط. إذا كان كل من RAWGpsTimeline ومسار البيانات الوصفية لحركة الكاميرا (CAMM) يتضمّنان قياسات نظام تحديد المواقع العالمي (GPS)، يُرجى الإشارة إلى الأولوية.

imu

object (Imu)

الإدخال فقط. بيانات ثلاثة أنواع من IMU للمجموعة. إذا كانت هذه البيانات كبيرة جدًا بحيث لا يمكن إدراجها في الطلب، يجب وضعها في مسار CAMM للفيديو. ويكون لهذه البيانات الأولوية دائمًا على بيانات CAMM المكافئة، في حال توفّرها.

processingState

enum (ProcessingState)

الناتج فقط. حالة المعالجة لهذا التسلسل.

failureReason

enum (ProcessingFailureReason)

الناتج فقط. إذا كانت هذه التسلسل لهاProcessState = FAILED، ستتضمّن هذه القيمة سبب تعذّر إتمامها. وفي حال كانت حالة معالجة البيانات هي أي قيمة أخرى، سيتم إلغاء ضبط هذا الحقل.

distanceMeters

number

الناتج فقط. المسافة المحسوبة لتسلسل الصورة بالمتر.

sequenceBounds

object (LatLngBounds)

الناتج فقط. مربّع مستطيل يتضمّن كل صورة في تسلسل الصور هذا.

viewCount

string (int64 format)

الناتج فقط. إجمالي عدد المشاهدات التي تلقّتها كل الصور المنشورة في سلسلة الصور هذه.

filename

string

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

مصدر GpsSource

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

عمليات التعداد
PHOTO_SEQUENCE يكون لنظام تحديد المواقع العالمي (GPS) في RAWGpsTimeline الأولوية في حال توفّره.
CAMERA_MOTION_METADATA_TRACK يكون لنظام تحديد المواقع العالمي (GPS) في مسار البيانات الوصفية لحركة الكاميرا (CAMM) الأولوية في حال توفّره.

إيمو

بيانات 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

قياس جهاز الاستشعار في المحور "س"

y

number

قياس جهاز الاستشعار في المحور "ص".

z

number

قياس جهاز الاستشعار في المحور "ع"

حالة المعالجة

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

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

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

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

سبب فشل المعالجة

الأسباب المحتملة لتعذُّر معالجة 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 وقت الالتقاط غير صالح. كانت الطوابع الزمنية من المستقبل.

قناة LatLngBounds

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

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

object (LatLng)

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

northeast

object (LatLng)

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

نوع الإدخال

نماذج إدخال PhotoSequence.

عمليات التعداد
INPUT_TYPE_UNSPECIFIED غير محدد سيعرض الخادم google.rpc.Code.INVALID_ARGUMENT.
VIDEO فيديو 360
XDM البيانات الوصفية القابلة للامتداد للجهاز، http://www.xdm.org