รับเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม

โดยค่าเริ่มต้น Routes API จะแสดงเส้นทางเริ่มต้น ซึ่งหมายถึงเส้นทางที่ไม่มีปัจจัยในการประหยัดเชื้อเพลิงหรือพลังงาน เมื่อเปิดใช้การกำหนดเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม คุณจะยังคงได้รับเส้นทางเริ่มต้นในการตอบกลับ นอกจากนี้ คุณยังจะได้รับเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมซึ่งแสดงเส้นทางที่ประหยัดเชื้อเพลิงหรือพลังงานมากที่สุดโดยอิงตามประเภทเครื่องยนต์ของรถ

เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมที่ Routes API ส่งคืนจะได้รับการเพิ่มประสิทธิภาพเพื่อการบริโภคเชื้อเพลิงลดลงตลอดทั้งเส้นทาง API นี้ใช้ประเภทเครื่องยนต์รถของคุณร่วมกับปัจจัยอื่นๆ เช่น การจราจรแบบเรียลไทม์และสภาพท้องถนนเพื่อเลือกเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม ยิ่งเส้นทางประหยัดเชื้อเพลิงหรือพลังงานมากเท่าใด ก็จะยิ่งลดการใช้เชื้อเพลิง/พลังงานและการปล่อยก๊าซ CO2 จากรถได้มากขึ้นเท่านั้น

เช่น ข้อได้เปรียบในการประหยัดเชื้อเพลิงแบบสัมพัทธ์ของยานพาหนะดีเซลมักจะดีกว่าในการขับขี่บนทางหลวง ยานพาหนะไฮบริดและรถยนต์ไฟฟ้ามีแนวโน้มที่จะให้ประสิทธิภาพมากขึ้นในการขับรถในเมืองแบบไม่มีที่สิ้นสุดและสภาพแวดล้อมการขับขี่บนเนินเขา ซึ่งสามารถใช้ประโยชน์จากระบบเบรกแบบสร้างใหม่ (Regenerative braking) ได้อย่างเต็มที่

คุณสามารถขอให้ API แสดงผลการบริโภคน้ำมันเชื้อเพลิงโดยประมาณสำหรับทั้งเส้นทางได้ด้วย ใช้ค่าประมาณการบริโภคเชื้อเพลิงเป็นวิธีการเปรียบเทียบเส้นทางต่างๆ ไม่ใช่เป็นการคาดประมาณการใช้เชื้อเพลิงโดยประมาณของยานพาหนะจริง

วิธีที่ Google Maps ประมาณการประหยัดพลังงาน

Routes API ประมาณค่าการประหยัดพลังงานโดยใช้ข้อมูลเชิงลึกจากห้องปฏิบัติการพลังงานทดแทนแห่งชาติของกระทรวงพลังงานสหรัฐอเมริกาและข้อมูลจากสำนักงานสิ่งแวดล้อมยุโรป การคํานวณนี้ประกอบด้วยปัจจัยที่มีผลต่อการใช้เชื้อเพลิงและพลังงาน และการปล่อย CO2 เช่น

  • การบริโภคเชื้อเพลิงหรือพลังงานโดยเฉลี่ยของยานพาหนะในภูมิภาคของคุณ
  • ความสูงชันของเนินเขาในเส้นทางของคุณ
  • รูปแบบการจราจรที่เคลื่อนที่สลับหยุดนิ่ง
  • ประเภทถนน (เช่น ถนนในท้องถิ่นหรือทางหลวง)

Routes API จะแสดงเส้นทางที่ประหยัดเชื้อเพลิงหรือพลังงานมากที่สุดเมื่อมีเวลาถึงใกล้เคียงกับเส้นทางเริ่มต้น ในกรณีที่ประหยัดเชื้อเพลิงได้น้อยมากหรือต้องเพิ่มเวลาในการขับรถขึ้นอย่างมาก API จะแสดงการประหยัดเชื้อเพลิงแบบสัมพัทธ์หรือพลังงานระหว่างเส้นทางเพื่อช่วยคุณในการเปรียบเทียบ

อ่านเพิ่มเติมเกี่ยวกับเทคโนโลยีการกําหนดเส้นทางที่เป็นมิตรกับสิ่งแวดล้อม (PDF)

ข้อกำหนดเบื้องต้น

หากต้องการใช้เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมหรือประเมินปริมาณการใช้เชื้อเพลิง ให้ทำดังนี้

  • คุณต้องระบุ TRAFFIC_AWARE_OPTIMAL เป็นค่ากำหนดการกำหนดเส้นทาง ในโหมดนี้ เซิร์ฟเวอร์จะทำการค้นหาเครือข่ายถนนอย่างละเอียดมากขึ้นเพื่อค้นหาเส้นทางที่เหมาะสม ดูข้อมูลเพิ่มเติมได้ที่กำหนดค่าคุณภาพเทียบกับเวลาในการตอบสนอง

  • คุณต้องตั้งค่า travelMode เป็น DRIVE คำขอโหมดการเดินทางอื่นๆ จะแสดงผลข้อผิดพลาด

  • คุณต้องตั้งค่าตำแหน่งสำหรับจุดอ้างอิงต้นทางในภูมิภาคที่รองรับ มิฉะนั้น API จะแสดงข้อผิดพลาด

  • เส้นทางนี้ต้องไม่มีจุดระหว่างทาง

การเรียกเก็บเงิน

โดยปกติแล้ว Google Maps Platform จะไม่เรียกเก็บเงินสำหรับการใช้ฟีเจอร์แสดงตัวอย่าง แต่เนื่องจากเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมและการประมาณปริมาณการใช้เชื้อเพลิงนั้น คุณต้องระบุ 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 ที่มี 2 เส้นทาง ได้แก่ เส้นทางเริ่มต้นและเส้นทางประหยัดเชื้อเพลิง คำตอบ:

  • พร็อพเพอร์ตี้อาร์เรย์ 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 จะมี ป้ายกำกับทั้ง 2 รายการ ได้แก่ 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)
  • ออสเตรีย (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)