আইসোক্রোনস এপিআই সর্বোত্তম অনুশীলন

মসৃণতা এবং বিশ্বস্ততা

আপনি polygon_fidelity এবং enable_smoothing প্যারামিটার ব্যবহার করে আউটপুট বহুভুজগুলোর চেহারা ও সূক্ষ্মতা কাস্টমাইজ করতে পারেন। যদিও এই অপশনগুলো স্বতন্ত্র, চূড়ান্ত আকৃতি নির্ধারণের জন্য এগুলো একত্রে কাজ করে।

  • polygon_fidelity : রেজোলিউশন। এটি পৌঁছানোযোগ্য এলাকা গণনা করতে ব্যবহৃত অন্তর্নিহিত গ্রিড সেলগুলির (S2 সেল) আকার নিয়ন্ত্রণ করে।
    • LOW : বড় গ্রিড সেল ব্যবহার করে। কোনো ফাঁক ছাড়া বড় এলাকা আবৃত করার জন্য এটি সর্বোত্তম, যার ফলে একটি সাধারণ আকৃতি তৈরি হয়।
    • MEDIUM : ভারসাম্যপূর্ণ নির্ভুলতা।
    • HIGH : ছোট গ্রিড সেল ব্যবহার করে। এর ফলে সড়ক নেটওয়ার্কের সাথে এটি আরও ভালোভাবে খাপ খায়, কিন্তু যেখানে সড়ক নেটওয়ার্ক পাতলা, সেখানে ফাঁকা জায়গা বা "গর্ত" তৈরি হতে পারে।
    • ডিফল্ট: যদি নির্দিষ্ট করা না থাকে, তাহলে পরিষেবাটি অনুরোধ করা ভ্রমণের সময়কালের উপর ভিত্তি করে স্বয়ংক্রিয়ভাবে বিশ্বস্ততা নির্বাচন করে।
  • enable_smoothing : এটি একটি নান্দনিক বৈশিষ্ট্য। এটি নিয়ন্ত্রণ করে যে ফিডেলিটি দ্বারা সংজ্ঞায়িত গ্রিড সেলগুলির তীক্ষ্ণ প্রান্তগুলি গোলাকার করা হবে কিনা।
    • false (Raw): সঠিক জ্যামিতিক গণনা ফেরত দেয়। গ্রিড সেলগুলোর প্রতিফলন হিসেবে প্রান্তগুলো অমসৃণ বা ধাপযুক্ত দেখায়। বিশ্লেষণাত্মক নির্ভুলতার জন্য সর্বোত্তম, যেমন কঠোর বিন্দু-ইন-পলিগন পরীক্ষা।
    • true (Smoothed): কোণাগুলো মসৃণ করার জন্য একটি পোস্ট-প্রসেসিং অ্যালগরিদম প্রয়োগ করে। মানচিত্রে দৃশ্যমান প্রদর্শনের জন্য সর্বোত্তম।

তাদের পারস্পরিক ক্রিয়া: ফিডেলিটি সেই বেসলাইন ডিটেইল নির্ধারণ করে, যার উপর ভিত্তি করে স্মুদিং অ্যালগরিদম কাজ করে।

  • হাই ফিডেলিটি + স্মুদিং: একটি বিশদ, জৈব-দর্শন আকৃতি তৈরি করে যা রাস্তার প্রান্তভাগকে নিবিড়ভাবে অনুসরণ করে।
  • লো ফিডেলিটি + স্মুদিং: একটি বিস্তৃত, সাধারণ "ব্লব" আকৃতি তৈরি করে।

পেলোডের আকার এবং রেন্ডারিং

বৃহৎ আইসোক্রোনগুলিতে হাজার হাজার স্থানাঙ্ক থাকতে পারে এবং পেলোড ৩০০ থেকে ৫০০ কিলোবাইটের মধ্যে হতে পারে।

  • ব্যান্ডউইথ: মনে রাখবেন যে, সর্বোচ্চ সময়কালের অনুরোধের ক্ষেত্রে JSON রেসপন্সের আকার উল্লেখযোগ্য।
  • রেন্ডারিং: অত্যন্ত বিস্তারিত পলিগন রেন্ডার করা পারফরম্যান্সের উপর প্রভাব ফেলে। প্রদর্শনের জন্য ভার্টেক্স সংখ্যা কমাতে enable_smoothing প্যারামিটার অথবা ক্লায়েন্ট-সাইড সিম্পলিফিকেশন লাইব্রেরি ব্যবহার করার কথা বিবেচনা করুন।

ত্রুটি পরিচালনা

5xx সার্ভার ত্রুটির জন্য এক্সপোনেনশিয়াল ব্যাকঅফ সহ রিট্রাই লজিক প্রয়োগ করুন। তবে, আপনার প্যারামিটার পরিবর্তন না করে 4xx ক্লায়েন্ট ত্রুটি রিট্রাই করবেন না :

  • INVALID_ARGUMENT (400) : পরীক্ষা করুন যে আপনার সময়কাল ধনাত্মক এবং নির্বাচিত মোডের সীমার মধ্যে আছে, যা DRIVE-এর জন্য সর্বাধিক 3,600 সেকেন্ড, অথবা অন্যান্য মোডের জন্য 7,200 সেকেন্ড।
  • NOT_FOUND (404) : মূলবিন্দুটি কোনো রাস্তার সাথে সংযুক্ত হতে পারেনি। স্থানাঙ্কটি কোনো পরিচিত রাস্তার কাছাকাছি সরানোর চেষ্টা করুন অথবা অঞ্চলটি সমর্থিত কিনা তা নিশ্চিত করুন।