Method: photoSequence.create

क्लाइंट के दिए गए UploadRef के साथ PhotoSequence को अपलोड करने के बाद, photoSequence.create किसी वीडियो या एक्सटेंसिबल डिवाइस के मेटाडेटा (XDM, http://www.xdm.org/) से 360o फ़ोटो का क्रम निकालता है, ताकि Google Maps पर Street View में पब्लिश किया जा सके.

photoSequence.create Operation.name फ़ील्ड में PhotoSequence आईडी सेट करके, Operation दिखाता है.

इस तरीके से ये गड़बड़ी कोड मिलते हैं:

एचटीटीपी अनुरोध

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

यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

क्वेरी पैरामीटर

पैरामीटर
inputType

enum (InputType)

ज़रूरी है. PhotoSequence का इनपुट फ़ॉर्म.

अनुरोध का मुख्य भाग

अनुरोध के मुख्य भाग में PhotoSequence का उदाहरण है.

जवाब का मुख्य भाग

कामयाब होने पर, रिस्पॉन्स के मुख्य हिस्से में Operation का नया इंस्टेंस शामिल किया जाता है.

अनुमति देने के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

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

ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.

PhotoSequence

मेटाडेटा के साथ 360o फ़ोटो का क्रम.

जेएसओएन के काेड में दिखाना 
{
  "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 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
uploadTime

string (Timestamp format)

सिर्फ़ आउटपुट के लिए. uSV Store सेवा में इस फ़ोटो के क्रम को बनाए जाने का समय.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
rawGpsTimeline[]

object (Pose)

सिर्फ़ इनपुट. हर फ़ोटो के साथ सिंक न होने वाले डिवाइस पर बढ़ते टाइमस्टैंप के साथ रॉ जीपीएस मेज़रमेंट. इन रॉ मेज़रमेंट का इस्तेमाल करके, हर फ़्रेम के पोज़ का अनुमान लगाया जाएगा. इनपुट में तब ज़रूरी है, जब InputType VIDEO है और रॉ जीपीएस मेज़रमेंट, कैमरा मोशन मेटाडेटा ट्रैक (CAMM) में नहीं हैं. अगर rawGpsTimeline और कैमरा मोशन मेटाडेटा ट्रैक (सीएएमएम), दोनों में रॉ जीपीएस मेज़रमेंट दिया गया हो, तो उपयोगकर्ता gpsSource का इस्तेमाल करके यह बता सकता है कि किसको प्राथमिकता दी जाएगी.
gpsSource

enum (GpsSource)

सिर्फ़ इनपुट. अगर rawGpsTimeline और कैमरा मोशन मेटाडेटा ट्रैक (सीएएमएम), दोनों में जीपीएस मेज़रमेंट शामिल है, तो बताएं कि किसे प्राथमिकता दी जाएगी.
imu

object (Imu)

सिर्फ़ इनपुट. कलेक्शन के लिए, तीन ऐक्सिस का IMU डेटा. अगर यह डेटा बहुत बड़ा है, तो इसे वीडियो के लिए CAMM ट्रैक में रखा जाना चाहिए. अगर यह डेटा मौजूद होता है, तो इसे हमेशा मिलते-जुलते सीएएमएम डेटा के मुकाबले प्राथमिकता दी जाती है.
processingState

enum (ProcessingState)

सिर्फ़ आउटपुट के लिए. इस क्रम की प्रोसेसिंग की स्थिति.
failureReason

enum (ProcessingFailureReason)

सिर्फ़ आउटपुट के लिए. अगर इस क्रम में transactionState = FAILED है, तो इसमें इसके पूरा न होने की वजह शामिल होगी. अगरprocessingState कोई दूसरी वैल्यू है, तो यह फ़ील्ड सेट नहीं होगा.
failureDetails

object (ProcessingFailureDetails)

सिर्फ़ आउटपुट के लिए. अगर इस क्रम में failureReason सेट किया गया है, तो इसमें गड़बड़ी के बारे में ज़्यादा जानकारी शामिल हो सकती है.
distanceMeters

number

सिर्फ़ आउटपुट के लिए. फ़ोटो के क्रम की तय की गई दूरी, मीटर में.
sequenceBounds

object (LatLngBounds)

सिर्फ़ आउटपुट के लिए. एक रेक्टैंगल बॉक्स, जिसमें फ़ोटो के इस क्रम की हर इमेज शामिल है.
viewCount

string (int64 format)

सिर्फ़ आउटपुट के लिए. इस PhotoSequence में मौजूद सभी पब्लिश की गई इमेज को मिले व्यू की कुल संख्या.
filename

string

सिर्फ़ आउटपुट के लिए. अपलोड का फ़ाइल नाम. डायरेक्ट्री पाथ शामिल नहीं है. यह सिर्फ़ तब उपलब्ध होता है, जब क्रम को फ़ाइल नाम देने वाले प्लैटफ़ॉर्म पर अपलोड किया गया हो.

GpsSource

जीपीएस मेज़रमेंट का मुख्य सोर्स.

Enums
PHOTO_SEQUENCE अगर rawGpsTimeline में जीपीएस की सुविधा मौजूद होती है, तो इसे प्राथमिकता दी जाती है.
CAMERA_MOTION_METADATA_TRACK कैमरा मोशन मेटाडेटा ट्रैक (सीएएमएम) में जीपीएस के मौजूद होने पर इसे प्राथमिकता दी जाती है.

इमू

डिवाइस के सेंसर से IMU डेटा.

जेएसओएन के काेड में दिखाना 
{
  "accelMpsps": [
    {
      object (Measurement3d)
    }
  ],
  "gyroRps": [
    {
      object (Measurement3d)
    }
  ],
  "magUt": [
    {
      object (Measurement3d)
    }
  ]
}
फ़ील्ड
accelMpsps[]

object (Measurement3d)

डिवाइसों से बढ़ते टाइमस्टैंप के साथ, एक्सलरोमीटर का माप मीटर/सेकंड^2 में है.
gyroRps[]

object (Measurement3d)

डिवाइसों से बढ़ते टाइमस्टैंप के साथ रेडियन/सेकंड में जाइरोस्कोप की माप.
magUt[]

object (Measurement3d)

डिवाइसों से बढ़ते टाइमस्टैंप के साथ माइक्रोटेस्ला (uT) में मैग्नेटिक फ़ील्ड का मैग्नेटोमीटर माप.

मेज़रमेंट 3d

सामान्य 3d माप का नमूना.

जेएसओएन के काेड में दिखाना 
{
  "captureTime": string,
  "x": number,
  "y": number,
  "z": number
}
फ़ील्ड
captureTime

string (Timestamp format)

IMU मेज़रमेंट का टाइमस्टैंप.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
x

number

x ऐक्सिस में सेंसर की माप.
y

number

y ऐक्सिस में सेंसर की माप.
z

number

z ऐक्सिस में सेंसर की माप.

ProcessingState

क्रम की प्रोसेसिंग की स्थिति. राज्यों की स्थिति इस तरह बदल जाती है:

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

यह क्रम किसी भी स्थिति से FAILED हो सकता है. इसके अलावा, प्रोसेस किए गए क्रम को किसी भी समय फिर से प्रोसेस किया जा सकता है.

Enums
PROCESSING_STATE_UNSPECIFIED स्थिति की जानकारी नहीं है, यह डिफ़ॉल्ट वैल्यू है.
PENDING क्रम अभी तक प्रोसेस नहीं हुआ है.
PROCESSING फ़िलहाल, क्रम प्रोसेस किया जा रहा है.
PROCESSED क्रम को प्रोसेस करने की प्रक्रिया पूरी हो गई है. इसमें जगह को बेहतर बनाने की प्रक्रिया भी शामिल है.
FAILED क्रम प्रोसेस नहीं किया जा सका. ज़्यादा जानकारी के लिए, just फ़्लो से जुड़ी समस्या देखें.

ProcessingFailureReason

इस PhotoSequence के प्रोसेस नहीं हो पाने की संभावित वजहें.

Enums
PROCESSING_FAILURE_REASON_UNSPECIFIED सफल न होने की वजह की जानकारी नहीं है. यह डिफ़ॉल्ट वैल्यू है.
LOW_RESOLUTION वीडियो फ़्रेम का रिज़ॉल्यूशन बहुत छोटा है.
DUPLICATE यह वीडियो पहले अपलोड किया जा चुका है.
INSUFFICIENT_GPS बहुत कम जीपीएस पॉइंट.
NO_OVERLAP_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 जीपीएस डेटा में, पांच सेकंड से ज़्यादा का अंतर है.
JUMPY_GPS जीपीएस डेटा में बदलाव नहीं होता, इसलिए इसे प्रोसेस नहीं किया जा सकता.
INVALID_IMU IMU (एक्सलरोमीटर, जाइरोस्कोप वगैरह) डेटा मान्य नहीं है. शायद उनमें ज़रूरी फ़ील्ड (x, y, z या समय) मौजूद न हों, सही तरीके से फ़ॉर्मैट नहीं किया गया हो या ऐसी कोई दूसरी समस्या हो जो हमारे सिस्टम को पार्स करने से रोकती हो.
INSUFFICIENT_IMU बहुत कम IMU पॉइंट हैं.
INSUFFICIENT_OVERLAP_TIME_SERIES जीपीएस, आईएमयू, और अन्य टाइम सीरीज़ डेटा के बीच की समयसीमा में, ओवरलैप न होना.
IMU_DATA_GAP IMU (एक्सलरोमीटर, जाइरोस्कोप वगैरह) डेटा में 0.1 सेकंड से ज़्यादा का अंतराल है.
UNSUPPORTED_CAMERA इस कैमरे का इस्तेमाल नहीं किया जा सकता.
NOT_OUTDOORS कुछ फ़्रेम, घर के अंदर थे. इसलिए, ये फ़्रेम इस्तेमाल नहीं किए जा सकते.
INSUFFICIENT_VIDEO_FRAMES ज़रूरत के मुताबिक वीडियो फ़्रेम नहीं हैं.
INSUFFICIENT_MOVEMENT काफ़ी मूविंग डेटा नहीं है.

ProcessingFailureDetails

प्रोसेसिंगFailure ऑब्जेक्ट की सूची के साथ दी जाने वाली अतिरिक्त जानकारी. इस मैसेज को प्रोसेसिंगFailureReason के साथ इस्तेमाल करना हमेशा ज़रूरी होता है. साथ ही, इस मैसेज में सेट की गई वैल्यू, फ़िल्म की गड़बड़ी की वजह से मेल खानी चाहिए.

जेएसओएन के काेड में दिखाना 
{

  // 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. जानकारी का सिर्फ़ एक सेट सेट किया जाएगा. इसे प्रोसेसिंगFailureREASON में बताई गई Enum से मेल खानी चाहिए. details इनमें से सिर्फ़ एक हो सकता है:
insufficientGpsDetails

object (InsufficientGpsFailureDetails)

अपर्याप्तGpsFailureDetails देखें.
gpsDataGapDetails

object (GpsDataGapFailureDetails)

GpsDataGapFailureDetails देखें.
imuDataGapDetails

object (ImuDataGapFailureDetails)

ImuDataGapFailureDetails देखें.
notOutdoorsDetails

object (NotOutdoorsFailureDetails)

NotOutdoorsFailureDetails देखें.
noOverlapGpsDetails

object (NoOverlapGpsFailureDetails)

NooverflowGpsFailureDetails देखें.

InsufficientGpsFailureDetails

प्रोसेसिंगFailure एलिमेंट#INSUFFICIENT_जीपीएस से जुड़ी जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "gpsPointsFound": integer
}
फ़ील्ड
gpsPointsFound

integer

वीडियो में मिले जीपीएस पॉइंट की संख्या.

GpsDataGapFailureDetails

प्रोसेसिंगFailure ऑब्जेक्ट#जीपीएस_DATA_GAP से जुड़ी जानकारी. अगर जीपीएस डेटा में एक से ज़्यादा गैप हैं, तो यहां सिर्फ़ सबसे ज़्यादा अवधि वाला डेटा ही शामिल किया जाएगा.

जेएसओएन के काेड में दिखाना 
{
  "gapDuration": string,
  "gapStartTime": string
}
फ़ील्ड
gapDuration

string (Duration format)

मिलने वाले जीपीएस डेटा में अंतर की अवधि.

सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो 's' पर खत्म होती है. उदाहरण: "3.5s".
gapStartTime

string (Duration format)

अंतराल शुरू होने के समय का सापेक्ष समय (वीडियो स्ट्रीम की शुरुआत से).

सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो 's' पर खत्म होती है. उदाहरण: "3.5s".

ImuDataGapFailureDetails

प्रोसेसिंगFailureReason#IMU_DATA_GAP से संबंधित जानकारी. अगर आईएमयू डेटा में एक से ज़्यादा अंतर हैं, तो यहां सिर्फ़ सबसे ज़्यादा अवधि वाले डेटा को रिपोर्ट किया जाता है.

जेएसओएन के काेड में दिखाना 
{
  "gapDuration": string,
  "gapStartTime": string
}
फ़ील्ड
gapDuration

string (Duration format)

पाए गए IMU डेटा में अंतर की अवधि.

सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो 's' पर खत्म होती है. उदाहरण: "3.5s".
gapStartTime

string (Duration format)

अंतराल शुरू होने के समय का सापेक्ष समय (वीडियो स्ट्रीम की शुरुआत से).

सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो 's' पर खत्म होती है. उदाहरण: "3.5s".

NotOutdoorsFailureDetails

प्रोसेसिंगFailureReason#NOT_OUTDOORS से जुड़ी जानकारी. अगर कई इनडोर फ़्रेम मिले हैं, तो पहला फ़्रेम यहां रिकॉर्ड किया जाता है.

जेएसओएन के काेड में दिखाना 
{
  "startTime": string
}
फ़ील्ड
startTime

string (Duration format)

इनडोर फ़्रेम मिलने के बाद का समय (वीडियो स्ट्रीम की शुरुआत से).

सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो 's' पर खत्म होती है. उदाहरण: "3.5s".

NoOverlapGpsFailureDetails

Photoसिक्वेंस प्रोसेसिंगFailureReason#NO_OVERLAP_जीपीएस से जुड़ी जानकारी.

जेएसओएन के काेड में दिखाना 
{
  "gpsStartTime": string,
  "gpsEndTime": string,
  "videoStartTime": string,
  "videoEndTime": string
}
फ़ील्ड
gpsStartTime

string (Timestamp format)

रिकॉर्ड किए गए पहले जीपीएस पॉइंट का समय.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
gpsEndTime

string (Timestamp format)

पिछली बार रिकॉर्ड किए गए जीपीएस पॉइंट का समय.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
videoStartTime

string (Timestamp format)

वीडियो के शुरू होने का समय.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".
videoEndTime

string (Timestamp format)

वीडियो के खत्म होने का समय.

RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: "2014-10-02T15:01:23Z" और "2014-10-02T15:01:23.045123456Z".

LatLngBounds

भौगोलिक निर्देशांक में एक रेक्टैंगल.

जेएसओएन के काेड में दिखाना 
{
  "southwest": {
    object (LatLng)
  },
  "northeast": {
    object (LatLng)
  }
}
फ़ील्ड
southwest

object (LatLng)

इन सीमाओं का दक्षिण-पश्चिमी कोना.
northeast

object (LatLng)

इन सीमाओं का उत्तर-पूर्व कोना.

InputType

PhotoSequence के इनपुट फ़ॉर्म.

Enums
INPUT_TYPE_UNSPECIFIED जानकारी नहीं दी गई. सर्वर google.rpc.Code.INVALID_ARGUMENT लौटाएगा.
VIDEO 360 डिग्री वाला वीडियो.
XDM एक्सटेंसिबल डिवाइस मेटाडेटा, http://www.xdm.org