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

بعد إنشاء مجموعة بيانات وتحميل البيانات إليها، يمكنك استخدام طلبات 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 إلى نقطة نهاية 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