یک مسیر سازگار با محیط زیست دریافت کنید

توسعه دهندگان منطقه اقتصادی اروپا (EEA).

به‌طور پیش‌فرض، Routes API مسیر پیش‌فرض را برمی‌گرداند، یعنی مسیری بدون فاکتورگیری در مصرف سوخت یا مصرف انرژی. وقتی مسیریابی سازگار با محیط زیست را فعال می‌کنید، همچنان مسیر پیش‌فرض را در پاسخ دریافت می‌کنید. علاوه بر این، مسیری سازگار با محیط زیست را نیز دریافت می‌کنید که بر اساس نوع موتور وسیله نقلیه‌تان، مسیر کم‌مصرف یا کم مصرف را نشان می‌دهد.

مسیر سازگار با محیط زیست که توسط Routes API بازگردانده شده است برای مصرف سوخت کمتر در کل مسیر بهینه شده است. API از نوع موتور وسیله نقلیه شما همراه با عوامل دیگری مانند ترافیک لحظه ای و شرایط جاده برای انتخاب مسیر سازگار با محیط زیست استفاده می کند. هرچه مسیر سوخت یا انرژی کارآمدتر باشد، مصرف سوخت یا انرژی خودرو و انتشار CO2 کمتر است.

به عنوان مثال، مزیت مصرف سوخت نسبی خودروهای دیزلی معمولاً در رانندگی در بزرگراه ها بیشترین است. خودروهای هیبریدی و الکتریکی تمایل دارند به تدریج کارایی بیشتری را در محیط‌های رانندگی در شهر توقف و حرکت و رانندگی در تپه فراهم کنند، جایی که می‌توانند به طور گسترده از ترمز احیاکننده استفاده کنند و از آن بهره ببرند.

همچنین می توانید درخواست کنید که API مصرف سوخت تخمینی را برای کل مسیر برگرداند. از تخمین مصرف سوخت به عنوان راهی برای مقایسه مسیرهای مختلف استفاده کنید، نه به عنوان تخمین صریح مصرف سوخت برای خودروی خود.

نقشه گوگل چگونه کارایی سوخت را تخمین می زند

Routes API با استفاده از بینش آزمایشگاه ملی انرژی های تجدیدپذیر وزارت انرژی ایالات متحده و داده های آژانس محیط زیست اروپا، کارایی سوخت را تخمین می زند. این محاسبه شامل عواملی است که بر مصرف سوخت و انرژی و انتشار CO2 شما تأثیر می گذارد، مانند:

  • میانگین مصرف سوخت یا انرژی برای وسایل نقلیه در منطقه شما
  • شیب تپه ها در مسیر شما
  • الگوهای ترافیکی توقف و حرکت
  • انواع جاده ها (مانند جاده های محلی یا بزرگراه ها)

Routes API زمانی که تقریباً همان زمان رسیدن را با مسیر پیش‌فرض داشته باشد، بیشترین مصرف سوخت یا انرژی را برمی‌گرداند. در مواردی که صرفه جویی در سوخت یا انرژی بسیار کم است یا زمان رانندگی را به میزان قابل توجهی افزایش می دهد، API صرفه جویی نسبی سوخت یا انرژی را بین مسیرها نشان می دهد تا به شما در مقایسه کمک کند.

درباره فناوری مسیریابی سازگار با محیط زیست (PDF) بیشتر بخوانید .

پیش نیازها

برای استفاده از مسیریابی سازگار با محیط زیست یا تخمین مصرف سوخت:

  • شما باید TRAFFIC_AWARE_OPTIMAL به عنوان اولویت مسیریابی مشخص کنید. در این حالت سرور جستجوی جامع تری در شبکه جاده ها انجام می دهد تا مسیر بهینه را پیدا کند. برای اطلاعات بیشتر، پیکربندی کیفیت در مقابل تأخیر را ببینید.

  • باید travelMode روی DRIVE یا TWO_WHEELER تنظیم کنید. درخواست برای هر حالت سفر دیگری یک خطا را نشان می دهد. مسیریابی سازگار با محیط زیست برای TWO_WHEELER فقط در چند کشور پشتیبانی می شود.

  • شما باید یک مکان برای نقطه راه مبدا در یک منطقه پشتیبانی شده تنظیم کنید. در غیر این صورت، API یک خطا برمی گرداند.

  • برای TWO_WHEELER ، باید مکانی را برای نقطه راه مبدا در یک منطقه پشتیبانی شده از دو چرخ تنظیم کنید. در غیر این صورت، API یک خطا برمی گرداند.

  • مسیر نمی تواند شامل یک ایستگاه بین راهی باشد.

صورتحساب

به طور معمول، Google Maps Platform برای استفاده از یک ویژگی Preview هزینه ای دریافت نمی کند. با این حال، از آنجایی که مسیریابی سازگار با محیط زیست و تخمین مصرف سوخت مستلزم آن است که TRAFFIC_AWARE_OPTIMAL به عنوان اولویت مسیریابی مشخص کنید، هزینه شما بر اساس SKU: Compute Routes Pro محاسبه می شود.

درباره صورتحساب برای Routes API بیشتر بیاموزید .

درخواست یک مسیر سازگار با محیط زیست

برای ایجاد درخواست برای محاسبه مسیر دوستدار محیط زیست، ویژگی های زیر را در درخواست تنظیم کنید:

  • emissionType برای خودرو با استفاده از مقادیر تعریف شده در VehicleEmissionType مشخص کنید: DIESEL ، GASOLINE ، ELECTRIC یا HYBRID . مقدار پیش فرض GASOLINE است.

  • requestedReferenceRoutes روی FUEL_EFFICIENT تنظیم کنید.

  • یک ماسک فیلد پاسخ را تنظیم کنید که مشخص می‌کند ویژگی‌های پاسخ مرتبط با یک مسیر سازگار با محیط زیست را بازگرداند:

    • routes.routeLabels: هر مسیر را به‌عنوان DEFAULT_ROUTE ، FUEL_EFFICIENT ، یا DEFAULT_ROUTE_ALTERNATE شناسایی می‌کند.

    • routes.routeToken: یک نشانه مسیر که می توانید برای بازیابی یک مسیر سفارشی به Navigation 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 تنظیم کنید.

  • emissionType برای خودرو با استفاده از مقادیر تعریف شده در VehicleEmissionType مشخص کنید: DIESEL ، GASOLINE ، ELECTRIC یا HYBRID . مقدار پیش فرض GASOLINE است.

    اگر emissionType HYBRID باشد، API برق و مصرف سوخت را به میکرولیتر سوخت تبدیل می کند.

    اگر emissionType ELECTRIC باشد، API مصرف برق را به میکرولیتر سوخت تبدیل می کند.

  • یک ماسک فیلد پاسخ تنظیم کنید که مشخص می‌کند ویژگی‌های پاسخ مرتبط با مصرف سوخت را بازگرداند: 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 Platform به طور مداوم در تلاش است تا پوشش بین المللی خدمات API ما را بهبود بخشد. لیست زیر آخرین جزئیات پوشش را بر اساس کشور به کشور، برای مسیریابی سازگار با محیط زیست نشان می دهد:

  • آلبانی (AL)
  • استرالیا (AU)
  • اتریش (AT)
  • بلژیک (BE)
  • بوسنی و هرزگوین (BA)
  • بلغارستان (BG)
  • کانادا (CA)
  • کرواسی (HR)
  • قبرس (CY)
  • چک (CZ)
  • دانمارک (DK)
  • مصر (EG)
  • استونی (EE)
  • فنلاند (FI)
  • فرانسه (FR)
  • آلمان (DE)
  • یونان (GR)
  • مجارستان (HU)
  • ایسلند (IS)
  • هند (IN)
  • اندونزی (ID)
  • ایرلند (IE)
  • ایتالیا (IT)
  • کوزوو (XK)
  • لتونی (LV)
  • لیختن اشتاین (LI)
  • لیتوانی (LT)
  • لوکزامبورگ (LU)
  • مالت (MT)
  • مکزیک (MX)
  • مونته نگرو (ME)
  • هلند (NL)
  • مقدونیه شمالی (MK)
  • نروژ (NO)
  • لهستان (PL)
  • پرتغال (PT)
  • رومانی (RO)
  • عربستان سعودی (SA)
  • صربستان (RS)
  • اسلواکی (SK)
  • اسلوونی (SI)
  • اسپانیا (ES)
  • سوئد (SE)
  • سوئیس (CH)
  • ترکیه (TR)
  • امارات متحده عربی (AE)
  • بریتانیا (GB)
  • ایالات متحده (ایالات متحده آمریکا)

مناطق پشتیبانی شده از دو چرخ

لیست زیر آخرین جزئیات پوشش را بر اساس کشور به کشور، برای مسیریابی دوستدار محیط زیست دو چرخ نشان می دهد:

  • هند (IN)
  • اندونزی (ID)