REST Resource: photo

{
  "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)
}

object ( PhotoId )

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

object ( UploadRef )

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

string

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

string

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

string

فقط خروجی لینک اشتراک گذاری عکس

object ( Pose )

اختیاری. ژست عکس.

object ( Connection )

اختیاری. اتصال به عکس های دیگر یک اتصال نشان دهنده پیوند این عکس به عکس دیگر است.

string ( Timestamp format)

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

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

string ( Timestamp format)

فقط خروجی زمان آپلود تصویر

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

object ( Place )

اختیاری. مکان هایی که این عکس به آنها تعلق دارد.

string ( int64 format)

فقط خروجی تعداد مشاهده عکس

enum ( TransferStatus )

فقط خروجی وضعیت انتقال حقوق روی این عکس.

enum ( MapsPublishStatus )

فقط خروجی وضعیت در Google Maps، چه این عکس منتشر شده باشد یا رد شده باشد.

{
  "id": string
}

string

یک شناسه منحصر به فرد برای یک عکس.

{

  // Union field file_source can be only one of the following:
  "uploadUrl": string
  // End of list of possible types for union field file_source.
}

string

یک مرجع آپلود باید برای هر کاربر منحصر به فرد باشد. این فرم را دنبال می کند: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}"

{
  "latLngPair": {
    object (LatLng)
  },
  "altitude": number,
  "heading": number,
  "pitch": number,
  "roll": number,
  "gpsRecordTimestampUnixEpoch": string,
  "level": {
    object (Level)
  },
  "accuracyMeters": number
}

object ( LatLng )

جفت طول و عرض جغرافیایی ژست، همانطور که در اینجا توضیح داده شده است: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng هنگام ایجاد یک Photo ، اگر جفت طول و عرض جغرافیایی ارائه نشده باشد، موقعیت جغرافیایی از هدر exif استفاده می شود. یک جفت طول و عرض جغرافیایی که در هدر عکس یا exif ارائه نشده است باعث می شود فرآیند عکس با شکست مواجه شود.

number

ارتفاع ژست بر حسب متر بالاتر از بیضی WGS84. NaN یک کمیت اندازه گیری نشده را نشان می دهد.

number

پارامترهای ژست زیر مربوط به مرکز عکس است. آنها با https://developers.google.com/streetview/spherical-metadata مطابقت دارند. سمت قطب نما، در مرکز عکس در درجه در جهت عقربه های ساعت از شمال اندازه گیری می شود. مقدار باید >=0 و <360 باشد. NaN یک کمیت اندازه گیری نشده را نشان می دهد.

number

گام، در مرکز عکس بر حسب درجه اندازه گیری می شود. مقدار باید >=-90 و <= 90 باشد. مقدار -90 به معنای نگاه مستقیم به پایین و مقدار 90 به معنای نگاه مستقیم به بالا است. NaN یک کمیت اندازه گیری نشده را نشان می دهد.

number

رول، در درجه اندازه گیری می شود. مقدار باید >= 0 و <360 باشد. مقدار 0 به معنای همسطح با افق است. NaN یک کمیت اندازه گیری نشده را نشان می دهد.

string ( Timestamp format)

زمان ثبت GPS از دوران UTC.

مهر زمانی در قالب RFC3339 UTC "Zulu"، با وضوح نانوثانیه و حداکثر نه رقم کسری. مثال‌ها: "2014-10-02T15:01:23Z" و "2014-10-02T15:01:23.045123456Z" .

object ( Level )

سطح (کف در یک ساختمان) که برای پیکربندی ناوبری عمودی استفاده می شود.

number

دقت افقی تخمینی این ژست بر حسب متر با اطمینان 68% (یک انحراف معیار). به عنوان مثال، در Android، این مقدار از این روش در دسترس است: https://developer.android.com/reference/android/location/Location#getAccuracy() . پلتفرم های دیگر روش های متفاوتی برای به دست آوردن تخمین های دقت مشابه دارند.

{
  "latitude": number,
  "longitude": number
}

number

عرض جغرافیایی بر حسب درجه باید در محدوده [-90.0، +90.0] باشد.

number

طول جغرافیایی بر حسب درجه باید در محدوده [-180.0، +180.0] باشد.

{
  "number": number,
  "name": string
}

number

اختیاری. شماره طبقه، برای سفارش استفاده می شود. 0 نشان دهنده سطح زمین، 1 نشان دهنده اولین سطح بالای سطح زمین، -1 نشان دهنده اولین سطح زیر سطح زمین است. مقادیر غیر صحیح صحیح هستند.

string

مورد نیاز. نام اختصاص داده شده به این سطح، محدود به 3 کاراکتر. در نظر بگیرید که اگر آسانسور وجود داشت، دکمه های آسانسور برای این سطح چگونه برچسب گذاری می شدند.

{
  "target": {
    object (PhotoId)
  }
}

object ( PhotoId )

مورد نیاز. مقصد اتصال از عکس حاوی به عکس دیگر.

{
  "placeId": string,
  "name": string,
  "languageCode": string
}

string

شناسه مکان، همانطور که در https://developers.google.com/places/place-id توضیح داده شده است.

string

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

string

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