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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "2014-10-02T15:01:23Z" و"2014-10-02T15:01:23.045123456Z".
uploadTime

string (Timestamp format)

النتائج فقط. الوقت الذي تم فيه تحميل الصورة

طابع زمني بتنسيق RFC3339 حسب التوقيت العالمي المنسَّق (UTC) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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"، سواء تم نشر هذه الصورة أو رفضها

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) "زولو" بدقة نانوثانية وما يصل إلى تسعة أرقام كسرية. أمثلة: "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

string

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

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، مثل الوضعية أو الربط بالمكان أو الاتصالات أو غير ذلك.