- משאב: תמונה
- מזהה תמונה
- UploadRef
- תנוחה
- אמריקה הלטינית
- רמה
- חיבור
- מקום
- העברת סטטוס
- מפות Google – סטטוס
- שיטות
משאב: תמונה
התמונה משמשת לאחסון תמונות 360 יחד עם המטא-נתונים של התמונות.
ייצוג JSON |
---|
{ "photoId": { object ( |
שדות | |
---|---|
photoId |
חובה. פלט בלבד. חובה כשמעדכנים תמונה. שומרים את הפלט רק כשיוצרים תמונה. מזהה של התמונה, שייחודית לכל התמונות ב-Google. |
uploadReference |
קלט בלבד. חובה בעת יצירת תמונה. קלט בלבד. כתובת ה-URL של המשאב שאליה מועלים הבייטים של התמונות. |
downloadUrl |
פלט בלבד. כתובת ה-URL להורדה של הבייטים. השדה הזה מוגדר רק כשהשדה |
thumbnailUrl |
פלט בלבד. כתובת ה-URL של התמונה הממוזערת להצגת תצוגה מקדימה של התמונה הנתונה. |
shareLink |
פלט בלבד. קישור לשיתוף של התמונה. |
pose |
אופציונלי. צילום של התמונה. |
connections[] |
אופציונלי. חיבורים לתמונות אחרות. קישור מייצג את הקישור מתמונה זו לתמונה אחרת. |
captureTime |
אופציונלי. הזמן המוחלט שבו התמונה צולמה. כשאין לחותמת הזמן של התמונה אקספרס, היא משמשת להגדרת חותמת זמן במטא-נתונים של התמונה. חותמת זמן בפורמט "Zulu" של RFC3339 UTC, ברזולוציה של ננו-שניות ועד תשע ספרות עשרוניות. דוגמאות: |
uploadTime |
פלט בלבד. השעה שבה התמונה הועלתה. חותמת זמן בפורמט "Zulu" של RFC3339 UTC, ברזולוציה של ננו-שניות ועד תשע ספרות עשרוניות. דוגמאות: |
places[] |
אופציונלי. המקומות שבהם התמונה הזו שייכת. |
viewCount |
פלט בלבד. הצגת ספירת התמונות. |
transferStatus |
פלט בלבד. הסטטוס של העברת הזכויות בתמונה הזו. |
mapsPublishStatus |
פלט בלבד. סטטוס במפות Google, גם אם התמונה הזו פורסמה וגם אם היא נדחתה. |
מזהה תמונה
מזהה של Photo
.
ייצוג JSON |
---|
{ "id": string } |
שדות | |
---|---|
id |
מזהה ייחודי של תמונה. |
העלאה
העלאת קובץ עזר לקובצי מדיה.
ייצוג JSON |
---|
{ // Union field |
שדות | |
---|---|
שדה איחוד file_source . חובה. file_source יכול להיות רק אחד מהבאים: |
|
uploadUrl |
קובץ העזר של ההעלאה צריך להיות ייחודי לכל משתמש. מבנה הטופס הוא: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}" |
תנוחה
מדידת תנוחות גולמית עבור ישות.
ייצוג JSON |
---|
{ "latLngPair": { object ( |
שדות | |
---|---|
latLngPair |
זוג קווי האורך והרוחב של התנוחה, כפי שמוסבר כאן: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng בעת יצירת |
altitude |
גובה התנוחה במטרים מעל האליפסה WGS84. NaN מציין כמות שלא נמדדת. |
heading |
הפרמטרים הבאים של התמונה קשורים למרכז התמונה. הן תואמות לכתובת https://developers.google.com/streetview/spherical-metadata. כיוון המצפן, נמדד במרכז התמונה במעלות בכיוון השעון מצפון. הערך חייב להיות >=0 ו-<360. NaN מציין כמות שלא נמדדת. |
pitch |
גובה צליל, במרכז התמונה. הערך חייב להיות גדול מ-90 ו-<=90. ערך של 90- פירושו להסתכל ישירות למטה, וערך של 90 פירושו חיפוש ישיר. NaN מציין כמות שלא נמדדת. |
roll |
גליל במעלות. הערך חייב להיות >= 0 ו-<360. ערך של 0 פירושו רמה עם האופק. NaN מציין כמות שלא נמדדת. |
gpsRecordTimestampUnixEpoch |
הזמן של רשומת ה-GPS מאז תקופת UTC. חותמת זמן בפורמט "Zulu" של RFC3339 UTC, ברזולוציה של ננו-שניות ועד תשע ספרות עשרוניות. דוגמאות: |
level |
מפלס (הקומה במבנה) המשמשת להגדרת ניווט אנכי. |
accuracyMeters |
הדיוק האופקי המשוער של תנוחה זו במטרים ברמת מהימנות של 68% (סטיית תקן אחת). לדוגמה, ב-Android, הערך הזה זמין בשיטה הזו: https://developer.android.com/reference/android/location/Location#getAccuracy(). בפלטפורמות אחרות יש שיטות שונות לקבלת הערכות דיוק דומות. |
הנ"צ
אובייקט שמייצג זוג של קווי אורך ורוחב. מבוטא כצמד של זוגות, שמייצג את מעלות קו הרוחב וקו האורך של המעלות. אם לא צוין אחרת, האובייקט חייב לעמוד ב תקן WGS84. הערכים צריכים להיות בטווחים מנורמלים.
ייצוג JSON |
---|
{ "latitude": number, "longitude": number } |
שדות | |
---|---|
latitude |
קו הרוחב במעלות. חייב להיות בטווח [ -90.0, +90.0]. |
longitude |
קו האורך במעלות. הערך חייב להיות בטווח [ -180.0, +180.0]. |
רמה
מידע על רמה המכיל את מספר הרמה ואת השם התואם לו.
ייצוג JSON |
---|
{ "number": number, "name": string } |
שדות | |
---|---|
number |
אופציונלי. מספר הקומה, משמש להזמנה. 0 מציין את מפלס פני הקרקע, 1 מציין את הרמה הראשונה מעל פני הקרקע, 1- מציין את הרמה הראשונה מתחת לפני הקרקע. ערכים לא שלמים הם תקינים. |
name |
חובה. שם שהוקצה לרמה הזו ומוגבל ל-3 תווים. כדאי לבדוק איך לחצני המעלית יתויגו לרמה הזאת אם היה שימוש במעלית. |
חיבור
קישור הוא הקישור בין תמונת המקור לבין תמונת היעד.
ייצוג JSON |
---|
{
"target": {
object ( |
שדות | |
---|---|
target |
חובה. יעד החיבור מהתמונה המכילה לתמונה אחרת. |
מקום
הוספת מטא-נתונים של ישות.
ייצוג JSON |
---|
{ "placeId": string, "name": string, "languageCode": string } |
שדות | |
---|---|
placeId |
מזהה המיקום, כפי שמתואר בכתובת https://developers.google.com/places/place-id. |
name |
פלט בלבד. שם המקום, מותאם לשוק המקומי בקוד השפה. |
languageCode |
פלט בלבד. ה-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 |
התמונה נדחתה בגלל סיבה לא ידועה. |
שיטות |
|
---|---|
|
אחרי שהלקוח מסיים להעלות את התמונה עם UploadRef שהוחזר, CreatePhoto מפרסם את התמונה Photo שהועלתה ל-Street View במפות Google. |
|
מחיקת השדה Photo והמטא נתונים שלו. |
|
קבלת המטא-נתונים של Photo שצוין. |
|
יוצר סשן העלאה כדי להתחיל להעלות בייטים של תמונות. |
|
עדכון המטא-נתונים של Photo , כמו תנוחה, שיוך למקום, חיבורים וכו'. |