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

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

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

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

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

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

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

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

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

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

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

لاستخدام ميزة "المسار الصديق للبيئة" أو تقدير استهلاك الوقود، اتّبِع الخطوات التالية:

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

• يجب ضبط travelMode على DRIVE أو TWO_WHEELER. سيؤدي طلب أي وسيلة نقل أخرى إلى ظهور خطأ. تتوفّر ميزة "تحديد المسار المراعي للبيئة" في TWO_WHEELER في بعض البلدان فقط.

• يجب ضبط موقع جغرافي لنقطة طريق المصدر في منطقة تتوفّر فيها هذه الميزة. وفي حال عدم توفّرها، ستعرض واجهة برمجة التطبيقات رسالة خطأ.

• بالنسبة إلى TWO_WHEELER، يجب ضبط موقع جغرافي لنقطة الانطلاق في منطقة تتوفّر فيها المركبات ذات العجلتين. بخلاف ذلك، ستعرض واجهة برمجة التطبيقات رسالة خطأ.

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

الفوترة

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

  إذا كانت قيمة 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)
• مصر (EG)
• إستونيا (EE)
• فنلندا (FI)
• فرنسا
• ألمانيا (DE)
• اليونان (GR)
• المجر (HU)
• أيسلندا (IS)
• الهند
• إندونيسيا (ID)
• أيرلندا (IE)
• إيطاليا
• كوسوفو (XK)
• لاتفيا (LV)
• ليختنشتاين (LI)
• ليتوانيا (LT)
• لوكسمبورغ (LU)
• مالطا (MT)
• المكسيك
• الجبل الأسود (ME)
• هولندا (NL)
• مقدونيا الشمالية (MK)
• النرويج (NO)
• بولندا (PL)
• البرتغال (PT)
• رومانيا (RO)
• المملكة العربية السعودية (SA)
• صربيا (RS)
• سلوفاكيا (SK)
• سلوفينيا (SI)
• إسبانيا
• السويد (SE)
• سويسرا (CH)
• تركيا (TR)
• الإمارات العربية المتحدة (AE)
• المملكة المتحدة
• الولايات المتحدة الأمريكية (US)

المناطق التي تتوفّر فيها ميزة "المركبات ذات العجلتين"

تعرض القائمة التالية أحدث تفاصيل التغطية، حسب البلد، لخدمة "التوجيه المراعي للبيئة" الخاصة بالمركبات ذات العجلتين:

• الهند
• إندونيسيا (ID)