Method: photoSequence.create

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

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 फ़ोटो का क्रम.

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 फ़ाइल में कैप्चर किए गए समय को बदल देता है.

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

string (Timestamp format)

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

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

object (Pose)

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

enum (GpsSource)

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

object (Imu)

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

enum (ProcessingState)

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

enum (ProcessingFailureReason)

सिर्फ़ आउटपुट के लिए. अगर इस क्रम में प्रोसेसिंग स्टेट = फ़ेल है, तो इसमें इसके न होने की वजह शामिल होगी. अगर प्रोसेसिंग स्टेट कोई दूसरी वैल्यू है, तो इस फ़ील्ड को सेट नहीं किया जाएगा.
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

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

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

object (Measurement3d)

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

object (Measurement3d)

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

object (Measurement3d)

माइक्रोटेस्ला (uT) में मैग्नेटोमीटर में चुंबकीय क्षेत्र की माप, जिसमें डिवाइसों के टाइमस्टैंप बढ़ते हैं.

मेज़रमेंट3d

3D मेज़रमेंट का सामान्य सैंपल.

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

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "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 क्रम को प्रोसेस नहीं किया जा सका. ज़्यादा जानकारी के लिए, अपग्रेड न होने की वजह देखें.

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

ProcessingFailureDetails

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

object (InsufficientGpsFailureDetails)

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

object (GpsDataGapFailureDetails)

GpsDataGapFailureDetails देखें.
imuDataGapDetails

object (ImuDataGapFailureDetails)

ImuDataGapFailureDetails देखें.
notOutdoorsDetails

object (NotOutdoorsFailureDetails)

NotOutdoorsFailureDetails देखें.
noOverlapGpsDetails

object (NoOverlapGpsFailureDetails)

NoओवरलैपGpsFailureDetails देखें.

InsufficientGpsFailureDetails

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

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

integer

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

GpsDataGapFailureDetails

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

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

string (Duration format)

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

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".
gapStartTime

string (Duration format)

गैप शुरू होने के समय का मिलता-जुलता समय (वीडियो स्ट्रीम की शुरुआत से).

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

ImuDataGapFailureDetails

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

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

string (Duration format)

आईएमयू डेटा में मिले गैप की अवधि.

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".
gapStartTime

string (Duration format)

गैप शुरू होने के समय का मिलता-जुलता समय (वीडियो स्ट्रीम की शुरुआत से).

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

NotOutdoorsFailureDetails

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

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

string (Duration format)

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

सेकंड में कुल नौ दशमलव अंक, जो 's' पर खत्म होते हैं. उदाहरण: "3.5s".

NoOverlapGpsFailureDetails

PhotoSequenceprocessingFailureReason#NO_OVERLAP_जीपीएस से जुड़ी जानकारी.

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

string (Timestamp format)

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

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

string (Timestamp format)

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

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

string (Timestamp format)

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

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

string (Timestamp format)

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

आरएफ़सी3339 यूटीसी "ज़ुलु" में टाइमस्टैंप फ़ॉर्मैट, नैनोसेकंड रिज़ॉल्यूशन और ज़्यादा से ज़्यादा नौ फ़्रैक्शनल अंकों के साथ हो सकता है. उदाहरण: "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)

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

InputType

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

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