REST Resource: photo

منبع: عکس

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 )

مورد نیاز. فقط خروجی هنگام به روز رسانی یک عکس ضروری است. خروجی فقط هنگام ایجاد عکس. شناسه عکس که در بین تمام عکس های گوگل بی نظیر است.

uploadReference

object ( UploadRef )

فقط ورودی هنگام ایجاد عکس ضروری است. فقط ورودی URL منبعی که بایت های عکس در آن آپلود می شوند.

downloadUrl

string

فقط خروجی آدرس دانلود بایت عکس. این فیلد فقط زمانی تنظیم می شود که GetPhotoRequest.view روی PhotoView.INCLUDE_DOWNLOAD_URL تنظیم شده باشد.

thumbnailUrl

string

فقط خروجی نشانی اینترنتی تصویر کوچک برای نمایش پیش نمایش عکس داده شده.

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 Maps، چه این عکس منتشر شده باشد یا رد شده باشد.

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

فقط خروجی زبان کدی که نام با آن بومی سازی شده است. این باید زبان کد مشخص شده در درخواست باشد، اما ممکن است بازگشتی باشد.

وضعیت انتقال

وضعیت انتقال حقوق

Enums
TRANSFER_STATUS_UNKNOWN وضعیت این انتقال مشخص نیست.
NEVER_TRANSFERRED این عکس هرگز در انتقال نبوده است.
PENDING این انتقال عکس آغاز شده است، اما گیرنده هنوز پاسخی نداده است.
COMPLETED انتقال عکس انجام شد و این عکس به گیرنده منتقل شد.
REJECTED گیرنده این انتقال عکس را رد کرد.
EXPIRED انتقال عکس قبل از اینکه گیرنده اقدامی انجام دهد منقضی شد.
CANCELLED فرستنده این انتقال عکس را لغو کرد.
RECEIVED_VIA_TRANSFER گیرنده این عکس را به دلیل انتقال حقوق در اختیار دارد.

MapsPublishStatus

وضعیت انتشار عکس در Google Maps.

Enums
UNSPECIFIED_MAPS_PUBLISH_STATUS وضعیت عکس مشخص نیست.
PUBLISHED این عکس از طریق نقشه گوگل برای عموم منتشر می شود.
REJECTED_UNKNOWN عکس به دلیل نامعلومی رد شده است.

روش ها

create

پس از اینکه مشتری آپلود عکس را با UploadRef برگشتی تمام کرد، CreatePhoto Photo آپلود شده را در نمای خیابان در Google Maps منتشر می کند.

delete

یک Photo و ابرداده آن را حذف می کند.

get

فراداده Photo مشخص شده را دریافت می کند.

startUpload

یک جلسه آپلود برای شروع آپلود بایت های عکس ایجاد می کند.

update

ابرداده های یک Photo مانند ژست، ارتباط مکان، اتصالات و غیره را به روز می کند.