دریافت مسیر بوم‌سازگار

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

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

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

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

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

Google Maps چگونه بهره‌وری سوخت را تخمین می‌زند

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

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

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

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

پیش‌نیازها

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

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

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

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

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

  • مسیر نمی‌تواند حاوی نقطه‌مسیر میانی باشد.

صورت‌حساب

معمولاً «پلاتفرم Google Maps» برای استفاده از ویژگی «پیش‌نمایش» هزینه‌ای دریافت نمی‌کند. بااین‌حال، چون مسیریابی زیست‌محیطی و برآورد مصرف سوخت مستلزم این است که 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: یک کد مسیر که می‌توانید به کیت توسعه نرم‌افزار پیمایش ارسال کنید تا مسیر سفارشی را بازیابی کنید.

نمونه درخواست بوم‌سازگار

کد زیر درخواستی برای مسیر بوم‌سازگار را نشان می‌دهد. در این مثال، از ماسک فیلد پاسخ برای برگرداندن ویژگی‌های پاسخ مرتبط با مسیر بوم‌سازگار به‌همراه ویژگی‌های 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 باشد، میانای برنامه‌سازی کاربردی مصرف برق و سوخت را به میکرولیتر سوخت تبدیل می‌کند.

    اگر 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 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)
  • ایالات متحده (US)

مناطق پشتیبانی‌شده برای موتورسیکلت

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

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