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

כברירת מחדל, 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)
  • ליטא (LT)
  • לוקסמבורג (LU)
  • מלטה (MT)
  • מונטנגרו (ME)
  • הולנד (NL)
  • מקדוניה הצפונית (MK)
  • נורווגיה (NO)
  • פולין (PL)
  • פורטוגל (PT)
  • רומניה (RO)
  • סרביה (RS)
  • סלובקיה (SK)
  • סלובניה (SI)
  • ספרד (ES)
  • שוודיה (SE)
  • שווייץ (CH)
  • טורקיה (TR)
  • בריטניה (GB)
  • ארצות הברית (US)