শুরু করার আগে

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

পূর্বশর্ত

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

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