API Tuyến đường hiện đang ở chế độ Xem trước (trước GA). Các sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể không được hỗ trợ hạn chế. Đồng thời, các thay đổi đối với sản phẩm và tính năng trước giai đoạn phát hành rộng rãi có thể không tương thích với các phiên bản trước giai đoạn phát hành rộng rãi khác. Các Sản phẩm trước giai đoạn phát hành rộng rãi chịu sự điều chỉnh của Điều khoản dành riêng cho dịch vụ nền tảng Google Maps. Để biết thêm thông tin, hãy xem nội dung mô tả giai đoạn ra mắt.

Định cấu hình tuyến đường thân thiện với môi trường

Theo mặc định, API Tuyến đường trả về tuyến đường mặc định, nghĩa là tuyến đường không tính đến hiệu suất tiêu thụ nhiên liệu hoặc năng lượng. Khi bật tính năng gửi đi thân thiện với môi trường, bạn vẫn nhận được tuyến mặc định trong phản hồi. Ngoài ra, bạn cũng sẽ quay lại tuyến đường thân thiện với môi trường để hiển thị tuyến đường tiết kiệm nhiên liệu hoặc năng lượng nhất dựa trên loại động cơ xe.

API Tuyến đường sử dụng loại động cơ xe của bạn cùng với các yếu tố khác, chẳng hạn như tình hình giao thông theo thời gian thực và tình trạng đường để chọn tuyến đường thân thiện với môi trường. Tuyến đường càng tiết kiệm nhiên liệu hoặc năng lượng, mức sử dụng nhiên liệu/năng lượng và lượng khí thải CO2 của xe càng thấp.

Ví dụ: ưu điểm tiết kiệm nhiên liệu tương đối của xe chạy bằng diesel thường lớn nhất khi lái xe trên đường cao tốc. Xe lai điện và xe điện có xu hướng tiết kiệm hơn trong thành phố khi bạn không thể di chuyển với tốc độ ổn định và khi lái xe trên đồi dốc cần thường xuyên sử dụng phanh tái sinh.

Tuyến đường thân thiện với môi trường mà API trả về được tối ưu hoá cho mức tiêu thụ nhiên liệu thấp hơn trên toàn bộ tuyến đường. Hãy sử dụng dữ liệu ước tính về mức tiêu thụ nhiên liệu cho tuyến đường như một cách để so sánh các tuyến đường khác nhau, chứ không phải để ước tính mức sử dụng nhiên liệu rõ ràng cho xe của bạn.

Cách Google Maps ước tính hiệu suất tiêu thụ nhiên liệu

API Tuyến đường ước tính hiệu suất tiêu thụ nhiên liệu dựa trên thông tin chuyên sâu của Phòng thí nghiệm quốc gia về năng lượng tái tạo của Bộ Năng lượng Hoa Kỳ và dữ liệu của Cơ quan Môi trường Châu Âu. Cách tính này bao gồm những yếu tố ảnh hưởng đến mức sử dụng nhiên liệu và năng lượng cũng như lượng khí thải CO2, chẳng hạn như:

  • Mức tiêu thụ nhiên liệu hoặc năng lượng trung bình cho các phương tiện trong khu vực của bạn
  • Độ dốc của đồi trên tuyến đường
  • Tình hình giao thông di chuyển chậm chạp
  • Các loại đường (như đường nội đô hoặc đường cao tốc)

API Tuyến đường trả về tuyến đường tiết kiệm nhiên liệu hoặc năng lượng nhất khi có cùng thời gian đến với tuyến đường mặc định. Trong trường hợp mức tiết kiệm nhiên liệu hoặc năng lượng quá nhỏ hoặc làm tăng thời gian lái xe đáng kể, API sẽ hiển thị mức tiết kiệm nhiên liệu hoặc năng lượng tương đối giữa các tuyến đường để giúp bạn so sánh.

Đọc thêm về công nghệ định tuyến theo hướng thân thiện với môi trường (PDF).

Điều kiện tiên quyết

Để sử dụng tính năng định tuyến thân thiện với môi trường, hãy đưa ra yêu cầu để tính toán tuyến đường:

  • Bạn phải chỉ định TRAFFIC_AWARE_OPTIMAL làm tùy chọn định tuyến. Ở chế độ này, máy chủ thực hiện tìm kiếm toàn diện hơn về mạng lưới đường bộ để tìm tuyến đường tối ưu. Để biết thêm thông tin, hãy xem phần nội dung Định cấu hình chất lượng so với độ trễ.

  • Bạn phải đặt travelMode thành DRIVE. Yêu cầu tuyến đường thân thiện với môi trường cho mọi chế độ đi lại khác sẽ trả về lỗi.

  • Bạn phải đặt một vị trí cho điểm tham chiếu ban đầu trong khu vực được hỗ trợ. Nếu không, API sẽ trả về lỗi.

  • Tuyến đường không được chứa điểm trung gian.

Yêu cầu một tuyến đường thân thiện với môi trường

Để yêu cầu tính toán tuyến đường thân thiện với môi trường, hãy thiết lập các thuộc tính sau trong yêu cầu:

  • Đặt requestedReferenceRoutes thành FUEL_EFFICIENT.

  • Chỉ định emissionType cho xe bằng các giá trị được xác định trong XeEmissionType: DIESEL, GASOLINE, ELECTRIC hoặc HYBRID. Giá trị mặc định là GASOLINE.

Ngoài ra, hãy đặt mặt nạ trường phản hồi chỉ định để trả về các thuộc tính phản hồi liên kết với tuyến đường thân thiện với môi trường:

  • routes.routeLabels: Xác định từng tuyến đường:

    • Đối với tuyến đường mặc định, thuộc tính mảng routeLabels chứa DEFAULT_ROUTE.

    • Đối với tuyến đường thân thiện với môi trường, thuộc tính mảng routeLabels chứa FUEL_EFFICIENT.

    • Đối với mọi tuyến đường thay thế, thuộc tính mảng routeLabels chứa DEFAULT_ROUTE_ALTERNATE.

  • routes.travelAdvisory.fuelConsumptionMicroliters: Mức sử dụng nhiên liệu ước tính cho toàn bộ tuyến đường, tính bằng microl.

    Nếu emissionTypeHYBRID, API sẽ chuyển đổi mức tiêu thụ điện và nhiên liệu thành microlít nhiên liệu.

    Nếu emissionTypeELECTRIC, API sẽ chuyển đổi mức tiêu thụ điện thành một phần triệu lít nhiên liệu.

  • routes.routeToken: Mã thông báo tuyến đường mà bạn có thể chuyển đến SDK điều hướng để truy xuất tuyến đường tuỳ chỉnh.

Ví dụ về yêu cầu thân thiện với môi trường

Đoạn mã sau đây cho thấy yêu cầu về một tuyến đường thân thiện với môi trường. Trong ví dụ này, bạn sử dụng mặt nạ trường phản hồi để trả về các thuộc tính phản hồi liên kết với một tuyến đường thân thiện với môi trường cùng với các thuộc tính routes.distanceMetersroutes.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: API_KEY' 
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.travelAdvisory.fuelConsumptionMicroliters,routes.routeToken' 
'https://routes.googleapis.com/directions/v2:computeRoutes'

Ví dụ về câu trả lời thân thiện với môi trường

Lệnh gọi tuyến tính toán ở trên tạo ra phản hồi JSON chứa hai tuyến:

{
    "routes": [
        {
            "distanceMeters": 138939,
            "duration": "5412s",
            "travelAdvisory": {
                "fuelConsumptionMicroliters": "10960841"
            },
            "routeToken": "CoYJCpoIC…0n9S1cu",
            "routeLabels": [
                "DEFAULT_ROUTE"
            ]
        },
        {
            "distanceMeters": 116887,
            "duration": "5631s",
            "travelAdvisory": {
                "fuelConsumptionMicroliters": "9302109"
            },
            "routeToken": "CuEHCu0G…xqm",
            "routeLabels": [
                "FUEL_EFFICIENT"
            ]
        }
    ]
}

Trong trường hợp tuyến mặc định và tuyến đường thân thiện với môi trường giống nhau, thuộc tính routeLabels sẽ chứa cả DEFAULT_ROUTEFUEL_EFFICIENT:

{
  "routes": [
    {
      "distanceMeters": 45875,
      "duration": "2655s",
      "travelAdvisory": {
        "fuelConsumptionMicroliters": "1926791"
      },
      "routeToken": "CvcDCos…6I40",
      "routeLabels": [
        "DEFAULT_ROUTE",
        "FUEL_EFFICIENT"
      ]
    }
  ]
}

Khu vực được hỗ trợ

Nhóm Nền tảng Google Maps không ngừng nỗ lực để cải thiện mức độ phù hợp quốc tế cho các dịch vụ API của chúng tôi. Danh sách sau đây liệt kê các thông tin mới nhất về phạm vi bao phủ, theo từng quốc gia, để định tuyến theo hướng thân thiện với môi trường:

  • Anbani (AL)
  • Áo (AT)
  • Bỉ (BE)
  • Bosnia và Herzegovina (BA)
  • Bungari (BG)
  • Canada (CA)
  • Croatia (HR)
  • Síp (CY)
  • Séc (CZ)
  • Đan Mạch (DK)
  • Estonia (EE)
  • Phần Lan (FI)
  • Pháp (Pháp)
  • Đức (DE)
  • Hy Lạp (GR)
  • Hungary (HU)
  • Iceland (IS)
  • Ireland (IE)
  • Ý (IT)
  • Kosovo (XK)
  • Tiếng Latvia (LV)
  • Liechtenstein (LI)
  • Lithuania (LT)
  • Luxembourg (LU)
  • Malta (MT)
  • Montenegro (ME)
  • Hà Lan (NL)
  • Bắc Macedonia (MK)
  • Na Uy (NO)
  • Ba Lan (PL)
  • Bồ Đào Nha (PT)
  • Romania (RO)
  • Serbia (RS)
  • Slovakia (SK)
  • Slovenia (SI)
  • Tây Ban Nha (ES)
  • Thuỵ Điển (SE)
  • Thuỵ Sĩ (CH)
  • Thổ Nhĩ Kỳ (TR)
  • Vương Quốc Anh (GB)
  • Hoa Kỳ (US)