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

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