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)

اختياريّ. الوقت المطلق الذي تم فيه التقاط الصورة عندما لا تحتوي الصورة على طابع زمني لـ 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"، سواء تم نشر هذه الصورة أو رفضها.

رقم تعريف الصورة

معرِّف لـ 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).

طابع زمني بتنسيق 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(). وتتّبع الأنظمة الأساسية الأخرى طرقًا مختلفة للحصول على تقديرات دقيقة للدقة.

خط الدعم

يمثل العنصر زوجًا من خط العرض/الطول. ويتم التعبير عن ذلك بزوجَين من الأزواج لتمثيل خط العرض وخط الطول بالدرجات. يجب أن يتوافق هذا العنصر مع معيار 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

الإخراج فقط. رمز اللغة الذي تمت ترجمة الاسم باستخدامه. يجب أن يكون هذا هو رمز اللغة المحدَّد في الطلب، ولكن قد يكون احتياطيًا.

حالة النقل

حالة نقل الحقوق.

عمليات التعداد
TRANSFER_STATUS_UNKNOWN لم يتم تحديد حالة عملية النقل هذه.
NEVER_TRANSFERRED لم يتم نقل هذه الصورة مطلقًا.
PENDING تم بدء نقل الصورة هذا، ولكن لم يرد المستلم بعد.
COMPLETED اكتملت عملية نقل الصورة وتم نقل هذه الصورة إلى المستلم.
REJECTED رفض المُستلِم عملية نقل الصور هذه.
EXPIRED انتهت صلاحية نقل الصورة قبل اتخاذ المُستلِم أي إجراء.
CANCELLED ألغى المُرسِل عملية نقل الصور هذه.
RECEIVED_VIA_TRANSFER يملك المُستلِم هذه الصورة بسبب نقل الحقوق.

حالة نشر الخرائط

حالة نشر الصورة في "خرائط Google"

عمليات التعداد
UNSPECIFIED_MAPS_PUBLISH_STATUS حالة الصورة غير معروفة.
PUBLISHED تم نشر الصورة بشكل علني على "خرائط Google".
REJECTED_UNKNOWN تم رفض الصورة لسبب غير معروف.

الطُرق

create

 بعد أن ينتهي العميل من تحميل الصورة باستخدام UploadRef التي تم إرجاعها، ينشر CreatePhoto Photo الذي تم تحميله إلى "التجوّل الافتراضي" على "خرائط Google".

delete

 يتم حذف Photo والبيانات الوصفية الخاصة به.

get

 تحصل على البيانات الوصفية الخاصة بـ Photo المحددة.

startUpload

 إنشاء جلسة تحميل لبدء تحميل وحدات البايت للصور

update

 تعدِّل البيانات الوصفية لدالة Photo، مثل الوضع، وربط المكان، والاتصالات، وغير ذلك.