الحصول على مجموعة بيانات

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

لمحة عن إصدارات مجموعات البيانات

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

يمكنك تحميل بيانات جديدة إلى مجموعة البيانات لإنشاء نسخة جديدة من مجموعة البيانات:

  • إذا تم تحميل البيانات الجديدة بنجاح، سيصبح الإصدار الجديد هو الإصدار "النشط" والإصدار الذي يستخدمه تطبيقك.

  • في حال حدوث خطأ في التحميل، تظلّ نسخة مجموعة البيانات السابقة التي تم تحميلها بنجاح هي النسخة "النشطة" التي يستخدمها تطبيقك.

لمزيد من المعلومات حول إنشاء نسخة جديدة من مجموعة بيانات، يُرجى الاطّلاع على تحميل بيانات جديدة إلى مجموعة البيانات.

عرض قائمة بجميع مجموعات البيانات

يمكنك إدراج جميع مجموعات البيانات من خلال إرسال طلب HTTP GET إلى نقطة النهاية list datasets:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets

يعرض هذا الطلب معلومات عن أحدث إصدار من جميع مجموعات البيانات، بغض النظر عمّا إذا كان الإصدار هو الإصدار النشط. إذا أردت فقط إدراج الإصدار النشط من كل مجموعة بيانات، أضِف مَعلمة طلب البحث tag=active إلى الطلب:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets?tag=active

على سبيل المثال، يعرض هذا الطلب معلومات عن أحدث إصدار من جميع مجموعات البيانات:

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H 'Authorization: Bearer $TOKEN' \
"https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets"

يعرض هذا الطلب ردًا على النحو التالي:

{
  "datasets": [
    {
      "name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46",
      "displayName": "My Test Dataset",
      "versionId": "5fb34e-1405-4ecd-8f81-31f1c07",
      "usage": [
        "USAGE_DATA_DRIVEN_STYLING"
      ],
      "gcsSource": {
        "inputUri": "gs://mybucket/my.csv",
        "fileFormat": "FILE_FORMAT_CSV"
      },
      "createTime": "2023-03-24T14:47:37.308977Z",
      "updateTime": "2023-03-24T14:48:05.053114Z",
      "versionCreateTime": "2023-03-24T14:48:05.053114Z",
      "status": {
        "state": "STATE_COMPLETED"
      }
    },
    {
      "name": "projects/PROJECT_NUMBER_OR_ID/datasets/2c8ae479-96704-89c6435ca959",
      "displayName": "My Other Test Dataset",
      "versionId": "0d2e3-b9da-47cc-819f-7ac67562",
      "usage": [
        "USAGE_DATA_DRIVEN_STYLING"
      ],
      "localFileSource": {
        "fileFormat": "FILE_FORMAT_CSV"
      },
      "createTime": "2023-03-24T14:41:52.579755Z",
      "updateTime": "2023-03-24T14:42:56.784122Z",
      "versionCreateTime": "2023-03-24T14:42:56.784122Z",
      "status": {
        "state": "STATE_COMPLETED"
      }
    }
  ]
}

الحصول على معلومات عن مجموعة بيانات

للحصول على معلومات حول مجموعة بيانات معيّنة، أرسِل طلب HTTP GET إلى نقطة النهاية get dataset التي تتضمّن أيضًا رقم تعريف مجموعة البيانات:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID

يعرض هذا الطلب معلومات عن أحدث إصدار من مجموعة البيانات، بغض النظر عمّا إذا كان الإصدار هو الإصدار النشط. إذا أردت الحصول على معلومات عن النسخة النشطة من مجموعة البيانات، أضِف علامة @active إلى الطلب:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID@active

على سبيل المثال:

curl -X GET \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H 'Authorization: Bearer $TOKEN' \
"https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46@active"

يعرض هذا الطلب ردًا في النموذج:

{
  "name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46",
  "displayName": "My Test Dataset",
  "versionId": "5fb34e-1405-4ecd-8f81-31f1c07",
  "usage": [
    "USAGE_DATA_DRIVEN_STYLING"
  ],
  "gcsSource": {
    "inputUri": "gs://mybucket/my.csv",
    "fileFormat": "FILE_FORMAT_CSV"
  },
  "createTime": "2023-03-24T14:47:37.308977Z",
  "updateTime": "2023-03-24T14:48:05.053114Z",
  "versionCreateTime": "2023-03-24T14:48:05.053114Z",
  "status": {
    "state": "STATE_COMPLETED"
  }
}

تنزيل مجموعة بيانات

لتنزيل البيانات من أحدث إصدار لمجموعة بيانات، أرسِل طلب HTTP GET إلى نقطة النهاية تنزيل مجموعة البيانات التي تتضمّن أيضًا رقم تعريف مجموعة البيانات:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID:download?alt=media

على سبيل المثال:

curl -X GET -L \
-H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
-H 'Authorization: Bearer $TOKEN' \
--output LOCAL_LOCATION_TO_OUTPUT \
"https://mapsplatformdatasets.googleapis.com/download/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e8a9e4f9fc46:download?alt=media"

في هذا المثال، يمكنك استخدام الخيار cURL --output لتحديد اسم الملف الذي يحتوي على البيانات التي تم تنزيلها. على سبيل المثال، يحدّد العلامة --output التالية تنزيل مجموعة البيانات إلى ملف باسم myjson.json في نفس الدليل المستخدم لتشغيل الأمر cURL:

--output myjson.json

أو استخدِم العلامة التالية لتنزيل البيانات إلى myjson.json في الدليل /tmp:

--output /tmp/myjson.json