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

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

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

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

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

วิธีที่ Google Maps ประมาณการประหยัดเชื้อเพลิง

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

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

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

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

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

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

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

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

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

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

• เส้นทางต้องไม่มีจุดแวะพักกลางทาง

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

โดยปกติแล้ว Google Maps Platform จะไม่เรียกเก็บเงินสำหรับการใช้ฟีเจอร์เวอร์ชันตัวอย่าง อย่างไรก็ตาม เนื่องจากเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมและการประมาณการใช้น้ำมัน กำหนดให้คุณระบุ TRAFFIC_AWARE_OPTIMAL เป็นค่ากำหนดการกำหนดเส้นทาง คุณจึง จะถูกเรียกเก็บเงินตาม SKU: Compute Routes Pro

ดูข้อมูลเพิ่มเติมเกี่ยวกับการเรียกเก็บเงินสำหรับ 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 มีทั้งป้ายกำกับ 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)
• ออสเตรเลีย (AU)
• ออสเตรีย (AT)
• เบลเยียม (BE)
• บอสเนียและเฮอร์เซโกวีนา (BA)
• บัลแกเรีย (BG)
• แคนา (CA)
• โครเอเชีย (HR)
• ไซปรัส (CY)
• เช็กเกีย (CZ)
• เดนมาร์ก (DK)
• อียิปต์ (EG)
• เอสโตเนีย (EE)
• ฟินแลนด์ (FI)
• ฝรั่งเศส (FR)
• เยอรมนี (DE)
• กรีซ (GR)
• ฮังการี (HU)
• ไอซ์แลนด์ (IS)
• อินเดีย (IN)
• อินโดนีเซีย (ID)
• ไอร์แลนด์ (IE)
• อิตาลี (IT)
• โคโซโว (XK)
• ลัตเวีย (LV)
• ลิกเตนสไตน์ (LI)
• ลิทัวเนีย (LT)
• ลักเซมเบิร์ก (LU)
• มอลตา (MT)
• เม็กซิโก (MX)
• มอนเตเนโกร (ME)
• เนเธอร์แลนด์ (NL)
• มาซิโดเนียเหนือ (MK)
• นอร์เวย์ (NO)
• โปแลนด์ (PL)
• โปรตุเกส (PT)
• โรมาเนีย (RO)
• ซาอุดีอาระเบีย (SA)
• เซอร์เบีย (RS)
• สโลวาเกีย (SK)
• สโลวีเนีย (SI)
• สเปน (ES)
• สวีเดน (SE)
• สวิตเซอร์แลนด์ (CH)
• ตุรกี (TR)
• สหรัฐอาหรับเอมิเรตส์ (AE)
• สหราชอาณาจักร (GB)
• สหรัฐอเมริกา (US)

ภูมิภาคที่รองรับยานพาหนะ 2 ล้อ

รายการต่อไปนี้แสดงรายละเอียดความครอบคลุมล่าสุดของเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อมสำหรับยานพาหนะ 2 ล้อในแต่ละประเทศ

• อินเดีย (IN)
• อินโดนีเซีย (ID)