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

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

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

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

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

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

আপনার কোডে ComputeRouteMatrix পদ্ধতি ব্যবহার করার আগে, আপনাকে অবশ্যই এটি সক্ষম করতে হবে। রুট পছন্দের API পদ্ধতিগুলি সক্ষম করার বিষয়ে আরও তথ্যের জন্য, শুরু করা দেখুন।

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

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

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

gRPC: https://developers.google.com/maps/documentation/routes_preferred/reference/rpc/google.maps.routes.v1

REST: 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-কী আপনার API কীতে সেট করা আবশ্যক৷

    • X-Goog-ফিল্ডমাস্ক অবশ্যই আপনার প্রতিক্রিয়া থেকে প্রয়োজনীয় ক্ষেত্রগুলির একটি কমা বিভক্ত তালিকায় সেট করতে হবে। উদাহরণস্বরূপ, X-Goog-FieldMask: originIndex,destinationIndex, period,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 রয়েছে। অনুরোধ দ্বারা উল্লিখিত উত্স এবং গন্তব্যগুলির জন্য, একটি প্রদত্ত উপাদানের জন্য রুটের উত্সটি origins[origin_index] সমতুল্য এবং রুটের গন্তব্যটি destinations[destination_index] । এই অ্যারেগুলি শূন্য-সূচীযুক্ত। মূল এবং গন্তব্য তালিকার অর্ডার সংরক্ষণ করা গুরুত্বপূর্ণ।

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

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

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