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

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

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

একটি রুট তৈরি করতে, শেষ বিন্দু create একটি POST অনুরোধ পাঠান।

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

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

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

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

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 এন্ডপয়েন্ট ব্যবহার করুন। এই এন্ডপয়েন্ট আপনাকে এক কলে 1000টি রুট পর্যন্ত সংজ্ঞায়িত করতে দেয়।

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 ক্ষেত্রটি ব্যবহার করুন, যেখানে প্রতিটি বৈশিষ্ট্য একটি কী-মান জোড়া। আপনি প্রতি রুটে 10টি কাস্টম কী-মান জোড়া প্রদান করতে পারেন।

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

নিম্নলিখিত রুট বৈশিষ্ট্যগুলির কিছু উদাহরণ যা আপনি ব্যবহার করতে পারেন:

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

routeAttributes ক্ষেত্র সংজ্ঞায়িত করার সময় পরবর্তী নির্দেশিকা অনুসরণ করুন:

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

তারপরে আপনি নিম্নলিখিত উপায়ে রোডস ম্যানেজমেন্ট ইনসাইটসের মধ্যে এই কাস্টম 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"