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

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