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

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

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

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

গুরুত্বপূর্ণ উন্নতি

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

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

Routes API Compute Route Matrix
  • আপনি TRAFFIC_AWARE_OPTIMAL নির্দিষ্ট না করলে সর্বাধিক ৬২৫টি এলিমেন্ট।
  • TRAFFIC_AWARE_OPTIMAL সহ সর্বাধিক ১০০টি এলিমেন্ট। উন্নত রাউটিং সংক্রান্ত পছন্দ দেখুন।
  • কোনও জায়গার আইডি ব্যবহার করে সর্বাধিক ৫০টি ওয়েপয়েন্ট (শুরু + গন্তব্য)।
Distance Matrix API
  • প্রতিটি অনুরোধে সর্বাধিক ২৫টি অরিজিন বা ২৫টি ডেস্টিনেশন।
  • প্রতিটি সার্ভার-সাইড অনুরোধে সর্বাধিক ১০০টি এলিমেন্ট (উৎসের সংখ্যা × গন্তব্যের সংখ্যা) থাকতে পারে।

অনুরোধের আরও দ্রুত উত্তর

Compute Route Matrix ফিচার নিম্নলিখিত লেটেন্সি উন্নত করে:

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

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

কম্পিউট রুট ফিচারে এইসব উন্নত রুটিং সুবিধা পাওয়া যায়:

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

আপনার প্রয়োজনীয় ডেটার জন্য অনুরোধ করুন

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

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

ট্রাফিকের জন্য উন্নত রুট কম্পিউটেশন

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

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

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 পরিষেবার মধ্যে রাউটিং বিকল্পের তুলনা করে।

ট্রাফিক সংক্রান্ত বিকল্প Routes API Directions API
Distance Matrix API		 লেটেন্সি
কোনও রিয়েল-টাইম ট্রাফিক নেই TRAFFIC_UNAWARE departure_time প্রপার্টি সেট করা নেই তিনটি মোডের মধ্যে সবচেয়ে কম লেটেন্সি।
লাইভ ট্রাফিক পরিস্থিতি প্রয়োগ করা হয়েছে TRAFFIC_AWARE সমতুল্য কিছু নেই

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

TRAFFIC_AWARE_OPTIMAL-এর তুলনায় এতে লেটেন্সি অনেক কম।
খুব ভাল কোয়ালিটির, বিস্তারিত লাইভ ট্রাফিক ডেটা প্রয়োগ করা হয়েছে TRAFFIC_AWARE_OPTIMAL departure_timeটি প্রপার্টি সেট

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

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

প্রধান পার্থক্য

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

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

Routes API Compute Routes এবং Compute Route Matrix ব্যবহার করার জন্য আপনার অ্যাপের API কনসোলে শুধুমাত্র একটি পরিষেবা চালু করুন।
আরও তথ্যের জন্য, Google API কনসোলে সেট-আপ করুন দেখুন।
Directions API
Distance Matrix API 		দুটি পরিষেবা চালু করুন: API কনসোলে আলাদা পরিষেবা হিসেবে Directions API এবং Distance Matrix API।

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

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

পৌঁছানোর প্রত্যাশিত সময় (ETA) সংক্রান্ত উত্তরে পার্থক্য

নিচের টেবিলে দেখানো অনুযায়ী, Routes API, ETA রিটার্ন করে এবং Directions API ও Distance Matrix API পরিষেবার থেকে আলাদাভাবে duration response property ব্যবহার করে।

ETA-এর ধরন Routes API Directions API
Distance Matrix API
ট্রাফিক সম্পর্কে অবগত নয়, সময়-নিরপেক্ষ পৌঁছানোর প্রত্যাশিত সময়।

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

  • duration উত্তরের প্রপার্টিতে ETA থাকে।
  • duration এবং staticDuration রেসপন্স প্রপার্টিতে একই ভ্যালু আছে।

অনুরোধে departure_time সেট না করা থাকলে এটি প্রযোজ্য।

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

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

  • রিয়েল-টাইম ট্রাফিক বিবেচনা করে ETA duration রেসপন্স প্রপার্টিতে অন্তর্ভুক্ত করা হয়েছে।
  • staticDuration উত্তরের প্রপার্টিতে রাস্তার মাধ্যমে ভ্রমণের সময়সীমা থাকে, তবে ট্রাফিক পরিস্থিতি বিবেচনা করা হয় না।
  • duration_in_traffic প্রপার্টি আর রিটার্ন করা হয় না।

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

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

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

এই পরিষেবার মাধ্যমে আপনাকে আর অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেটকে পলিলাইন ওয়েপয়েন্টে কনভার্ট করতে হবে না। এটি POST অনুরোধের বডিকে সাপোর্ট করে এবং তাই URL স্ট্রিংয়ের সীমার দ্বারা আর প্রভাবিত হয় না। Distance Matrix API-এর কিছু ব্যবহারকারী ল্যাটিটিউড/লংটিউড পয়েন্টকে পলিলাইন ওয়েপয়েন্টে কনভার্ট করে অনুরোধের সীমা সংক্রান্ত সমস্যার সমাধান করেছেন।

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

Routes API, উত্তরের মধ্যে ফর্ম্যাট করা ঠিকানা প্রদান করে না। ফর্ম্যাট করা ঠিকানা পেতে, এই ব্যবহারের ক্ষেত্রে তৈরি করা এবং আরও ভালো কোয়ালিটির ফলাফল প্রদানকারী Geocoding API ব্যবহার করুন।

উপলভ্য ভ্রমণ মোড

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

উত্তরের ফর্ম্যাট হিসেবে XML

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