Directions API (Legacy) বা Distance Matrix API (Legacy) থেকে মাইগ্রেট করা

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

Directions API বা Distance Matrix API ব্যবহার করে এমন অ্যাপকে Routes API-তে কীভাবে মাইগ্রেট করবেন তা এই গাইডে বর্ণনা করা হয়েছে। Routes API সম্পর্কে আরও জানতে, প্রোডাক্ট ওভারভিউ দেখুন।

মাইগ্রেশনের জন্য বিলিং সংক্রান্ত পেশাদার পদ্ধতি

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

REST API এন্ডপয়েন্ট আপডেট করা

নতুন Routes API এন্ডপয়েন্ট ব্যবহার করতে আপনার কোড আপডেট করুন

Directions API থেকে

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

Distance Matrix API থেকে

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API 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 অনুরোধের অংশ হিসেবে অনুরোধের বডি বা হেডারে প্যারামিটার পাস করেন। উদাহরণ দেখতে, এখানে যান:

পলিলাইন-এনকোড করা ওয়েপয়েন্টকে লোকেশন ওয়েপয়েন্টে কনভার্ট করুন

এনকোড করা পলিলাইন হিসেবে ওয়েপয়েন্ট নির্দিষ্ট করার সুবিধা Directions API (Legacy)-তে উপলভ্য, যাতে ১৬৩৮৪ অক্ষরের URL সীমার মধ্যে অনেকগুলি ওয়েপয়েন্ট ফিট করা যায়। Routes API-তে এই ফিচারটি প্রয়োজনীয় নয় কারণ অক্ষাংশ/দ্রাঘিমাংশ কোঅর্ডিনেট হিসেবে REST বা gRPC অনুরোধের বডিতে ওয়েপয়েন্ট ট্রান্সমিট করা যেতে পারে। উদাহরণ হিসেবে, রুট ম্যাট্রিক্স গণনা করুন ডকুমেন্টে HTTP উদাহরণ দেখুন অথবা ইন্টারমিডিয়েট ওয়েপয়েন্ট নির্দিষ্ট করুন ডকুমেন্টে ইন্টারমিডিয়েট ওয়েপয়েন্ট নির্ধারণ করুন।

প্যারামিটার কনভার্ট করুন

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

প্যারামিটার কনভার্সনের অনুরোধ করুন

দিকনির্দেশ বা দূরত্বের ম্যাট্রিক্স প্যারামিটার Routes API প্যারামিটার নোট
alternatives computeAlternativeRoutes
arrival_time arrivalTime শুধুমাত্র TRANSIT মোডে উপলভ্য এবং departureTime-এর সাথে একই সময়ে উপলভ্য নয়।
avoid routeModifiers
departure_time departureTime arrivalTime-এর সাথে একই সময়ে ব্যবহার করা যাবে না।
language languageCode শুধু Compute Routes-এর জন্য কাজ করে।
mode travelMode

GET URL কোয়েরি প্যারামিটারের পরিবর্তে RouteTravelMode ভ্যালু ব্যবহার করে computeRoutes অথবা computeRouteMatrix HTTP POST JSON অনুরোধের বডিতে পাস করা হয়েছে (computeRoutes-এর জন্য DRIVE, TWO_WHEELER, WALK, TRANSIT, TRUCK অথবা BICYCLE)। এগুলির জন্য সহায়তা যোগ করা হয়েছে TWO_WHEELER, TRANSIT, এবং TRUCK.
region regionCode
traffic_model trafficModel আরও জানুন
transit_mode "travelMode": "TRANSIT" Directions API (Legacy)-তে, ট্রানজিট রুটে, একই ট্রাভেল মোড (যেমন, হাঁটা বা ট্রানজিট) সহ ট্রিপের প্রতিটি সেগমেন্টকে একটি ধাপ হিসেবে বিবেচনা করা হয় এবং সেই ট্রাভেল মোডের জন্য আলাদা আলাদা দিকনির্দেশ সাবস্টেপে থাকে। এর বিপরীতে, Routes API-তে, সব ধরনের ভ্রমণের ক্ষেত্রে ধাপগুলি ধারাবাহিকভাবে একটি নেভিগেশন নির্দেশিকা হিসেবে কাজ করে। তাই প্রতিটি নেভিগেশন নির্দেশাবলী হল একটি ধাপ। একটি ভ্রমণ মোডে একাধিক ধাপের জন্য, Routes API মেটাডেটা প্রদান করে যার মধ্যে `stepsOverview`-এ সেই ভ্রমণ মোডের ধাপগুলির একটি সারাংশ থাকে। এই মেটাডেটার অনুরোধ করতে, `routes.legs.stepsOverview` ফিল্ড মাস্ক ব্যবহার করুন। আরও জানুন।
transit_routing_preference transitRoutingPreference আরও জানুন
units units আরও জানুন
waypoints intermediates এনকোড করা পলিলাইন-এর জন্য সহায়তা সরিয়ে দেওয়া হয়েছে।
optimize=true ওয়েপয়েন্টের জন্য "optimizeWaypointOrder": "true" আরও জানুন

রেসপন্স প্যারামিটার কনভার্সন

দিকনির্দেশ বা দূরত্বের ম্যাট্রিক্স প্যারামিটার Routes API প্যারামিটার নোট
copyrights

উত্তরে অন্তর্ভুক্ত করা হয়নি। আপনার ব্যবহারকারীদের ফলাফল দেখানোর সময় আপনাকে অবশ্যই নিম্নলিখিত বিবৃতি অন্তর্ভুক্ত করতে হবে:

Powered by Google, ©YEAR Google

যেমন:

Powered by Google, ©2022 Google
distance distanceMeters দূরত্ব শুধুমাত্র মিটারে উপলভ্য।
duration_in_traffic duration Routes API থেকে সরানো হয়েছে, duration ব্যবহার করুন।
status উপলভ্য নেই। API-এর মাধ্যমে রিপোর্ট করা সমস্যার জন্য HTTP রেসপন্স কোড ব্যবহার করুন। আরও তথ্যের জন্য অনুরোধ সংক্রান্ত সমস্যা ম্যানেজ করা দেখুন।
geocoded_waypoints geocoding_results শুধু Compute Routes-এর জন্য কাজ করে। ঠিকানা হিসেবে নির্দিষ্ট করা ওয়েপয়েন্টের জন্য শুধুমাত্র জিওকোডিং রেসপন্স সংক্রান্ত তথ্য থাকে।
bounds viewport
legs.end_address উপলভ্য নেই।

উচ্চ পর্যায়ের যথার্থতা সহ রাউটিংয়ের জন্য কোঅর্ডিনেটের পরিবর্তে প্লেস আইডি ব্যবহার করুন। প্লেস আইডিতে এমন ডেটা থাকে যা সঠিক অ্যাক্সেস পয়েন্টে রুটকে স্ন্যাপ করে।

  • আপনি কোনও ঠিকানা দিয়ে শুরু করলে: এটি কোনও জায়গার আইডিতে সমাধান করতে জায়গা অটোমেটিক সম্পূর্ণ করা বা Geocoding API ব্যবহার করুন।
  • আপনি যদি স্থানাঙ্ক দিয়ে শুরু করেন: আরও অর্থপূর্ণ লোকেশন প্রদান করতে গন্তব্য সার্চ করুন বিকল্প ব্যবহার করার কথা বিবেচনা করুন। স্থানাঙ্ক থেকে ঠিকানা পাওয়া জটিল হতে পারে এবং এর ফলে ভুল স্ন্যাপিং হতে পারে। Routes API স্থানাঙ্ককে ঠিকানায় রিভার্স-জিওকোড করে না।
legs.start_address উপলভ্য নেই।
overview_polyline পলিলাইন
summary description
waypoint_order optimizedIntermediateWaypointIndex