কেন Routes API এ মাইগ্রেট করবেন?

Routes API দিকনির্দেশ, দূরত্ব এবং ভ্রমণের সময় গণনা করার জন্য উন্নত কর্মক্ষমতা প্রদান করে, যা বর্তমানে নির্দেশাবলী API এবং দূরত্ব ম্যাট্রিক্স API ব্যবহার করে এমন অ্যাপগুলিকে প্রতিস্থাপন করা সার্থক করে তোলে। রুট API-এর বেশিরভাগ কার্যকারিতা দিকনির্দেশ API এবং দূরত্ব ম্যাট্রিক্স API উভয়ের সাথেই পশ্চাদমুখী সামঞ্জস্যপূর্ণ।

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

মূল উন্নতি

এই বিভাগে আপনার অ্যাপে রুট API ব্যবহার করার সময় আপনি আশা করতে পারেন এমন কিছু উন্নতি কভার করে।

বর্ধিত অনুরোধ সীমা

রুট API
  • সর্বাধিক 625টি উপাদান, যদি না আপনি TRAFFIC_AWARE_OPTIMAL উল্লেখ করেন।
  • TRAFFIC_AWARE_OPTIMAL সহ সর্বাধিক 100টি উপাদান। উন্নত রাউটিং পছন্দগুলি দেখুন।
  • একটি প্লেস আইডি ব্যবহার করে সর্বাধিক 50টি ওয়েপয়েন্ট (উৎপত্তি + গন্তব্য)।
দূরত্ব ম্যাট্রিক্স API
  • প্রতি অনুরোধে সর্বাধিক 25টি উৎস বা 25টি গন্তব্য।
  • সার্ভার-সাইড অনুরোধ প্রতি সর্বোচ্চ 100টি উপাদান (উৎপত্তির সংখ্যা × গন্তব্যের সংখ্যা)।

দ্রুত অনুরোধ প্রতিক্রিয়া

গণনা রুট ম্যাট্রিক্স বৈশিষ্ট্য নিম্নলিখিত লেটেন্সি উন্নতি প্রস্তাব করে:

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

রাউটিং বর্ধিতকরণ

কম্পিউট রুট বৈশিষ্ট্য এই রাউটিং বর্ধিতকরণ অফার করে:

  • দূরত্ব এবং ETA ছাড়াও টোল তথ্য ।
  • 2-চাকার যানবাহনের রুট ।
  • নিরাপত্তার জন্য আপনার স্টপওভার ওয়েপয়েন্টের যোগ্যতা অর্জন করুন ।
  • ওয়েপয়েন্টের জন্য ভ্রমণের দিকনির্দেশ এবং রাস্তার পাশে নির্ধারণ করে ETA নির্ভুলতা বৃদ্ধি করা হয়েছে ।

আপনার প্রয়োজন শুধুমাত্র তথ্য অনুরোধ

প্রক্রিয়াকরণের সময় এবং বিলিং চার্জ হ্রাস করে আপনি এখন কোন ক্ষেত্রগুলিকে ফেরত দিতে হবে তা নির্দিষ্ট করুন৷

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

ট্রাফিকের জন্য উন্নত রুট গণনা

Routes API তিনটি রাউটিং পছন্দগুলিকে সমর্থন করে যা আপনি ট্র্যাফিক তথ্যের অনুরোধ করার সময় প্রতিক্রিয়া লেটেন্সি এবং ডেটা মানের মধ্যে ভারসাম্য বজায় রাখতে ব্যবহার করতে পারেন৷

আরও তথ্যের জন্য, মান বনাম লেটেন্সি কনফিগার করুন দেখুন।

TRAFFIC_UNAWARE
(ডিফল্ট)		 রুট গণনা করতে, লাইভ ট্রাফিক ডেটা নয়, গড় সময়-স্বাধীন ট্রাফিক ডেটা ব্যবহার করে, যার ফলে সর্বনিম্ন প্রতিক্রিয়ার বিলম্ব হয়৷ এই সেটিংটি যখন দিকনির্দেশ API এবং দূরত্ব ম্যাট্রিক্স API-এ ট্র্যাফিক ব্যবহার করা হয় না তখন তার সমতুল্য৷
TRAFFIC_AWARE
(নতুন)		 কম লেটেন্সির জন্য পারফরম্যান্স-অপ্টিমাইজ করা লাইভ ট্রাফিক গুণমান। TRAFFIC_AWARE_OPTIMAL এর বিপরীতে, এই সেটিংটি উল্লেখযোগ্যভাবে বিলম্ব কমাতে অপ্টিমাইজেশন প্রয়োগ করে। এই সেটিংটি Routes API-এর জন্যও নতুন যার কোন সমতুল্য দিকনির্দেশ API বা দূরত্ব ম্যাট্রিক্স API নেই।
TRAFFIC_AWARE_OPTIMAL উচ্চ মানের, ব্যাপক ট্রাফিক ডেটা। এই সেটিংটি সর্বোচ্চ লেটেন্সি তৈরি করে এবং দিকনির্দেশ API এবং দূরত্ব ম্যাট্রিক্স API-এ departure_time সেটিং এর সমতুল্য।
এই পছন্দটি maps.google.com এবং Google Maps মোবাইল অ্যাপ দ্বারা ব্যবহৃত মোডের সমতুল্য৷

রুট গণনা তুলনা

নিম্নলিখিত সারণীটি রুট API এবং দিকনির্দেশ API এবং দূরত্ব ম্যাট্রিক্স API পরিষেবাগুলির মধ্যে রাউটিং বিকল্পগুলির তুলনা করে৷

ট্রাফিক বিকল্প রুট API দিকনির্দেশ API
দূরত্ব ম্যাট্রিক্স API		 লেটেন্সি
কোনো রিয়েল-টাইম ট্রাফিক নেই TRAFFIC_UNAWARE departure_time প্রপার্টি সেট করা হয়নি তিনটি মোডের দ্রুততম লেটেন্সি।
লাইভ ট্রাফিক শর্ত প্রযোজ্য TRAFFIC_AWARE কোন সমতুল্য নয়

Routes API দ্বারা নতুন মোড যোগ করা হয়েছে। এটি TRAFFIC_UNAWARE এর চেয়ে সামান্য বেশি বিলম্ব প্রদান করে যার অল্প খরচে ETA মানের।

এটির TRAFFIC_AWARE_OPTIMAL এর চেয়ে অনেক কম লেটেন্সি রয়েছে৷

উচ্চ মানের, ব্যাপক লাইভ ট্রাফিক ডেটা প্রয়োগ করা হয়েছে TRAFFIC_AWARE_OPTIMAL departure_time প্রপার্টি সেট

maps.google.com এবং Google Maps মোবাইল অ্যাপ দ্বারা ব্যবহৃত মোডের সমতুল্য৷

কম্পিউট রুট ম্যাট্রিক্সের জন্য, একটি অনুরোধে উপাদানের সংখ্যা (উৎপত্তির সংখ্যা × গন্তব্যের সংখ্যা) 100-এর বেশি হতে পারে না।

মূল পার্থক্য

এই বিভাগে রুট API এবং এটি যে পরিষেবাগুলি প্রতিস্থাপন করে তার মধ্যে মূল পার্থক্যগুলি কভার করে, আপনার বিদ্যমান অ্যাপগুলিতে এই পরিষেবাগুলি থেকে স্থানান্তর করার সময় আপনি এই পার্থক্যগুলিকে সমাধান করতে পারেন৷

দুটির পরিবর্তে একটি পরিষেবাতে কল করুন

রুট API কম্পিউট রুট এবং কম্পিউট রুট ম্যাট্রিক্স ব্যবহার করার জন্য আপনার অ্যাপের জন্য API কনসোলে শুধুমাত্র একটি পরিষেবা সক্ষম করুন৷
আরও তথ্যের জন্য, Google API কনসোলে সেট আপ দেখুন।
দিকনির্দেশ API
দূরত্ব ম্যাট্রিক্স API		 দুটি পরিষেবা সক্ষম করুন: দিকনির্দেশ API এবং দূরত্ব ম্যাট্রিক্স API API কনসোলে পৃথক পরিষেবা হিসাবে৷

HTTPS POST অনুরোধ ব্যবহার করে

রুট API একটি HTTP POST অনুরোধের অংশ হিসাবে অনুরোধের বডিতে বা হেডারে প্যারামিটারগুলি পাস করুন৷
উদাহরণের জন্য, দেখুন:
- একটি রুট গণনা
- একটি রুট ম্যাট্রিক্স গণনা করুন
দিকনির্দেশ API
দূরত্ব ম্যাট্রিক্স API		 একটি HTTP GET অনুরোধ ব্যবহার করে URL প্যারামিটার পাস করুন।

ETA প্রতিক্রিয়া পার্থক্য

রুট এপিআই ইটিএ প্রদান করে এবং নিচের সারণীতে দেখানো নির্দেশাবলী এপিআই এবং ডিসটেন্স ম্যাট্রিক্স এপিআই পরিষেবার থেকে ভিন্নভাবে duration প্রতিক্রিয়া বৈশিষ্ট্য ব্যবহার করে।

ETA এর প্রকার রুট API দিকনির্দেশ API
দূরত্ব ম্যাট্রিক্স API
ট্রাফিক অজানা, সময়-স্বাধীন ETA।

TRAFFIC_UNAWARE ব্যবহার করে সেট করুন।

  • ETA duration প্রতিক্রিয়া বৈশিষ্ট্য অন্তর্ভুক্ত.
  • duration এবং staticDuration প্রতিক্রিয়া বৈশিষ্ট্য একই মান ধারণ করে।

অনুরোধে departure_time সেট করা না হওয়ার সাথে মিলে যায়।

  • ETA duration প্রতিক্রিয়া বৈশিষ্ট্য অন্তর্ভুক্ত.
  • duration_in_traffic প্রতিক্রিয়া বৈশিষ্ট্য ফেরত দেওয়া হয় না।
ETA যা রিয়েল-টাইম ট্রাফিক বিবেচনা করে।

TRAFFIC_AWARE বা TRAFFIC_AWARE_OPTIMAL ব্যবহার করে সেট করুন।

  • রিয়েল-টাইম ট্র্যাফিক বিবেচনায় নেওয়া ETA duration প্রতিক্রিয়া বৈশিষ্ট্যের মধ্যে রয়েছে।
  • staticDuration রেসপন্স প্রপার্টিতে ট্রাফিক পরিস্থিতি বিবেচনায় না নিয়ে রুট দিয়ে ভ্রমণের সময়কাল রয়েছে।
  • duration_in_traffic সম্পত্তি আর ফেরত দেওয়া হয় না।

অনুরোধে departure_time ব্যবহার করে সেট করুন।

  • রিয়েল-টাইম ট্রাফিক বিবেচনায় নেওয়া ETA duration_in_traffic রেসপন্স প্রপার্টিতে রয়েছে।

পলিলাইন ওয়েপয়েন্ট

আপনাকে আর এই পরিষেবার সাথে আপনার অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্কগুলিকে পলিলাইন ওয়েপয়েন্টে রূপান্তর করতে হবে না, যা একটি POST অনুরোধের বডি সমর্থন করে এবং তাই URL স্ট্রিং সীমা দ্বারা আর প্রভাবিত হয় না৷ ডিসট্যান্স ম্যাট্রিক্স এপিআই-এর কিছু ব্যবহারকারী অক্ষাংশ/দ্রাঘিমাংশকে পলিলাইন ওয়েপয়েন্টে রূপান্তর করে অনুরোধের সীমা সমস্যাটি সমাধান করেছেন।

ফরম্যাট করা ঠিকানা (বিপরীত জিওকোড)

Routes API প্রতিক্রিয়াতে ফর্ম্যাট করা ঠিকানা প্রদান করে না। ফর্ম্যাট করা ঠিকানাগুলি পেতে, জিওকোডিং API ব্যবহার করুন যা এই ব্যবহারের ক্ষেত্রে তৈরি করা হয়েছে এবং উচ্চ মানের ফলাফল প্রদান করে৷

উপলব্ধ ভ্রমণ মোড

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

একটি প্রতিক্রিয়া বিন্যাস হিসাবে XML

Routes API একটি প্রতিক্রিয়া বিন্যাস হিসাবে XML প্রদান করে না। আপনি অনলাইনে অনেকগুলি JSON থেকে XML রূপান্তরকারী খুঁজে পেতে পারেন যা আপনার উদ্দেশ্য অনুসারে হওয়া উচিত।