- المرجع: صورة
- رقم تعريف الصورة
- تحميل المرجع
- الزهرة
- أمريكا اللاتينية
- المستوى
- الاتصال
- المكان
- حالة النقل
- حالة نشر الخرائط
- الطُرق
المورد: صورة
يتم استخدام الصورة لتخزين الصور بزاوية 360 درجة مع البيانات الوصفية للصور.
تمثيل JSON |
---|
{ "photoId": { object ( |
الحقول | |
---|---|
photoId |
مطلوبة. الإخراج فقط. مطلوبة عند تعديل صورة. عند إنشاء صورة فقط، يتم إخراجها. معرّف الصورة، وهو فريد بين جميع الصور في Google |
uploadReference |
الإدخال فقط مطلوبة عند إنشاء صورة. الإدخال فقط عنوان URL للمورد الذي يتم تحميل وحدات بايت للصورة إليه. |
downloadUrl |
الإخراج فقط. عنوان URL لتنزيل وحدات البايت الخاصة بالصورة. يتم ضبط هذا الحقل فقط عند ضبط |
thumbnailUrl |
الإخراج فقط. عنوان URL للصورة المصغّرة لعرض معاينة للصورة المحدّدة. |
shareLink |
الإخراج فقط. رابط المشاركة الخاص بالصورة |
pose |
اختياريّ. صورة من الصورة |
connections[] |
اختياريّ. اتصالات الصور الأخرى. يمثل الاتصال الرابط من هذه الصورة إلى صورة أخرى. |
captureTime |
اختياريّ. الوقت المطلق الذي تم فيه التقاط الصورة عندما لا تحتوي الصورة على طابع زمني لـ exif، يتم استخدامها لضبط طابع زمني في البيانات الوصفية للصورة. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة تصل إلى نانو ثانية وما يصل إلى تسعة أرقام كسور أمثلة: |
uploadTime |
الإخراج فقط. وقت تحميل الصورة. طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة تصل إلى نانو ثانية وما يصل إلى تسعة أرقام كسور أمثلة: |
places[] |
اختياريّ. الأماكن التي تنتمي إليها هذه الصورة |
viewCount |
الإخراج فقط. عدد مرات مشاهدة الصورة |
transferStatus |
الإخراج فقط. حالة نقل الحقوق في هذه الصورة. |
mapsPublishStatus |
الإخراج فقط. الحالة في "خرائط Google"، سواء تم نشر هذه الصورة أو رفضها. |
رقم تعريف الصورة
معرِّف لـ Photo
.
تمثيل JSON |
---|
{ "id": string } |
الحقول | |
---|---|
id |
هو معرِّف فريد لصورة. |
تحميل المرجع
يُرجى تحميل المرجع لملفات الوسائط.
تمثيل JSON |
---|
{ // Union field |
الحقول | |
---|---|
حقل الاتحاد file_source . مطلوبة. لا يمكن أن يكون file_source سوى واحد مما يلي: |
|
uploadUrl |
يجب أن يكون مرجع التحميل فريدًا لكل مستخدم. ويجب اتّباع الخطوات التالية: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{uploadReference}" |
وضع
قياس اللقطات الأولية للكيانات
تمثيل JSON |
---|
{ "latLngPair": { object ( |
الحقول | |
---|---|
latLngPair |
زوج خط العرض وخط الطول، كما هو موضّح هنا: https://cloud.google.com/datastore/docs/reference/rest/shared.Types/LatLng عند إنشاء |
altitude |
الارتفاع في وضع الارتفاع بالأمتار أعلى علامة الحذف WGS84 وتشير قيمة NaN إلى كمية لا يتم قياسها. |
heading |
ترتبط معلمات الوضع التالية بوضع وسط الصورة. أن تتطابق مع https://developers.google.com/streetview/spherical-metadata. عنوان البوصلة، حيث يتم قياسه في منتصف الصورة بالدرجات في اتجاه عقارب الساعة من الشمال. يجب أن تكون القيمة >=0 و360. وتشير قيمة NaN إلى كمية لا يتم قياسها. |
pitch |
يتم قياس درجة الصوت في منتصف الصورة بالدرجات. يجب أن تكون القيمة >=-90 و <= 90. تعني القيمة -90 النظر مباشرةً إلى الأسفل، والقيمة 90 تعني النظر مباشرةً إلى الأعلى. وتشير قيمة NaN إلى كمية لا يتم قياسها. |
roll |
يتم قياسها بالدرجات. يجب أن تكون القيمة >= 0 و360. تعني القيمة 0 المستوى مع الأفق. وتشير قيمة NaN إلى كمية لا يتم قياسها. |
gpsRecordTimestampUnixEpoch |
وقت سجل نظام تحديد المواقع العالمي (GPS) منذ فترة التوقيت العالمي المنسّق (UTC). طابع زمني بتنسيق RFC3339 UTC "Zulu"، بدقة تصل إلى نانو ثانية وما يصل إلى تسعة أرقام كسور أمثلة: |
level |
المستوى (الطابق في مبنى) يُستخدَم لضبط إعدادات التنقّل العمودي |
accuracyMeters |
الدقة الأفقية المقدّرة لهذا الوضع بالمتر مع مستوى ثقة يبلغ% 68 (انحراف واحد عادي) على سبيل المثال، تتوفّر هذه القيمة على Android على النحو التالي: https://developer.android.com/reference/android/location/Location#getAccuracy(). وتتّبع الأنظمة الأساسية الأخرى طرقًا مختلفة للحصول على تقديرات دقيقة للدقة. |
خط الدعم
يمثل العنصر زوجًا من خط العرض/الطول. ويتم التعبير عن ذلك بزوجَين من الأزواج لتمثيل خط العرض وخط الطول بالدرجات. يجب أن يتوافق هذا العنصر مع معيار WGS84 ما لم يُنص على خلاف ذلك. يجب أن تكون القيم داخل النطاقات التي تمت تسويتها.
تمثيل JSON |
---|
{ "latitude": number, "longitude": number } |
الحقول | |
---|---|
latitude |
خط العرض بالدرجات. يجب أن يكون ضمن النطاق [-90.0 أو +90.0]. |
longitude |
خط الطول بالدرجات. يجب أن يكون ضمن النطاق [-180.0 أو +180.0]. |
المستوى
معلومات المستوى التي تحتوي على رقم المستوى واسمه المقابل.
تمثيل JSON |
---|
{ "number": number, "name": string } |
الحقول | |
---|---|
number |
اختياريّ. رقم الطابق، ويُستخدم للطلب. يشير الرقم 0 إلى مستوى الأرض، بينما يشير الرقم 1 إلى المستوى الأول فوق مستوى الأرض، ويشير الرقم 1 إلى المستوى الأول تحت مستوى الأرض. القيم التي لا تمثّل عددًا صحيحًا. |
name |
مطلوبة. اسم مخصّص لهذا المستوى، يقتصر على 3 أحرف. مراعاة كيفية تصنيف أزرار المصعد لهذا المستوى إذا كان هناك مصعد. |
الرابط
الاتصال هو الرابط من صورة مصدر إلى صورة وجهة.
تمثيل JSON |
---|
{
"target": {
object ( |
الحقول | |
---|---|
target |
مطلوبة. وجهة الاتصال من الصورة التي تحتوي على صورة أخرى. |
مكان
وضع البيانات الوصفية لكيان
تمثيل JSON |
---|
{ "placeId": string, "name": string, "languageCode": string } |
الحقول | |
---|---|
placeId |
معرّف المكان كما هو موضّح في https://developers.google.com/PLACES/place-id |
name |
الإخراج فقط. اسم المكان، مع الترجمة إلى رمز اللغة |
languageCode |
الإخراج فقط. رمز اللغة الذي تمت ترجمة الاسم باستخدامه. يجب أن يكون هذا هو رمز اللغة المحدَّد في الطلب، ولكن قد يكون احتياطيًا. |
حالة النقل
حالة نقل الحقوق.
عمليات التعداد | |
---|---|
TRANSFER_STATUS_UNKNOWN |
لم يتم تحديد حالة عملية النقل هذه. |
NEVER_TRANSFERRED |
لم يتم نقل هذه الصورة مطلقًا. |
PENDING |
تم بدء نقل الصورة هذا، ولكن لم يرد المستلم بعد. |
COMPLETED |
اكتملت عملية نقل الصورة وتم نقل هذه الصورة إلى المستلم. |
REJECTED |
رفض المُستلِم عملية نقل الصور هذه. |
EXPIRED |
انتهت صلاحية نقل الصورة قبل اتخاذ المُستلِم أي إجراء. |
CANCELLED |
ألغى المُرسِل عملية نقل الصور هذه. |
RECEIVED_VIA_TRANSFER |
يملك المُستلِم هذه الصورة بسبب نقل الحقوق. |
حالة نشر الخرائط
حالة نشر الصورة في "خرائط Google"
عمليات التعداد | |
---|---|
UNSPECIFIED_MAPS_PUBLISH_STATUS |
حالة الصورة غير معروفة. |
PUBLISHED |
تم نشر الصورة بشكل علني على "خرائط Google". |
REJECTED_UNKNOWN |
تم رفض الصورة لسبب غير معروف. |
الطُرق |
|
---|---|
|
بعد أن ينتهي العميل من تحميل الصورة باستخدام UploadRef التي تم إرجاعها، ينشر CreatePhoto Photo الذي تم تحميله إلى "التجوّل الافتراضي" على "خرائط Google". |
|
يتم حذف Photo والبيانات الوصفية الخاصة به. |
|
تحصل على البيانات الوصفية الخاصة بـ Photo المحددة. |
|
إنشاء جلسة تحميل لبدء تحميل وحدات البايت للصور |
|
تعدِّل البيانات الوصفية لدالة Photo ، مثل الوضع، وربط المكان، والاتصالات، وغير ذلك. |