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

تعرض 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: 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)
• فرنسا
• ألمانيا (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)