নির্বাচিত রুট তৈরি করুন

এই পৃষ্ঠায় নিম্নলিখিত বিভাগগুলিতে রোডস সিলেকশন এপিআই ব্যবহার করে কীভাবে রুট তৈরি করতে হয় এবং কাস্টম অ্যাট্রিবিউট যোগ করতে হয় তা বর্ণনা করা হয়েছে:

একটি রুট তৈরি করুন

একটি রুট তৈরি করতে, create endpoint-এ একটি POST অনুরোধ পাঠান।

https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes?selectedRouteId=SELECTED_ROUTE_ID

অনুরোধের মূল অংশটি অবশ্যই একটি JSON অবজেক্ট হতে হবে যা SelectedRoute রিসোর্সকে সংজ্ঞায়িত করে। এই অবজেক্টটি নিম্নলিখিত তথ্যগুলি নির্দিষ্ট করে:

  • নিম্নলিখিত তথ্য সহ একটি dynamicRoute অবজেক্ট:
    • নির্বাচিত রুটের origin ।
    • নির্বাচিত রুটের destination ।
    • রুটের যেকোনো intermediates , যা ওয়েপয়েন্ট নামেও পরিচিত।
  • একটি অনন্য selectedRouteId । এই মানটি ৪ থেকে ৬৩ অক্ষরের মধ্যে হতে হবে এবং শুধুমাত্র আলফানিউমেরিক অক্ষর ব্যবহার করতে হবে । যদি আপনি একটি ID প্রদান না করেন, তাহলে সিস্টেম নির্বাচিত রুটের জন্য একটি অনন্য ID তৈরি করবে।

নিম্নলিখিত কোড নমুনাটি create এন্ডপয়েন্টে একটি POST অনুরোধের কাঠামো দেখায়।

curl -X POST -d '
    {"dynamic_route": { \
      origin: {latitude: ORIGIN_LATITUDE ,longitude: ORIGIN_LONGITUDE}, \
      destination: {latitude: DESTINATION_LATITUDE, longitude: DESTINATION_LONGITUDE} \
    }}' \' \
  -H 'X-Goog-User-Project: PROJECT_NUMBER' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  "https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes?selectedRouteId=SELECTED_ROUTE_ID"

সফল হলে, API SelectedRoute রিসোর্সটি ফেরত পাঠাবে। প্রতিক্রিয়ায় name ক্ষেত্রে selectedRouteId অন্তর্ভুক্ত থাকবে। আপনি SelectedRoute রিসোর্সটি পুনরুদ্ধার করতে বা মুছে ফেলতে এই selectedRouteId ব্যবহার করতে পারেন।

নিম্নলিখিত কোড নমুনাটি একটি সফল create এন্ডপয়েন্ট রেসপন্সের কাঠামো দেখায়।

{
  "name": "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID",
  "dynamicRoute": {
    "origin": {
      "latitude": ORIGIN_LATITUDE,
      "longitude": ORIGIN_LONGITUDE
    },
    "destination": {
      "latitude": DESTINATION_LATITUDE,
      "longitude": DESTINATION_LONGITUDE
    }
  },
  "createTime": "CREATE_TIME",
  "state": "STATE_VALIDATING"
}

ব্যাচ তৈরি রুট

একটি একক অনুরোধে একাধিক রুট তৈরি করতে, batchCreate এন্ডপয়েন্ট ব্যবহার করুন। এই এন্ডপয়েন্ট আপনাকে এক কলে ১০০০টি পর্যন্ত রুট সংজ্ঞায়িত করতে দেয়।

batchCreate এন্ডপয়েন্টে একটি POST অনুরোধ পাঠান:

https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes:batchCreate

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

অনুরোধের বডিটি অবশ্যই একটি JSON অবজেক্ট হতে হবে যাতে একটি requests অ্যারে থাকবে। এই অ্যারের মধ্যে প্রতিটি অবজেক্ট হল একটি CreateSelectedRouteRequest যা একটি পৃথক SelectedRoute রিসোর্সকে সংজ্ঞায়িত করে।

নিম্নলিখিত কোড নমুনাটি batchCreate এন্ডপয়েন্টে একটি POST অনুরোধের কাঠামো দেখায়:

curl -X POST -d '
    {"requests": [
      {
        "dynamicRoute": {
          "origin": {"latitude": ORIGIN_LATITUDE_1, "longitude": ORIGIN_LONGITUDE_1},
          "destination": {"latitude": DESTINATION_LATITUDE_1, "longitude": DESTINATION_LONGITUDE_1}
        },
        "selectedRouteId": "route-one"
      },
      {
        "dynamicRoute": {
          "origin": {"latitude": ORIGIN_LATITUDE_2, "longitude": ORIGIN_LONGITUDE_2},
          "destination": {"latitude": DESTINATION_LATITUDE_2, "longitude": DESTINATION_LONGITUDE_2}
        },
        "selectedRouteId": "route-two"
      }
    ]}
  ' \
  -H 'X-Goog-User-Project: PROJECT_NUMBER' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  "https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes:batchCreate"

সফল হলে, API তৈরি করা SelectedRoute রিসোর্সের একটি অ্যারে সম্বলিত একটি প্রতিক্রিয়া প্রদান করে।

নিম্নলিখিত কোড নমুনাটি একটি batchCreate এন্ডপয়েন্ট প্রতিক্রিয়ার কাঠামো দেখায়:

{
  "selectedRoutes": [
    {
      "name": "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID_1",
      "dynamicRoute": {
        "origin": {
          "latitude": ORIGIN_LATITUDE_1,
          "longitude": ORIGIN_LONGITUDE_1
        },
        "destination": {
          "latitude": DESTINATION_LATITUDE_1,
          "longitude": DESTINATION_LONGITUDE_1
        }
      },
      "createTime": "CREATE_TIME_1",
      "state": "STATE_VALIDATING"
    },
    {
      "name": "projects/PROJECT_NUMBER/selectedRoutes/SELECTED_ROUTE_ID_2",
      "dynamicRoute": {
        "origin": {
          "latitude": ORIGIN_LATITUDE_2,
          "longitude": ORIGIN_LONGITUDE_2
        },
        "destination": {
          "latitude": DESTINATION_LATITUDE_2,
          "longitude": DESTINATION_LONGITUDE_2
        }
      },
      "intermediates": [],
      "createTime": "CREATE_TIME_2",
      "state": "STATE_VALIDATING"
    }
  ]
}

মধ্যবর্তী ওয়েপয়েন্ট সহ একটি রুট তৈরি করুন

উৎপত্তিস্থল এবং গন্তব্যস্থলের মধ্যে নির্দিষ্ট বিন্দুর মধ্য দিয়ে যাওয়া একটি রুট তৈরি করতে, আপনার অনুরোধের বডিতে dynamicRoute অবজেক্টের মধ্যে একটি intermediates অ্যারে অন্তর্ভুক্ত করুন। intermediates অ্যারের প্রতিটি উপাদান তার latitude এবং longitude দ্বারা সংজ্ঞায়িত একটি ওয়েপয়েন্ট, একটি রুটে সর্বাধিক 25টি ওয়েপয়েন্ট থাকতে পারে।

নিম্নলিখিত কোড নমুনাটি দেখায় কিভাবে মধ্যবর্তী ওয়েপয়েন্ট সহ একটি SelectedRoute তৈরি করতে হয়:

curl -X POST -d '
    {"dynamic_route": { \
        "origin": {"latitude": ORIGIN_LATITUDE , "longitude": ORIGIN_LONGITUDE}, \
        "intermediates": [
          {"latitude": INTERMEDIATE_LATITUDE_1, "longitude": INTERMEDIATE_LONGITUDE_1},
          {"latitude": INTERMEDIATE_LATITUDE_2, "longitude": INTERMEDIATE_LONGITUDE_2},
          {"latitude": INTERMEDIATE_LATITUDE_3, "longitude": INTERMEDIATE_LONGITUDE_3}
        ],
        "destination": {"latitude": DESTINATION_LATITUDE, "longitude": DESTINATION_LONGITUDE}}}' \
  -H 'X-Goog-User-Project: PROJECT_NUMBER' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  "https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes?selectedRouteId=SELECTED_ROUTE_ID"

কাস্টম রুট বৈশিষ্ট্য ব্যবহার করুন

রোডস ম্যানেজমেন্ট ইনসাইটসের মধ্যে আপনার রুট ম্যানেজমেন্ট এবং ডেটা বিশ্লেষণ উন্নত করতে, SelectedRoute অবজেক্টে একটি route_attributes ক্ষেত্র অন্তর্ভুক্ত করা হয়েছে।

প্রতিটি রুটের জন্য আপনার নিজস্ব কাস্টম বৈশিষ্ট্য নির্ধারণ করতে routeAttributes ক্ষেত্রটি ব্যবহার করুন, যেখানে প্রতিটি বৈশিষ্ট্য একটি কী-মান জোড়া। আপনি প্রতি রুটে সর্বাধিক ১০টি কাস্টম কী-মান জোড়া প্রদান করতে পারেন।

এই বৈশিষ্ট্যগুলি নির্দিষ্ট রুট সনাক্তকরণের জন্য অথবা আপনার প্রয়োজনের সাথে প্রাসঙ্গিক মানদণ্ডের ভিত্তিতে রুটগুলিকে গোষ্ঠীবদ্ধ করার জন্য কার্যকর।

আপনি যে রুট অ্যাট্রিবিউটগুলি ব্যবহার করতে পারেন তার কিছু উদাহরণ নিচে দেওয়া হল:

  • "road_classification": "highway"
  • "maintenance_zone": "north_district"
  • "event_id": "marathon_2024"
  • "pavement_type": "asphalt"

routeAttributes ক্ষেত্রটি সংজ্ঞায়িত করার সময় নিম্নলিখিত নির্দেশিকাগুলি অনুসরণ করুন:

  • কীগুলি goog উপসর্গ দিয়ে শুরু করা উচিত নয়।
  • প্রতিটি কী এবং প্রতিটি মানের দৈর্ঘ্য ১০০ অক্ষরের বেশি হওয়া উচিত নয়।

এরপর আপনি রোডস ম্যানেজমেন্ট ইনসাইটস-এর মধ্যে এই কাস্টম routeAttributes নিম্নলিখিত উপায়ে ব্যবহার করতে পারেন:

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

পরবর্তী কোড নমুনাটি দেখায় কিভাবে কাস্টম routeAttributes দিয়ে একটি SelectedRoute তৈরি করতে হয়।

curl -X POST -d '
    {"dynamic_route": { origin: {latitude: ORIGIN_LATITUDE ,longitude: ORIGIN_LONGITUDE}, destination: {latitude: DESTINATION_LATITUDE, longitude: DESTINATION_LONGITUDE}}, route_attributes: {"ATTRIBUTE_KEY":"ATTRIBUTE_VALUE"}}' \
  -H 'X-Goog-User-Project: PROJECT_NUMBER' \
  -H 'Content-Type: application/json' \
  -H "Authorization: Bearer ACCESS_TOKEN" \
  "https://roads.googleapis.com/selection/v1/projects/PROJECT_NUMBER/selectedRoutes?selectedRouteId=SELECTED_ROUTE_ID"