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

TWO_WHEELER ও TRANSIT-এর জন্য সহায়তা যোগ করা হয়েছে।
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 উপলভ্য নেই।

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

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