फ़ोटो बाइट अपलोड करना शुरू करने के लिए, अपलोड सेशन बनाता है. यह तरीका, Photo की बाइट अपलोड करने के लिए, दिखाए गए UploadRef के अपलोड यूआरएल का इस्तेमाल करता है.
https://support.google.com/maps/answer/7012050?ref_topic=6275604 में दिखाई गई फ़ोटो के लिए ज़रूरी शर्तों के अलावा, फ़ोटो को नीचे दी गई ज़रूरी शर्तें पूरी करनी होंगी:
- फ़ोटो स्फ़ीर XMP मेटाडेटा को फ़ोटो मेटाडेटा में शामिल करना ज़रूरी है. ज़रूरी फ़ील्ड देखने के लिए, https://developers.google.com/streetview/spherical-metadata पर जाएं.
- फ़ोटो का पिक्सल साइज़, https://support.google.com/maps/answer/7012050?ref_topic=6275604 में दी गई साइज़ की ज़रूरी शर्तों के मुताबिक होना चाहिए. साथ ही, फ़ोटो का साइज़, हॉरिज़ॉन्टल तौर पर 360 डिग्री होना चाहिए.
अपलोड पूरा होने के बाद, इस तरीके में photo.create के साथ UploadRef का इस्तेमाल करके, Photo ऑब्जेक्ट एंट्री बनाई जाती है.
एचटीटीपी अनुरोध
POST https://streetviewpublish.googleapis.com/v1/photo:startUpload
यूआरएल, gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य हिस्सा
कामयाब रहने पर, जवाब के मुख्य हिस्से में UploadRef का एक इंस्टेंस शामिल किया जाता है.
अनुमति देने के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/streetviewpublish
ज़्यादा जानकारी के लिए, OAuth 2.0 की खास जानकारी देखें.