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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

חיוב

בדרך כלל, Google Maps Platform לא מחויבת על שימוש בתכונות בגרסת טרום-השקה (Preview). עם זאת, מכיוון שכדי להשתמש במסלולים ידידותיים לסביבה ובהערכת צריכת הדלק צריך לציין את 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)
  • בלגיה (BE)
  • בוסניה והרצגובינה (BA)
  • בולגריה (BG)
  • קנדה (CA)
  • קרואטיה (HR)
  • קפריסין (CY)
  • צ'כיה (CZ)
  • דנמרק (DK)
  • מצרים (EG)
  • אסטוניה (EE)
  • פינלנד (FI)
  • צרפת (FR)
  • גרמניה (DE)
  • יוון (GR)
  • הונגריה (HU)
  • איסלנד (IS)
  • הודו (IN)
  • אינדונזיה (ID)
  • אירלנד (IE)
  • איטליה (IT)
  • קוסובו (XK)
  • לטביה (LV)
  • ליכטנשטיין (LI)
  • ליטא (LT)
  • לוקסמבורג (LU)
  • מלטה (MT)
  • מקסיקו (MX)
  • מונטנגרו (ME)
  • הולנד (NL)
  • מקדוניה הצפונית (MK)
  • נורווגיה (NO)
  • פולין (PL)
  • פורטוגל (PT)
  • רומניה (RO)
  • ערב הסעודית (SA)
  • סרביה (RS)
  • סלובקיה (SK)
  • סלובניה (SI)
  • ספרד (ES)
  • שוודיה (SE)
  • שווייץ (CH)
  • טורקיה (TR)
  • איחוד האמירויות הערביות (AE)
  • בריטניה (GB)
  • ארצות הברית (US)

אזורים נתמכים לרכב דו-גלגלי

ברשימה הבאה מפורטים הפרטים העדכניים לגבי הכיסוי של מסלולים ידידותיים לסביבה לכלי רכב דו-גלגליים בכל מדינה:

  • הודו (IN)
  • אינדונזיה (ID)