একটি রুট ম্যাট্রিক্স গণনা

Routes Preferred API-এর ComputeRouteMatrix পদ্ধতি ব্যবহার করে আপনি একাধিক অরিজিন এবং গন্তব্যস্থলের জন্য একটি রুটের দূরত্ব এবং সময়কাল গণনা করতে পারেন। ComputeRouteMatrix স্ট্রিমিং gRPC কল এবং REST HTTP কল উভয়কেই সমর্থন করে।

উৎপত্তিস্থল এবং গন্তব্যস্থল জোড়ার একটি তালিকা দেওয়া হলে, ComputeRouteMatrix প্রতিটি উৎপত্তিস্থল থেকে শুরু করে প্রতিটি গন্তব্যস্থলে শেষ হওয়া রুটের দূরত্ব এবং সময়কাল গণনা করে। স্ট্রিমের প্রতিটি উপাদান একটি একক রুটের তথ্যের সাথে মিলে যায়।

দূরত্ব ম্যাট্রিক্স পরিষেবার তুলনায় ComputeRouteMatrix পদ্ধতির বেশ কিছু সুবিধা রয়েছে:

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

ComputeRouteMatrix পদ্ধতি সক্রিয় করুন

আপনার কোডে ComputeRouteMatrix পদ্ধতি ব্যবহার করার আগে, আপনাকে এটি সক্ষম করতে হবে। Routes Preferred API পদ্ধতি সক্রিয় করার বিষয়ে আরও তথ্যের জন্য, Getting Started দেখুন।

ComputeRouteMatrix পদ্ধতি ব্যবহার করুন

ComputeRouteMatrix পদ্ধতিটি Routes Preferred v1 এন্ডপয়েন্টের মাধ্যমে উপলব্ধ।

আরও বিস্তারিত তথ্যের জন্য নিম্নলিখিত ডকুমেন্টেশন দেখুন:

জিআরপিসি: https://developers.google.com/maps/documentation/routes_preferred/reference/rpc/google.maps.routes.v1

বিশ্রাম: https://developers.google.com/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRouteMatrix

নিম্নলিখিত জেনেরিক ধাপগুলি ComputeRouteMatrix পদ্ধতিতে কল করার জন্য gRPC ব্যবহার করার পদ্ধতি বর্ণনা করে:

1. googleapis সংগ্রহস্থল থেকে প্রয়োজনীয় প্রোটোবাফারগুলি দেখুন:

   https://github.com/googleapis/googleapis/tree/master/google/maps/routes

   মনে রাখবেন যে কিছু বিল্ড সিস্টেম, যেমন Go, স্বয়ংক্রিয়ভাবে আপনার জন্য এটি করতে পারে।

2. আপনার পছন্দের ভাষা এবং বিল্ড টুলের সেট ব্যবহার করে, প্রাসঙ্গিক প্রোটোবাফার কোড তৈরি করুন।

3. আপনার অনুরোধ তৈরি করুন। অনুরোধের সাথে দুটি প্রয়োজনীয় মেটাডেটা পাঠাতে হবে:

   • X-Goog-Api-Key আপনার API কী-তে সেট করতে হবে।

   • X-Goog-Fieldmask অবশ্যই প্রতিক্রিয়া থেকে আপনার প্রয়োজনীয় ক্ষেত্রগুলির একটি কমা দ্বারা পৃথক তালিকাতে সেট করা উচিত। উদাহরণস্বরূপ, X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status । আপনি সমস্ত ক্ষেত্র বোঝাতে ওয়াইল্ডকার্ড অক্ষর (*) ব্যবহার করতে পারেন, তবে এটি নিরুৎসাহিত করা হয়। API প্রতিক্রিয়া পরীক্ষা এবং বুঝতে ওয়াইল্ডকার্ড অক্ষর ব্যবহার করুন, তবে আপনার প্রোডাকশন কোডে ফিল্ড মাস্কে আপনি যে ক্ষেত্রগুলি চান তা স্পষ্টভাবে তালিকাভুক্ত করুন।

     ফিল্ড মাস্ক স্ট্রিং কীভাবে তৈরি করবেন সে সম্পর্কে আরও তথ্যের জন্য, https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto দেখুন। মনে রাখবেন যে আপনার প্রয়োজন নেই এমন ক্ষেত্রগুলি অক্ষম করলে লেটেন্সি হ্রাস পেতে পারে কারণ সেই ক্ষেত্রগুলিতে আরও গণনার প্রয়োজন হতে পারে। আপনার লেটেন্সি স্থিতিশীল থাকবে যদি আপনি আপনার প্রয়োজনীয় ক্ষেত্রগুলি নির্দিষ্ট করেন এবং আরও গণনার প্রয়োজন এমন নতুন ক্ষেত্রগুলি পরে যুক্ত করা হয়।

4. আপনার অনুরোধ routespreferred.googleapis.com:443 ঠিকানায় পাঠান। আপনাকে অবশ্যই TLS প্রোটোকল ব্যবহার করতে হবে।

ComputeRouteMatrix পদ্ধতি ব্যবহারের উদাহরণের জন্য, একটি রুট ম্যাট্রিক্স (বিটা) উদাহরণ গণনা দেখুন।

ComputeRouteMatrix পদ্ধতির একটি স্বতন্ত্র বৈশিষ্ট্য হল যে ত্রুটি কোডগুলি সম্পূর্ণ স্ট্রিম বা পৃথক উপাদানের জন্য ফেরত পাঠানো যেতে পারে। উদাহরণস্বরূপ, যদি অনুরোধটি ত্রুটিপূর্ণ হয় (উদাহরণস্বরূপ, এর শূন্য উৎপত্তি) তাহলে স্ট্রিম সংযোগ একটি ত্রুটি ফেরত দেয়। তবে, যদি একটি ত্রুটি স্ট্রিমের কয়েকটি উপাদানের ক্ষেত্রে প্রযোজ্য হয় (উদাহরণস্বরূপ, একটি উৎপত্তির জন্য একটি অবৈধ স্থান আইডি সেট করা), তাহলে শুধুমাত্র ত্রুটি দ্বারা প্রভাবিত উপাদানগুলিতে ত্রুটি কোড থাকে।

স্ট্রিম দ্বারা ফেরত দেওয়া উপাদানগুলি কোনও ক্রমে ফেরত দেওয়ার গ্যারান্টি দেওয়া হয় না। এই কারণে, প্রতিটি উপাদানে একটি origin_index এবং একটি destination_index থাকে। অনুরোধ দ্বারা নির্দিষ্ট origin এবং destinations এর জন্য, route origin একটি প্রদত্ত উপাদানের জন্য origins[origin_index] এর সমতুল্য এবং route destination destinations[destination_index] এর সমতুল্য। এই অ্যারেগুলি শূন্য-সূচকযুক্ত। origin এবং destination তালিকার ক্রম সংরক্ষণ করা গুরুত্বপূর্ণ।

টোল ফি গণনা করা হচ্ছে

টোল ফি গণনা সম্পর্কে তথ্যের জন্য, টোল ফি গণনা দেখুন।

টোল ফি গণনার উদাহরণের জন্য, একটি রুট ম্যাট্রিক্সের উদাহরণ গণনা করুন দেখুন।