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

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