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

একটি ডেটাসেট তৈরি করে তাতে ডেটা আপলোড করার পরে, আপনি ডেটাসেট অ্যাক্সেস করার জন্য 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"
      }
    }
  ]
}

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

একটি নির্দিষ্ট ডেটাসেট সম্পর্কে তথ্য পেতে, ডেটাসেটের আইডি সহ get ডেটাসেট এন্ডপয়েন্টে একটি 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