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 היא באמצעות המטא-נתונים של XMP של Photo מקומות שבבייטים של התמונות. 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 מתבצע דגימה, שמכיל הודעת 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 אחד או יותר. כברירת מחדל

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

פרמטרים:

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

string

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

PhotoView

חובה. המדיניות קובעת אם צריך להחזיר כתובת URL להורדה של הבייטים של התמונות בתשובה עם התמונה.
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.

טיפוסים בני מנייה (enum)
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.

כברירת מחדל

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

פרמטרים:

  • 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.

כברירת מחדל

  • לא מחזירה את כתובת ה-URL להורדה של 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

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

שדות
gap_duration

Duration

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

Duration

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

Imu

נתוני 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

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

שדות
gap_duration

Duration

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

Duration

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

InsufficientGpsFailureDetails

פרטים שקשורים ל-ProcessFailureReason#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 aexpression.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

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

כברירת מחדל

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

פרמטרים:

  • 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

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

שדות
gps_start_time

Timestamp

זמן של נקודת ה-GPS המתועדת הראשונה.
gps_end_time

Timestamp

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

Timestamp

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

Timestamp

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

NotOutdoorsFailureDetails

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

שדות
start_time

Duration

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

תמונה

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

שדות
photo_id

PhotoId

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

UploadRef

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

string

פלט בלבד. כתובת ה-URL להורדה של הבייטים של התמונות. השדה הזה מוגדר רק כאשר בשדה 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.

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

TransferStatus

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

טיפוסים בני מנייה (enum)
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 גולמיות עם חותמות זמן הולכות וגדלות מהמכשיר שלא מסתנכרנות עם כל תמונה. המדידות הגולמיות האלה ישמשו כדי להסיק את המיקום של כל פריים. נדרש כקלט כאשר קלטType הוא VIDEO ומדידות ה-GPS הגולמיות לא נמצאות ב'מעקב אחר מטא-נתונים של תנועת המצלמה' (CAMM). המשתמש יכול לציין איזה עדיפות מקבל עדיפות באמצעות gps_source אם מדידות GPS גולמיות מסופקות גם ב-RAW_gps_timeline וגם ב- Camera Motion Metadata Track (CAMM).
gps_source

GpsSource

קלט בלבד. אם גם RAW_gps_timeline וגם ה- Camera Motion Metadata Track (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

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

string

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

GpsSource

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

טיפוסים בני מנייה (enum)
PHOTO_SEQUENCE ה-GPS ב-Raw_gps_timeline מקבל עדיפות אם הוא קיים.
CAMERA_MOTION_METADATA_TRACK GPS ב- Camera Motion Metadata Track (CAMM) מקבל קדימות, אם הוא קיים.

PhotoView

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

טיפוסים בני מנייה (enum)
BASIC תגובות השרת לא כוללות את כתובת האתר להורדה עבור הבייטים של התמונות. ערך ברירת המחדל.
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

פרטים נוספים שנלווים ל-ProcessFailureReason enum. תמיד צריך להשתמש בהודעה הזו בשילוב עם ProcessingFailureReason, והערך של אחד מהסטטוסים בהודעה הזו צריך להיות תואם ל-"NegativeReason".

שדות
שדה איחוד details. תוגדר רק קבוצת פרטים אחת, והיא צריכה להתאים ל-enum המתאים ב-ProcessFailureReason. 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 זה נכשל.

טיפוסים בני מנייה (enum)
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<---------+
              +------+

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

טיפוסים בני מנייה (enum)
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}"