الحصول على مسار صديق للبيئة

بشكل تلقائي، تعرض Routes API المسار التلقائي، ما يعني المسار بدون احتساب كفاءة استهلاك الوقود أو الطاقة. عند تفعيل التوجيه الصديق للبيئة، سيظل بإمكانك الحصول على المسار التلقائي في الرد. بالإضافة إلى ذلك، يمكنك أيضًا الرجوع إلى مسار صديق للبيئة يعرض المسار الأقل استهلاكًا للوقود أو الطاقة بناءً على نوع محرّك مركبتك.

تم تحسين المسار الصديق للبيئة الذي تعرضه واجهة برمجة التطبيقات Routes API لتقليل استهلاك الوقود على المسار بأكمله. تستخدم واجهة برمجة التطبيقات نوع محرّك مركبتك إلى جانب عوامل أخرى، مثل كثافة حركة المرور في الوقت الفعلي وأحوال الطرق لاختيار المسار الصديق للبيئة. كلما كان المسار أكثر توفيرًا للوقود أو الطاقة، انخفض استهلاك سيارتك للوقود/الطاقة وانبعاثات ثاني أكسيد الكربون.

على سبيل المثال، تعد الميزة النسبية للاقتصاد في استهلاك الوقود لمركبة الديزل بشكل عام الأكثر استخدامًا بشكل عام في القيادة على الطريق السريع. تميل السيارات الهجينة والكهربائية إلى توفير كفاءة أكبر بشكل تدريجي في عمليات القيادة في المدن والقيادة على الطرق الجبلية حيث يمكنها استخدام المكابح المتجددة والاستفادة منها على نطاق واسع.

يمكنك أيضًا أن تطلب من واجهة برمجة التطبيقات عرض الاستهلاك المقدّر للوقود للمسار بكامله. استخدم تقديرات استهلاك الوقود كوسيلة لمقارنة المسارات المختلفة، وليس كتقديرات لاستخدام الوقود بشكل صريح لمركبتك المحددة.

كيفية تقدير "خرائط Google" لكفاءة استهلاك الوقود

تقدّر واجهة برمجة التطبيقات Routes API معدّل استهلاك الوقود استنادًا إلى إحصاءات يوفّرها المختبر الوطني للطاقة المتجددة التابع لوزارة الطاقة الأمريكية وبيانات من "الوكالة الأوروبية للبيئة". تتضمن عملية الحساب هذه العوامل التي تؤثر في استخدام الوقود والطاقة وانبعاثات ثاني أكسيد الكربون، مثل:

• متوسط استهلاك الوقود أو الطاقة للمركبات في منطقتك
• مدى انحدار التلال في مسارك
• أنماط السير والتوقّف في حركة المرور
• أنواع الطرق (مثل الطرق المحلية أو الطرق السريعة)

تعرض Routes API المسار الأقل استهلاكًا للوقود أو الطاقة عندما يكون وقت الوصول فيه مقاربًا للمسار التلقائي. في الحالات التي يكون فيها توفير الوقود أو الطاقة صغيرًا جدًا أو يزيد وقت القيادة بشكل كبير، تعرض واجهة برمجة التطبيقات مقدار التوفير النسبي في الوقود أو الطاقة بين المسارات لمساعدتك في المقارنة.

اطّلع على مزيد من المعلومات عن تكنولوجيا "المسار الصديق للبيئة" (PDF).

المتطلّبات الأساسية

لاستخدام المسار الصديق للبيئة أو تقدير استهلاك الوقود، يُرجى اتّباع الخطوات التالية:

• يجب تحديد TRAFFIC_AWARE_OPTIMAL كإعداد مفضّل للتوجيه. في هذا الوضع، يُجري الخادم بحثًا أكثر شمولاً عن شبكة الطرق للعثور على المسار الأمثل. لمزيد من المعلومات، يرجى الاطّلاع على ضبط الجودة مقابل وقت الاستجابة.

• يجب ضبط السمة travelMode على DRIVE. تعرض طلبات أي وضع سفر آخر خطأ.

• يجب ضبط موقع جغرافي للنقطة الوسيطة للمنشأ في منطقة معتمَدة. بخلاف ذلك، تعرض واجهة برمجة التطبيقات خطأً.

• لا يمكن أن يحتوي المسار على نقطة وسيطة.

الفوترة

لا تفرض "منصة خرائط Google" عادةً أي رسوم على استخدام ميزة "المعاينة". وبما أنّ التوجيه الصديق للبيئة وتقدير استهلاك الوقود يتطلبان تحديد TRAFFIC_AWARE_OPTIMAL كإعداد مفضّل للتوجيه، يتم تحصيل الرسوم منك استنادًا إلى رمز التخزين التعريفي: المسارات المتقدّمة.

مزيد من المعلومات حول الفوترة في Routes API.

طلب مسار صديق للبيئة

لطلب رصد مسار صديق للبيئة، عليك ضبط السمات التالية في الطلب:

• حدِّد السمة emissionType للمركبة باستخدام القيم المحدّدة في VehicleEmissionType: 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 لتفعيل احتساب استخدام الوقود.

• حدِّد السمة 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" باستمرار على تحسين التغطية الدولية لخدمات واجهة برمجة التطبيقات لدينا. توضح القائمة التالية أحدث تفاصيل التغطية، على أساس كل بلد على حدة، للتوجيه الصديق للبيئة:

• ألبانيا (AL)
• النمسا (AT)
• بلجيكا (BE)
• البوسنة والهرسك (BA)
• بلغاريا (BG)
• كندا
• كرواتيا (HR)
• قبرص (CY)
• تشيكيا (CZ)
• الدانمرك (DK)
• إستونيا (EE)
• فنلندا (FI)
• فرنسا
• ألمانيا (DE)
• اليونان (GR)
• هنغاريا (HU)
• أيسلندا (IS)
• أيرلندا (IE)
• إيطاليا
• كوسوفو (XK)
• لاتفيا (LV)
• ليختنشتاين (LI)
• ليتوانيا (LT)
• لوكسمبورغ (LU)
• مالطا (MT)
• الجبل الأسود (ME)
• هولندا (NL)
• مقدونيا الشمالية (MK)
• النرويج (NO)
• بولندا (PL)
• البرتغال (PT)
• رومانيا (RO)
• صربيا (RS)
• سلوفاكيا (SK)
• سلوفينيا (SI)
• إسبانيا
• السويد (SE)
• سويسرا (CH)
• تركيا (TR)
• المملكة المتحدة
• الولايات المتحدة الأمريكية (US)