মানচিত্র ডেটাসেট API বর্তমানে প্রিভিউতে রয়েছে (প্রি-GA)। প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির সীমিত সমর্থন থাকতে পারে এবং প্রাক-GA পণ্য এবং বৈশিষ্ট্যগুলির পরিবর্তনগুলি অন্যান্য প্রাক-GA সংস্করণগুলির সাথে সামঞ্জস্যপূর্ণ নাও হতে পারে। প্রাক-GA অফারগুলি Google মানচিত্র প্ল্যাটফর্ম পরিষেবার নির্দিষ্ট শর্তাবলী দ্বারা আচ্ছাদিত। আরও তথ্যের জন্য, লঞ্চ পর্যায়ের বিবরণ দেখুন।

এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

একটি ডেটাসেট তৈরি করুন

একটি ডেটাসেট তৈরি করা একটি দ্বি-পদক্ষেপ প্রক্রিয়া:

ডেটাসেট তৈরি করার জন্য একটি অনুরোধ করুন।
ডেটাসেটে ডেটা আপলোড করার জন্য একটি অনুরোধ করুন।

পূর্বশর্ত

একটি ডেটাসেট তৈরি করার সময়:

আপনার Google ক্লাউড প্রকল্পের মধ্যে প্রদর্শনের নামগুলি অবশ্যই অনন্য হতে হবে৷
প্রদর্শনের নাম অবশ্যই 64 বাইটের কম হতে হবে (কারণ এই অক্ষরগুলিকে UTF-8-এ উপস্থাপন করা হয়েছে, কিছু ভাষায় প্রতিটি অক্ষর একাধিক বাইট দ্বারা প্রতিনিধিত্ব করা যেতে পারে)।
বর্ণনা অবশ্যই 1000 বাইটের কম হতে হবে।

ডেটা আপলোড করার সময়:

সমর্থিত ফাইল প্রকারগুলি হল CSV, GeoJSON, এবং KML৷
সর্বাধিক সমর্থিত ফাইলের আকার হল 350 MB।
অ্যাট্রিবিউট কলামের নাম স্ট্রিং "?_" দিয়ে শুরু হতে পারে না।
ত্রিমাত্রিক জ্যামিতি সমর্থিত নয়। এতে WKT বিন্যাসে "Z" প্রত্যয় এবং GeoJSON বিন্যাসে উচ্চতা স্থানাঙ্ক অন্তর্ভুক্ত রয়েছে।

টিপ: যদি আপনার ডেটা ফাইলটি বড় হয় এবং এতে অনেকগুলি বৈশিষ্ট্য থাকে যা আপনার স্টাইলিংয়ের জন্য প্রয়োজন হয় না এবং আপনি রেন্ডারিং কর্মক্ষমতা অপ্টিমাইজ করতে চান, অপ্রয়োজনীয় বৈশিষ্ট্যগুলি সরাতে ফাইলটি সম্পাদনা করুন৷ গুণাবলীর সংখ্যা হ্রাস করা মানচিত্রের টাইলসের আকারকে হ্রাস করে, যার ফলে রেন্ডারিং কর্মক্ষমতা উন্নত হয়।

GeoJSON প্রয়োজনীয়তা

মানচিত্র ডেটাসেট API বর্তমান GeoJSON স্পেসিফিকেশন সমর্থন করে। মানচিত্র ডেটাসেট API এছাড়াও GeoJSON ফাইলগুলিকে সমর্থন করে যেগুলিতে নিম্নলিখিত অবজেক্টের ধরনগুলির মধ্যে একটি রয়েছে:

জ্যামিতি বস্তু । একটি জ্যামিতি বস্তু হল একটি স্থানিক আকৃতি, যা ঐচ্ছিক ছিদ্র সহ বিন্দু, রেখা এবং বহুভুজের মিলন হিসাবে বর্ণনা করা হয়।
বৈশিষ্ট্য বস্তু . একটি বৈশিষ্ট্য বস্তুতে একটি জ্যামিতি এবং অতিরিক্ত নাম/মান জোড়া রয়েছে, যার অর্থ অ্যাপ্লিকেশন-নির্দিষ্ট।
বৈশিষ্ট্য সংগ্রহ . একটি বৈশিষ্ট্য সংগ্রহ বৈশিষ্ট্য বস্তুর একটি সেট.

মানচিত্র ডেটাসেট API জিওজেএসএন ফাইলগুলিকে সমর্থন করে না যেগুলির ডাটা রয়েছে WGS84 ব্যতীত অন্য একটি স্থানাঙ্ক রেফারেন্স সিস্টেমে (CRS)৷

GeoJSON সম্পর্কে আরও তথ্যের জন্য, RFC 7946 অনুবর্তী দেখুন।

KML প্রয়োজনীয়তা

মানচিত্র ডেটাসেট API-এর নিম্নলিখিত প্রয়োজনীয়তা রয়েছে:

সমস্ত URL অবশ্যই ফাইলের সাথে স্থানীয় (বা আপেক্ষিক) হতে হবে।
বিন্দু, রেখা এবং বহুভুজ জ্যামিতি সমর্থিত।
সমস্ত ডেটা বৈশিষ্ট্য স্ট্রিং হিসাবে বিবেচিত হয়।

নিম্নলিখিত KML বৈশিষ্ট্য সমর্থিত নয়:

আইকন বা <styleUrl> ফাইলের বাইরে সংজ্ঞায়িত।
নেটওয়ার্ক লিঙ্ক, যেমন <NetworkLink>
গ্রাউন্ড ওভারলে, যেমন <GroundOverlay>
3D জ্যামিতি বা যেকোনো উচ্চতা-সম্পর্কিত ট্যাগ যেমন <altitudeMode>
ক্যামেরা স্পেসিফিকেশন যেমন <LookAt>
KML ফাইলের ভিতরে শৈলী সংজ্ঞায়িত করা হয়েছে।

CSV প্রয়োজনীয়তা

CSV ফাইলগুলির জন্য, সমর্থিত কলামের নামগুলি অগ্রাধিকারের ক্রমে নীচে তালিকাভুক্ত করা হয়েছে:

latitude longitude
lat , long
x , y
wkt (সুপরিচিত পাঠ্য)
address , city , state , zip
address
একটি একক কলাম যেখানে সমস্ত ঠিকানার তথ্য রয়েছে, যেমন 1600 Amphitheatre Parkway Mountain View, CA 94043

উদাহরণস্বরূপ, আপনার ফাইলে x , y , এবং wkt নামে কলাম রয়েছে। কারণ x এবং y একটি উচ্চতর অগ্রাধিকার রয়েছে, উপরের তালিকায় সমর্থিত কলামের নামের ক্রম দ্বারা নির্ধারিত, x এবং y কলামের মান ব্যবহার করা হয় এবং wkt কলাম উপেক্ষা করা হয়।

এছাড়াও:

প্রতিটি কলামের নাম অবশ্যই একটি একক কলামের অন্তর্গত। অর্থাৎ, আপনার xy নামে একটি কলাম থাকতে পারে না যেখানে x এবং y উভয় স্থানাঙ্ক ডেটা রয়েছে। x এবং y স্থানাঙ্ক অবশ্যই পৃথক কলামে থাকতে হবে।
কলামের নাম অক্ষর-সংবেদনশীল।
কলাম নামের ক্রম কোন ব্যাপার না. উদাহরণস্বরূপ, যদি আপনার CSV ফাইলে lat এবং long কলাম থাকে, সেগুলি যেকোনো ক্রমে ঘটতে পারে।

ডেটা আপলোড ত্রুটিগুলি পরিচালনা করা৷

একটি ডেটাসেটে ডেটা আপলোড করার সময়, আপনি এই বিভাগে বর্ণিত সাধারণ ত্রুটিগুলির একটির সম্মুখীন হতে পারেন৷

GeoJSON ত্রুটি

সাধারণ GeoJSON ত্রুটির মধ্যে রয়েছে:

অনুপস্থিত type ক্ষেত্র, বা type একটি স্ট্রিং নয়। আপলোড করা GeoJSON ডেটা ফাইলে প্রতিটি বৈশিষ্ট্য অবজেক্ট এবং জ্যামিতি অবজেক্ট সংজ্ঞার অংশ হিসাবে type নামে একটি স্ট্রিং ক্ষেত্র থাকতে হবে।

KML ত্রুটি

সাধারণ KML ত্রুটিগুলির মধ্যে রয়েছে:

ডেটা ফাইলে উপরে তালিকাভুক্ত কোনো অসমর্থিত KML বৈশিষ্ট্য থাকা উচিত নয়, অন্যথায় ডেটা আমদানি ব্যর্থ হতে পারে।

CSV ত্রুটি

সাধারণ CSV ত্রুটিগুলির মধ্যে রয়েছে:

কিছু সারি একটি জ্যামিতি কলামের জন্য মান অনুপস্থিত. একটি CSV ফাইলের সমস্ত সারিতে জ্যামিতি কলামগুলির জন্য অ-খালি মান থাকতে হবে৷ জ্যামিতি কলাম অন্তর্ভুক্ত:
- latitude longitude
- lat , long
- x , y
- wkt
- address , city , state , zip
- address
- একটি একক কলাম যেখানে সমস্ত ঠিকানার তথ্য রয়েছে, যেমন 1600 Amphitheatre Parkway Mountain View, CA 94043
দ্রষ্টব্য: এই ত্রুটিটি প্রায়শই "' 'কে দ্বিগুণে রূপান্তর করতে অক্ষম" বা "ভৌগোলিতে ইনপুট পার্স করা যায়নি।: ভূগোল মান অনুপস্থিত" আকারে একটি বার্তা দ্বারা বর্ণনা করা হয়।
যদি x এবং y আপনার জ্যামিতি কলাম হয়, নিশ্চিত করুন যে ইউনিটগুলি দ্রাঘিমাংশ এবং অক্ষাংশ। কিছু পাবলিক ডেটাসেট x এবং y শিরোনামের অধীনে বিভিন্ন স্থানাঙ্ক সিস্টেম ব্যবহার করে। ভুল ইউনিট ব্যবহার করা হলে, ডেটাসেট সফলভাবে আমদানি করতে পারে, কিন্তু রেন্ডার করা ডেটা অপ্রত্যাশিত অবস্থানে ডেটাসেট পয়েন্টগুলি দেখাতে পারে।

ডেটাসেট তৈরি করার জন্য একটি অনুরোধ করুন

ডেটাসেট এন্ডপয়েন্টে একটি POST অনুরোধ পাঠিয়ে একটি ডেটাসেট তৈরি করুন:

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

ডেটাসেট সংজ্ঞায়িত করার অনুরোধে একটি JSON বডি পাস করুন। তোমাকে অবশ্যই:

ডেটাসেটের displayName উল্লেখ করুন। displayName মান অবশ্যই সমস্ত ডেটাসেটের জন্য অনন্য হতে হবে।
usage সেট করুন USAGE_DATA_DRIVEN_STYLING .
দ্রষ্টব্য: বর্তমানে, USAGE_DATA_DRIVEN_STYLING হল একমাত্র মান usage জন্য সমর্থিত।

উদাহরণ স্বরূপ:

curl -X POST -d '{
    "displayName": "My Test Dataset", 
    "usage": "USAGE_DATA_DRIVEN_STYLING"
  }' \
  -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer $TOKEN" \
  https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets

প্রতিক্রিয়াটিতে ডেটাসেটের আইডি রয়েছে, অতিরিক্ত তথ্য সহ projects/ PROJECT_NUMBER_OR_ID /datasets/ DATASET_ID ফর্মে। ডেটাসেট আপডেট বা সংশোধন করার অনুরোধ করার সময় ডেটাসেট আইডি ব্যবহার করুন।

{
  "name": "projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e9fc46",
  "displayName": "My Test Dataset",
  "usage": [
    "USAGE_DATA_DRIVEN_STYLING"
  ],
  "createTime": "2022-08-15T17:50:00.189682Z",
  "updateTime": "2022-08-15T17:50:00.189682Z" 
}

ডেটাসেটে ডেটা আপলোড করার জন্য একটি অনুরোধ করুন

আপনি ডেটাসেট তৈরি করার পরে, Google ক্লাউড স্টোরেজ থেকে বা একটি স্থানীয় ফাইল থেকে ডেটাসেটে ডেটা আপলোড করুন৷

দ্রষ্টব্য: আপনি শুধুমাত্র একবার ডেটাসেটে ডেটা আপলোড করতে পারেন। অর্থাৎ, আপনি ক্লাউড স্টোরেজ বা স্থানীয় ফাইল থেকে ডেটা আপলোড করার অনুরোধটি চালানোর পরে, আপনি আবার একই ডেটাসেটে ডেটা আপলোড করতে পারবেন না। আপলোড করার সময় কোনো ত্রুটি থাকলে, আপনাকে অবশ্যই ডেটাসেটটি পুনরায় তৈরি করতে হবে এবং আবার আপলোড করার চেষ্টা করতে হবে।

ক্লাউড স্টোরেজ থেকে ডেটা আপলোড করুন

আপনি ক্লাউড স্টোরেজ থেকে ডেটাসেট এন্ডপয়েন্টে একটি POST অনুরোধ পাঠিয়ে আপনার ডেটাসেটে আপলোড করেন যাতে ডেটাসেটের আইডিও অন্তর্ভুক্ত থাকে:

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

JSON অনুরোধের বডিতে:

ক্লাউড সঞ্চয়স্থানে ডেটা ধারণকারী সম্পদের ফাইল পাথ নির্দিষ্ট করতে inputUri ব্যবহার করুন। এই পথটি gs:// GCS_BUCKET / FILE আকারে রয়েছে।
যে ব্যবহারকারী অনুরোধ করছেন তার জন্য স্টোরেজ অবজেক্ট ভিউয়ারের ভূমিকা বা অন্য কোনো ভূমিকা প্রয়োজন যাতে storage.objects.get অনুমতি অন্তর্ভুক্ত থাকে। ক্লাউড স্টোরেজে অ্যাক্সেস পরিচালনার বিষয়ে আরও তথ্যের জন্য, অ্যাক্সেস নিয়ন্ত্রণের ওভারভিউ দেখুন।
fileFormat ব্যবহার করে ডেটার ফাইল ফরম্যাটটি যেমন হয় উল্লেখ করুন: FILE_FORMAT_GEOJSON (GeoJson ফাইল), FILE_FORMAT_KML (KML ফাইল), অথবা FILE_FORMAT_CSV (CSV ফাইল)।

উদাহরণ স্বরূপ:

curl -X POST  -d '{
    "gcs_source":{
      "inputUri": "gs://my_bucket/my_csv_file",
      "fileFormat": "FILE_FORMAT_CSV"
    }
  }' \
  -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
  -H "content-type: application/json" \
  -H "Authorization: Bearer $TOKEN" \
  https://mapsplatformdatasets.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e9fc46:import

প্রতিক্রিয়া ফর্মে আছে:

{
  "name": "projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID@VERSION_NUMBER"
}

একটি ফাইল থেকে ডেটা আপলোড করুন

একটি ফাইল থেকে ডেটা আপলোড করতে, ডেটাসেট এন্ডপয়েন্টে একটি HTTP POST অনুরোধ পাঠান যাতে ডেটাসেটের আইডিও অন্তর্ভুক্ত থাকে::

https://mapsplatformdatasets.googleapis.com/upload/v1/projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID:import

অনুরোধে রয়েছে:

Goog-Upload-Protocol শিরোনামটি multipart সেট করা আছে।
metadata বৈশিষ্ট্য একটি ফাইলের পাথ নির্দিষ্ট করে যা আপলোড করার জন্য ডেটার ধরন নির্দিষ্ট করে, যেমন হয়: FILE_FORMAT_GEOJSON (GeoJSON ফাইল), FILE_FORMAT_KML (KML ফাইল), অথবা FILE_FORMAT_CSV (CSV ফাইল)৷
এই ফাইলের বিষয়বস্তু নিম্নলিখিত বিন্যাস আছে:
```
{"local_file_source": {"file_format": "FILE_FORMAT_GEOJSON"}}
```
আপলোড করার জন্য ডেটা সহ GeoJSON, KML, বা CSV ফাইলের পাথ নির্দিষ্ট করে rawdata বৈশিষ্ট্য।

নিম্নলিখিত অনুরোধ দুটি ফাইলের পাথ নির্দিষ্ট করতে curl -F বিকল্প ব্যবহার করে:

curl -X POST \
  -H 'X-Goog-User-Project: PROJECT_NUMBER_OR_ID' \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Goog-Upload-Protocol: multipart" \
  -F "metadata=@csv_metadata_file" \
  -F "rawdata=@csv_data_file" \
  https://mapsplatformdatasets.googleapis.com/upload/v1/projects/PROJECT_NUMBER_OR_ID/datasets/f57074a0-a8b6-403e-9df1-e9fc46:import

প্রতিক্রিয়া ফর্মে আছে:

{
  "name": "projects/PROJECT_NUMBER_OR_ID/datasets/DATASET_ID@VERSION_NUMBER"
}