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

כברירת מחדל, 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 API.

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

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

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

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

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

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

  • routes.routeToken: אסימון מסלול שאפשר להעביר אל ניווט ב-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 פועל בהתמדה לשיפור מפות 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)