このページは 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 の課金の詳細をご確認ください。

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

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

VehicleEmissionType で定義されている値（DIESEL、GASOLINE、ELECTRIC、HYBRID）を使用して、車両の emissionType を指定します。デフォルト値は 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 を呼び出すと、デフォルトルートと燃料効率が良いルートの 2 つのルートを含む JSON レスポンスが生成されます。レスポンスの説明:

デフォルトルートの場合、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 に設定します。
VehicleEmissionType で定義されている値（DIESEL、GASOLINE、ELECTRIC、HYBRID）を使用して、車両の emissionType を指定します。デフォルト値は 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 チームは、Google の 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）