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

โดยค่าเริ่มต้น 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 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)
• ออสเตรีย (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)
• สเปน (สเปน)
• สวีเดน (SE)
• สวิตเซอร์แลนด์ (CH)
• ตุรกี (TR)
• สหราชอาณาจักร (GB)
• สหรัฐอเมริกา (US)