このページは Cloud Translation API によって翻訳されました。

環境に優しいルート

デフォルトでは、Routes API はデフォルトルートを返します。エネルギー効率やエネルギー効率を考慮せずに、環境に優しいルーティングを使用している場合でも、レスポンスでデフォルトルートが取得されます。また環境に優しいルートを検索し、最も燃料効率が良いルートまたはエネルギー効率の高いルートを表示する車のエンジンの種類に応じて調整します

Routes API から返される環境に優しいルートは、ルート全体の燃料消費量を削減API は車両のエンジンを使用しますリアルタイムの交通状況や道路状況などの要因に加え、環境に優しいルートを選択しますルートの燃料効率やエネルギー効率が高いほど、車の燃料使用量、エネルギー使用量、CO2 排出量を削減できます。

たとえば、ディーゼル車の相対的な燃料経済性の優位性は、一般的に表に出てきています。ハイブリッド車と電気自動車は、都市部でのストップアンドゴーや起伏のある運転の効率を段階的に高める再生可能エネルギーを幅広く活用し、その恩恵を受けられるブレーキ。

次の場所の推定燃料消費量を返すよう API にリクエストすることもできます。表示されます。燃料消費量の予測値を比較して、正確な車両の燃料消費量の明示的な推定値としてではなく、異なるルートを表示します。

Google マップでの燃料効率の推定方法

Routes API は米国からの分析情報を使用して燃料効率を推定エネルギー省国立再生可能エネルギー研究所欧州環境機関のデータですこの計算には以下の因数が含まれます燃料とエネルギーの使用量、CO2 排出量に影響する、次のような要因です。

お住まいの地域における自動車の燃料またはエネルギーの平均消費量
ルート上での坂の勾配
少し進んでは止まるパターンの交通状況
道路の種類（一般道路や高速道路など）

Routes API は、次の場合に最も多くの燃料またはエネルギー効率のルートを返します。到着時刻はデフォルトルートとほぼ同じです。燃料またはエネルギー節約が小さすぎる、運転時間が大幅に増加するといった場合、API ルート間の相対的な燃料またはエネルギーの節約量が表示され、比較できます。

詳しくは、環境に優しいルート選択のテクノロジーに関する資料（PDF）をご覧ください。

前提条件

環境に優しいルート選択を使用する、または燃料消費量を見積もるには:

ルーティング設定として TRAFFIC_AWARE_OPTIMAL を指定する必要があります。このサーバーが道路網の網羅的な検索を実行して、最適なルートを見つけます。詳細については、次をご覧ください: 品質とレイテンシを構成する。
travelMode を DRIVE に設定する必要があります。次のリクエスト: それ以外の移動手段ではエラーが返されます。
出発地のウェイポイントの位置をサポートされているリージョン。それ以外の場合、API はエラーを返します。
ルートに中間地点を含めることはできません。

課金

通常、Google Maps Platform ではプレビューの使用料はかかりません。機能。環境に優しいルート選択と燃料消費量の推定によりルーティング設定として TRAFFIC_AWARE_OPTIMAL を指定する必要があります。料金は SKU: Routes Advanced。

Routes API の課金の詳細をご確認ください。

環境に優しいルートをリクエスト

環境に優しいルートの計算をリクエストするには、次のプロパティを設定します。リクエスト内:

定義された値を使用して、車両の emissionType を指定します。 VehicleEmissionType: DIESEL、GASOLINE、ELECTRIC、または HYBRID。デフォルト値は GASOLINE。
requestedReferenceRoutes を FUEL_EFFICIENT に設定する。
レスポンスプロパティを返すように指定するレスポンスフィールドマスクを設定します。環境に優しいルートに関連する情報:
- routes.routeLabels:: 各ルートを DEFAULT_ROUTE、 FUEL_EFFICIENT、DEFAULT_ROUTE_ALTERNATE。
- routes.routeToken:: Pod に渡すことができるルートトークン画像データを取得する 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）
スペイン（ES）
スウェーデン（SE）
スイス（CH）
トルコ（TR）
英国（GB）
米国（US）