শুরু করার আগে

এই ডকুমেন্টে ডেটাসেট নিয়ে কাজ করার সময় প্রয়োজনীয় শর্ত, পেশাদার পদ্ধতি এবং সাধারণ সমস্যার বিবরণ দেওয়া হয়েছে।

পূর্বশর্ত

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

  • আপনার Google Cloud প্রোজেক্টে ডিসপ্লে নাম অনন্য হতে হবে।
  • যে নাম দেখানো হবে তা ৬৪ বাইটের কম হতে হবে (কারণ এই অক্ষরগুলি UTF-8-এ দেখানো হয়, কিছু ভাষায় প্রতিটি অক্ষর একাধিক বাইট দ্বারা দেখানো যেতে পারে)।
  • বিবরণ ১০০০ বাইটের কম হতে হবে।

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

  • CSV, GeoJSON এবং KML ফাইলের ধরন কাজ করে।
  • সর্বাধিক ৫০০ এমবি সাইজের ফাইল আপলোড করা যায়।
  • অ্যাট্রিবিউট কলামের নাম "?_" স্ট্রিং দিয়ে শুরু করা যাবে না।
  • থ্রি-ডাইমেনশনাল জিওমেট্রি কাজ করে না। এর মধ্যে WKT ফর্ম্যাটে "Z" প্রত্যয় এবং GeoJSON ফর্ম্যাটে অল্টিটিউড কোঅর্ডিনেট অন্তর্ভুক্ত।

ডেটা প্রস্তুত করার পেশাদার পদ্ধতি

আপনার সোর্স ডেটা জটিল বা বড় হলে, যেমন ঘন পয়েন্ট, দীর্ঘ লাইনস্ট্রিং বা পলিগন (সাধারণত ৫০ এমবির চেয়ে বড় সোর্স ফাইল এই বিভাগে পড়ে), ভিজ্যুয়াল ম্যাপে সেরা পারফর্ম্যান্স পেতে আপলোড করার আগে আপনার ডেটা সরল করার কথা বিবেচনা করুন।

আপনার ডেটা প্রস্তুত করার জন্য এখানে কিছু পেশাদার পদ্ধতি দেওয়া হল:

  1. ফিচার প্রপার্টি মিনিমাইজ করুন। আপনার ম্যাপ স্টাইল করার জন্য প্রয়োজনীয় ফিচার প্রপার্টি শুধুমাত্র রাখুন, যেমন "id" এবং "category"। আপনি অনন্য শনাক্তকারী 'কী'-তে ডেটা-ড্রিভেন স্টাইল ব্যবহার করে ক্লায়েন্ট অ্যাপ্লিকেশনের কোনও ফিচারে অতিরিক্ত প্রপার্টি যোগ করতে পারবেন। যেমন, ডেটা-ড্রিভেন স্টাইলিংয়ের মাধ্যমে রিয়েল টাইমে আপনার ডেটা দেখুন।
  2. টাইল সাইজ কমাতে এবং ম্যাপের পারফর্ম্যান্স উন্নত করতে, যেখানে সম্ভব প্রপার্টি অবজেক্টের জন্য সহজ ডেটা টাইপ ব্যবহার করুন, যেমন পূর্ণসংখ্যা।
  3. ফাইল আপলোড করার আগে জটিল জ্যামিতি সরল করুন। আপনি নিজের পছন্দমতো কোনও জিওস্পেশিয়াল টুলে এটি করতে পারেন, যেমন ওপেন সোর্স Mapshaper.org ইউটিলিটি অথবা জটিল পলিগন জিওমেট্রিতে ST_Simplify ব্যবহার করে BigQuery-তে।
  4. ফাইল আপলোড করার আগে খুব ঘন পয়েন্ট ক্লাস্টার করুন। আপনি নিজের পছন্দের কোনও জিওস্পেশিয়াল টুলে এটি করতে পারেন, যেমন ওপেন সোর্স turf.js ক্লাস্টার ফাংশন, অথবা BigQuery-তে ঘন পয়েন্ট জিওমেট্রিতে ST_CLUSTERDBSCAN ব্যবহার করে।

Datasets ও BigQuery-এর সাহায্যে আপনার ডেটা ভিজ্যুয়ালাইজ করুন লিঙ্কে ডেটাসেট সংক্রান্ত পেশাদার পদ্ধতি সম্পর্কে অতিরিক্ত নির্দেশিকা দেখুন।

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

Maps Datasets API বর্তমান GeoJSON স্পেসিফিকেশন সাপোর্ট করে। Maps Datasets API-তে GeoJSON ফাইলও কাজ করে, যাতে নিম্নলিখিত অবজেক্টের ধরনগুলির মধ্যে যেকোনও একটি থাকে:

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

Maps Datasets API এমন GeoJSON ফাইল সাপোর্ট করে না যার ডেটা WGS84 ছাড়া অন্য কোনও কোঅর্ডিনেট রেফারেন্স সিস্টেমে (CRS) আছে।

GeoJSON সম্পর্কে আরও তথ্যের জন্য, RFC 7946 কমপ্লায়েন্ট দেখুন।

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

Maps Datasets 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 হেডারের অধীনে বিভিন্ন কোঅর্ডিনেট সিস্টেম ব্যবহার করে। ভুল ইউনিট ব্যবহার করা হলে, ডেটাসেট হয়ত সফলভাবে ইমপোর্ট করা যাবে, কিন্তু রেন্ডার করা ডেটা অপ্রত্যাশিত লোকেশনে ডেটাসেট পয়েন্ট দেখাতে পারে।