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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

חיוב

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

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

• אלבניה (AL)
• אוסטריה (AT)
• בלגיה (BE)
• בוסניה והרצגובינה (BA)
• בולגריה (BG)
• קנדה (CA)
• קרואטיה (HR)
• קפריסין (CY)
• צ'כיה (CZ)
• דנמרק (DK)
• אסטוניה (EE)
• פינלנד (FI)
• צרפת (FR)
• גרמניה (DE)
• יוון (GR)
• הונגריה (HU)
• איסלנד (IS)
• אירלנד (IE)
• איטליה (IT)
• קוסובו (XK)
• לטביה (LV)
• ליכטנשטיין (LI)
• ליטא
• לוקסמבורג (LU)
• מלטה (MT)
• מונטנגרו (ME)
• הולנד (NL)
• מקדוניה הצפונית (MK)
• נורווגיה (NO)
• פולין (PL)
• פורטוגל (PT)
• רומניה (RO)
• סרביה (RS)
• סלובקיה (SK)
• סלובניה (SI)
• ספרד (ES)
• שוודיה (SE)
• שווייץ (CH)
• טורקיה (TR)
• בריטניה (GB)
• ארצות הברית (US)