Package google.streetview.publish.v1

الفهرس

StreetViewPublishService

نشر الصور التي يساهم بها المستخدمون في ميزة "التجوّل الافتراضي" وربطها

BatchDeletePhotos

rpc BatchDeletePhotos(BatchDeletePhotosRequest) returns (BatchDeletePhotosResponse)

يؤدي هذا الإجراء إلى حذف قائمة "Photos" وبياناته الوصفية.

يُرجى العِلم أنّه في حال تعذّر تنفيذ BatchDeletePhotos، هذا يعني أن الحقول المهمة غير متوفرة أو هناك خطأ في المصادقة. حتى في حال نجاح "BatchDeletePhotos"، قد تتعذّر الصور الفردية في المجموعة. ويتم تحديد أعطال التطبيق هذه في كل PhotoResponse.status في BatchDeletePhotosResponse.results. راجِع DeletePhoto للتعرّف على أخطاء معيّنة يمكن أن تحدث لكل صورة.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
BatchGetPhotos

rpc BatchGetPhotos(BatchGetPhotosRequest) returns (BatchGetPhotosResponse)

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

يُرجى العِلم أنّه في حال تعذّر تنفيذ BatchGetPhotos، هذا يعني أن الحقول المهمة غير متوفرة أو هناك خطأ في المصادقة. حتى في حال نجاح "BatchGetPhotos"، قد تتعذّر الصور الفردية في المجموعة. ويتم تحديد أعطال التطبيق هذه في كل PhotoResponse.status في BatchGetPhotosResponse.results. راجِع GetPhoto للتعرّف على أخطاء معيّنة يمكن أن تحدث لكل صورة.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
BatchUpdatePhotos

rpc BatchUpdatePhotos(BatchUpdatePhotosRequest) returns (BatchUpdatePhotosResponse)

يتم تعديل البيانات الوصفية لـ Photos، مثل الوضعية وربطها بالمكان والاتصالات وما إلى ذلك. لا يمكن تغيير وحدات بكسل الصور.

يُرجى العِلم أنّه في حال تعذّر تنفيذ BatchUpdatePhotos، هذا يعني أن الحقول المهمة غير متوفرة أو هناك خطأ في المصادقة. حتى في حال نجاح "BatchUpdatePhotos"، قد تتعذّر الصور الفردية في المجموعة. ويتم تحديد أعطال التطبيق هذه في كل PhotoResponse.status في BatchUpdatePhotosResponse.results. راجِع UpdatePhoto للتعرّف على أخطاء معيّنة يمكن أن تحدث لكل صورة.

يتم استخدام الحقول المحددة في الحقل updateMask فقط. في حال عدم توفّر السمة updateMask، سيسري التعديل على جميع الحقول.

يجب ألا يتجاوز عدد رسائل UpdatePhotoRequest في BatchUpdatePhotosRequest 20 رسالة.

ملاحظة: لتعديل Pose.altitude، يجب ملء الحقل Pose.latLngPair أيضًا. وإلا، سيفشل الطلب.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
CreatePhoto

rpc CreatePhoto(CreatePhotoRequest) returns (Photo)

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

في الوقت الحالي، الطريقة الوحيدة لتحديد العنوان واقتراح التشغيل واللف في CreatePhoto هي من خلال البيانات الوصفية للصور البانورامية XMP في وحدات البايت الخاصة بالصور. يتجاهل CreatePhoto حقول pose.heading وpose.pitch وpose.roll وpose.altitude وpose.level في Pose.

تُرجع هذه الطريقة رموز الخطأ التالية:

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
CreatePhotoSequence

rpc CreatePhotoSequence(CreatePhotoSequenceRequest) returns (Operation)

بعد أن ينتهي العميل من تحميل PhotoSequence باستخدام UploadRef المعروض، يستخلص CreatePhotoSequence سلسلة من الصور بزاوية 360 من الفيديو أو البيانات الوصفية القابلة للامتداد للجهاز (XDM، http://www.xdm.org/) ليتم نشرها في ميزة "التجوّل الافتراضي" على "خرائط Google".

تعرض الدالة CreatePhotoSequence القيمة Operation، مع ضبط رقم تعريف PhotoSequence في الحقل Operation.name.

تُرجع هذه الطريقة رموز الخطأ التالية:

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
DeletePhoto

rpc DeletePhoto(DeletePhotoRequest) returns (Empty)

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

تُرجع هذه الطريقة رموز الخطأ التالية:

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
DeletePhotoSequence

rpc DeletePhotoSequence(DeletePhotoSequenceRequest) returns (Empty)

يؤدي هذا الإجراء إلى حذف PhotoSequence وبياناته الوصفية.

تُرجع هذه الطريقة رموز الخطأ التالية:

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
GetPhoto

rpc GetPhoto(GetPhotoRequest) returns (Photo)

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

تُرجع هذه الطريقة رموز الخطأ التالية:

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
GetPhotoSequence

rpc GetPhotoSequence(GetPhotoSequenceRequest) returns (Operation)

للحصول على البيانات الوصفية لنطاق PhotoSequence المحدَّد عبر واجهة Operation

تُنتج هذه الطريقة الأنواع الثلاثة التالية من الاستجابات:

  • Operation.done = false، إذا لم تكتمل معالجة PhotoSequence بعد.
  • Operation.done = true وتم تعبئة Operation.error إذا كان هناك خطأ في المعالجة.
  • Operation.done = true ويتم ضرب Operation.response، التي تحتوي على رسالة PhotoSequence.

تُرجع هذه الطريقة رموز الخطأ التالية:

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
ListPhotoSequences

rpc ListPhotoSequences(ListPhotoSequencesRequest) returns (ListPhotoSequencesResponse)

يتم إدراج جميع عناصر PhotoSequences التي تنتمي إلى المستخدم بترتيب تنازلي حسب الطابع الزمني لـ CreatePhotoSequence.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
ListPhotos

rpc ListPhotos(ListPhotosRequest) returns (ListPhotosResponse)

يسرد جميع عناصر Photos التي تنتمي إلى المستخدم.

ملاحظة: لا يتم عرض الصور التي تم إنشاؤها مؤخرًا ولا تزال قيد الفهرسة في الردّ.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
StartPhotoSequenceUpload

rpc StartPhotoSequenceUpload(Empty) returns (UploadRef)

يتم إنشاء جلسة تحميل لبدء تحميل بيانات تسلسل الصور. يتم استخدام عنوان URL للتحميل الخاص بـ UploadRef المعروض لتحميل بيانات photoSequence.

بعد اكتمال التحميل، يتم استخدام UploadRef مع CreatePhotoSequence لإنشاء إدخال الكائن PhotoSequence.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
StartUpload

rpc StartUpload(Empty) returns (UploadRef)

يتم إنشاء جلسة تحميل لبدء تحميل وحدات البايت للصور. تستخدم هذه الطريقة عنوان URL للتحميل الخاص بمساحة UploadRef المعروضة لتحميل وحدات البايت الخاصة بـ Photo.

بالإضافة إلى متطلبات الصور المعروضة في https://support.google.com/maps/answer/7012050?ref_topic=6275604، يجب أن تستوفي الصورة المتطلبات التالية:

بعد اكتمال التحميل، تستخدم الطريقة UploadRef مع CreatePhoto لإنشاء إدخال الكائن Photo.

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.
UpdatePhoto

rpc UpdatePhoto(UpdatePhotoRequest) returns (Photo)

لتعديل البيانات الوصفية لجهاز Photo، مثل الوضعية أو الربط بالمكان أو الروابط أو غير ذلك. لا يمكن تغيير وحدات البكسل في الصورة.

يتم استخدام الحقول المحدّدة في الحقل updateMask فقط. في حال عدم توفّر السمة updateMask، سيسري التعديل على جميع الحقول.

تُرجع هذه الطريقة رموز الخطأ التالية:

نطاقات الأذونات

يجب توفير نطاق OAuth التالي:

  • https://www.googleapis.com/auth/streetviewpublish

لمزيد من المعلومات، يُرجى الاطِّلاع على نظرة عامة على OAuth 2.0.

BatchDeletePhotosRequest

طلب حذف عدة Photos

الحقول
photo_ids[]

string

مطلوب. أرقام تعريف Photos تتطلّب طلبات HTTP GET البنية التالية لمعلَمة طلب البحث لعنوان URL: photoIds=<id1>&photoIds=<id2>&....

BatchDeletePhotosResponse

الرد على عملية الحذف المجمّع لواحدة أو أكثر من Photos.

الحقول
status[]

Status

حالة العملية الخاصة بحذف Photo واحد في الطلب المجمّع.

BatchGetPhotosRequest

يمكنك طلب الحصول على حزمة "Photos" واحدة أو أكثر. الإعداد التلقائي

  • عنوان URL للتنزيل لوحدات البايت الخاصة بالصور.

المَعلمات:

  • تتحكّم السياسة view في ما إذا كان سيتم عرض عنوان URL للتنزيل لوحدات البايت الخاصة بالصور.
الحقول
photo_ids[]

string

مطلوب. أرقام تعريف Photos بالنسبة إلى طلبات HTTP GET، يجب أن تكون معلمة طلب البحث لعنوان URL هي photoIds=<id1>&photoIds=<id2>&....
view

PhotoView

مطلوب. تحدِّد هذه السياسة ما إذا كان يجب عرض عنوان URL للتنزيل لوحدات البايت الخاصة بالصور في الردّ على الصورة.
language_code

string

اختياريّ. رمز اللغة BCP-47، مثل en-US أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. إذا لم يتم تحديد language_code، يتم استخدام إعدادات اللغة المفضّلة للمستخدم في خدمات Google.

BatchGetPhotosResponse

الرد على طلب الحصول على مُجمَّع بقيمة Photos.

الحقول
results[]

PhotoResponse

قائمة النتائج لكل طلب Photo فردي، بالترتيب نفسه للطلبات الواردة في BatchGetPhotos.

BatchUpdatePhotosRequest

طلب تعديل البيانات الوصفية للصور تحديث وحدات بكسل الصور غير معتمد.

الحقول
update_photo_requests[]

UpdatePhotoRequest

مطلوب. قائمة UpdatePhotoRequests

BatchUpdatePhotosResponse

ردّ على تعديل مجمّع للبيانات الوصفية لواحدة أو أكثر من Photos.

الحقول
results[]

PhotoResponse

يتم تعديل قائمة النتائج لكل Photo فردي، بترتيب الطلب نفسه.

الاتصال

الرابط هو الرابط من صورة مصدر إلى صورة وجهة.

الحقول
target

PhotoId

مطلوب. وجهة الربط من الصورة التي تحتوي على الصورة إلى صورة أخرى.

CreatePhotoRequest

يمكنك طلب إنشاء Photo.

الحقول
photo

Photo

مطلوب. الصورة المطلوب إنشاؤها.

CreatePhotoSequenceRequest

يمكنك طلب إنشاء PhotoSequence من فيديو.

الحقول
photo_sequence

PhotoSequence

مطلوب. PhotoSequence للإنشاء.
input_type

InputType

مطلوب. نموذج إدخال PhotoSequence.

InputType

يُرجى إدخال نماذج PhotoSequence.

عمليات التعداد
INPUT_TYPE_UNSPECIFIED لم يتم تحديده. سيعيد الخادم google.rpc.Code.INVALID_ARGUMENT.
VIDEO فيديو 360.
XDM البيانات الوصفية القابلة للتوسّع للأجهزة، http://www.xdm.org

DeletePhotoRequest

طلب حذف Photo

الحقول
photo_id

string

مطلوب. رقم تعريف Photo

DeletePhotoSequenceRequest

طلب حذف PhotoSequence

الحقول
sequence_id

string

مطلوب. رقم تعريف PhotoSequence

GetPhotoRequest

يمكنك طلب الحصول على Photo.

الإعداد التلقائي

  • عنوان URL للتنزيل لوحدات البايت الخاصة بالصور.

المَعلمات:

  • تتحكّم السياسة view في ما إذا كان سيتم عرض عنوان URL للتنزيل لوحدات البايت الخاصة بالصور.
الحقول
photo_id

string

مطلوب. رقم تعريف Photo
view

PhotoView

مطلوب. تحدِّد هذه السياسة ما إذا كان يجب عرض عنوان URL للتنزيل لوحدات البايت الخاصة بالصور في استجابة Photo.
language_code

string

رمز اللغة BCP-47، مثل en-US أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. إذا لم يتم تحديد language_code، يتم استخدام إعدادات اللغة المفضّلة للمستخدم في خدمات Google.

GetPhotoSequenceRequest

يمكنك طلب الحصول على PhotoSequence.

الإعداد التلقائي

  • لا يعرض عنوان URL للتنزيل الخاص بـ PhotoSequence.

المَعلمات:

  • تتحكّم السياسة view في ما إذا كان سيتم عرض عنوان URL للتنزيل الخاص بـ PhotoSequence.
الحقول
sequence_id

string

مطلوب. رقم تعريف تسلسل الصور.
view
(deprecated)

PhotoView

تحدِّد هذه السياسة ما إذا كان يجب عرض عنوان URL للتنزيل لتسلسل الصور في download_url من الصور الفردية في ردّ PhotoSequence.

ملاحظة: لم يتم التنفيذ حاليًا.
filter

string

اختياريّ. تعبير الفلتر مثلاً: published_status=PUBLISHED

الفلاتر المتوافقة هي: published_status. يُرجى الاطّلاع على https://google.aip.dev/160 للحصول على مزيد من المعلومات.

GpsDataGapFailureDetails

التفاصيل المتعلقة بمشكلة المعالجة (Failurereason#GPS_DATA_GAP) إذا كان هناك العديد من الثغرات في بيانات نظام تحديد المواقع العالمي (GPS)، سيتم الإبلاغ هنا فقط عن الفترة ذات المدة الأكبر.

الحقول
gap_duration

Duration

مدة الفجوة التي تم العثور عليها في بيانات نظام تحديد المواقع العالمي (GPS).
gap_start_time

Duration

الوقت النسبي (منذ بداية الفيديو المضمّن) الذي بدأت فيه الفجوة

Imu

بيانات جهاز استشعار IMU من أدوات استشعار الجهاز

الحقول
accel_mpsps[]

Measurement3d

قياسات مقياس التسارع بالمتر/ثانية^2 مع زيادة الطوابع الزمنية من الأجهزة
gyro_rps[]

Measurement3d

قياسات الجيروسكوب بوحدات راديان/ثانية مع زيادة الطوابع الزمنية من الأجهزة
mag_ut[]

Measurement3d

قياسات مقياس المغناطيسية للمجال المغناطيسي بالميكروتيسلا (uT) مع زيادة الطوابع الزمنية من الأجهزة

القياس 3d

عينة قياس ثلاثي الأبعاد عامة.

الحقول
capture_time

Timestamp

الطابع الزمني لقياس جهاز استشعار IMU
x

float

قياس المستشعر في المحور x.
y

float

قياس أداة الاستشعار في المحور y.
z

float

قياس المستشعر في المحور z.

ImuDataGapFailureDetails

التفاصيل المتعلقة بمشكلة المعالجة (Failurereason#IMU_DATA_GAP) في حال وجود فجوات متعددة في بيانات IMU، سيتم الإبلاغ هنا فقط عن الفترة ذات المدة الأكبر.

الحقول
gap_duration

Duration

يشير ذلك المصطلح إلى مدة الفجوة التي تم العثور عليها في بيانات جهاز استشعار IMU.
gap_start_time

Duration

الوقت النسبي (منذ بداية الفيديو المضمّن) الذي بدأت فيه الفجوة

InsufficientGpsFailureDetails

التفاصيل المتعلقة بمشكلة تعذُّر المعالجة#INSUFFICIENT_GPS.

الحقول
gps_points_found

int32

عدد نقاط نظام تحديد المواقع العالمي (GPS) التي تم العثور عليها في الفيديو

LatLngBounds

مستطيل في الإحداثيات الجغرافية

الحقول
southwest

LatLng

الزاوية الجنوبية الغربية لهذه الحدود.
northeast

LatLng

الزاوية الشمالية الشرقية من هذه الحدود.

المستوى

معلومات المستوى التي تتضمّن رقم المستوى والاسم المقابل له

الحقول
number

double

اختياريّ. رقم الطابق، يُستخدَم للطلب. يشير الرقم 0 إلى مستوى الأرض، ويشير 1 إلى المستوى الأول فوق مستوى الأرض، ويشير -1 إلى المستوى الأول تحت مستوى الأرض. لا بأس باستخدام القيم غير الصحيحة.
name

string

مطلوب. اسم يتم تعيينه لهذا المستوى، ولا يزيد عن 3 أحرف. فكر في كيفية تسمية أزرار المصعد لهذا المستوى إذا كان هناك مصعد.

ListPhotoSequencesRequest

طلب إدراج جميع تسلسلات الصور التي تخص المستخدم الذي يرسل الطلب.

المَعلمات:

  • تُحدِّد الدالة pageSize الحد الأقصى لعدد تسلسلات الصور المطلوب عرضها.
  • pageToken هي قيمة الرمز المميّز للصفحة التالية التي يتم عرضها من طلب ListPhotoSequences سابق، إن توفّر.
الحقول
page_size

int32

اختياريّ. الحد الأقصى لعدد تسلسلات الصور المطلوب عرضها. يجب ألا تكون قيمة pageSize سالبة. إذا كانت قيمة pageSize صفرًا أو لم يتم تقديمها، يتم استخدام الحجم التلقائي للصفحة وهو 100. قد يكون عدد تسلسلات الصور التي يتم عرضها في الرد أقل من pageSize إذا كان عدد تسلسلات الصور أقل من pageSize. لم يتم تنفيذ ذلك حاليًا، ولكنه قيد التنفيذ.
page_token

string

اختياريّ. قيمة nextPageToken المعروضة من طلب ListPhotoSequences سابق، إن توفّر
filter

string

اختياريّ. تعبير الفلتر مثلاً: imagery_type=SPHERICAL

الفلاتر المتوافقة هي: imagery_type وprocessing_state وmin_latitude وmax_latitude وmin_longitude وmax_longitude وfilename_query وmin_capture_time_seconds و"max_capture_time_seconds". يُرجى الاطّلاع على https://google.aip.dev/160 للحصول على مزيد من المعلومات. ويجب إرسال طلبات البحث عن اسم الملف كعبارة لإتاحة عدة كلمات وحروف خاصة من خلال إضافة علامات اقتباس مع حروف إلغاء. على سبيل المثال: filename_query="مثال على عبارة.mp4"

ListPhotoSequencesResponse

ردّ لإدراج تسلسلات الصور التي تخصّ المستخدِم.

الحقول
photo_sequences[]

Operation

قائمة بتسلسلات الصور من خلال واجهة Operation

يستند الحد الأقصى لعدد السلع التي يتم إرجاعها إلى الحقل pageSize في الطلب.

يمكن أن يكون لكل عنصر في القائمة ثلاث حالات محتملة،

  • Operation.done = false، إذا لم تكتمل معالجة PhotoSequence بعد.
  • Operation.done = true وتم تعبئة Operation.error إذا كان هناك خطأ في المعالجة.
  • Operation.done = true ويحتوي Operation.response على رسالة PhotoSequence، وفي كل تسلسل، تتم تعبئة Id فقط.
next_page_token

string

رمز مميّز لاسترداد الصفحة التالية من النتائج، أو فارغًا إذا لم تكن هناك نتائج أخرى في القائمة

ListPhotosRequest

يمكنك طلب إدراج جميع الصور التي تخصّ المستخدم الذي يرسل الطلب.

الإعداد التلقائي

  • عنوان URL للتنزيل لوحدات البايت الخاصة بالصور.

المَعلمات:

  • تتحكّم السياسة view في ما إذا كان سيتم عرض عنوان URL للتنزيل لوحدات البايت الخاصة بالصور.
  • يحدِّد تطبيق "pageSize" الحد الأقصى لعدد الصور المطلوب عرضها.
  • pageToken هي قيمة الرمز المميّز للصفحة التالية التي يتم عرضها من طلب ListPhotos سابق، إن توفّر.
  • تسمح الدالة filter بالفلترة حسب مَعلمة معيّنة. "رقم تعريف المكان" هي المعلمة الوحيدة المتوافقة في الوقت الحالي.
الحقول
view

PhotoView

مطلوب. تحدِّد هذه السياسة ما إذا كان يجب عرض عنوان URL للتنزيل لوحدات البايت الخاصة بالصور في استجابة "صور Google".
page_size

int32

اختياريّ. الحد الأقصى لعدد الصور المطلوب عرضها. يجب ألا تكون قيمة pageSize سالبة. إذا كانت قيمة pageSize صفرًا أو لم يتم تقديمها، يتم استخدام الحجم التلقائي للصفحة وهو 100. قد يكون عدد الصور التي يتم عرضها في الرد أقل من pageSize إذا كان عدد الصور التي يمتلكها المستخدم أقل من pageSize.
page_token

string

اختياريّ. قيمة nextPageToken المعروضة من طلب ListPhotos سابق، إن توفّر
filter

string

اختياريّ. تعبير الفلتر مثلاً: placeId=ChIJj61dQgK6j4AR4GeTYWZsKWw

الفلاتر المتوافقة هي: placeId وmin_latitude وmax_latitude وmin_longitude وmax_longitude. يُرجى الاطّلاع على https://google.aip.dev/160 للحصول على مزيد من المعلومات.
language_code

string

اختياريّ. رمز اللغة BCP-47، مثل en-US أو "sr-Latn". لمزيد من المعلومات، يُرجى الاطّلاع على http://www.unicode.org/reports/tr35/#Unicode_locale_identifier. إذا لم يتم تحديد language_code، يتم استخدام إعدادات اللغة المفضّلة للمستخدم في خدمات Google.

ListPhotosResponse

ردّ لإدراج جميع الصور التي تخصّ أحد المستخدمين.

الحقول
photos[]

Photo

قائمة الصور يحدّد الحقل pageSize في الطلب عدد العناصر التي تم عرضها.
next_page_token

string

رمز مميّز لاسترداد الصفحة التالية من النتائج، أو فارغًا إذا لم تكن هناك نتائج أخرى في القائمة

NoOverlapGpsFailureDetails

التفاصيل المتعلقة بـ PhotoSequenceProcessingFailurereason#NO_OVERLAP_GPS.

الحقول
gps_start_time

Timestamp

وقت أول نقطة مسجّلة لنظام تحديد المواقع العالمي (GPS)
gps_end_time

Timestamp

وقت آخر نقطة مسجّلة لنظام تحديد المواقع العالمي (GPS)
video_start_time

Timestamp

وقت بدء الفيديو
video_end_time

Timestamp

وقت انتهاء الفيديو

NotOutdoorsFailureDetails

التفاصيل ذات الصلة بـ"تعذُّر المعالجة"#NOT_OUTDOORS. وإذا تم العثور على عدة إطارات داخلية، يتم تسجيل الإطار الأول هنا.

الحقول
start_time

Duration

الوقت النسبي (منذ بداية الفيديو المضمّن) الذي تم فيه العثور على إطار داخلي.

صورة

تُستخدَم الصورة لتخزين الصور بزاوية 360 إلى جانب البيانات الوصفية للصور.

الحقول
photo_id

PhotoId

مطلوب. النتائج فقط. مطلوب عند تحديث الصورة. الإخراج فقط عند إنشاء صورة. معرّف للصورة، يكون فريدًا بين جميع الصور في Google.
upload_reference

UploadRef

الإدخال فقط. مطلوب عند إنشاء صورة. الإدخال فقط. عنوان URL للمورد الذي يتم تحميل وحدات البايت للصور إليه.
download_url

string

النتائج فقط. عنوان URL لتنزيل وحدات البايت الخاصة بالصور. يتم ضبط هذا الحقل فقط عند ضبط GetPhotoRequest.view على PhotoView.INCLUDE_DOWNLOAD_URL.
thumbnail_url

string

النتائج فقط. عنوان URL للصورة المصغّرة لعرض معاينة للصورة المحدّدة.
pose

Pose

اختياريّ. وضع الصورة
connections[]

Connection

اختياريّ. الروابط بصور أخرى يمثل الاتصال الرابط من هذه الصورة إلى صورة أخرى.
capture_time

Timestamp

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

Timestamp

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

Place

اختياريّ. الأماكن التي تنتمي إليها هذه الصورة.
view_count

int64

النتائج فقط. عدد مشاهدات الصورة
transfer_status

TransferStatus

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

MapsPublishStatus

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

MapsPublishStatus

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

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

TransferStatus

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

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

PhotoId

معرِّف Photo.

الحقول
id

string

معرّف فريد للصورة

PhotoResponse

حمولة الاستجابة لعملية Photo واحدة في عمليات مجمّعة بما في ذلك BatchGetPhotos وBatchUpdatePhotos.

الحقول
status

Status

حالة عملية الحصول على صورة واحدة أو تعديلها في الطلب المجمّع.
photo

Photo

مرجع Photo، إذا تم الطلب بنجاح

PhotoSequence

سلسلة من الصور بزاوية 360 إلى جانب البيانات الوصفية.

الحقول
id

string

النتائج فقط. معرّف فريد لتسلسل الصور وهو يعمل أيضًا كمعرّف عملية طويل الأمد إذا تم التحميل بشكل غير متزامن.
photos[]

Photo

النتائج فقط. الصور التي تظهر فيها طوابع زمنية متزايدة.
upload_reference

UploadRef

الإدخال فقط. مطلوب عند إنشاء تسلسل الصور. اسم المورد الذي يتم فيه تحميل وحدات البايت لتسلسل الصور (في شكل فيديو).
capture_time_override

Timestamp

اختياريّ. الوقت المطلق الذي يبدأ فيه التقاط تسلسل الصور. في حال كان تسلسل الصور عبارة عن فيديو، يكون وقت بدء الفيديو. إذا تمت تعبئة هذا الحقل في الإدخال، فسيؤدي ذلك إلى إلغاء وقت الالتقاط في الفيديو أو ملف XDM.
upload_time

Timestamp

النتائج فقط. وقت إنشاء تسلسل الصور هذا في خدمة متجر uSV.
raw_gps_timeline[]

Pose

الإدخال فقط. قياسات أولية لنظام تحديد المواقع العالمي (GPS) مع زيادة الطوابع الزمنية من الجهاز التي لا تتم مزامنتها مع كل صورة وسيتم استخدام هذه القياسات الأولية لاستنتاج وضع كل إطار. يكون هذا الحقل مطلوبًا في الإدخال عندما يكون مصدر الإدخال VIDEO، ولا تكون قياسات نظام تحديد المواقع العالمي (GPS) الأولية في مسار البيانات الوصفية لحركة الكاميرا (CAMM). يمكن للمستخدم تحديد الأولوية باستخدام gps_source إذا تم توفير قياسات أولية لنظام تحديد المواقع العالمي (GPS) في كل من RAW_gps_timeline وتتبّع البيانات الوصفية لحركة الكاميرا (CAMM).
gps_source

GpsSource

الإدخال فقط. إذا تضمّن كلٌّ من RAW_gps_timeline ومسار البيانات الوصفية لحركة الكاميرا (CAMM) قياسات نظام تحديد المواقع العالمي (GPS)، حدِّد الخيار الذي يكون له الأولوية.
imu

Imu

الإدخال فقط. بيانات جهاز استشعار IMU ثلاثية المحاور للمجموعة. وإذا كانت هذه البيانات كبيرة جدًا بحيث لا يمكن وضعها في الطلب، يجب وضعها في مسار CAMM للفيديو. تكون لهذه البيانات دائمًا الأولوية على بيانات CAMM المكافئة، إن وجدت.
processing_state

ProcessingState

النتائج فقط. حالة معالجة هذا التسلسل.
failure_reason

ProcessingFailureReason

النتائج فقط. إذا كان هذا التسلسل لمعالجة البيانات = تعذّر إتمامها، سيتم عرض سبب فشلها. إذا كانت حالة transaction_state هي أي قيمة أخرى، سيتم إلغاء ضبط هذا الحقل.
failure_details

ProcessingFailureDetails

النتائج فقط. إذا كان التسلسل يحتوي على مجموعة failure_reason، قد يحتوي هذا التسلسل على تفاصيل إضافية عن الخطأ.
distance_meters

double

النتائج فقط. المسافة المحسوبة لتسلسل الصور بالمتر.
sequence_bounds

LatLngBounds

النتائج فقط. مربع مستطيل يضم كل صورة في تسلسل الصور هذا.
view_count

int64

النتائج فقط. إجمالي عدد المشاهدات التي تلقتها جميع الصور المنشورة في تسلسل الصور هذا.
filename

string

النتائج فقط. اسم ملف التحميل لا يتضمّن مسار الدليل. لا يتوفّر هذا الخيار إلا إذا تم تحميل التسلسل على منصّة توفّر اسم الملف.

GpsSource

المصدر الأساسي لقياسات نظام تحديد المواقع العالمي (GPS).

عمليات التعداد
PHOTO_SEQUENCE وتكون الأولوية لنظام تحديد المواقع العالمي في RAW_gps_timeline في حال توفره.
CAMERA_MOTION_METADATA_TRACK وتكون الأولوية لنظام تحديد المواقع العالمي (GPS) في مسار البيانات الوصفية لحركة الكاميرا (CAMM) في حال توفّره.

PhotoView

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

عمليات التعداد
BASIC لا تتضمّن ردود الخادم عنوان URL للتنزيل لوحدات البايت الخاصة بالصور. القيمة التلقائية.
INCLUDE_DOWNLOAD_URL تتضمن ردود الخادم عنوان URL للتنزيل لوحدات البايت الخاصة بالصور.

مكان

وضع البيانات الوصفية لكيان ما.

الحقول
place_id

string

معرّف المكان، كما هو موضّح في https://developers.google.com/places/place-id.
name

string

النتائج فقط. تمثّل هذه السمة اسم المكان، مترجَمًا إلى language_code.
language_code

string

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

الوضع

قياس الوضع الأوّلي لأحد العناصر.

الحقول
lat_lng_pair

LatLng

زوج خط العرض وخط الطول للوضع، كما هو موضّح هنا: https://cloud.google.com/datastore/docs/reference/rest/Shared.Types/LatLng عند إنشاء Photo، إذا لم يتم توفير زوجَي خط العرض وخط الطول، سيتم استخدام الموقع الجغرافي من عنوان exif. يؤدي عدم تقديم زوج من خط العرض وخط الطول في الصورة أو عنوان EXIF إلى تعذُّر معالجة الصورة.
altitude

double

ارتفاع الوضعية على الأمتار فوق القطْع الناقص WGS84. تشير NaN إلى كمية لم يتم قياسها.
heading

double

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

double

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

double

اللفافة بالدرجات يجب أن تكون القيمة أكبر من أو يساوي 0 وأصغر من 360. تعني القيمة 0 المستوى مع الأفق. تشير NaN إلى كمية لم يتم قياسها.
gps_record_timestamp_unix_epoch

Timestamp

وقت تسجيل نظام تحديد المواقع العالمي (GPS) منذ حقبة التوقيت العالمي المنسق (UTC).
level

Level

المستوى (الطابق في مبنى) يُستخدَم لضبط التنقل العمودي.
accuracy_meters

float

الدقة الأفقية المقدرة لهذا الوضع بالأمتار بثقة تبلغ 68% (انحراف معياري واحد). على سبيل المثال، على أجهزة Android، تتوفّر هذه القيمة من خلال هذه الطريقة: https://developer.android.com/reference/android/location/Location#getAccuracy(). تعتمد المنصات الأخرى طرقًا مختلفة للحصول على تقديرات دقة مشابهة.

ProcessingFailureDetails

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

الحقول
حقل الاتحاد details. سيتم ضبط مجموعة واحدة فقط من التفاصيل، ويجب أن تتطابق مع التعداد المقابل في "سبب تعذُّر المعالجة". يمكن أن يكون details واحدًا فقط مما يلي:
insufficient_gps_details

InsufficientGpsFailureDetails

عرض معلومات غير كافية في GpsFailureDetails.
gps_data_gap_details

GpsDataGapFailureDetails

يمكنك الاطّلاع على GpsDataGapFailureDetails.
imu_data_gap_details

ImuDataGapFailureDetails

يمكنك الاطّلاع على ImuDataGapFailureDetails.
not_outdoors_details

NotOutdoorsFailureDetails

يُرجى الاطّلاع على NotOutdoorsFailureDetails.
no_overlap_gps_details

NoOverlapGpsFailureDetails

يمكنك الاطّلاع على NoOverlapGpsFailureDetails.

ProcessingFailureReason

الأسباب المحتملة لتعذُّر معالجة PhotoSequence.

عمليات التعداد
PROCESSING_FAILURE_REASON_UNSPECIFIED لم يتم تحديد سبب عدم اكتمال العملية، وهذه هي القيمة التلقائية.
LOW_RESOLUTION درجة دقة إطار الفيديو صغيرة جدًا.
DUPLICATE سبق أن تم تحميل هذا الفيديو.
INSUFFICIENT_GPS نقاط GPS قليلة جدًا.
NO_OVERLAP_GPS لا يوجد تداخل بين الإطار الزمني لمسار نظام تحديد المواقع العالمي (GPS) والإطار الزمني للفيديو.
INVALID_GPS نظام تحديد المواقع العالمي (GPS) غير صالح (على سبيل المثال، جميع نقاط نظام تحديد المواقع العالمي هي على (0,0)
FAILED_TO_REFINE_POSITIONS لا يمكن تحديد موقع تسلسل الصور بدقة في العالم.
TAKEDOWN تمت إزالة التسلسل لأسباب تتعلق بالسياسة.
CORRUPT_VIDEO ملف الفيديو تالف أو تعذّر فك ترميزه.
INTERNAL حدث عطل دائم في النظام الأساسي.
INVALID_VIDEO_FORMAT تنسيق الفيديو غير صالح أو غير متوافق.
INVALID_VIDEO_DIMENSIONS تم العثور على نسبة عرض إلى ارتفاع غير صالحة للصورة.
INVALID_CAPTURE_TIME وقت الالتقاط غير صالح. الطوابع الزمنية كانت من المستقبل.
GPS_DATA_GAP تتضمّن بيانات نظام تحديد المواقع العالمي (GPS) فجوة تزيد مدتها عن 5 ثوانٍ.
JUMPY_GPS بيانات نظام تحديد المواقع العالمي (GPS) غير منتظمة بحيث لا يمكن معالجتها.
INVALID_IMU بيانات مقياس التسارع والجيروسكوب وما إلى ذلك غير صالحة. وقد تكون هناك حقول غير مطلوبة (س أو ص أو ع أو الوقت)، أو قد لا يتم تنسيقها بشكلٍ صحيح، أو قد تكون هناك أي مشكلة أخرى تمنع أنظمتنا من تحليلها.
INSUFFICIENT_IMU نقاط وحدة استشعار IMU قليلة جدًا.
INSUFFICIENT_OVERLAP_TIME_SERIES التداخل غير الكافي في الإطار الزمني بين بيانات نظام تحديد المواقع العالمي (GPS) ووحدة استشعار IMU وغيرها من بيانات السلاسل الزمنية.
IMU_DATA_GAP تحتوي بيانات مقياس التسارع والجيروسكوب وما إلى ذلك على فجوات تزيد مدتها عن 0.1 ثانية.
UNSUPPORTED_CAMERA الكاميرا غير متوافقة.
NOT_OUTDOORS بعض اللقطات كانت داخل المنزل، وهذا الإجراء غير متوافق.
INSUFFICIENT_VIDEO_FRAMES لا تتوفّر إطارات كافية للفيديو.
INSUFFICIENT_MOVEMENT لا تتوفر بيانات نقل كافية.

ProcessingState

حالة معالجة التسلسل. تنتقل الحالات على النحو التالي:

     +-------------------------+
     |                         |
 +---v---+  +----------+  +----+----+
 |PENDING+-->PROCESSING+-->PROCESSED|
 +---+---+  +----+-----+  +----+----+
     |           |             |
     |        +--v---+         |
     +-------->FAILED<---------+
              +------+

قد ينتقل التسلسل إلى "تعذّر الإجراء" من أي حالة. بالإضافة إلى ذلك، قد تتم إعادة معالجة التسلسل الذي تمت معالجته في أي وقت.

عمليات التعداد
PROCESSING_STATE_UNSPECIFIED لم يتم تحديد الولاية، وهذه هي القيمة التلقائية.
PENDING لم تبدأ معالجة التسلسل بعد.
PROCESSING التسلسل قيد المعالجة حاليًا.
PROCESSED انتهت معالجة التسلسل، بما في ذلك موضع التحسين.
FAILED تعذّرت معالجة التسلسل. راجِع "سبب التعذُّر" لمزيد من التفاصيل.

UpdatePhotoRequest

طلب تعديل البيانات الوصفية لـ Photo تحديث وحدات البكسل في الصورة غير معتمد.

الحقول
photo

Photo

مطلوب. عنصر Photo يحتوي على البيانات الوصفية الجديدة.
update_mask

FieldMask

مطلوب. قناع يحدّد الحقول في البيانات الوصفية للصورة المطلوب تعديلها في حال عدم توفّر بيانات Photo الوصفية القديمة، سيتم استبدال بيانات Photo الوصفية الجديدة بالكامل في هذا الطلب. يتعذّر التعديل في حال تحديد حقول غير صالحة. يمكن تحديد حقول متعددة في قائمة مفصولة بفواصل.

الحقول التالية صالحة:

  • pose.heading
  • pose.lat_lng_pair
  • pose.pitch
  • pose.roll
  • pose.level
  • pose.altitude
  • connections
  • places

ملاحظة: عندما يحتوي updateMask على حقول متكرّرة، يتم استبدال مجموعة القيم المتكرّرة بالكامل بالمحتوى الجديد. على سبيل المثال، إذا كان الحقل "updateMask" يحتوي على الحقل "connections" وكان الحقل "UpdatePhotoRequest.photo.connections" فارغًا، ستتم إزالة جميع عمليات الربط.

UploadRef

تحميل مرجع لملفات الوسائط

الحقول
حقل الاتحاد file_source. مطلوب. يمكن أن يكون file_source واحدًا فقط مما يلي:
upload_url

string

يجب أن يكون مرجع التحميل فريدًا لكل مستخدم. وهو يتّبع النموذج التالي: "https://streetviewpublish.googleapis.com/media/user/{account_id}/photo/{upload_reference}".