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

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

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

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