یک مجموعه داده دریافت کنید

پس از ایجاد یک مجموعه داده و آپلود داده ها در آن، می توانید از درخواست های HTTP GET برای دسترسی به مجموعه داده استفاده کنید. این صفحه نحوه فهرست کردن همه مجموعه داده های خود، نحوه دریافت اطلاعات در مورد یک مجموعه داده خاص و نحوه دانلود داده ها از یک مجموعه داده را شرح می دهد.

درباره نسخه های مجموعه داده

پس از آپلود موفقیت آمیز داده، وضعیت مجموعه داده روی STATE_COMPLETED تنظیم می شود و آن مجموعه داده به نسخه فعال تبدیل می شود. این بدان معناست که مجموعه داده برای استفاده در برنامه شما آماده است. برای تعیین state مجموعه داده، می توانید همه مجموعه داده ها را فهرست کنید یا یک مجموعه داده خاص را دریافت کنید.

برای ایجاد نسخه جدیدی از مجموعه داده می توانید داده های جدیدی را در مجموعه داده آپلود کنید:

  • اگر داده های جدید با موفقیت آپلود شوند، نسخه جدید به نسخه "فعال" تبدیل می شود و نسخه ای است که توسط برنامه شما استفاده می شود.

  • اگر خطایی در آپلود وجود داشته باشد، نسخه داده موفق قبلی به‌عنوان نسخه «فعال» باقی می‌ماند و نسخه‌ای است که برنامه شما استفاده می‌کند.

برای اطلاعات بیشتر درباره ایجاد نسخه جدیدی از مجموعه داده، به آپلود داده جدید در مجموعه داده مراجعه کنید.

لیست تمام مجموعه های داده

با ارسال یک درخواست HTTP GET به نقطه پایانی مجموعه داده‌های فهرست، همه مجموعه‌های داده را فهرست کنید:

https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets

این درخواست اطلاعات مربوط به آخرین نسخه از همه مجموعه‌های داده را برمی‌گرداند، صرف نظر از اینکه آیا نسخه نسخه فعال است یا خیر. اگر فقط می‌خواهید نسخه فعال هر مجموعه داده را فهرست کنید، پارامتر tag=active query را به درخواست اضافه کنید:

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