تعرض 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)