রুট API ওভারভিউ

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

দ্রষ্টব্য: আপনি যদি দিকনির্দেশ API বা দূরত্ব ম্যাট্রিক্স এপিআই থেকে স্থানান্তরিত হন, তাহলে কেন রুট এপিআই-এ মাইগ্রেট করুন থেকে শুরু করে মাইগ্রেশন নির্দেশাবলী দেখুন।

কেন রুট API ব্যবহার করুন

Routes API এর মাধ্যমে, আপনি পরিবহনের বিবরণ, আপ-টু-ডেট ট্র্যাফিক এবং রাস্তার অবস্থা এবং রুটের পছন্দগুলি ব্যবহার করে সঠিক রুট এবং ভ্রমণের তথ্য পেতে পারেন:

• পরিবহনের বিভিন্ন মোডের ধরন এবং ক্ষমতা

• কোন গাড়ি কোন দিকে যাচ্ছে

• পিক আপ বা ড্রপ অফের জন্য রাস্তার পাশে

• ট্রাফিক অবস্থা এবং রাস্তা বন্ধ

• বিপজ্জনক এলাকা এড়ানো বা নিরাপদ পিকআপ এলাকা প্রদানের মতো নিরাপত্তা সংক্রান্ত উদ্বেগ

• টোল এবং ট্রিপ মেটাডেটা যেমন সময় এবং দূরত্ব, এবং জ্বালানী দক্ষতার মতো ঐচ্ছিক বৈশিষ্ট্য সহ আপনার রাউটিং চাহিদা জুড়ে লেটেন্সি, গুণমান এবং খরচের ভারসাম্য বজায় রাখুন

আপনি প্রেরণের সময়সূচীর জন্য সবচেয়ে কার্যকর রুটগুলিও নির্ধারণ করতে পারেন, যেমন:

• প্যাকেজগুলির একটি সিরিজ বাছাই করার জন্য কর্মীদের একটি সেট বরাদ্দ করা ভাল

• সেরা গুদাম নির্ধারণ করুন যেখান থেকে প্যাকেজগুলি তাদের চূড়ান্ত গন্তব্যে পাঠানো হবে

আপনি রুট API দিয়ে কি করতে পারেন?

Routes API এর সাথে, আপনি রাউটিং তথ্যের দুটি প্রাথমিক বিভাগ পেতে পারেন:

• একটি অবস্থান থেকে একক বা একাধিক গন্তব্যে যাওয়ার রুট

• অনেকগুলি শুরু এবং শেষ অবস্থানের মধ্যে সম্ভাব্য রুটের একটি ম্যাট্রিক্স ৷

একক বা একাধিক গন্তব্যের জন্য রুট পান

Routes API Compute Routes পদ্ধতির সাহায্যে, আপনি অবস্থানের মধ্যে গণনা করতে পারেন:

• ভ্রমণের বিভিন্ন উপায় এবং একক বা একাধিক গন্তব্যের জন্য দিকনির্দেশ পান :

  • ট্রানজিট, ড্রাইভিং, দুই চাকার যানবাহন, হাঁটা বা সাইকেল চালানো সহ পরিবহনের উপায়।

  • ওয়েপয়েন্টগুলির একটি সিরিজ, যেগুলিকে ভ্রমণ করার জন্য আপনি সবচেয়ে কার্যকর অর্ডারের জন্য অপ্টিমাইজ করতে পারেন৷

• উৎপত্তিস্থল, গন্তব্যস্থল এবং পথপয়েন্ট নির্দিষ্ট করার একাধিক উপায় :

  • টেক্সট স্ট্রিং। উদাহরণস্বরূপ: "শিকাগো, আইএল", "ডারউইন, এনটি, অস্ট্রেলিয়া", "1800 অ্যাম্ফিথিয়েটার পার্কওয়ে, মাউন্টেন ভিউ, CA 94043", বা "CWF6+FWX মাউন্টেন ভিউ, ক্যালিফোর্নিয়া"

  • আইডি রাখুন

  • অক্ষাংশ এবং দ্রাঘিমাংশ স্থানাঙ্ক, ঐচ্ছিকভাবে গাড়ির শিরোনাম সহ

• আপনার প্রয়োজন এবং লক্ষ্যগুলির উপর ভিত্তি করে আপনার রুট বিকল্পগুলিকে সূক্ষ্ম সুর করুন :

  • আপনার গাড়ির ইঞ্জিনের প্রকারের জন্য জ্বালানি বা শক্তি-দক্ষ রুট নির্বাচন করুন: ডিজেল, বৈদ্যুতিক, হাইব্রিড, গ্যাস। আরও তথ্যের জন্য, একটি পরিবেশ বান্ধব রুট পান দেখুন।

  • ট্রাফিক গণনার জন্য সূক্ষ্ম বিকল্পগুলি সেট করুন, আপনাকে গুণমান বনাম লেটেন্সি ট্রেড অফ সিদ্ধান্ত নিতে দেয়৷ বিশদ বিবরণের জন্য, কীভাবে এবং যদি ট্র্যাফিক ডেটা অন্তর্ভুক্ত করতে হয় তা নির্দিষ্ট করুন দেখুন।

  • ETA নির্ভুলতা বাড়াতে ওয়েপয়েন্টের জন্য গাড়ির শিরোনাম (ভ্রমণের দিকনির্দেশ) এবং রাস্তার পাশের তথ্য সেট করুন। বিশদ বিবরণের জন্য, যানবাহনের শিরোনাম এবং রাস্তার পাশে নির্দিষ্ট করুন দেখুন।

  • পাস-থ্রু বনাম টার্মিনাল অবস্থান এবং নিরাপদ স্টপওভার অবস্থান নির্দিষ্ট করুন। বিশদ বিবরণের জন্য, একটি রুট বরাবর একটি স্টপ সেট করুন এবং একটি রুটের মধ্য দিয়ে যাওয়ার জন্য একটি বিন্দু সেট করুন দেখুন।

  • রুটের দূরত্ব এবং ETA সহ টোল তথ্যের জন্য অনুরোধ করুন। বিশদ বিবরণের জন্য, একটি রুটের জন্য টোল ফি গণনা দেখুন।

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

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

রুট এপিআই Compute Route Matrix পদ্ধতি আপনার ব্যবসার প্রয়োজনের উপর ভিত্তি করে সর্বোত্তম উত্স এবং গন্তব্য চয়ন করতে সাহায্য করার জন্য দূরত্ব এবং আনুমানিক আগমনের সময় সহ একাধিক শুরু এবং শেষ বিন্দুর মধ্যে প্রস্তাবিত রুটের তথ্যের একটি ম্যাট্রিক্স প্রদান করে৷ আপনি এই ধরণের দূরত্বের ডেটার জন্য অনুরোধ করতে পারেন:

• একটি নির্বাচিত ভ্রমণ মোডের জন্য দূরত্ব

• দূরত্ব কিলোমিটার বা মাইলে

• ট্রাফিকের আনুমানিক ভ্রমণ সময়

দূরত্বের ডেটা দিয়ে, আপনি একাধিক সম্ভাব্য উত্স এবং গন্তব্যের মধ্যে যাত্রী, চালান বা কর্মীদের রুট করার সবচেয়ে কার্যকর উপায় নির্ধারণ করতে পারেন।

সম্পূর্ণ ম্যাট্রিক্স গণনা করার আগে আপনি প্রতিক্রিয়ার উপাদানগুলি স্ট্রিম করতে পারেন, প্রতিক্রিয়া লেটেন্সি কমিয়ে।

আপনি 625 পর্যন্ত গন্তব্যের সংখ্যার উৎপত্তি গুণের সংখ্যা সহ সার্ভার-সাইড অনুরোধে একাধিক উত্স এবং গন্তব্য নির্দিষ্ট করতে পারেন।

রুট API কিভাবে কাজ করে

Routes API এর দুটি পদ্ধতি রয়েছে: ComputeRoutes এবং ComputeRouteMatrix ।

কম্পিউটার রুট

Routes API ComputeRoutes পদ্ধতি একটি JSON অনুরোধ বডি সহ একটি HTTP POST অনুরোধ গ্রহণ করে যাতে অনুরোধের বিবরণ থাকে। একটি উত্স, গন্তব্য, ট্রাভেলমোড এবং কোন ক্ষেত্রগুলি ফেরত দিতে হবে তা নির্দিষ্ট করার জন্য একটি ফিল্ড মাস্ক প্রয়োজন৷

উদাহরণ

curl -X POST -d '{
    "origin": {
      "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043"
    },
    "destination": {
      "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132"
    },
  "travelMode": "DRIVE"
  }' \
  -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
  -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \
  'https://routes.googleapis.com/directions/v2:computeRoutes'

পরিষেবাটি তারপরে অনুরোধ করা রুট গণনা করে এবং আপনার অনুরোধ করা ক্ষেত্রগুলি ফেরত দেয়।

ComputeRouteMatrix

Routes API ComputeRouteMatrix একটি JSON অনুরোধের বডি সহ একটি HTTP POST অনুরোধ গ্রহণ করে যাতে অনুরোধের বিবরণ থাকে। কোন ক্ষেত্রগুলি ফেরত দিতে হবে তা নির্দিষ্ট করতে কমপক্ষে একটি উত্স, দুই বা ততোধিক গন্তব্য, ট্র্যাভেলমোড এবং একটি ফিল্ড মাস্ক প্রয়োজন৷

উদাহরণ

curl -X POST -d '{
  "origins": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420761,
            "longitude": -122.081356
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.403184,
            "longitude": -122.097371
          }
        }
      }
    }
  ],
  "destinations": [
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.420999,
            "longitude": -122.086894
          }
        }
      }
    },
    {
      "waypoint": {
        "location": {
          "latLng": {
            "latitude": 37.383047,
            "longitude": -122.044651
          }
        }
      }
    }
  ],
  "travelMode": "DRIVE"
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \
'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'

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

সম্পদ

নিম্নলিখিত সারণীটি যে ডেটা ফেরত দেয় তার সাথে রুট API এর মাধ্যমে উপলব্ধ সংস্থানগুলিকে সংক্ষিপ্ত করে৷

তথ্য সম্পদ	ডেটা ফিরে এসেছে	রিটার্ন ফরম্যাট
কম্পিউটার রুট	অনুরোধ করা হলে বিকল্প রুট সহ রুট, পা এবং একটি রুটের জন্য ধাপগুলি ফেরত দেয়।	JSON
ComputeRouteMatrix	একটি মূল ওয়েপয়েন্ট থেকে একটি গন্তব্য ওয়েপয়েন্টে রুটের একটি অ্যারে ফেরত দেয়।

রুট API কিভাবে ব্যবহার করবেন

1	সেট আপ করুন	আপনার Google ক্লাউড প্রকল্প সেট আপ দিয়ে শুরু করুন এবং অনুসরণ করা সেটআপ নির্দেশাবলী সম্পূর্ণ করুন৷
2	একটি রুট গণনা করুন এবং প্রতিক্রিয়া পর্যালোচনা করুন	আরও তথ্যের জন্য, একটি রুট পান দেখুন এবং রুট প্রতিক্রিয়া পর্যালোচনা করুন ।
3	রুটের ম্যাট্রিক্স গণনা করুন এবং প্রতিক্রিয়া পর্যালোচনা করুন	আরও তথ্যের জন্য, একটি রুট ম্যাট্রিক্স পান দেখুন এবং রুট ম্যাট্রিক্স প্রতিক্রিয়া পর্যালোচনা করুন ।

উপলব্ধ ক্লায়েন্ট লাইব্রেরি

Routes API-এর জন্য উপলব্ধ ক্লায়েন্ট লাইব্রেরির তালিকার জন্য, ক্লায়েন্ট লাইব্রেরি দেখুন।

এরপর কি

• উপলব্ধ রুট বিকল্প
• কোন তথ্য ফেরত দিতে হবে তা বেছে নিন
• দিকনির্দেশ API বা দূরত্ব ম্যাট্রিক্স API থেকে স্থানান্তর করুন
• Routes API প্রিভিউ থেকে GA-তে স্থানান্তর করুন