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)

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

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

string (Timestamp format)

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

חותמת זמן בפורמט "Zulu" של RFC3339 UTC, ברזולוציה של ננו-שניות ועד תשע ספרות עשרוניות. דוגמאות: "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, גם אם התמונה הזו פורסמה וגם אם היא נדחתה.

מזהה תמונה

מזהה של Photo.

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

string

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

העלאה

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

ייצוג 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.

חותמת זמן בפורמט "Zulu" של RFC3339 UTC, ברזולוציה של ננו-שניות ועד תשע ספרות עשרוניות. דוגמאות: "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(). בפלטפורמות אחרות יש שיטות שונות לקבלת הערכות דיוק דומות.

הנ"צ

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

string

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

סטטוס העברה

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

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

סטטוס הפרסום ב-Maps

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

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

שיטות

create

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

delete

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

get

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

startUpload

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

update

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