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

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

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

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

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

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

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

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

سرد جميع مجموعات البيانات

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

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 إلى نقطة نهاية الحصول على مجموعة البيانات والتي على معرّف مجموعة البيانات:

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