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

بعد إنشاء مجموعة بيانات وتحميل البيانات إليها، يمكنك استخدام طلبات HTTP 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 في الdirectory نفسه المستخدَم لتشغيل الأمر cURL:

--output myjson.json

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

--output /tmp/myjson.json