環境にやさしいルートの設定

デフォルトでは、Routes API は燃料またはエネルギー効率を考慮に入れずにデフォルト ルートを返します。環境に優しいルート選択を有効にしても、レスポンスでデフォルトのルートが取得されます。また、車のエンジンの種類に応じた、燃料効率やエネルギー効率の高いルートを表示する環境に優しいルートも返されます。

Routes API から返される環境に優しいルートは、ルート全体で燃料消費を抑えるように最適化されます。この API は、車両のエンジンタイプとその他の要素(リアルタイムの交通状況や道路状況など)を使用して、環境に優しいルートを選択します。ルートの燃料効率やエネルギー効率が高いほど、燃料消費量やエネルギー使用量と CO2 排出量が低くなります。

たとえば、ディーゼル車の相対的な燃料効率の優位性は、一般的に高速道路の走行時に最も高くなります。ハイブリッド車と電気自動車は、停車と発進の繰り返しが多い市街地や坂道の多い場所での走行時に回生ブレーキを多用し、そのメリットによって徐々に効率を高めていく傾向があります。

ルート全体の推定燃料消費量を API が返すようにリクエストすることもできます。燃料消費量の見積もりは、正確な車両の明示的な燃料使用量の推定値ではなく、さまざまなルートを比較するための手段として使用してください。

Google マップによる燃料効率の推定方法

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

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

Routes API は、到着時刻がデフォルト ルートとほぼ同じ場合、燃料またはエネルギー効率が最も良いルートを返します。燃料やエネルギーの節約量が少なすぎる場合、または走行時間が大幅に増える場合は、API はルート間の相対的な燃料やエネルギーの節約量を比較して、簡単に比較できるようにします。

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

Prerequisites

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

  • ルーティング設定として TRAFFIC_AWARE_OPTIMAL を指定する必要があります。このモードでは、サーバーは道路網をより詳細に検索して最適なルートを見つけます。詳細については、品質とレイテンシの構成をご覧ください。

  • travelModeDRIVE に設定する必要があります。その他の移動手段をリクエストすると、エラーが返されます。

  • 出発地地点の場所は、サポートされている地域で設定する必要があります。そうしないと、API はエラーを返します。

  • ルートに中間地点を含めることはできません。

課金

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

Routes API の課金の詳細

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

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

  • VehicleEmissionType で定義された値(DIESELGASOLINEELECTRICHYBRID)を使用して、車両の emissionType を指定します。デフォルト値は GASOLINE です。

  • requestedReferenceRoutesFUEL_EFFICIENT に設定する。

  • 環境に優しいルートに関連付けられたレスポンス プロパティを返すように指定するレスポンス フィールド マスクを設定します。

    • routes.routeLabels:: 各ルートの DEFAULT_ROUTEFUEL_EFFICIENTDEFAULT_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: API_KEY' \
-H 'X-Goog-FieldMask: routes.distanceMeters,routes.duration,routes.routeLabels,routes.routeToken' \
'https://routes.googleapis.com/directions/v2:computeRoutes'

環境に優しい対応の例

上の compute_route 呼び出しは、デフォルト ルートと燃料効率が良いルートの 2 つのルートを含む JSON レスポンスを生成します。レスポンス:

  • デフォルト ルートの場合、routeLabels 配列プロパティには DEFAULT_ROUTE が含まれています。

  • 環境に優しいルートの場合、routeLabels 配列プロパティには FUEL_EFFICIENT が含まれます。

  • true へのリクエストで computeAlternativeRoutes を設定して代替ルートを計算する場合、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_ROUTEFUEL_EFFICIENT の両方のラベルが含まれます。

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

ルートの燃料使用量を見積もる

このメソッドをリクエストすると、ルート全体の推定燃料使用量をマイクロリットルで返すことができます。ルートの推定燃料使用量をレスポンスに追加するには:

  • 燃料使用量の計算を有効にするには、extraComputations 配列フィールドを FUEL_CONSUMPTION に設定します。

  • VehicleEmissionType で定義された値(DIESELGASOLINEELECTRICHYBRID)を使用して、車両の emissionType を指定します。デフォルト値は GASOLINE です。

    emissionTypeHYBRID の場合、電力と燃料の消費量はマイクロリットルに変換されます。

    emissionTypeELECTRIC の場合、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: 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)