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

تم تحسين المسار الصديق للبيئة الذي تعرضه واجهة برمجة التطبيقات 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: رمز تعريف مسار يمكنك تمريره إلى حزمة تطوير البرامج للتنقّل لاسترداد مسار مخصّص

مثال على طلب صديق للبيئة

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

• ألبانيا (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)