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

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