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

ইউরোপীয় অর্থনৈতিক অঞ্চল (EEA) ডেভেলপাররা

Routes API দিকনির্দেশ, দূরত্ব এবং ভ্রমণের সময় গণনার ক্ষেত্রে উন্নত পারফরম্যান্স প্রদান করে, যার ফলে Directions API এবং Distance Matrix API ব্যবহারকারী অ্যাপগুলোকে এটি দিয়ে প্রতিস্থাপন করা যুক্তিযুক্ত। Routes API-এর বেশিরভাগ কার্যকারিতা Directions API এবং Distance Matrix API উভয়ের সাথেই ব্যাকওয়ার্ড কম্প্যাটিবল।

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

মূল উন্নতি

এই বিভাগে আপনার অ্যাপে রাউটস এপিআই (Routes API) ব্যবহার করার ফলে আপনি যে সকল উন্নত সুবিধা আশা করতে পারেন, সে সম্পর্কে আলোচনা করা হয়েছে।

অনুরোধের সীমা বৃদ্ধি করা হয়েছে

রাউটস এপিআই রাউট ম্যাট্রিক্স গণনা করুন
  • সর্বোচ্চ ৬২৫টি উপাদান, যদি না আপনি TRAFFIC_AWARE_OPTIMAL নির্দিষ্ট করে দেন।
  • TRAFFIC_AWARE_OPTIMAL সহ সর্বাধিক ১০০টি এলিমেন্ট। উন্নত রাউটিং প্রেফারেন্স দেখুন।
  • একটি প্লেস আইডি ব্যবহার করে সর্বাধিক ৫০টি ওয়েপয়েন্ট (উৎস + গন্তব্য)।
দূরত্ব ম্যাট্রিক্স এপিআই
  • প্রতি অনুরোধে সর্বোচ্চ ২৫টি উৎস অথবা ২৫টি গন্তব্য।
  • প্রতিটি সার্ভার-সাইড অনুরোধে সর্বোচ্চ ১০০টি উপাদান (উৎস সংখ্যা × গন্তব্য সংখ্যা)।

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

কম্পিউট রুট ম্যাট্রিক্স ফিচারটি নিম্নলিখিত ল্যাটেন্সি উন্নতি প্রদান করে:

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

রাউটিং উন্নতকরণ

কম্পিউট রাউট ফিচারটি নিম্নলিখিত রাউটিং বর্ধনগুলি প্রদান করে:

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

আপনার প্রয়োজনীয় তথ্যটুকুই অনুরোধ করুন।

এখন আপনি নির্দিষ্ট করে দিতে পারেন কোন কোন ফিল্ড ফেরত দেওয়া হবে, ফলে প্রসেসিং সময় এবং বিলিং চার্জ কমে যায়।

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

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

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

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

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

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

নিম্নলিখিত সারণিতে Routes API , Directions API এবং Distance Matrix API পরিষেবাগুলির মধ্যে রাউটিং বিকল্পগুলির তুলনা করা হয়েছে।

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

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

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

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

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

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

মূল পার্থক্য

এই বিভাগে Routes API এবং এটি যে সার্ভিসগুলোকে প্রতিস্থাপন করে, সেগুলোর মধ্যেকার প্রধান পার্থক্যগুলো আলোচনা করা হয়েছে। এছাড়াও, আপনার বিদ্যমান অ্যাপগুলোতে এই সার্ভিসগুলো থেকে মাইগ্রেট করার সময় কীভাবে এই পার্থক্যগুলো সমাধান করবেন, তার উপায়গুলোও তুলে ধরা হয়েছে।

দুটি পরিষেবার পরিবর্তে একটিতে ফোন করুন।

রাউটস এপিআই আপনার অ্যাপের Compute Routes এবং Compute Route Matrix ব্যবহার করার জন্য API Console-এ শুধুমাত্র একটি সার্ভিস সক্রিয় করুন।
আরও তথ্যের জন্য, গুগল এপিআই কনসোলে সেট আপ দেখুন।
দিকনির্দেশনা এপিআই
দূরত্ব ম্যাট্রিক্স এপিআই		 এপিআই কনসোলে ডিরেকশনস এপিআই এবং ডিসটেন্স ম্যাট্রিক্স এপিআই—এই দুটি সার্ভিসকে আলাদা সার্ভিস হিসেবে সক্রিয় করুন।

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

রাউটস এপিআই HTTP POST অনুরোধের অংশ হিসেবে রিকোয়েস্ট বডিতে অথবা হেডারে প্যারামিটার পাস করুন।
উদাহরণস্বরূপ দেখুন:
একটি পথ গণনা করুন
একটি রুট ম্যাট্রিক্স গণনা করুন
দিকনির্দেশনা এপিআই
দূরত্ব ম্যাট্রিক্স এপিআই		 HTTP GET অনুরোধ ব্যবহার করে URL প্যারামিটার প্রেরণ করুন।

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

নিচের সারণিতে দেখানো অনুযায়ী, Routes API আনুমানিক সময় (ETA) ফেরত দেয় এবং Directions API ও Distance Matrix API পরিষেবাগুলো থেকে ভিন্নভাবে duration রেসপন্স প্রপার্টি ব্যবহার করে।

ETA এর ধরণ রাউটস এপিআই দিকনির্দেশনা এপিআই
দূরত্ব ম্যাট্রিক্স এপিআই
ট্র্যাফিক সম্পর্কে অজ্ঞাত, সময়-নিরপেক্ষ আনুমানিক আগমনের সময় (ETA)।

TRAFFIC_UNAWARE ব্যবহার করে সেট করা হয়েছে।

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

অনুরোধে departure_time নির্ধারণ করা না থাকার সাথে সম্পর্কিত।

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

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

  • রিয়েল-টাইম ট্র্যাফিক বিবেচনায় নিয়ে আনুমানিক সময় (ETA) ' duration response' প্রপার্টির মধ্যে অন্তর্ভুক্ত থাকে।
  • staticDuration রেসপন্স প্রপার্টিটিতে ট্র্যাফিকের অবস্থা বিবেচনা না করে রুটটি অতিক্রম করার সময়কাল থাকে।
  • duration_in_traffic প্রপার্টিটি এখন আর রিটার্ন করা হয় না।

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

  • রিয়েল-টাইম ট্র্যাফিক বিবেচনায় নিয়ে আনুমানিক আগমনের সময় (ETA) duration_in_traffic রেসপন্স প্রপার্টিতে অন্তর্ভুক্ত থাকে।

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

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

ফরম্যাট করা ঠিকানা (রিভার্স জিওকোড)

Routes API রেসপন্সে ফরম্যাট করা ঠিকানা প্রদান করে না। ফরম্যাট করা ঠিকানা পেতে Geocoding API ব্যবহার করুন, যা এই বিশেষ কাজের জন্যই তৈরি করা হয়েছে এবং উন্নত মানের ফলাফল দেয়।

উপলব্ধ ভ্রমণ পদ্ধতি

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

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

Routes API রেসপন্স ফরম্যাট হিসেবে XML প্রদান করে না। আপনি অনলাইনে বেশ কিছু JSON থেকে XML কনভার্টার খুঁজে নিতে পারেন যা আপনার প্রয়োজন মেটাতে সক্ষম হবে।