Method: computeRouteMatrix

উত্স এবং গন্তব্যগুলির একটি তালিকা নেয় এবং উত্স এবং গন্তব্যের প্রতিটি সংমিশ্রণের জন্য রুট তথ্য সম্বলিত একটি স্ট্রিম প্রদান করে৷

দ্রষ্টব্য: এই পদ্ধতির জন্য আপনাকে ইনপুটে একটি প্রতিক্রিয়া ক্ষেত্র মাস্ক নির্দিষ্ট করতে হবে। আপনি URL প্যারামিটার $fields বা fields ব্যবহার করে প্রতিক্রিয়া ক্ষেত্র মাস্ক প্রদান করতে পারেন, অথবা HTTP/gRPC হেডার X-Goog-FieldMask ব্যবহার করে ( উপলব্ধ URL প্যারামিটার এবং শিরোনাম দেখুন। মান হল ফিল্ড পাথগুলির একটি কমা বিভক্ত তালিকা। ক্ষেত্র পাথ কিভাবে নির্মাণ করতে হয় সে সম্পর্কে এই বিস্তারিত ডকুমেন্টেশন দেখুন।

উদাহরণস্বরূপ, এই পদ্ধতিতে:

  • সমস্ত উপলব্ধ ক্ষেত্রের ফিল্ড মাস্ক (ম্যানুয়াল পরিদর্শনের জন্য): X-Goog-FieldMask: *
  • রুটের সময়কাল, দূরত্ব, উপাদানের স্থিতি, অবস্থা, এবং উপাদান সূচকের ফিল্ড মাস্ক (উদাহরণস্বরূপ উত্পাদন সেটআপ): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

এটা গুরুত্বপূর্ণ যে আপনি আপনার ফিল্ড মাস্কে status অন্তর্ভুক্ত করুন কারণ অন্যথায় সমস্ত বার্তা ঠিক আছে বলে মনে হবে। Google ওয়াইল্ডকার্ড ( * ) প্রতিক্রিয়া ফিল্ড মাস্ক ব্যবহারকে নিরুৎসাহিত করে, কারণ:

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

HTTP অনুরোধ

POST https://routespreferred.googleapis.com/v1:computeRouteMatrix

URL gRPC ট্রান্সকোডিং সিনট্যাক্স ব্যবহার করে।

শরীরের অনুরোধ

অনুরোধের অংশে নিম্নলিখিত কাঠামো সহ ডেটা রয়েছে:

JSON প্রতিনিধিত্ব 
{
  "origins": [
    {
      object (RouteMatrixOrigin)
    }
  ],
  "destinations": [
    {
      object (RouteMatrixDestination)
    }
  ],
  "travelMode": enum (RouteTravelMode),
  "routingPreference": enum (RoutingPreference),
  "departureTime": string
}
ক্ষেত্র
origins[]

object ( RouteMatrixOrigin )

প্রয়োজন। উৎপত্তির বিন্যাস, যা প্রতিক্রিয়া ম্যাট্রিক্সের সারি নির্ধারণ করে। উত্স এবং গন্তব্যের মূলত্বের জন্য বেশ কয়েকটি আকারের সীমাবদ্ধতা প্রযোজ্য:

  • উপাদানের সংখ্যা (উৎপত্তি × গন্তব্য) কোন ক্ষেত্রেই 625 এর বেশি হওয়া উচিত নয়।
  • রাউটিং পছন্দ TRAFFIC_AWARE_OPTIMAL এ সেট করা থাকলে উপাদানের সংখ্যা (উৎপত্তি × গন্তব্য) 100 এর বেশি হওয়া উচিত নয়।
  • placeId হিসাবে নির্দিষ্ট করা ওয়েপয়েন্টের সংখ্যা (উৎপত্তি + গন্তব্য) 50 এর বেশি হওয়া উচিত নয়।
destinations[]

object ( RouteMatrixDestination )

প্রয়োজন। গন্তব্যের অ্যারে, যা প্রতিক্রিয়া ম্যাট্রিক্সের কলাম নির্ধারণ করে।

travelMode

enum ( RouteTravelMode )

ঐচ্ছিক। পরিবহনের মোড নির্দিষ্ট করে।

routingPreference

enum ( RoutingPreference )

ঐচ্ছিক। রুট গণনা কিভাবে নির্দিষ্ট করে. সার্ভার রুট গণনা করার জন্য নির্বাচিত রাউটিং পছন্দ ব্যবহার করার চেষ্টা করে। যদি রাউটিং পছন্দ একটি ত্রুটি বা একটি অতিরিক্ত দীর্ঘ লেটেন্সি ফলাফল, একটি ত্রুটি ফিরে আসে. ভবিষ্যতে, পছন্দের বিকল্পটি একটি বৈধ ফলাফল না দিলে আমরা একটি ভিন্ন বিকল্প ব্যবহার করার জন্য একটি ফলব্যাক প্রক্রিয়া প্রয়োগ করতে পারি। আপনি এই বিকল্পটি শুধুমাত্র তখনই নির্দিষ্ট করতে পারেন যখন travelMode DRIVE বা TWO_WHEELER হয়, অন্যথায় অনুরোধটি ব্যর্থ হয়।

departureTime

string ( Timestamp format)

ঐচ্ছিক। প্রস্থানের সময়। আপনি যদি এই মানটি সেট না করেন তবে এটি আপনার অনুরোধ করার সময় ডিফল্ট হবে। যদি আপনি এই মানটি এমন একটি সময়ে সেট করেন যা ইতিমধ্যে ঘটেছে, অনুরোধটি ব্যর্থ হয়।

RFC3339 UTC "জুলু" ফর্ম্যাটে একটি টাইমস্ট্যাম্প, ন্যানোসেকেন্ড রেজোলিউশন এবং নয়টি পর্যন্ত ভগ্নাংশের সংখ্যা। উদাহরণ: "2014-10-02T15:01:23Z" এবং "2014-10-02T15:01:23.045123456Z" ।

প্রতিক্রিয়া শরীর

সফল হলে, প্রতিক্রিয়া বডিতে RouteMatrixElement এর একটি উদাহরণ থাকে।

অনুমোদনের সুযোগ

নিম্নলিখিত OAuth সুযোগ প্রয়োজন:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

আরও তথ্যের জন্য, OAuth 2.0 ওভারভিউ দেখুন।