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

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

  • אלבניה (אלבניה)
  • אוסטריה
  • בלגיה
  • בוסניה והרצגובינה (BA)
  • בולגריה
  • קנדה
  • קרואטיה
  • קפריסין (CY)
  • צ'כיה
  • דנמרק
  • אסטוניה
  • פינלנד
  • צרפת (FR)
  • גרמניה
  • יוון
  • הונגריה
  • איסלנד
  • אירלנד
  • איטליה
  • קוסובו (XK)
  • לטביה
  • ליכטנשטיין (LI)
  • ליטא
  • לוקסמבורג
  • מלטה
  • מונטנגרו (ME)
  • הולנד
  • מקדוניה הצפונית (MK)
  • נורווגיה
  • פולין
  • פורטוגל
  • רומניה
  • סרביה (RS)
  • סלובקיה (SK)
  • סלובניה
  • ספרד
  • שוודיה
  • שווייץ
  • טורקיה (TR)
  • בריטניה (GB)
  • ארצות הברית (US)