REST Resource: photo

منبع: عکس

عکس برای ذخیره عکس‌های ۳۶۰ درجه به همراه فراداده‌های عکس استفاده می‌شود.

نمایش 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 )

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

downloadUrl

string

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

thumbnailUrl

string

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

pose

object ( Pose )

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

connections[]

object ( Connection )

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

captureTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

uploadTime

string ( Timestamp format)

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

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

places[]

object ( Place )

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

viewCount

string ( int64 format)

فقط خروجی. تعداد عکس‌ها را ببینید.

transferStatus

enum ( TransferStatus )

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

mapsPublishStatus

enum ( MapsPublishStatus )

فقط خروجی. وضعیت در نقشه‌های گوگل، اینکه آیا این عکس منتشر شده یا رد شده است.

شناسه عکس

شناسه برای یک 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

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

roll

number

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

gpsRecordTimestampUnixEpoch

string ( Timestamp format)

زمان ثبت GPS از زمان UTC.

از RFC 3339 استفاده می‌کند، که در آن خروجی تولید شده همیشه به صورت Z-normalized خواهد بود و از ارقام کسری ۰، ۳، ۶ یا ۹ استفاده می‌کند. آفست‌های غیر از "Z" نیز پذیرفته می‌شوند. مثال‌ها: "2014-10-02T15:01:23Z" ، "2014-10-02T15:01:23.045123456Z" یا "2014-10-02T15:01:23+05:30" .

level

object ( Level )

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

accuracyMeters

number

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

لات‌لنگ

شیء‌ای که یک جفت عرض/طول جغرافیایی را نشان می‌دهد. این به صورت یک جفت دوتایی بیان می‌شود تا درجه عرض جغرافیایی و درجه طول جغرافیایی را نشان دهد. مگر اینکه خلاف آن مشخص شده باشد، این شیء باید با استاندارد WGS84 مطابقت داشته باشد. مقادیر باید در محدوده نرمال باشند.

نمایش JSON 
{
  "latitude": number,
  "longitude": number
}
فیلدها
latitude

number

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

longitude

number

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

سطح

اطلاعات سطح شامل شماره سطح و نام متناظر آن.

نمایش JSON 
{
  "number": number,
  "name": string
}
فیلدها
number

number

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

name

string

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

اتصال

یک اتصال، پیوندی از یک عکس منبع به یک عکس مقصد است.

نمایش 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

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

وضعیت انتقال

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

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

وضعیت انتشار نقشه‌ها

وضعیت انتشار عکس در گوگل مپ.

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

روش‌ها

create

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

delete

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

get

 ابرداده (metadata) Photo مشخص شده را دریافت می‌کند.

startUpload

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

update

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