- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- PhotoSequence
- GpsSource
- इमू
- मेज़रमेंट3d
- ProcessingState
- ProcessingFailureReason
- ProcessingFailureDetails
- InsufficientGpsFailureDetails
- GpsDataGapFailureDetails
- ImuDataGapFailureDetails
- NotOutdoorsFailureDetails
- NoOverlapGpsFailureDetails
- LatLngBounds
- InputType
- इसे आज़माएं!
क्लाइंट के दिए गए UploadRef
के साथ PhotoSequence
को अपलोड करने के बाद, photoSequence.create
किसी वीडियो या एक्सटेंसिबल डिवाइस के मेटाडेटा (XDM, http://www.xdm.org/) से 360o फ़ोटो का क्रम निकालता है, ताकि Google Maps पर Street View में पब्लिश किया जा सके.
photoSequence.create
Operation.name
फ़ील्ड में PhotoSequence
आईडी सेट करके, Operation
दिखाता है.
इस तरीके से ये गड़बड़ी कोड मिलते हैं:
google.rpc.Code.INVALID_ARGUMENT
, अगर अनुरोध गलत तरीके से किया गया है.google.rpc.Code.NOT_FOUND
, अगर अपलोड रेफ़रंस मौजूद नहीं है.
एचटीटीपी अनुरोध
POST https://streetviewpublish.googleapis.com/v1/photoSequence
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
inputType |
ज़रूरी है. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में PhotoSequence
का उदाहरण है.
जवाब का मुख्य भाग
कामयाब होने पर, रिस्पॉन्स के मुख्य हिस्से में Operation
का नया इंस्टेंस शामिल किया जाता है.
अनुमति देने के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/streetviewpublish
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.
PhotoSequence
मेटाडेटा के साथ 360o फ़ोटो का क्रम.
जेएसओएन के काेड में दिखाना |
---|
{ "id": string, "photos": [ { object ( |
फ़ील्ड | |
---|---|
id |
सिर्फ़ आउटपुट के लिए. फ़ोटो के क्रम के लिए यूनीक आइडेंटिफ़ायर. अगर अपलोड एसिंक्रोनस तरीके से किया जाता है, तो यह लंबे समय तक चलने वाले ऑपरेशन आईडी के तौर पर भी काम करता है. |
photos[] |
सिर्फ़ आउटपुट के लिए. बढ़ते टाइमस्टैंप वाली फ़ोटो. |
uploadReference |
सिर्फ़ इनपुट. फ़ोटो का क्रम बनाते समय ज़रूरी है. संसाधन का नाम जहां फ़ोटो के क्रम (वीडियो के रूप में) की बाइट अपलोड की जाती हैं. |
captureTimeOverride |
ज़रूरी नहीं. फ़ोटो के क्रम को कैप्चर करने का कुल समय. अगर फ़ोटो का क्रम एक वीडियो है, तो यह वीडियो के शुरू होने का समय होगा. अगर इस फ़ील्ड में जानकारी अपने-आप भर जाती है, तो यह वीडियो या XDM फ़ाइल में कैप्चर करने के समय को बदल देती है. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: |
uploadTime |
सिर्फ़ आउटपुट के लिए. uSV Store सेवा में इस फ़ोटो के क्रम को बनाए जाने का समय. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: |
rawGpsTimeline[] |
सिर्फ़ इनपुट. हर फ़ोटो के साथ सिंक न होने वाले डिवाइस पर बढ़ते टाइमस्टैंप के साथ रॉ जीपीएस मेज़रमेंट. इन रॉ मेज़रमेंट का इस्तेमाल करके, हर फ़्रेम के पोज़ का अनुमान लगाया जाएगा. इनपुट में तब ज़रूरी है, जब InputType VIDEO है और रॉ जीपीएस मेज़रमेंट, कैमरा मोशन मेटाडेटा ट्रैक (CAMM) में नहीं हैं. अगर rawGpsTimeline और कैमरा मोशन मेटाडेटा ट्रैक (सीएएमएम), दोनों में रॉ जीपीएस मेज़रमेंट दिया गया हो, तो उपयोगकर्ता gpsSource का इस्तेमाल करके यह बता सकता है कि किसको प्राथमिकता दी जाएगी. |
gpsSource |
सिर्फ़ इनपुट. अगर rawGpsTimeline और कैमरा मोशन मेटाडेटा ट्रैक (सीएएमएम), दोनों में जीपीएस मेज़रमेंट शामिल है, तो बताएं कि किसे प्राथमिकता दी जाएगी. |
imu |
सिर्फ़ इनपुट. कलेक्शन के लिए, तीन ऐक्सिस का IMU डेटा. अगर यह डेटा बहुत बड़ा है, तो इसे वीडियो के लिए CAMM ट्रैक में रखा जाना चाहिए. अगर यह डेटा मौजूद होता है, तो इसे हमेशा मिलते-जुलते सीएएमएम डेटा के मुकाबले प्राथमिकता दी जाती है. |
processingState |
सिर्फ़ आउटपुट के लिए. इस क्रम की प्रोसेसिंग की स्थिति. |
failureReason |
सिर्फ़ आउटपुट के लिए. अगर इस क्रम में transactionState = FAILED है, तो इसमें इसके पूरा न होने की वजह शामिल होगी. अगरprocessingState कोई दूसरी वैल्यू है, तो यह फ़ील्ड सेट नहीं होगा. |
failureDetails |
सिर्फ़ आउटपुट के लिए. अगर इस क्रम में |
distanceMeters |
सिर्फ़ आउटपुट के लिए. फ़ोटो के क्रम की तय की गई दूरी, मीटर में. |
sequenceBounds |
सिर्फ़ आउटपुट के लिए. एक रेक्टैंगल बॉक्स, जिसमें फ़ोटो के इस क्रम की हर इमेज शामिल है. |
viewCount |
सिर्फ़ आउटपुट के लिए. इस PhotoSequence में मौजूद सभी पब्लिश की गई इमेज को मिले व्यू की कुल संख्या. |
filename |
सिर्फ़ आउटपुट के लिए. अपलोड का फ़ाइल नाम. डायरेक्ट्री पाथ शामिल नहीं है. यह सिर्फ़ तब उपलब्ध होता है, जब क्रम को फ़ाइल नाम देने वाले प्लैटफ़ॉर्म पर अपलोड किया गया हो. |
GpsSource
जीपीएस मेज़रमेंट का मुख्य सोर्स.
Enums | |
---|---|
PHOTO_SEQUENCE |
अगर rawGpsTimeline में जीपीएस की सुविधा मौजूद होती है, तो इसे प्राथमिकता दी जाती है. |
CAMERA_MOTION_METADATA_TRACK |
कैमरा मोशन मेटाडेटा ट्रैक (सीएएमएम) में जीपीएस के मौजूद होने पर इसे प्राथमिकता दी जाती है. |
इमू
डिवाइस के सेंसर से IMU डेटा.
जेएसओएन के काेड में दिखाना |
---|
{ "accelMpsps": [ { object ( |
फ़ील्ड | |
---|---|
accelMpsps[] |
डिवाइसों से बढ़ते टाइमस्टैंप के साथ, एक्सलरोमीटर का माप मीटर/सेकंड^2 में है. |
gyroRps[] |
डिवाइसों से बढ़ते टाइमस्टैंप के साथ रेडियन/सेकंड में जाइरोस्कोप की माप. |
magUt[] |
डिवाइसों से बढ़ते टाइमस्टैंप के साथ माइक्रोटेस्ला (uT) में मैग्नेटिक फ़ील्ड का मैग्नेटोमीटर माप. |
मेज़रमेंट 3d
सामान्य 3d माप का नमूना.
जेएसओएन के काेड में दिखाना |
---|
{ "captureTime": string, "x": number, "y": number, "z": number } |
फ़ील्ड | |
---|---|
captureTime |
IMU मेज़रमेंट का टाइमस्टैंप. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: |
x |
x ऐक्सिस में सेंसर की माप. |
y |
y ऐक्सिस में सेंसर की माप. |
z |
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 . जानकारी का सिर्फ़ एक सेट सेट किया जाएगा. इसे प्रोसेसिंगFailureREASON में बताई गई Enum से मेल खानी चाहिए. details इनमें से सिर्फ़ एक हो सकता है: |
|
insufficientGpsDetails |
अपर्याप्तGpsFailureDetails देखें. |
gpsDataGapDetails |
GpsDataGapFailureDetails देखें. |
imuDataGapDetails |
ImuDataGapFailureDetails देखें. |
notOutdoorsDetails |
NotOutdoorsFailureDetails देखें. |
noOverlapGpsDetails |
NooverflowGpsFailureDetails देखें. |
InsufficientGpsFailureDetails
प्रोसेसिंगFailure एलिमेंट#INSUFFICIENT_जीपीएस से जुड़ी जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "gpsPointsFound": integer } |
फ़ील्ड | |
---|---|
gpsPointsFound |
वीडियो में मिले जीपीएस पॉइंट की संख्या. |
GpsDataGapFailureDetails
प्रोसेसिंगFailure ऑब्जेक्ट#जीपीएस_DATA_GAP से जुड़ी जानकारी. अगर जीपीएस डेटा में एक से ज़्यादा गैप हैं, तो यहां सिर्फ़ सबसे ज़्यादा अवधि वाला डेटा ही शामिल किया जाएगा.
जेएसओएन के काेड में दिखाना |
---|
{ "gapDuration": string, "gapStartTime": string } |
फ़ील्ड | |
---|---|
gapDuration |
मिलने वाले जीपीएस डेटा में अंतर की अवधि. सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो ' |
gapStartTime |
अंतराल शुरू होने के समय का सापेक्ष समय (वीडियो स्ट्रीम की शुरुआत से). सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो ' |
ImuDataGapFailureDetails
प्रोसेसिंगFailureReason#IMU_DATA_GAP से संबंधित जानकारी. अगर आईएमयू डेटा में एक से ज़्यादा अंतर हैं, तो यहां सिर्फ़ सबसे ज़्यादा अवधि वाले डेटा को रिपोर्ट किया जाता है.
जेएसओएन के काेड में दिखाना |
---|
{ "gapDuration": string, "gapStartTime": string } |
फ़ील्ड | |
---|---|
gapDuration |
पाए गए IMU डेटा में अंतर की अवधि. सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो ' |
gapStartTime |
अंतराल शुरू होने के समय का सापेक्ष समय (वीडियो स्ट्रीम की शुरुआत से). सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो ' |
NotOutdoorsFailureDetails
प्रोसेसिंगFailureReason#NOT_OUTDOORS से जुड़ी जानकारी. अगर कई इनडोर फ़्रेम मिले हैं, तो पहला फ़्रेम यहां रिकॉर्ड किया जाता है.
जेएसओएन के काेड में दिखाना |
---|
{ "startTime": string } |
फ़ील्ड | |
---|---|
startTime |
इनडोर फ़्रेम मिलने के बाद का समय (वीडियो स्ट्रीम की शुरुआत से). सेकंड में अवधि, जिसमें नौ भिन्नात्मक अंक हो सकते हैं और जो ' |
NoOverlapGpsFailureDetails
Photoसिक्वेंस प्रोसेसिंगFailureReason#NO_OVERLAP_जीपीएस से जुड़ी जानकारी.
जेएसओएन के काेड में दिखाना |
---|
{ "gpsStartTime": string, "gpsEndTime": string, "videoStartTime": string, "videoEndTime": string } |
फ़ील्ड | |
---|---|
gpsStartTime |
रिकॉर्ड किए गए पहले जीपीएस पॉइंट का समय. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: |
gpsEndTime |
पिछली बार रिकॉर्ड किए गए जीपीएस पॉइंट का समय. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: |
videoStartTime |
वीडियो के शुरू होने का समय. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: |
videoEndTime |
वीडियो के खत्म होने का समय. RFC3339 यूटीसी "ज़ुलु" फ़ॉर्मैट में एक टाइमस्टैंप, जिसमें नैनोसेकंड रिज़ॉल्यूशन और नौ फ़्रैक्शनल अंक तक हो सकते हैं. उदाहरण: |
LatLngBounds
भौगोलिक निर्देशांक में एक रेक्टैंगल.
जेएसओएन के काेड में दिखाना |
---|
{ "southwest": { object ( |
फ़ील्ड | |
---|---|
southwest |
इन सीमाओं का दक्षिण-पश्चिमी कोना. |
northeast |
इन सीमाओं का उत्तर-पूर्व कोना. |
InputType
PhotoSequence
के इनपुट फ़ॉर्म.
Enums | |
---|---|
INPUT_TYPE_UNSPECIFIED |
जानकारी नहीं दी गई. सर्वर google.rpc.Code.INVALID_ARGUMENT लौटाएगा. |
VIDEO |
360 डिग्री वाला वीडियो. |
XDM |
एक्सटेंसिबल डिवाइस मेटाडेटा, http://www.xdm.org |