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

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

--output myjson.json

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

--output /tmp/myjson.json