Package google.streetview.publish.v1

אינדקס

StreetViewPublishService

מפרסם ומקשר תמונות שמשתמשים תרמו ב-Street View.

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

מחיקת רשימה של Photos והמטא-נתונים שלהם.

חשוב לשים לב שאם BatchDeletePhotos נכשל, חסרים שדות קריטיים או שיש שגיאת אימות. גם אם BatchDeletePhotos יצליח, יכול להיות שיהיו כשלים בתמונות בודדות בקבוצה. הכשלים האלה מצוינים בכל PhotoResponse.status בBatchDeletePhotosResponse.results. ב-DeletePhoto מפורטים כשלים ספציפיים בכל תמונה.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

הפונקציה מקבלת את המטא-נתונים של האצווה שצוינה ב-Photo.

חשוב לשים לב שאם BatchGetPhotos נכשל, חסרים שדות קריטיים או שיש שגיאת אימות. גם אם BatchGetPhotos יצליח, יכול להיות שיהיו כשלים בתמונות בודדות בקבוצה. הכשלים האלה מצוינים בכל PhotoResponse.status בBatchGetPhotosResponse.results. ב-GetPhoto מפורטים כשלים ספציפיים בכל תמונה.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

עדכון המטא-נתונים של Photos, כגון תנוחה, שיוך מקום, חיבורים וכו'. שינוי הפיקסלים של התמונות לא נתמך.

חשוב לשים לב שאם BatchUpdatePhotos נכשל, חסרים שדות קריטיים או שיש שגיאת אימות. גם אם BatchUpdatePhotos יצליח, יכול להיות שיהיו כשלים בתמונות בודדות בקבוצה. הכשלים האלה מצוינים בכל PhotoResponse.status בBatchUpdatePhotosResponse.results. ב-UpdatePhoto מפורטים כשלים ספציפיים בכל תמונה.

נעשה שימוש רק בשדות שצוינו בשדה updateMask. אם השדה updateMask לא קיים, העדכון חל על כל השדות.

מספר ההודעות של UpdatePhotoRequest בBatchUpdatePhotosRequest לא יכול לחרוג מ-20.

הערה: כדי לעדכן את Pose.altitude, צריך למלא גם את הערך Pose.latLngPair. אחרת, הבקשה תיכשל.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

אחרי שהלקוח יסיים להעלות את התמונה עם UploadRef שהוחזר, CreatePhoto יפרסם את Photo שהועלה ל-Street View במפות Google.

כרגע, הדרך היחידה להגדיר כותרת, מצגת מכירות וגלילה ב-CreatePhoto היא באמצעות המטא-נתונים של Photosphere XMP בבייטים של התמונות. התכונה CreatePhoto מתעלמת מהשדות pose.heading, pose.pitch, pose.roll, pose.altitude ו-pose.level ב-Pose.

השיטה הזו מחזירה את קודי השגיאה הבאים:

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

לאחר שהלקוח יסיים להעלות את PhotoSequence עם ה-UploadRef שהוחזר, CreatePhotoSequence שולף רצף של תמונות 360 מסרטון או מטא-נתונים של מכשיר שניתן להרחבה (XDM, http://www.xdm.org/) כדי לפרסם אותם ב-Street View במפות Google.

CreatePhotoSequence מחזירה Operation, כאשר המזהה של PhotoSequence מוגדר בשדה Operation.name.

השיטה הזו מחזירה את קודי השגיאה הבאים:

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

מוחק Photo ואת המטא-נתונים שלו.

השיטה הזו מחזירה את קודי השגיאה הבאים:

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

מוחק PhotoSequence ואת המטא-נתונים שלו.

השיטה הזו מחזירה את קודי השגיאה הבאים:

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

הפונקציה מקבלת את המטא-נתונים של Photo שצוין.

השיטה הזו מחזירה את קודי השגיאה הבאים:

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

הפונקציה מקבלת את המטא-נתונים של השדה PhotoSequence שצוין דרך הממשק של Operation.

שיטה זו מחזירה את שלושת סוגי התגובות הבאים:

  • Operation.done = False, אם העיבוד של PhotoSequence עדיין לא הסתיים.
  • Operation.done = true ו-Operation.error מאוכלס, אם הייתה שגיאה בעיבוד.
  • Operation.done = true ו-Operation.response poulated, שמכיל הודעת PhotoSequence.

השיטה הזו מחזירה את קודי השגיאה הבאים:

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

בתיבת הדו-שיח הזו מפורטים כל ה-PhotoSequences ששייכים למשתמש, בסדר יורד של חותמות זמן ב-CreatePhotoSequence.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

בתיבת הדו-שיח הזו מפורטים כל Photos ששייכים למשתמש.

הערה: תמונות שנוצרו לאחרונה אבל נוספו לאינדקס עדיין לא מוחזרות בתגובה.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

יוצר סשן העלאה כדי להתחיל להעלות נתונים של רצף תמונות. כתובת ה-URL להעלאה של UploadRef שהוחזר משמשת להעלאת הנתונים של photoSequence.

בסיום ההעלאה, נעשה שימוש ב-UploadRef יחד עם CreatePhotoSequence כדי ליצור את רשומת האובייקט PhotoSequence.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
StartUpload

rpc StartUpload(Empty) returns (UploadRef)

יוצר סשן העלאה של העלאת בייטים של תמונות. השיטה משתמשת בכתובת ה-URL להעלאה של ה-UploadRef שהוחזר כדי להעלות את הבייטים עבור Photo.

בנוסף לדרישות לגבי תמונות שמופיעות בכתובת https://support.google.com/maps/answer/7012050?ref_topic=6275604, התמונה צריכה לעמוד בדרישות הבאות:

אחרי שההעלאה מסתיימת, השיטה משתמשת ב-UploadRef עם CreatePhoto כדי ליצור את רשומת האובייקט Photo.

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.
UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

עדכון המטא-נתונים של Photo, כגון תנוחה, שיוך מקום, חיבורים וכו'. שינוי הפיקסלים של תמונה לא נתמך.

נעשה שימוש רק בשדות שצוינו בשדה updateMask. אם השדה updateMask לא קיים, העדכון חל על כל השדות.

השיטה הזו מחזירה את קודי השגיאה הבאים:

היקפי הרשאות

נדרש היקף OAuth הבא:

  • https://www.googleapis.com/auth/streetviewpublish

למידע נוסף, עיין בסקירה הכללית על OAuth 2.0.

BatchDeletePhotosRequest

עליך לשלוח בקשה למחוק כמה פריטים של Photos.

שדות
photo_ids[]

string

חובה. המזהים של Photos. בקשות HTTP GET מחייבות את התחביר הבא עבור פרמטר השאילתה של כתובת ה-URL: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

תגובה למחיקה אחת של Photos או יותר בכמות גדולה.

שדות
status[]

Status

הסטטוס של הפעולה למחיקת Photo יחיד בבקשת האצווה.

BatchGetPhotosRequest

עליך לשלוח בקשה לקבלת Photos אחד או יותר. כברירת מחדל

  • לא מחזיר את כתובת האתר להורדה של הבייטים של התמונות.

פרמטרים:

  • view קובע אם תוחזר כתובת ה-URL להורדה של הבייטים של התמונות.
שדות
photo_ids[]

string

חובה. המזהים של Photos. בבקשות HTTP GET, פרמטר השאילתה של כתובת ה-URL צריך להיות photoIds=<id1>&photoIds=<id2>&....
view

PhotoView

חובה. מציינת אם כתובת URL להורדה של הבייטים של התמונות תוחזר בתגובה ל-Photos.
language_code

string

אפשרות. קוד השפה BCP-47, למשל "en-US" או "sr-Latn". מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. אם לא צוין language_code, ייעשה שימוש בהעדפות השפה של המשתמש עבור שירותי Google.

BatchGetPhotosResponse

תגובה לקבוצה של Photos.

שדות
results[]

PhotoResponse

רשימת תוצאות לכל בקשה בנפרד עבור Photo, באותו סדר שבו מוצגות הבקשות ב-BatchGetPhotos.

BatchUpdatePhotosRequest

עליך לבקש לעדכן את המטא-נתונים של התמונות. אין תמיכה בעדכון הפיקסלים של התמונות.

שדות
update_photo_requests[]

UpdatePhotoRequest

חובה. רשימה של UpdatePhotoRequests.

BatchUpdatePhotosResponse

תגובה לעדכון אחד או יותר של מטא-נתונים מסוג Photos.

שדות
results[]

PhotoResponse

רשימת התוצאות לכל עדכון Photo בנפרד, באותו סדר שבו מופיעה הבקשה.

חיבור

חיבור הוא הקישור מתמונת מקור לתמונת יעד.

שדות
target

PhotoId

חובה. יעד החיבור מהתמונה שמכילה לתמונה אחרת.

CreatePhotoRequest

עליך לשלוח בקשה ליצור Photo.

שדות
photo

Photo

חובה. תמונה ליצירה.

CreatePhotoSequenceRequest

עליך לשלוח בקשה ליצירת PhotoSequence מסרטון.

שדות
photo_sequence

PhotoSequence

חובה. PhotoSequence כדי ליצור.
input_type

InputType

חובה. צורת הקלט של PhotoSequence.

InputType

צורות קלט של PhotoSequence.

טיפוסים בני מנייה (enums)
INPUT_TYPE_UNSPECIFIED לא צוין. השרת יחזיר google.rpc.Code.INVALID_ARGUMENT.
VIDEO וידאו 360.
XDM מטא-נתונים של מכשירים מורחבים, http://www.xdm.org

DeletePhotoRequest

עליך לשלוח בקשה למחוק Photo.

שדות
photo_id

string

חובה. המזהה של Photo.

DeletePhotoSequenceRequest

עליך לשלוח בקשה למחוק PhotoSequence.

שדות
sequence_id

string

חובה. המזהה של PhotoSequence.

GetPhotoRequest

עליך לשלוח בקשה לקבלת Photo.

כברירת מחדל

  • לא מחזיר את כתובת האתר להורדה של הבייטים של התמונות.

פרמטרים:

  • view קובע אם תוחזר כתובת ה-URL להורדה של הבייטים של התמונות.
שדות
photo_id

string

חובה. המזהה של Photo.
view

PhotoView

חובה. המדיניות קובעת אם יש להחזיר כתובת URL להורדה של הבייטים של התמונות בתגובה Photo.
language_code

string

קוד השפה BCP-47, למשל "en-US" או "sr-Latn". מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. אם לא צוין language_code, ייעשה שימוש בהעדפות השפה של המשתמש עבור שירותי Google.

GetPhotoSequenceRequest

עליך לשלוח בקשה לקבלת PhotoSequence.

כברירת מחדל

  • לא מחזיר את כתובת האתר להורדה עבור PhotoSequence.

פרמטרים:

  • view קובע אם תוחזר כתובת ה-URL להורדה של PhotoSequence.
שדות
sequence_id

string

חובה. המזהה של רצף התמונות.
view
(deprecated)

PhotoView

המדיניות הזו קובעת אם כתובת URL להורדה של רצף התמונות תוחזר ב-download_url מהתמונות הנפרדות בתגובה PhotoSequence.

הערה: לא מיושם כרגע.
filter

string

אפשרות. ביטוי המסנן. לדוגמה: published_status=PUBLISHED

המסננים הנתמכים הם: published_status. מידע נוסף זמין בכתובת https://google.aip.dev/160.

GpsDataGapFailureDetails

פרטים שקשורים לעיבודFailureReason#GPS_DATA_GAP. אם קיימים מספר פערים בנתוני ה-GPS, יוצג כאן רק היעד עם משך הזמן הגבוה ביותר.

שדות
gap_duration

Duration

משך הזמן של הפער בנתוני ה-GPS שנמצאו.
gap_start_time

Duration

הזמן היחסי (מתחילת שידור הווידאו) מרגע שהפער התחיל.

אימו

נתוני IMU מחיישני המכשיר.

שדות
accel_mpsps[]

Measurement3d

מד התאוצה נמדד במטרים לשנייה ב^2 עם חותמות זמן גדלות ממכשירים.
gyro_rps[]

Measurement3d

מדידות הג'ירוסקופ ברדיאנים לשנייה עם חותמות זמן במכשירים שגדלות.
mag_ut[]

Measurement3d

מדידות המגנטומטר של השדה המגנטי במיקרו-טסלה (uT) עם עלייה בחותמות הזמן ממכשירים.

מדידה3d

דגימה כללית של מדידת תלת ממד.

שדות
capture_time

Timestamp

חותמת הזמן של מדידת ה-IMU.
x

float

מדידת החיישן בציר ה-x.
y

float

מדידת החיישן בציר ה-y.
z

float

מדידת החיישן בציר ה-z.

ImuDataGapFailureDetails

פרטים הקשורים לעיבודFailureReason#IMU_DATA_GAP. אם יש כמה פערים בנתונים של מכשיר IMU, רק המדד עם משך הזמן הארוך ביותר מדווח כאן.

שדות
gap_duration

Duration

משך הפער בנתוני ה-IMU שנמצא.
gap_start_time

Duration

הזמן היחסי (מתחילת שידור הווידאו) מרגע שהפער התחיל.

InsufficientGpsFailureDetails

פרטים שקשורים לעיבודFailureReason#INSUFFICIENT_GPS.

שדות
gps_points_found

int32

מספר נקודות ה-GPS שנמצאו בסרטון.

LatLngBounds

מלבן בקואורדינטות גיאוגרפיות.

שדות
southwest

LatLng

הפינה הדרום-מערבית של גבולות אלה.
northeast

LatLng

הפינה הצפון-מזרחית של גבולות אלה.

רמה

פרטי הרמה שמכילים את מספר הרמה ואת השם התואם שלה.

שדות
number

double

אפשרות. מספר הקומה, משמש להזמנה. 0 מציין את רמת הקרקע, 1 מציין את המפלס הראשון מעל לפני הקרקע, 1 מציין את המפלס הראשון מתחת לפני הקרקע. מותר להשתמש בערכים לא שלמים.
name

string

חובה. שם שהוקצה לרמה הזו, מוגבל ל-3 תווים. מומלץ לחשוב איך יתויגו לחצני המעלית לקומה הזו אם יש בה מעלית.

ListPhotoSequencesRequest

בקשה לקבל רשימה של כל רצפי התמונות ששייכים למשתמש ששולח את הבקשה.

פרמטרים:

  • pageSize קובע את המספר המקסימלי של רצפי תמונות להחזרה.
  • pageToken הוא ערך האסימון של הדף הבא שמוחזר מבקשת ListPhotoSequences קודמת, אם הייתה כזו.
שדות
page_size

int32

אפשרות. המספר המקסימלי של רצפי תמונות להחזרה. הערך pageSize חייב להיות מספר לא שלילי. אם הערך בשדה pageSize הוא אפס או לא צוין, ייעשה שימוש בגודל ברירת המחדל של 100 בדף. מספר רצפי התמונות שהוחזרו בתגובה עשוי להיות קטן מ-pageSize אם מספר ההתאמות קטן מ-pageSize. האפשרות הזו לא מיושמת כרגע אבל נמצאת בתהליך.
page_token

string

אפשרות. הערך של nextPageToken שהוחזר מבקשת ListPhotoSequences קודמת, אם הייתה כזו.
filter

string

אפשרות. ביטוי המסנן. לדוגמה: imagery_type=SPHERICAL

המסננים הנתמכים הם: imagery_type, processing_state, min_latitude, max_latitude, min_longitude, max_longitude, filename_query, min_capture_time_seconds, 'max_capture_time_seconds. מידע נוסף זמין בכתובת https://google.aip.dev/160. יש לשלוח שאילתות לגבי שמות קבצים כביטוי, על מנת לתמוך במספר מילים ותווים מיוחדים, על ידי הוספת מירכאות כפולות. לדוגמה: filename_query="example of a phrase.mp4"

ListPhotoSequencesResponse

תגובה לרשימה של כל רצפי התמונות ששייכים למשתמש.

שדות
photo_sequences[]

Operation

רשימה של רצפי תמונות דרך ממשק Operation.

המספר המקסימלי של פריטים שמוחזרים מבוסס על השדה pageSize בבקשה.

לכל פריט ברשימה יכולים להיות שלושה מצבים אפשריים:

  • Operation.done = False, אם העיבוד של PhotoSequence עדיין לא הסתיים.
  • Operation.done = true ו-Operation.error מאוכלס, אם הייתה שגיאה בעיבוד.
  • Operation.done = true ו-Operation.response מכיל הודעת PhotoSequence. בכל רצף, רק Id מאוכלס.
next_page_token

string

אסימון לאחזור דף התוצאות הבא, או ריק אם אין עוד תוצאות ברשימה.

ListPhotosRequest

יש לבקש להציג את כל התמונות ששייכות למשתמש ששולח את הבקשה.

כברירת מחדל

  • לא מחזיר את כתובת האתר להורדה של הבייטים של התמונות.

פרמטרים:

  • view קובע אם תוחזר כתובת ה-URL להורדה של הבייטים של התמונות.
  • המספר המקסימלי של תמונות שיוחזר נקבע על ידי pageSize.
  • pageToken הוא ערך האסימון של הדף הבא שמוחזר מבקשת ListPhotos קודמת, אם הייתה כזו.
  • באמצעות filter אפשר לסנן לפי פרמטר נתון. בשלב זה, 'placeId' הוא הפרמטר היחיד שנתמך.
שדות
view

PhotoView

חובה. ההגדרה קובעת אם כתובת URL להורדה של הבייטים של התמונות תוחזר בתגובה של Photos.
page_size

int32

אפשרות. המספר המקסימלי של תמונות להחזרה. הערך pageSize חייב להיות מספר לא שלילי. אם הערך בשדה pageSize הוא אפס או לא צוין, ייעשה שימוש בגודל ברירת המחדל של 100 בדף. מספר התמונות שיוחזרו בתשובה עשוי להיות קטן מ-pageSize אם מספר התמונות ששייכות למשתמש קטן מ-pageSize.
page_token

string

אפשרות. הערך של nextPageToken שהוחזר מבקשת ListPhotos קודמת, אם הייתה כזו.
filter

string

אפשרות. ביטוי המסנן. לדוגמה: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw

המסננים הנתמכים הם: placeId, min_latitude, max_latitude, min_longitude, max_longitude. מידע נוסף זמין בכתובת https://google.aip.dev/160.
language_code

string

אפשרות. קוד השפה BCP-47, למשל "en-US" או "sr-Latn". מידע נוסף זמין בכתובת http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. אם לא צוין language_code, ייעשה שימוש בהעדפות השפה של המשתמש עבור שירותי Google.

ListPhotosResponse

תגובה לרשימה של כל התמונות ששייכות למשתמש.

שדות
photos[]

Photo

רשימת התמונות. מספר הפריטים שיוחזרו בבקשה נקבע בשדה pageSize.
next_page_token

string

אסימון לאחזור דף התוצאות הבא, או ריק אם אין עוד תוצאות ברשימה.

NoOverlapGpsFailureDetails

פרטים הקשורים ל-PhotoSequenceSequenceFailureReason#NO_OVERLAP_GPS.

שדות
gps_start_time

Timestamp

שעת ההקלטה הראשונה של נקודת ה-GPS.
gps_end_time

Timestamp

שעת ההקלטה האחרונה של נקודת ה-GPS.
video_start_time

Timestamp

שעת ההתחלה של הסרטון.
video_end_time

Timestamp

שעת הסיום של הסרטון.

NotOutdoorsFailureDetails

פרטים הקשורים לעיבודFailureReason#NOT_OUTDOORS. אם נמצאו כמה מסגרות מקורות, הפריים הראשון מתועד כאן.

שדות
start_time

Duration

זמן יחסי (מתחילת שידור הווידאו) כאשר נמצאה פריים מקורה.

תמונה

התמונה משמשת לאחסון תמונות 360 יחד עם מטא-נתונים של תמונות.

שדות
photo_id

PhotoId

חובה. פלט בלבד. חובה כשמעדכנים תמונה. שומרים את הפלט רק כשיוצרים תמונה. המזהה של התמונה. זהו מזהה ייחודי בכל התמונות ב-Google.
upload_reference

UploadRef

קלט בלבד. חובה כשיוצרים תמונה. קלט בלבד. כתובת ה-URL של המשאב שאליו מועלים הבייטים של התמונות.
download_url

string

פלט בלבד. כתובת האתר להורדה של הבייטים של התמונות. השדה הזה מוגדר רק אם בשדה GetPhotoRequest.view מוגדר הערך PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnail_url

string

פלט בלבד. כתובת ה-URL של התמונה הממוזערת להצגת תצוגה מקדימה של התמונה הנתונה.
pose

Pose

אפשרות. תנוחת התמונה.
connections[]

Connection

אפשרות. חיבורים לתמונות אחרות. חיבור מייצג את הקישור מתמונה זו לתמונה אחרת.
capture_time

Timestamp

אפשרות. הזמן המוחלט שבו התמונה צולמה. אם לתמונה אין חותמת זמן של EXIF, היא משמשת להגדרת חותמת זמן במטא-נתונים של התמונה.
upload_time

Timestamp

פלט בלבד. השעה שבה התמונה הועלתה.
places[]

Place

אפשרות. המקומות שאליהם התמונה הזו שייכת.
view_count

int64

פלט בלבד. מספר צפיות בתמונה.
transfer_status

TransferStatus

פלט בלבד. סטטוס העברת הזכויות בתמונה הזו.
maps_publish_status

MapsPublishStatus

פלט בלבד. הסטטוס במפות Google, בין אם התמונה פורסמה או נדחתה.

MapsPublishStatus

סטטוס הפרסום של התמונה במפות Google.

טיפוסים בני מנייה (enums)
UNSPECIFIED_MAPS_PUBLISH_STATUS סטטוס התמונה אינו ידוע.
PUBLISHED התמונה תפורסם לציבור באמצעות מפות Google.
REJECTED_UNKNOWN התמונה נדחתה מסיבה לא ידועה.

TransferStatus

הסטטוס של העברת הזכויות.

טיפוסים בני מנייה (enums)
TRANSFER_STATUS_UNKNOWN לא צוין סטטוס ההעברה.
NEVER_TRANSFERRED התמונה הזו אף פעם לא הועברה.
PENDING העברת התמונות החלה, אבל הנמען עדיין לא הגיב.
COMPLETED העברת התמונות הושלמה, והתמונה הועברה לנמען.
REJECTED הנמען דחה את העברת התמונות הזו.
EXPIRED התוקף של העברת התמונות פג לפני שהנמען ביצע פעולה כלשהי.
CANCELLED השולח ביטל את העברת התמונות הזו.
RECEIVED_VIA_TRANSFER הנמען הוא הבעלים של התמונה הזו בגלל העברת זכויות.

PhotoId

מזהה של Photo.

שדות
id

string

מזהה ייחודי לתמונה.

PhotoResponse

מטען ייעודי (payload) של תגובה עבור Photo יחיד בפעולות אצווה, כולל BatchGetPhotos ו-BatchUpdatePhotos.

שדות
status

Status

הסטטוס של הפעולה כדי לקבל או לעדכן תמונה יחידה בבקשת האצווה.
photo

Photo

המשאב Photo, אם הבקשה בוצעה בהצלחה.

PhotoSequence

רצף של תמונות 360 עם מטא-נתונים.

שדות
id

string

פלט בלבד. המזהה הייחודי של רצף התמונות. מזהה זה משמש גם כמזהה פעולה ארוך אם ההעלאה מתבצעת באופן אסינכרוני.
photos[]

Photo

פלט בלבד. תמונות עם חותמות זמן שעולות בהדרגה.
upload_reference

UploadRef

קלט בלבד. נדרש כשיוצרים רצף תמונות. שם המשאב שאליו מועלים הבייטים של רצף התמונות (כסרטון).
capture_time_override

Timestamp

אפשרות. הזמן המוחלט מרגע התחלת הצילום של רצף התמונות. אם רצף התמונות הוא סרטון, זוהי שעת ההתחלה של הסרטון. אם השדה הזה מאוכלס בקלט, הוא מבטל את זמן הצילום של הסרטון או בקובץ ה-XDM.
upload_time

Timestamp

פלט בלבד. השעה שבה רצף התמונות הזה נוצר בשירות החנות של uSV.
raw_gps_timeline[]

Pose

קלט בלבד. מדידות GPS גולמיות עם חותמות זמן שגדלות ועולות מהמכשיר, שלא מסתנכרנות עם כל תמונה בזמן. המדידות הגולמיות האלה ישמשו כדי להסיק את התנוחה של כל מסגרת. נדרש בקלט כאשר שיטת הקלט היא VIDEO ומדידות GPS גולמיות לא נכללות במעקב המטא-נתונים של תנועת המצלמה (CAMM). המשתמש יכול לציין איזה מהם מקבל עדיפות באמצעות gps_source אם מדידות GPS גולמיות זמינות גם ב-RAW_gps_timeline וגם בטראק מטא-נתונים של תנועת מצלמה (CAMM).
gps_source

GpsSource

קלט בלבד. אם גם RAW_gps_timeline וגם הטראק של המטא-נתונים של תנועת המצלמה (CAMM) מכילים מדידות GPS, יש לציין איזה מהם מקבל עדיפות.
imu

Imu

קלט בלבד. נתוני IMU עם שלושה צירים לאוסף. אם הנתונים האלה גדולים מדי ולא ניתן לכלול אותם בבקשה, צריך להוסיף אותם למסלול CAMM של הסרטון. הנתונים האלה תמיד מקבלים עדיפות על פני נתוני CAMM מקבילים, אם הם קיימים.
processing_state

ProcessingState

פלט בלבד. מצב העיבוד של הרצף הזה.
failure_reason

ProcessingFailureReason

פלט בלבד. אם הרצף הזה כולל את הערךprocessing_state = FAILED, המאפיין יכלול את הסיבה לכך. אם ה-processing_state הוא ערך אחר כלשהו, השדה הזה לא יוגדר.
failure_details

ProcessingFailureDetails

פלט בלבד. אם הרצף הזה מוגדר כ-failure_reason, ייתכן שיהיו פרטים נוספים על הכשל.
distance_meters

double

פלט בלבד. המרחק המחושב של רצף התמונות במטרים.
sequence_bounds

LatLngBounds

פלט בלבד. תיבה מלבנית המקיפה כל תמונה ברצף התמונות הזה.
view_count

int64

פלט בלבד. מספר הצפיות הכולל שקיבלו כל התמונות שפורסמו ברצף התמונות הזה.
filename

string

פלט בלבד. שם הקובץ של ההעלאה. לא כולל את נתיב הספרייה. האפשרות הזו זמינה רק אם הרצף הועלה לפלטפורמה שמספקת את שם הקובץ.

GpsSource

המקור העיקרי של מדידות GPS.

טיפוסים בני מנייה (enums)
PHOTO_SEQUENCE ל-GPS בערך RAW_gps_timeline יש עדיפות אם הוא קיים.
CAMERA_MOTION_METADATA_TRACK ל-GPS בערוץ המטא-נתונים של המצלמה (CAMM) יש עדיפות אם הוא קיים.

PhotoView

ההגדרה קובעת איזו תצוגה של Photo תכלול בתגובה.

טיפוסים בני מנייה (enums)
BASIC תגובות השרת לא כוללות את כתובת ה-URL להורדה של הבייטים של התמונות. ערך ברירת המחדל.
INCLUDE_DOWNLOAD_URL תגובות השרת כוללות את כתובת ה-URL להורדה של הבייטים של התמונות.

מקום

הוספת מטא-נתונים לישות.

שדות
place_id

string

מזהה מקום, כפי שמתואר בכתובת https://developers.google.com/places/place-id.
name

string

פלט בלבד. שם המקום, שהותאם ל-language_code.
language_code

string

פלט בלבד. ה-language_code שעמו הותאם לשוק המקומי של השם. הוא צריך להיות ה-language_code שצוין בבקשה, אבל יכול להיות שהוא יהיה חלופה.

תנוחה

מדידת תנוחות גולמיות של ישות.

שדות
lat_lng_pair

LatLng

צמדים של קווי אורך ורוחב בתנוחה, כפי שמוסבר כאן: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng ביצירת Photo, אם לא סופקו צמדים של קווי אורך ורוחב, נעשה שימוש במיקום הגיאוגרפי של כותרת ה-exif. צמד קו רוחב וקו אורך שלא צוין בתמונה או בכותרת ה-exif עלול לגרום לתקלה בתהליך התמונה.
altitude

double

גובה התנוחה במטרים מעל אליפסואיד WGS84. NaN מציין כמות לא נמדדת.
heading

double

הפרמטרים הבאים של התנוחה נוגעים למרכז התמונה. הן תואמות ל-https://developers.google.com/streetview/spherical-metadata. כותרת המצפן, נמדדת במרכז התמונה במעלות בכיוון השעון מצפון. הערך חייב להיות גדול מ-0 וקטן מ-360. NaN מציין כמות לא נמדדת.
pitch

double

גובה הצליל, שנמדד במרכז התמונה במעלות. הערך חייב להיות גדול מ-90-> ו-<= 90. המשמעות של 90- היא להביט ישירות למטה, וערך של 90 פירושו להביט ישירות למעלה. NaN מציין כמות לא נמדדת.
roll

double

סיבוב, נמדד במעלות. הערך חייב להיות גדול מ-0 וקטן מ-360. ערך של 0 פירושו רמה מול האופק. NaN מציין כמות לא נמדדת.
gps_record_timestamp_unix_epoch

Timestamp

השעה של רשומת ה-GPS מאז תקופת זמן UTC.
level

Level

מפלס (הקומה במבנה) המשמשת להגדרת ניווט אנכי.
accuracy_meters

float

הדיוק האופקי המשוער של תנוחה זו במטרים ברמת ודאות של 68% (סטיית תקן אחת). לדוגמה, ב-Android, הערך הזה זמין בשיטה הבאה: https://developer.android.com/reference/android/location/Location#getAccuracy(). בפלטפורמות אחרות יש שיטות שונות להשגת הערכות דיוק דומות.

ProcessingFailureDetails

פרטים נוספים שנלווים לטיפוסים של אי-העיבוד. יש להשתמש תמיד בהודעה הזו בשילוב עם AcceptFailureReason, והערך שמוגדר בהודעה הזו צריך להתאים ל-failureReason.

שדות
שדה איחוד details. רק קבוצה אחת של פרטים תוגדר, והיא חייבת להתאים לטיפוסים הטיפוסיים (enum) המתאימים ב-processingFailureReason. הערך של details יכול להיות רק אחת מהאפשרויות הבאות:
insufficient_gps_details

InsufficientGpsFailureDetails

למידע נוסף, ניתן לעיין בקטע InsufficientGpsFailureDetails.
gps_data_gap_details

GpsDataGapFailureDetails

פרטים נוספים זמינים בקטע GpsDataGapFailureDetails.
imu_data_gap_details

ImuDataGapFailureDetails

מידע נוסף זמין ב-ImuDataGapFailureDetails.
not_outdoors_details

NotOutdoorsFailureDetails

ראו NotOutdoorsFailureDetails.
no_overlap_gps_details

NoOverlapGpsFailureDetails

מידע נוסף זמין ב-NoOverlapGpsFailureDetails.

ProcessingFailureReason

הסיבות האפשריות לכך שהעיבוד של PhotoSequence נכשל.

טיפוסים בני מנייה (enums)
PROCESSING_FAILURE_REASON_UNSPECIFIED סיבת הכשל לא צוינה. זהו ערך ברירת המחדל.
LOW_RESOLUTION הרזולוציה של הפריים של הסרטון קטנה מדי.
DUPLICATE הסרטון הזה כבר הועלה בעבר.
INSUFFICIENT_GPS מעט מדי נקודות GPS.
NO_OVERLAP_GPS אין חפיפה בין מסגרת הזמן של מסלול ה-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 בנתוני ה-GPS יש פער של יותר מ-5 שניות.
JUMPY_GPS נתוני ה-GPS לא יציבים מדי לעיבוד.
INVALID_IMU נתוני IMU (מד תאוצה, ג'ירוסקופ וכו') לא תקינים. ייתכן שחסרים בהם שדות חובה (x, y, z או זמן), שהפורמט שלהם שגוי או שיש בעיה אחרת שמונעת מהמערכות שלנו לנתח אותם.
INSUFFICIENT_IMU יש מעט מדי נקודות IMU.
INSUFFICIENT_OVERLAP_TIME_SERIES אין מספיק חפיפה במסגרת הזמן בין ה-GPS לבין נתוני ה-IMU ונתונים אחרים של פעולות על ציר הזמן.
IMU_DATA_GAP בנתוני IMU (מד תאוצה, ג'ירוסקופ וכו') יש פערים במשך של יותר מ-0.1 שניות.
UNSUPPORTED_CAMERA המצלמה לא נתמכת.
NOT_OUTDOORS חלק מהפריימים היו בתוך הבית, וההגדרה הזו לא נתמכת.
INSUFFICIENT_VIDEO_FRAMES אין מספיק פריימים של וידאו.
INSUFFICIENT_MOVEMENT אין מספיק נתונים בהעברה.

ProcessingState

מצב העיבוד של הרצף. המצבים משתנים באופן הבא:

     +-------------------------+
     |                         |
 +---v---+  +----------+  +----+----+
 |PENDING+-->PROCESSING+-->PROCESSED|
 +---+---+  +----+-----+  +----+----+
     |           |             |
     |        +--v---+         |
     +-------->FAILED<---------+
              +------+

הרצף עשוי לעבור לסטטוס 'נכשל' מכל מצב. בנוסף, בכל שלב ניתן לעבד מחדש רצף שעבר עיבוד.

טיפוסים בני מנייה (enums)
PROCESSING_STATE_UNSPECIFIED לא צוין מצב, זהו ערך ברירת המחדל.
PENDING עיבוד הרצף עוד לא התחיל.
PROCESSING הרצף נמצא כרגע בתהליך עיבוד.
PROCESSED העיבוד של הרצף הסתיים, כולל מיקום הצמצום.
FAILED עיבוד הרצף נכשל. לפרטים נוספים, אפשר לעיין ב'סיבת הכשל'.

UpdatePhotoRequest

עליך לשלוח בקשה לעדכון המטא-נתונים של Photo. אין תמיכה בעדכון הפיקסלים של תמונה.

שדות
photo

Photo

חובה. אובייקט Photo שמכיל את המטא-נתונים החדשים.
update_mask

FieldMask

חובה. הוספת מסכה שמזהה שדות במטא-נתונים של התמונות שיש לעדכן. אם לא קיימים, המטא-נתונים הישנים מסוג Photo יוחלפו במטא-נתונים החדשים של Photo בבקשה הזו. העדכון ייכשל אם יצוינו שדות לא חוקיים. ברשימה מופרדת בפסיקים אפשר לציין כמה שדות.

השדות הבאים חוקיים:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

הערה: כאשר updateMask מכיל שדות חוזרים, כל הערכים החוזרים מוחלפים בתוכן החדש. לדוגמה, אם המשתנה updateMask מכיל את הערך connections והשדה UpdatePhotoRequest.photo.connections ריק, כל החיבורים יוסרו.

UploadRef

העלאת קובצי עזר לקובצי מדיה.

שדות
שדה איחוד file_source. חובה. הערך של file_source יכול להיות רק אחת מהאפשרויות הבאות:
upload_url

string

קובץ עזר להעלאה צריך להיות ייחודי לכל משתמש. היא תהיה בתבנית הבאה: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}"