מסלול ידידותי לסביבה

מפתחים באזור הכלכלי האירופי (EEA)

כברירת מחדל, Routes API מחזיר את המסלול הברירת מחדל, כלומר מסלול שלא מביא בחשבון את צריכת הדלק או היעילות האנרגטית. כשמפעילים ניתוב ידידותי לסביבה, עדיין מקבלים את מסלול ברירת המחדל בתשובה. בנוסף, תקבלו גם מסלול ידידותי לסביבה שמציג את המסלול הכי חסכוני בדלק או באנרגיה על סמך סוג המנוע של הרכב.

המסלול הידידותי לסביבה שמוחזר על ידי Routes API מותאם לצריכת דלק נמוכה יותר לאורך כל המסלול. ה-API משתמש בסוג המנוע של הרכב, וגם בגורמים אחרים כמו מצב התנועה בזמן אמת ותנאי הדרך, כדי לבחור את המסלול הידידותי לסביבה. ככל שהמסלול יותר חסכוני בדלק או באנרגיה, כך צריכת הדלק או האנרגיה ופליטות הפחמן הדו-חמצני של הרכב נמוכות יותר.

לדוגמה, מבחינת חיסכון בדלק, לרכבים עם מנוע דיזל יש יתרון יחסי בנסיעות בכביש מהיר. כלי רכב היברידיים וחשמליים הם חסכוניים יותר בנסיעות עירוניות שמאופיינות בעצירות תכופות ובסביבות שיש בהן הרבה עליות וירידות. בתנאים כאלה, כלי רכב מהסוג הזה מאפשרים לכם ליהנות מהיתרונות של הבלימה הרגנרטיבית.

אפשר גם לבקש שה-API יחזיר את הערכת צריכת הדלק לכל המסלול. ההערכות של צריכת הדלק נועדו להשוואה בין מסלולים שונים, ולא כהערכות מדויקות של צריכת הדלק ברכב שלכם.

איך מחושבת צריכת הדלק במפות Google

‫Routes API מחשב את צריכת הדלק על סמך תובנות שהתקבלו מהמעבדה הלאומית לאנרגיה מתחדשת של משרד האנרגיה האמריקאי ונתונים מהסוכנות האירופית לאיכות הסביבה. החישוב הזה כולל גורמים שמשפיעים על צריכת הדלק והאנרגיה ועל פליטות הפחמן הדו-חמצני, למשל:

  • הצריכה הממוצעת של דלק או אנרגיה בכלי רכב באזור שלכם
  • השיפועים של העליות והירידות במסלול שלכם
  • המאפיינים של פקקי התנועה
  • סוגי הכבישים (למשל: דרכים עירוניות או בין-עירוניות)

ה-Routes API מחזיר את המסלול הכי חסכוני בדלק או באנרגיה אם זמן ההגעה במסלול הזה דומה, פחות או יותר, לזמן ההגעה במסלול שמוגדר כברירת מחדל. אם מדובר בחיסכון קטן מדי בדלק או באנרגיה או אם זמן הנסיעה ארוך יותר בצורה משמעותית, ה-API מציג את החיסכון היחסי בדלק או באנרגיה במסלולים השונים, כדי לעזור לכם להחליט.

מידע נוסף על הטכנולוגיה של המסלולים הידידותיים לסביבה (מסמך PDF).

דרישות מוקדמות

כדי להשתמש במסלולים ידידותיים לסביבה או להעריך את צריכת הדלק:

  • צריך לציין את TRAFFIC_AWARE_OPTIMAL כהעדפה לניתוב. במצב הזה, השרת מבצע חיפוש מקיף יותר של רשת הכבישים כדי למצוא את המסלול האופטימלי. מידע נוסף זמין במאמר בנושא הגדרת האיכות לעומת זמן האחזור.

  • צריך להגדיר את travelMode לערך DRIVE. בקשות לכל אמצעי תחבורה אחר יחזירו שגיאה.

  • צריך להגדיר מיקום לנקודת המוצא באזור נתמך. אחרת, ה-API מחזיר שגיאה.

  • המסלול לא יכול להכיל נקודת ביניים.

חיוב

בדרך כלל, בפלטפורמה של מפות Google לא נגבה תשלום על שימוש בתכונת תצוגה מקדימה. עם זאת, כדי להשתמש במסלולים ידידותיים לסביבה ולחשב את צריכת הדלק, צריך לציין את TRAFFIC_AWARE_OPTIMAL כהעדפת המסלול, ולכן החיוב מתבצע על סמך מק"ט: Compute Routes Pro.

מידע נוסף על חיוב ב-Routes API

בקשה למסלול ידידותי לסביבה

כדי לשלוח בקשה לחישוב מסלול ידידותי לסביבה, מגדירים את המאפיינים הבאים בבקשה:

  • מציינים את הערך emissionType לרכב באמצעות הערכים שמוגדרים בVehicleEmissionType: DIESEL,‏ GASOLINE,‏ ELECTRIC או HYBRID. ערך ברירת המחדל הוא GASOLINE.

  • מגדירים את requestedReferenceRoutes להיות FUEL_EFFICIENT.

  • מגדירים מסכת שדות של תגובה שמציינת להחזיר את מאפייני התגובה שמשויכים למסלול ידידותי לסביבה:

    • ‫routes.routeLabels: מזהה כל מסלול כDEFAULT_ROUTE,‏ FUEL_EFFICIENT או DEFAULT_ROUTE_ALTERNATE.

    • routes.routeToken: טוקן מסלול שאפשר להעביר אל Navigation 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, ה-API ממיר את צריכת החשמל והדלק למיקרוליטרים של דלק.

    אם הערך של emissionType הוא ELECTRIC, ה-API ממיר את צריכת החשמל למיקרוליטרים של דלק.

  • מגדירים אנונימיזציה של שדות בתגובה שמציינת להחזיר את מאפייני התגובה שמשויכים לשימוש בדלק: 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 פועל כל הזמן כדי לשפר את הכיסוי הבינלאומי של שירותי ה-API שלנו. הרשימה הבאה מציגה את פרטי הכיסוי העדכניים של ניתוב ידידותי לסביבה, לפי מדינה:

  • אלבניה (AL)
  • אוסטרליה (AU)
  • אוסטריה (AT)
  • בלגיה
  • בוסניה והרצגובינה (BA)
  • בולגריה (BG)
  • קנדה (CA)
  • קרואטיה
  • קפריסין (CY)
  • צ'כיה (CZ)
  • דנמרק (DK)
  • מצרים (EG)
  • אסטוניה (EE)
  • פינלנד (FI)
  • צרפת (FR)
  • גרמניה (DE)
  • יוון
  • הונגריה (HU)
  • איסלנד (IS)
  • הודו (IN)
  • אינדונזיה (ID)
  • אירלנד (IE)
  • איטליה (IT)
  • קוסובו (XK)
  • לטביה (LV)
  • ליכטנשטיין (LI)
  • ליטא (LT)
  • לוקסמבורג (LU)
  • מלטה (MT)
  • מקסיקו (MX)
  • מונטנגרו (ME)
  • הולנד (NL)
  • מקדוניה הצפונית (MK)
  • נורווגיה (NO)
  • פולין (PL)
  • פורטוגל
  • רומניה (RO)
  • ערב הסעודית (SA)
  • סרביה (RS)
  • סלובקיה (SK)
  • סלובניה (SI)
  • ספרד (ES)
  • שוודיה (SE)
  • שווייץ (CH)
  • טורקיה (TR)
  • איחוד האמירויות הערביות (AE)
  • בריטניה (GB)
  • ארצות הברית (US)