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

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

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

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

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

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

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

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

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

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

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

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

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

• يجب ضبط travelMode على DRIVE. تعرض طلبات أي وضع سفر آخر خطأً.

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

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

الإذن بالوصول إلى الفوترة

لا تفرض "منصة خرائط Google" عادةً رسومًا مقابل استخدام ميزة المعاينة. ومع ذلك، بما أنّ التوجيه إلى المسار الصديق للبيئة وتقدير استهلاك الوقود يتطلبان تحديد TRAFFIC_AWARE_OPTIMAL على أنّه الخيار المفضّل للتوجيه، يتم تحصيل الرسوم منك استنادًا إلى رمز التخزين التعريفي SKU: المسارات المتقدم.

يمكنك الاطّلاع على مزيد من المعلومات حول الفوترة في 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: 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)
• إستونيا (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)