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

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

--output myjson.json

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

--output /tmp/myjson.json