デフォルトでは、Routes API はデフォルトのルート（燃料やエネルギー効率を考慮しないルート）を返します。環境に優しいルーティングを有効にしても、レスポンスにはデフォルト ルートが含まれます。また、車両のエンジンの種類に応じて燃料効率またはエネルギー効率が最も良いルートを示す、環境に優しいルートも返されます。
Routes API から返される環境に優しいルートは、ルート全体で燃料消費量を抑えるように最適化されています。この API は、車両のエンジンの種類と、リアルタイムの交通状況や道路状況などの情報を使用して、環境に優しいルートを選択します。ルートの燃料効率またはエネルギー効率が高いほど、車の燃料使用量、エネルギー使用量、CO2 排出量が少なくなります。
たとえば、ディーゼル車の相対的な燃料経済の優位性は、一般的に高速道路の運転で最も大きなものです。ハイブリッド車と電気自動車は、停車と発進を繰り返す市街地や坂道の多い場所での走行時に回生ブレーキを多用し、そのメリットを享受できる環境において、徐々に効率を高める傾向があります。
また、API でルート全体の推定燃料消費量を返すようにリクエストすることもできます。推定燃料消費量は、車両の正確な推定燃料消費量の推定ではなく、異なるルートを比較する手段として使用してください。
Google マップによる燃料効率の推定方法
Routes API は、米国エネルギー省の国立再生可能エネルギー研究所の分析情報と欧州環境機関のデータを使用して、燃料効率を推定します。この計算では、燃料使用量、エネルギー使用量、CO2 排出量に影響する次のような要因が考慮されます。
- お住まいの地域における自動車の燃料またはエネルギーの平均消費量
- ルート上での坂の勾配
- 少し進んでは止まるパターンの交通状況
- 道路の種類（一般道路や高速道路など）
Routes API は、到着時刻がデフォルト ルートとほぼ同じ場合、最も燃料またはエネルギー効率が良いルートを返します。燃料またはエネルギーの節約量が少なすぎる場合、または走行時間が大幅に増加する場合は、API によりルート間の燃料またはエネルギーの節約量の相対値が表示され、簡単に比較できます。
詳しくは、環境に優しいルート選択のテクノロジーに関する資料（PDF）をご覧ください。
Prerequisites
環境に優しいルート選択を使用する、または燃料消費量を見積もるには:
ルーティング設定として
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: 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が含まれます。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_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: 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）