このページは 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）