এই নির্দেশিকায় বর্ণনা করা হয়েছে কীভাবে Directions API বা Distance Matrix API ব্যবহারকারী অ্যাপগুলিকে Routes API ব্যবহারে মাইগ্রেট করতে হয়। Routes API সম্পর্কে বিস্তারিত জানতে, প্রোডাক্ট ওভারভিউ দেখুন।
মাইগ্রেশনের জন্য বিলিংয়ের সর্বোত্তম অনুশীলন
আপনার এপিআই (API) ব্যবহার যদি দ্বিতীয়-স্তরের মূল্যে যাওয়ার মতো যথেষ্ট বেশি হয়, তবে এই নির্দেশিকাটি প্রযোজ্য হবে। কোনো এপিআই-এর নতুন সংস্করণে স্থানান্তরিত হওয়ার সময়, আপনাকে একটি ভিন্ন SKU-এর জন্যও বিল করা হয়। স্থানান্তরের মাসে খরচ বৃদ্ধি এড়ানোর জন্য, আমরা সুপারিশ করি যে মাসের শুরুর দিকে যত দ্রুত সম্ভব নতুন এপিআইগুলো প্রোডাকশনে চালু করুন। এটি নিশ্চিত করবে যে আপনি স্থানান্তরের মাসেই সবচেয়ে সাশ্রয়ী মাসিক মূল্যের স্তরগুলোতে পৌঁছাতে পারবেন। মূল্যের স্তরগুলো সম্পর্কে তথ্যের জন্য, প্রাইসিং পেজ এবং প্রাইসিং FAQ দেখুন।
REST API এন্ডপয়েন্টগুলি আপডেট করুন
নতুন রাউটস এপিআই এন্ডপয়েন্টগুলো ব্যবহার করার জন্য আপনার কোড আপডেট করুন।
ডিরেকশনস এপিআই থেকে
| দিকনির্দেশনা এপিআই | https://maps.googleapis.com/maps/api/directions/ outputFormat ? parameters |
| রাউটস এপিআই | https://routes.googleapis.com/directions/v2:computeRoutes |
দূরত্ব ম্যাট্রিক্স এপিআই থেকে
| দূরত্ব ম্যাট্রিক্স এপিআই | https://maps.googleapis.com/maps/api/distancematrix/ outputFormat ? parameters |
| রাউটস এপিআই | https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix |
HTTPS রিকোয়েস্ট বডি ব্যবহার করার জন্য URL প্যারামিটারগুলোকে রূপান্তর করুন।
Directions API এবং Distance Matrix API ব্যবহার করে, আপনি একটি HTTP GET অনুরোধে URL প্যারামিটার হিসেবে কনফিগারেশন প্রোপার্টিগুলো পাস করেন। উদাহরণস্বরূপ, Directions API-এর জন্য:
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API ব্যবহার করে, আপনি একটি HTTP POST অনুরোধের অংশ হিসেবে রিকোয়েস্ট বডিতে অথবা হেডারে প্যারামিটার পাস করতে পারেন। উদাহরণের জন্য দেখুন:
পলিলাইন-এনকোডেড ওয়েপয়েন্টগুলিকে অবস্থান ওয়েপয়েন্টে রূপান্তর করুন
১৬৩৮৪ অক্ষরের URL সীমার মধ্যে বিপুল সংখ্যক ওয়েপয়েন্ট অন্তর্ভুক্ত করার জন্য Directions API (Legacy)- তে এনকোডেড পলিলাইন হিসেবে ওয়েপয়েন্ট নির্দিষ্ট করার সুবিধা রয়েছে। Routes API-তে এই বৈশিষ্ট্যটির প্রয়োজন নেই, কারণ ওয়েপয়েন্টগুলো REST বা gRPC অনুরোধের বডিতে অক্ষাংশ/দ্রাঘিমাংশ স্থানাঙ্ক হিসেবে প্রেরণ করা যায়। উদাহরণের জন্য, 'Compute a route matrix ' ডকুমেন্টের HTTP Example দেখুন, অথবা 'Specify intermediate waypoints ' ডকুমেন্টের Define an intermediate waypoint অংশটি দেখুন ।
প্যারামিটার রূপান্তর করুন
নিম্নলিখিত সারণিতে Directions API এবং Distance Matrix API-এর সেইসব প্যারামিটারের তালিকা দেওয়া হয়েছে যেগুলোর নাম পরিবর্তন বা পরিমার্জন করা হয়েছে, অথবা যেগুলো GA রিলিজে সমর্থিত নয়। আপনি যদি এই প্যারামিটারগুলোর কোনোটি ব্যবহার করে থাকেন, তবে আপনার কোড আপডেট করুন।
অনুরোধ প্যারামিটার রূপান্তর
| দিক বা দূরত্ব ম্যাট্রিক্স প্যারামিটার | রাউটস এপিআই প্যারামিটার | নোট |
|---|---|---|
alternatives | computeAlternativeRoutes | |
arrival_time | arrivalTime | শুধুমাত্র TRANSIT মোডে উপলব্ধ, এবং departureTime সাথে একই সময়ে নয়। |
avoid | routeModifiers | |
departure_time | departureTime | arrivalTime এর সাথে একই সময়ে ব্যবহার করা যাবে না। |
language | languageCode | শুধুমাত্র কম্পিউট রাউটের জন্য সমর্থিত। |
mode | travelMode | |
region | regionCode | |
traffic_model | trafficModel | আরও জানুন |
transit_mode | "travelMode": "TRANSIT" | ডাইরেকশনস এপিআই (লেগ্যাসি)-তে, একটি ট্রানজিট রুটে, একই ভ্রমণ পদ্ধতির (যেমন, হাঁটা বা ট্রানজিট) প্রতিটি অংশকে একটি ধাপ হিসেবে গণ্য করা হয় এবং সেই ভ্রমণ পদ্ধতির জন্য স্বতন্ত্র নির্দেশনাগুলো উপ-ধাপে থাকে। এর বিপরীতে, রুটস এপিআই-তে, সব ধরনের ভ্রমণের জন্য ধাপগুলো ধারাবাহিকভাবে একটিই নেভিগেশন নির্দেশনা। সুতরাং প্রতিটি নেভিগেশন নির্দেশনাই একটি ধাপ। একটি ভ্রমণ পদ্ধতিতে একাধিক ধাপ থাকলে, রুটস এপিআই `stepsOverview`-এ মেটাডেটা প্রদান করে, যাতে সেই ভ্রমণ পদ্ধতির ধাপগুলোর একটি সারসংক্ষেপ থাকে। এই মেটাডেটা অনুরোধ করতে, `routes.legs.stepsOverview` ফিল্ড মাস্কটি ব্যবহার করুন। আরও জানুন । |
transit_routing_preference | transitRoutingPreference | আরও জানুন |
units | units | আরও জানুন |
waypoints | intermediates | এনকোডেড পলিলাইনের জন্য সমর্থন সরানো হয়েছে। |
ওয়েপয়েন্টগুলির জন্য optimize=true | "optimizeWaypointOrder": "true" | আরও জানুন |
প্রতিক্রিয়া পরামিতি রূপান্তর
| দিক বা দূরত্ব ম্যাট্রিক্স প্যারামিটার | রাউটস এপিআই প্যারামিটার | নোট |
|---|---|---|
copyrights | প্রতিক্রিয়ায় অন্তর্ভুক্ত নয়। আপনার ব্যবহারকারীদের কাছে ফলাফল প্রদর্শন করার সময় আপনাকে অবশ্যই নিম্নলিখিত বিবৃতিটি অন্তর্ভুক্ত করতে হবে: উদাহরণস্বরূপ: | |
distance | distanceMeters | দূরত্ব শুধুমাত্র মিটারে উপলব্ধ। |
duration_in_traffic | duration | Routes API থেকে এটি সরানো হয়েছে, duration ব্যবহার করুন। |
status | উপলব্ধ নয়। এপিআই দ্বারা রিপোর্ট করা ত্রুটির জন্য HTTP রেসপন্স কোড ব্যবহার করুন। আরও তথ্যের জন্য ‘অনুরোধের ত্রুটি পরিচালনা’ দেখুন। | |
geocoded_waypoints | geocoding_results | শুধুমাত্র 'কম্পিউট রুটস'-এর জন্য সমর্থিত। এতে শুধুমাত্র ঠিকানা হিসাবে নির্দিষ্ট করা ওয়েপয়েন্টগুলির জন্য জিওকোডিং প্রতিক্রিয়া তথ্য থাকে। |
bounds | viewport | |
legs.end_address | উপলব্ধ নয়। | উচ্চ-সঠিক রাউটিংয়ের জন্য স্থানাঙ্কের পরিবর্তে প্লেস আইডি ব্যবহার করুন। প্লেস আইডিতে এমন ডেটা থাকে যা রুটটিকে সঠিক অ্যাক্সেস পয়েন্টে সংযুক্ত করে।
|
legs.start_address | উপলব্ধ নয়। | |
overview_polyline | পলিলাইন | |
summary | description | |
waypoint_order | optimizedIntermediateWaypointIndex |