REST Resource: photo

משאב: תמונה

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

ייצוג JSON 
{
  "photoId": {
    object (PhotoId)
  },
  "uploadReference": {
    object (UploadRef)
  },
  "downloadUrl": string,
  "thumbnailUrl": string,
  "shareLink": string,
  "pose": {
    object (Pose)
  },
  "connections": [
    {
      object (Connection)
    }
  ],
  "captureTime": string,
  "uploadTime": string,
  "places": [
    {
      object (Place)
    }
  ],
  "viewCount": string,
  "transferStatus": enum (TransferStatus),
  "mapsPublishStatus": enum (MapsPublishStatus)
}
שדות
photoId

object (PhotoId)

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

object (UploadRef)

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

string

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

string

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

object (Pose)

זה שינוי אופציונלי. המצולמת של התמונה.
connections[]

object (Connection)

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

string (Timestamp format)

זה שינוי אופציונלי. הזמן האבסולוטי שבו התמונה צולמה. אם אין חותמת זמן של תצוגת exif בתמונה, חותמת זמן זו משמשת לציון חותמת הזמן במטא-נתונים של התמונה.

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
uploadTime

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
places[]

object (Place)

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

string (int64 format)

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

enum (TransferStatus)

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

enum (MapsPublishStatus)

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

PhotoId

מזהה של Photo.

ייצוג JSON 
{
  "id": string
}
שדות
id

string

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

UploadRef

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

ייצוג JSON 
{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}
שדות
שדה איחוד file_source. חובה. file_source יכול להיות רק אחת מהאפשרויות הבאות:
uploadUrl

string

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

תנוחה

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

ייצוג JSON 
{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}
שדות
latLngPair

object (LatLng)

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

number

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

number

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

number

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

number

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

string (Timestamp format)

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

חותמת זמן ב-RFC3339 UTC 'Zulu' בפורמט של רזולוציה של ננו-שנייה ועד תשע ספרות עשרוניות. דוגמאות: "2014-10-02T15:01:23Z" ו-"2014-10-02T15:01:23.045123456Z".
level

object (Level)

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

number

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

LatLng

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

ייצוג JSON 
{
  "latitude": number,
  "longitude": number
}
שדות
latitude

number

קו הרוחב במעלות. הוא חייב להיות בטווח [-90.0, +90.0].
longitude

number

קו האורך במעלות. הוא חייב להיות בטווח [-180.0, +180.0].

רמה

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

ייצוג JSON 
{
  "number": number,
  "name": string
}
שדות
number

number

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

string

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

חיבור

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

ייצוג JSON 
{
  "target": {
    object (PhotoId)
  }
}
שדות
target

object (PhotoId)

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

מקום

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

ייצוג JSON 
{
  "placeId": string,
  "name": string,
  "languageCode": string
}
שדות
placeId

string

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

string

פלט בלבד. שם המקום, תוך שימוש ב-languageCode.
languageCode

string

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

TransferStatus

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

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

MapsPublishStatus

סטטוס אתר החדשות של התמונה במפות Google.

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

שיטות

create

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

delete

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

get

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

startUpload

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

update

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