יוצר סשן העלאה כדי להתחיל להעלות בייטים של תמונות. השיטה משתמשת בכתובת ה-URL להעלאה של UploadRef שהוחזרה כדי להעלות את הבייטים של Photo.
בנוסף לדרישות לגבי תמונות שמפורטות בכתובת https://support.google.com/maps/answer/7012050?ref_topic=6275604, התמונה צריכה לעמוד בדרישות הבאות:
- מטא-נתוני XMP של תמונה פנורמית ב-360° צריכים להיכלל במטא-נתונים של התמונה. בכתובת https://developers.google.com/streetview/spherical-metadata מפורטים שדות החובה.
- גודל התמונה בפיקסלים צריך לעמוד בדרישות הגודל שמפורטות במאמר https://support.google.com/maps/answer/7012050?ref_topic=6275604, והתמונה צריכה להיות תמונה מלאה של 360 מעלות אופקית.
אחרי שההעלאה מסתיימת, ה-method משתמש ב-UploadRef עם photo.create כדי ליצור את רשומת האובייקט Photo.
בקשת HTTP
POST https://streetviewpublish.googleapis.com/v1/photo:startUpload
כתובת ה-URL כתובה בתחביר של gRPC Transcoding.
גוף הבקשה
גוף הבקשה צריך להיות ריק.
גוף התשובה
אם הפעולה בוצעה ללא שגיאות, גוף התגובה יכיל מופע של UploadRef.
היקפי הרשאה
נדרש היקף ההרשאות הבא של OAuth:
https://www.googleapis.com/auth/streetviewpublish
ניתן למצוא מידע נוסף כאן: OAuth 2.0 Overview.