একটি পরিবেশ বান্ধব রুট পান

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

Routes API দ্বারা ফিরে আসা পরিবেশ-বান্ধব রুট সমগ্র রুটে কম জ্বালানী খরচের জন্য অপ্টিমাইজ করা হয়েছে। পরিবেশ-বান্ধব রুট বেছে নেওয়ার জন্য API আপনার গাড়ির ইঞ্জিনের ধরন ব্যবহার করে যেমন রিয়েল-টাইম ট্র্যাফিক এবং রাস্তার অবস্থার মতো অন্যান্য কারণগুলি। রুট যত বেশি জ্বালানি বা শক্তি সাশ্রয়ী হবে, আপনার গাড়ির জ্বালানি/শক্তি ব্যবহার এবং CO2 নির্গমন তত কম হবে।

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

আপনি অনুরোধ করতে পারেন যে API পুরো রুটের জন্য আনুমানিক জ্বালানী খরচ ফেরত দেয়। বিভিন্ন রুট তুলনা করার উপায় হিসাবে জ্বালানী খরচ অনুমান ব্যবহার করুন, আপনার সঠিক গাড়ির জন্য স্পষ্ট জ্বালানী ব্যবহারের অনুমান হিসাবে নয়।

কিভাবে Google Maps জ্বালানী দক্ষতা অনুমান করে

ইউএস ডিপার্টমেন্ট অফ এনার্জি-এর জাতীয় পুনর্নবীকরণযোগ্য শক্তি ল্যাবরেটরির অন্তর্দৃষ্টি এবং ইউরোপীয় পরিবেশ সংস্থার ডেটা ব্যবহার করে রুট এপিআই জ্বালানী-দক্ষতা অনুমান করে৷ এই গণনায় আপনার জ্বালানী এবং শক্তির ব্যবহার এবং CO2 নির্গমনকে প্রভাবিত করে এমন কারণগুলি অন্তর্ভুক্ত করে, যেমন:

  • আপনার অঞ্চলে যানবাহনের জন্য গড় জ্বালানি বা শক্তি খরচ
  • আপনার পথে পাহাড়ের খাড়াতা
  • থামুন এবং যান ট্রাফিক নিদর্শন
  • রাস্তার ধরন (যেমন স্থানীয় রাস্তা বা হাইওয়ে)

রুট এপিআই সবচেয়ে জ্বালানি বা শক্তি-দক্ষ রুট ফেরত দেয় যখন এটির ডিফল্ট রুটের মতো প্রায় একই আগমনের সময় থাকে। যে ক্ষেত্রে জ্বালানী বা শক্তি সঞ্চয় খুব কম বা ড্রাইভিং সময় উল্লেখযোগ্যভাবে বৃদ্ধি করে, API আপনাকে তুলনা করতে সাহায্য করার জন্য রুটের মধ্যে আপেক্ষিক জ্বালানী বা শক্তি সঞ্চয় দেখায়।

পরিবেশ বান্ধব রাউটিং প্রযুক্তি (PDF) সম্পর্কে আরও পড়ুন ।

পূর্বশর্ত

পরিবেশ বান্ধব রাউটিং ব্যবহার করতে বা জ্বালানী খরচ অনুমান করতে:

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

  • আপনাকে অবশ্যই DRIVE travelMode সেট করতে হবে। অন্য কোনো ভ্রমণ মোডের জন্য অনুরোধ একটি ত্রুটি ফেরত.

  • আপনাকে অবশ্যই একটি সমর্থিত অঞ্চলে মূল পথপয়েন্টের জন্য একটি অবস্থান সেট করতে হবে৷ অন্যথায়, API একটি ত্রুটি প্রদান করে।

  • রুটে একটি মধ্যবর্তী পথপয়েন্ট থাকতে পারে না।

বিলিং

সাধারণত, Google মানচিত্র প্ল্যাটফর্ম একটি পূর্বরূপ বৈশিষ্ট্য ব্যবহারের জন্য চার্জ করে না। যাইহোক, যেহেতু পরিবেশ বান্ধব রাউটিং এবং জ্বালানী খরচ অনুমান করার জন্য আপনাকে রাউটিং পছন্দ হিসাবে TRAFFIC_AWARE_OPTIMAL নির্দিষ্ট করতে হবে, তাই আপনাকে SKU: রুট অ্যাডভান্সড এর উপর ভিত্তি করে চার্জ করা হবে।

রুট API-এর জন্য বিলিং সম্পর্কে আরও জানুন ।

একটি পরিবেশ বান্ধব রুট অনুরোধ

একটি পরিবেশ-বান্ধব রুট গণনা করার জন্য অনুরোধ করতে, অনুরোধে নিম্নলিখিত বৈশিষ্ট্যগুলি সেট করুন:

  • VehicleEmissionType- এ সংজ্ঞায়িত মানগুলি ব্যবহার করে গাড়ির জন্য emissionType নির্দিষ্ট করুন: DIESEL , GASOLINE , ELECTRIC , বা HYBRID । ডিফল্ট মান হল GASOLINE ।

  • requestedReferenceRoutes FUEL_EFFICIENT এ সেট করুন।

  • একটি প্রতিক্রিয়া ক্ষেত্র মাস্ক সেট করুন যা একটি পরিবেশ-বান্ধব রুটের সাথে সম্পর্কিত প্রতিক্রিয়া বৈশিষ্ট্যগুলি ফেরত দিতে নির্দিষ্ট করে:

    • routes.routeLabels: প্রতিটি রুটকে DEFAULT_ROUTE , FUEL_EFFICIENT , বা DEFAULT_ROUTE_ALTERNATE হিসাবে চিহ্নিত করে।

    • routes.routeToken: একটি রুট টোকেন যা আপনি একটি কাস্টম রুট পুনরুদ্ধার করতে নেভিগেশন SDK- তে যেতে পারেন।

উদাহরণ পরিবেশ বান্ধব অনুরোধ

নিম্নলিখিত কোড একটি পরিবেশ বান্ধব রুট জন্য একটি অনুরোধ দেখায়. এই উদাহরণে, আপনি routes.distanceMeters এবং routes.duration বৈশিষ্ট্য সহ একটি পরিবেশ-বান্ধব রুটের সাথে সম্পর্কিত প্রতিক্রিয়া বৈশিষ্ট্যগুলি ফেরত দিতে প্রতিক্রিয়া ক্ষেত্র মাস্ক ব্যবহার করেন:

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "routeModifiers": {
    "vehicleInfo": {
      "emissionType": "GASOLINE"
    }
  },
  "travelMode":"DRIVE",
  "routingPreference": "TRAFFIC_AWARE_OPTIMAL",
  "requestedReferenceRoutes": ["FUEL_EFFICIENT"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

উদাহরণ পরিবেশ বান্ধব প্রতিক্রিয়া

উপরের computeRoutes কলটি একটি JSON প্রতিক্রিয়া তৈরি করে যাতে দুটি রুট থাকে: ডিফল্ট রুট এবং জ্বালানী সাশ্রয়ী রুট। প্রতিক্রিয়ায়:

  • ডিফল্ট রুটের জন্য, routeLabels অ্যারে বৈশিষ্ট্যে DEFAULT_ROUTE থাকে।

  • পরিবেশ-বান্ধব রুটের জন্য, routeLabels অ্যারে বৈশিষ্ট্যে FUEL_EFFICIENT রয়েছে।

  • যদি আপনি বিকল্প রুট গণনা করার অনুরোধে computeAlternativeRoutes true সেট করেন, তাহলে routeLabels অ্যারে বৈশিষ্ট্যে DEFAULT_ROUTE_ALTERNATE থাকে।

{
    "routes": [
        {
            "distanceMeters": 138939,
            "duration": "5412s",
            "routeToken": "CoYJCpoIC…0n9S1cu",
            "routeLabels": [
                "DEFAULT_ROUTE"
            ]
        },
        {
            "distanceMeters": 116887,
            "duration": "5631s",
            "routeToken": "CuEHCu0G…xqm",
            "routeLabels": [
                "FUEL_EFFICIENT"
            ]
        }
    ]
}

বর্তমান ড্রাইভিং অবস্থা এবং অন্যান্য কারণের কারণে, ডিফল্ট রুট এবং পরিবেশ বান্ধব রুট একই হতে পারে। এই ক্ষেত্রে, routeLabels উভয় লেবেল থাকে: DEFAULT_ROUTE এবং FUEL_EFFICIENT :

{
  "routes": [
    {
      "distanceMeters": 45875,
      "duration": "2655s",
      "routeToken": "CvcDCos…6I40",
      "routeLabels": [
        "DEFAULT_ROUTE",
        "FUEL_EFFICIENT"
      ]
    }
  ]
}

রুটের জন্য জ্বালানী ব্যবহার অনুমান করুন

আপনি মাইক্রোলিটারে সমগ্র রুটের জন্য আনুমানিক জ্বালানি ব্যবহার ফেরত দেওয়ার জন্য পদ্ধতিটিকে অনুরোধ করতে পারেন। প্রতিক্রিয়াতে একটি রুটের জন্য আনুমানিক জ্বালানী ব্যবহার যোগ করতে:

  • জ্বালানী ব্যবহার গণনা সক্ষম করতে extraComputations অ্যারে ফিল্ড FUEL_CONSUMPTION এ সেট করুন৷

  • VehicleEmissionType- এ সংজ্ঞায়িত মানগুলি ব্যবহার করে গাড়ির জন্য emissionType নির্দিষ্ট করুন: DIESEL , GASOLINE , ELECTRIC , বা HYBRID । ডিফল্ট মান হল GASOLINE ।

    যদি emissionType HYBRID হয়, তাহলে এপিআই বিদ্যুৎ এবং জ্বালানি খরচকে জ্বালানির মাইক্রোলিটারে রূপান্তর করে।

    যদি emissionType ELECTRIC হয়, তাহলে এপিআই বিদ্যুতের খরচকে জ্বালানির মাইক্রোলিটারে রূপান্তর করে।

  • একটি প্রতিক্রিয়া ক্ষেত্র মাস্ক সেট করুন যা জ্বালানী ব্যবহারের সাথে সম্পর্কিত প্রতিক্রিয়া বৈশিষ্ট্যগুলি ফেরত দিতে নির্দিষ্ট করে: routes.travelAdvisory.fuelConsumptionMicroliters ।

নিম্নলিখিত উদাহরণটি একটি অনুরোধের অংশ হিসাবে আনুমানিক জ্বালানী ব্যবহারের অনুরোধ করে যাতে পরিবেশ-বান্ধব রুটও অন্তর্ভুক্ত থাকে:

curl -X POST -H 'content-type: application/json' -d '{
  "origin": {
    "location": {
      "latLng": {
        "latitude": 41.76904801292959,
        "longitude": -72.67374935684933
      }
    }
  },
  "destination": {
    "location": {
      "latLng": {
        "latitude": 41.823042361105024,
        "longitude": -71.40933143059424
      }
    }
  },
  "routeModifiers": {
    "vehicleInfo": {
      "emissionType": "GASOLINE"
    }
  },
  "travelMode":"DRIVE",
  "routingPreference": "TRAFFIC_AWARE_OPTIMAL",
  "extraComputations": ["FUEL_CONSUMPTION"],
  "requestedReferenceRoutes": ["FUEL_EFFICIENT"]
}' \
-H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken,routes.travelAdvisory.fuelConsumptionMicroliters' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

প্রতিক্রিয়াটিতে ডিফল্ট রুট এবং পরিবেশ বান্ধব রুট উভয়ের জন্য আনুমানিক জ্বালানী খরচ রয়েছে:

{
    "routes": [
        {
            "distanceMeters": 138939,
            "duration": "5412s",
            "travelAdvisory": {
                "fuelConsumptionMicroliters": "11019554"
            },
            "routeToken": "CoYJCpoIC…0n9S1cu",
            "routeLabels": [
                "DEFAULT_ROUTE"
            ]
        },
        {
            "distanceMeters": 116887,
            "duration": "5631s",
            "travelAdvisory": {
                "fuelConsumptionMicroliters": "9572436"
            },
            "routeToken": "CuEHCu0G…xqm",
            "routeLabels": [
                "FUEL_EFFICIENT"
            ]
        }
    ]
}

সমর্থিত অঞ্চল

Google Maps প্ল্যাটফর্ম টিম আমাদের API পরিষেবাগুলির জন্য আন্তর্জাতিক কভারেজ উন্নত করার জন্য ক্রমাগত কাজ করছে৷ পরিবেশ বান্ধব রাউটিং-এর জন্য নিম্নোক্ত তালিকাটি দেশ-বিদেশের ভিত্তিতে সর্বশেষ কভারেজের বিবরণ দেখায়:

  • আলবেনিয়া (AL)
  • অস্ট্রিয়া (AT)
  • বেলজিয়াম (BE)
  • বসনিয়া ও হার্জেগোভিনা (BA)
  • বুলগেরিয়া (বিজি)
  • কানাডা (CA)
  • ক্রোয়েশিয়া (এইচআর)
  • সাইপ্রাস (CY)
  • চেকিয়া (সিজেড)
  • ডেনমার্ক (DK)
  • এস্তোনিয়া (EE)
  • ফিনল্যান্ড (FI)
  • ফ্রান্স (FR)
  • জার্মানি (DE)
  • গ্রীস (GR)
  • হাঙ্গেরি (HU)
  • আইসল্যান্ড (IS)
  • আয়ারল্যান্ড (IE)
  • ইতালি (আইটি)
  • কসোভো (XK)
  • লাটভিয়া (LV)
  • লিচেনস্টাইন (LI)
  • লিথুয়ানিয়া (LT)
  • লুক্সেমবার্গ (LU)
  • মাল্টা (MT)
  • মন্টিনিগ্রো (ME)
  • নেদারল্যান্ডস (NL)
  • উত্তর মেসিডোনিয়া (MK)
  • নরওয়ে (NO)
  • পোল্যান্ড (PL)
  • পর্তুগাল (PT)
  • রোমানিয়া (RO)
  • সার্বিয়া (RS)
  • স্লোভাকিয়া (SK)
  • স্লোভেনিয়া (SI)
  • স্পেন (ES)
  • সুইডেন (SE)
  • সুইজারল্যান্ড (CH)
  • তুরস্ক (TR)
  • যুক্তরাজ্য (GB)
  • মার্কিন যুক্তরাষ্ট্র (মার্কিন যুক্তরাষ্ট্র)