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

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

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

يعرض الرمز التالي طلبًا لمسار صديق للبيئة. في هذا المثال، يمكنك استخدام قناع حقل الاستجابة لعرض سمات الاستجابة المرتبطة بمسار صديق للبيئة مع السمتَين 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)
• أستراليا (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)
• إسبانيا
• السويد (SE)
• سويسرا (CH)
• تركيا (TR)
• الإمارات العربية المتحدة (AE)
• المملكة المتحدة
• الولايات المتحدة (US)

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

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

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