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، يتم استخدام هذا الطابع الزمني لضبط طابع زمني في البيانات الوصفية للصورة.

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف 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 في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف 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)

النتائج فقط. الحالة في "خرائط Google"، أي ما إذا تم نشر هذه الصورة أو رفضها

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) منذ بدء حساب الفترة حسب التوقيت العالمي المنسّق

يستخدم المعيار RFC 3339، حيث يكون الناتج الذي يتم إنشاؤه مُمثلاً بالتوقيت العالمي المنسَّق مع حرف Z في النهاية ويستخدم الأرقام الجزئية 0 أو 3 أو 6 أو 9. تُقبل أيضًا المعادلات الأخرى التي لا تستخدم حرف Z. أمثلة: "2014-10-02T15:01:23Z" أو "2014-10-02T15:01:23.045123456Z" أو "2014-10-02T15:01:23+05:30".
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

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

TransferStatus

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

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

MapsPublishStatus

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

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

الطُرق

create

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

delete

 يحذف هذا الإجراء Photo وبياناته الوصفية.

get

 تعرض هذه الطريقة البيانات الوصفية الخاصة بـ Photo المحدّد.

startUpload

 تنشئ هذه الطريقة جلسة تحميل لبدء تحميل وحدات بايت من الصور.

update

 تعدّل هذه الطريقة البيانات الوصفية الخاصة بـ Photo، مثل الوضع والارتباط بالمكان وعمليات الربط وما إلى ذلك.