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)

اختياريّ. الوقت المطلق الذي تم فيه التقاط الصورة عندما لا تتضمّن الصورة طابعًا زمنيًا خارجيًا، يتم استخدام هذا الإعداد لضبط طابع زمني في البيانات الوصفية للصورة.

طابع زمني بتنسيق 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 
{
  "uploadUrl": string
}
الحقول
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 lipsoid يشير NaN إلى الكمية التي لا يتم قياسها.
heading

number

ترتبط معلمات الوضع التالية بمركز الصورة. تتطابق مع https://developers.google.com/streetview/spherical-metadata. عنوان البوصلة، يتم قياسه في منتصف الصورة بدرجات في اتجاه عقارب الساعة من الشمال. يجب أن تكون القيمة &>=0 و<360. يشير NaN إلى الكمية التي لا يتم قياسها.
pitch

number

يتم ضبط درجة الصوت في وسط الصورة بالدرجات. يجب أن تكون القيمة &>=-90 و<= 90. تعني القيمة -90 النظر للأسفل مباشرةً، والقيمة 90 تعني النظر مباشرةً إلى الأعلى. يشير NaN إلى الكمية التي لا يتم قياسها.
roll

number

يتم قياسها بالدرجات. يجب أن تكون القيمة &؛ gt;= 0 و <360. تعني القيمة 0 المستوى مع الأفق. يشير NaN إلى الكمية التي لا يتم قياسها.
gpsRecordTimestampUnixEpoch

string (Timestamp format)

وقت سجل نظام تحديد المواقع العالمي (GPS) منذ العصر منذ التوقيت العالمي المتفق عليه.

طابع زمني بتنسيق 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 يمتلك المستلم هذه الصورة بسبب نقل الحقوق.

حالة MapsMaps

حالة نشر الصورة على "خرائط Google".

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

الطُرق

create

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

delete

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

get

 الحصول على البيانات الوصفية للسمة Photo المحدّدة

startUpload

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

update

 تُعدّل البيانات الوصفية لسمة Photo، مثل الوضع المرتبط وربط المكان بالأماكن المحيطة وما إلى ذلك.