الفهرس
MapsPlatformDatasets
(واجهة)CreateDatasetRequest
(رسالة)Dataset
(رسالة)DeleteDatasetRequest
(رسالة)DownloadDatasetRequest
(رسالة)DownloadDatasetResponse
(رسالة)FileFormat
(تعداد)GcsSource
(رسالة)GetDatasetRequest
(رسالة)ImportDatasetRequest
(رسالة)ImportDatasetResponse
(رسالة)ListDatasetsRequest
(رسالة)ListDatasetsResponse
(رسالة)LocalFileSource
(رسالة)Status
(رسالة)Status.State
(تعداد)UpdateDatasetMetadataRequest
(رسالة)Usage
(تعداد)
MapsPlatformDatasets
تعريف الخدمة لواجهة برمجة تطبيقات مجموعات البيانات في "منصة خرائط Google"
CreateDataset |
---|
إنشاء مجموعة بيانات جديدة للمشروع المحدد.
|
DeleteDataset |
---|
احذف مجموعة البيانات المحددة .
|
DownloadDataset |
---|
يتم تنزيل مجموعة بيانات.
|
GetDataset |
---|
الحصول على مجموعة البيانات.
|
ImportDataset |
---|
لاستيراد نسخة جديدة من البيانات لمجموعة البيانات.
|
ListDatasets |
---|
سرد جميع مجموعات البيانات للمشروع المحدد.
|
UpdateDatasetMetadata |
---|
تحديث البيانات الوصفية لمجموعة البيانات.
|
CreateDatasetRequest
طلب إنشاء مجموعة بيانات للخرائط
الحقول | |
---|---|
parent |
مطلوبة. تمثّل هذه السمة المشروع الرئيسي الذي سيمتلك مجموعة البيانات. التنسيق: project/{$project} |
dataset |
مطلوبة. تمثّل هذه السمة نسخة مجموعة البيانات المطلوب إنشاؤها. |
مجموعة البيانات
تمثيل لمجموعة بيانات النظام الأساسي للخرائط.
الحقول | |
---|---|
name |
اسم المورد، المشاريع/{project}/مجموعات البيانات/{dataset_id} |
display_name |
اسم يمكن لشخص عادي قراءته، يظهر في واجهة مستخدم وحدة التحكم . |
description |
وصف مجموعة البيانات هذه . |
version_id |
تمثّل هذه السمة معرّف إصدار مجموعة البيانات. |
usage[] |
حالات الاستخدام المحددة لمجموعة البيانات هذه. |
status |
النتائج فقط. تمثّل هذه السمة حالة إصدار مجموعة البيانات هذا. |
create_time |
النتائج فقط. الوقت الذي تم فيه إنشاء مجموعة البيانات لأول مرة. |
update_time |
النتائج فقط. الوقت الذي تم فيه آخر تعديل للبيانات الوصفية لمجموعة البيانات. |
version_create_time |
النتائج فقط. الوقت الذي تم فيه إنشاء هذه النسخة من مجموعة البيانات. (حدث ذلك عند استيراد البيانات إلى مجموعة البيانات) |
version_description |
النتائج فقط. وصف هذا الإصدار من مجموعة البيانات. يتم توفيره عند استيراد البيانات إلى مجموعة البيانات. |
حقل الاتحاد data_source تفاصيل حول مصدر بيانات مجموعة البيانات. يمكن أن تكون السمة "data_source " واحدة فقط مما يلي: |
|
local_file_source |
مصدر ملف محلي لمجموعة البيانات لعملية تحميل واحدة. |
gcs_source |
مصدر ملف Google Cloud Storage لمجموعة البيانات لعملية تحميل واحدة. |
DeleteDatasetRequest
طلب حذف مجموعة بيانات
مجموعة البيانات المطلوب حذفها.
الحقول | |
---|---|
name |
مطلوبة. Format: projects/${project}/datasets/{dataset_id} |
DownloadDatasetRequest
طلب تنزيل مجموعة البيانات.
الحقول | |
---|---|
name |
مجموعة البيانات المطلوب جلبها. Format: projects/${project}/datasets/${dataset_id} |
DownloadDatasetResponse
استجابة من تنزيل مجموعة البيانات.
FileFormat
تمثّل هذه السمة تنسيق الملف الذي يتم تحميله.
عمليات التعداد | |
---|---|
FILE_FORMAT_UNSPECIFIED |
تنسيق الملف غير محدد. |
FILE_FORMAT_GEOJSON |
GeoJson. |
FILE_FORMAT_KML |
ملف KML. |
FILE_FORMAT_CSV |
بملف CSV. |
GcsSource
تفاصيل عن مصدر البيانات عندما يكون في Google Cloud Storage.
الحقول | |
---|---|
input_uri |
معرّف الموارد المنتظم (URI) لبيانات المصدر. مثلاً: |
file_format |
تنسيق الملف لعنصر Google Cloud Storage. يُستخدم هذا بشكل أساسي للتحقق من الصحة. |
GetDatasetRequest
طلب الحصول على مجموعة البيانات المحددة.
الحقول | |
---|---|
name |
مطلوبة. اسم المورد: project/{project}/datasets/{dataset_id} |
ImportDatasetRequest
طلب استيراد نسخة جديدة من مجموعة البيانات.
الحقول | |
---|---|
name |
مطلوبة. اسم المورد، المشاريع/{project}/مجموعات البيانات/{dataset_id} |
version_description |
وصف للبيانات الجديدة التي يتم استيرادها. |
حقل الاتحاد data_source تفاصيل حول مصدر بيانات مجموعة البيانات. يمكن أن تكون السمة "data_source " واحدة فقط مما يلي: |
|
local_file_source |
مصدر ملف محلي لمجموعة البيانات للاستيراد لمرة واحدة. |
gcs_source |
مصدر ملف Google Cloud Storage لمجموعة البيانات لعملية استيراد لمرة واحدة. |
ImportDatasetResponse
رد ناتج من استيراد نسخة جديدة من مجموعة البيانات.
الحقول | |
---|---|
name |
مطلوبة. اسم المورد لإصدار مجموعة البيانات الذي تم إنشاؤه حديثًا، project/{project}/datasets/{dataset_id}@{version_id} |
ListDatasetsRequest
طلب سرد مجموعات بيانات للمشروع.
الحقول | |
---|---|
parent |
مطلوبة. اسم المشروع لإدراج جميع مجموعات البيانات له. |
page_size |
الحدّ الأقصى لعدد النُسخ المطلوب عرضها في كل صفحة وفي حال عدم تحديدها (أو عدم توفّرها)، سيتم عرض جميع مجموعات البيانات. |
page_token |
الرمز المميز للصفحة الذي تم استلامه من استدعاء ListDatasets سابق. قم بإدخاله لاسترداد الصفحة التالية. |
ListDatasetsResponse
الرد على قائمة مجموعات البيانات للمشروع.
الحقول | |
---|---|
datasets[] |
جميع مجموعات البيانات الخاصة بالمشروع. |
next_page_token |
رمز مميز يمكن إرساله كـ |
LocalFileSource
التفاصيل المتعلّقة بمصدر البيانات عندما يكون ملفًا محليًا.
الحقول | |
---|---|
filename |
اسم الملف الذي تم تحميله وامتداده |
file_format |
تمثّل هذه السمة تنسيق الملف الذي يتم تحميله. |
الحالة
حالة إصدار مجموعة البيانات.
الحقول | |
---|---|
state |
تعداد الحالة للحالة |
error_message |
رسالة خطأ توضح سبب عدم التنفيذ. وتكون فارغة إذا لم تكن مجموعات البيانات في حالة فشل. |
الحالة
قائمة بالحالات لمجموعة البيانات.
عمليات التعداد | |
---|---|
STATE_UNSPECIFIED |
لم يتم ضبط حالة مجموعة البيانات هذه. |
STATE_IMPORTING |
يتم استيراد البيانات إلى مجموعة بيانات. |
STATE_IMPORT_SUCCEEDED |
تم استيراد البيانات إلى مجموعة بيانات بنجاح. |
STATE_IMPORT_FAILED |
تعذَّر استيراد البيانات إلى مجموعة بيانات. |
STATE_DELETING |
جارٍ حذف مجموعة البيانات. |
STATE_DELETION_FAILED |
حالة تعذّر الحذف. تشير هذه الحالة إلى تعذُّر حذف مجموعة البيانات. قد تتم إعادة محاولة الحذف. |
STATE_PROCESSING |
جارٍ معالجة البيانات. |
STATE_PROCESSING_FAILED |
حالة تعذّر المعالجة. تشير هذه الحالة إلى تعذّر المعالجة وقد يتم الإبلاغ عن أخطاء. |
STATE_NEEDS_REVIEW |
هذه الحالة غير مستخدَمة حاليًا. |
STATE_PUBLISHING |
حالة النشر تشير هذه الحالة إلى أنّ عملية النشر قيد التقدّم. |
STATE_PUBLISHING_FAILED |
حالات تعذُّر النشر تشير هذه الحالة إلى تعذُّر النشر. قد تتم إعادة محاولة النشر. |
STATE_COMPLETED |
الحالة المكتملة. تمثل هذه الحالة مجموعة البيانات المتاحة لاستخدامها المحدد. |
UpdateDatasetMetadataRequest
طلب تعديل حقول البيانات الوصفية لمجموعة البيانات.
الحقول | |
---|---|
dataset |
مطلوبة. مجموعة البيانات المطلوب تعديلها. يُستخدم اسم مجموعة البيانات لتحديد مجموعة البيانات المراد تحديثها. يحتوي الاسم على التنسيق: project/{project}/datasets/{dataset_id} |
update_mask |
قائمة الحقول المطلوب تعديلها. يجب إدخال القيمة "*" لاستبدال الجهاز بالكامل. |
الاستخدام
يحدد الاستخدام المكان المراد استخدام البيانات فيه لمعرفة كيفية معالجة البيانات.
عمليات التعداد | |
---|---|
USAGE_UNSPECIFIED |
لم يتم ضبط استخدام مجموعة البيانات هذه. |
USAGE_DATA_DRIVEN_STYLING |
وسيتم استخدام مجموعة البيانات هذه للنمط المستند إلى البيانات. |