Method: photoSequence.create

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

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

यह तरीका, गड़बड़ी के ये कोड दिखाता है:

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

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

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

यह आरएफ़सी 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 सेवा में कब बनाया गया था.

यह आरएफ़सी 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)

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

enum (GpsSource)

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

object (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

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

Enums
PHOTO_SEQUENCE अगर rawGpsTimeline में जीपीएस मौजूद है, तो उसे प्राथमिकता दी जाती है.
CAMERA_MOTION_METADATA_TRACK अगर कैमरा मोशन मेटाडेटा ट्रैक (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

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

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

string (Timestamp format)

आईएमयू मेज़रमेंट का टाइमस्टैंप.

यह आरएफ़सी 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 में बदल सकती है. इसके अलावा, प्रोसेस की गई किसी भी सीक्वेंस को किसी भी समय फिर से प्रोसेस किया जा सकता है.

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

ProcessingFailureReason

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

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

ProcessingFailureDetails

ProcessingFailureReason enum के साथ दी जाने वाली अतिरिक्त जानकारी. इस मैसेज का इस्तेमाल हमेशा 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 में मौजूद संबंधित enum से मेल खानी चाहिए. 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

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

GpsDataGapFailureDetails

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

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

string (Duration format)

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

यह अवधि सेकंड में होती है. इसमें नौ दशमलव अंक तक हो सकते हैं. इसके आखिर में '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)

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

यह आरएफ़सी 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)

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

यह आरएफ़सी 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)

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

यह आरएफ़सी 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)

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

यह आरएफ़सी 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 के इनपुट फ़ॉर्म.

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