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

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

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

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

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

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

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

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

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

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

สิ่งที่ต้องดำเนินการก่อน

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

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

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

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

• เส้นทางนี้ไม่สามารถมีจุดอ้างอิงกลาง

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

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

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

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