একটি ডেটাসেট পান

একটি ডেটাসেট তৈরি করে তাতে ডেটা আপলোড করার পর, আপনি HTTP GET রিকোয়েস্ট ব্যবহার করে ডেটাসেটটি অ্যাক্সেস করতে পারেন। এই পৃষ্ঠায় বর্ণনা করা হয়েছে কীভাবে আপনার সমস্ত ডেটাসেটের তালিকা দেখতে হয়, কীভাবে একটি নির্দিষ্ট ডেটাসেট সম্পর্কে তথ্য পেতে হয় এবং কীভাবে একটি ডেটাসেট থেকে ডেটা ডাউনলোড করতে হয়।

ডেটাসেট সংস্করণ সম্পর্কে

সফলভাবে ডেটা আপলোড হওয়ার পর, ডেটাসেটের অবস্থা STATE_COMPLETED এ সেট হয়ে যায় এবং সেই ডেটাসেটটি সক্রিয় সংস্করণ হয়ে ওঠে। এর মানে হলো, ডেটাসেটটি আপনার অ্যাপে ব্যবহারের জন্য প্রস্তুত। ডেটাসেটের state জানতে, আপনি সমস্ত ডেটাসেটের তালিকা দেখতে পারেন অথবা একটি নির্দিষ্ট ডেটাসেট পেতে পারেন।

ডেটা সেটের একটি নতুন সংস্করণ তৈরি করতে আপনি ডেটা সেটে নতুন ডেটা আপলোড করতে পারেন:

• নতুন ডেটা সফলভাবে আপলোড হলে, নতুন সংস্করণটি "সক্রিয়" সংস্করণ হয়ে যায় এবং আপনার অ্যাপে সেই সংস্করণটিই ব্যবহৃত হয়।

• আপলোডে কোনো ত্রুটি হলে, পূর্ববর্তী সফল ডেটাসেট সংস্করণটিই 'সক্রিয়' সংস্করণ হিসেবে থেকে যায় এবং আপনার অ্যাপ সেই সংস্করণটিই ব্যবহার করে।

ডেটা সেটের নতুন সংস্করণ তৈরি করার বিষয়ে আরও তথ্যের জন্য, ডেটা সেটে নতুন ডেটা আপলোড করুন দেখুন।

সমস্ত ডেটাসেট তালিকাভুক্ত করুন

`list datasets` এন্ডপয়েন্টে একটি 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"
      }
    }
  ]
}

একটি ডেটাসেট সম্পর্কে তথ্য পান

কোনো নির্দিষ্ট ডেটাসেট সম্পর্কে তথ্য পেতে, get dataset এন্ডপয়েন্টে একটি 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 ফ্ল্যাগটি নির্দেশ করে যে ডেটাসেটটি cURL কমান্ডটি চালানোর জন্য ব্যবহৃত একই ডিরেক্টরিতে myjson.json নামের একটি ফাইলে ডাউনলোড করা হবে:

--output myjson.json

অথবা /tmp ডিরেক্টরিতে থাকা myjson.json ফাইলে ডেটা ডাউনলোড করতে নিম্নলিখিত ফ্ল্যাগটি ব্যবহার করুন:

--output /tmp/myjson.json