Routes API はデフォルトの場合、燃料やエネルギー効率を考慮しない、デフォルト ルートを返します。環境に優しいルート選択を有効にしても、レスポンスではデフォルトのルートが返されます。さらに、車のエンジンの種類に応じた、燃費やエネルギー効率の最も良いルートを示す環境に優しいルート選択も返されます。
Routes API から返される環境に優しいルート選択は、ルート全体で燃料消費量が少なくなるように最適化されています。この API は、車両のエンジンの種類と、リアルタイムの交通状況や道路状況などの情報を合わせて、環境に優しいルート選択をします。ルートでの燃料またはエネルギー効率が高いほど、燃料消費量、エネルギー消費量、および CO2 排出量が低くなります。
たとえば、ディーゼル車の相対的な燃料効率の優位性は、一般的に高速道路の走行時に最も高くなります。ハイブリッド車と電気自動車は、停車と発進の繰り返しが多い市街地や坂道の多い場所での走行時に回生ブレーキを多用し、そのメリットによって徐々に効率を高めていく傾向があります。
また、ルート全体の推定燃料消費量を返すよう API にリクエストすることもできます。燃料消費量の推定値は、さまざまなルートを比較する方法として使用してください。特定の車両の燃料使用量の推定値として使用しないでください。
Google マップによる燃料効率の推定方法
Routes API は、米国エネルギー省の国立再生可能エネルギー研究所の知見と欧州環境機関のデータを用いて、燃料効率を推定します。この計算では、燃料消費量、エネルギー使用量、CO2 排出量に影響する次のような要因が考慮されます。
- お住まいの地域における自動車の燃料またはエネルギーの平均消費量
- ルート上での坂の勾配
- 少し進んでは止まるパターンの交通状況
- 道路の種類(一般道路や高速道路など)
Routes API は、デフォルト ルートと到着時刻がほぼ同じ場合、燃料またはエネルギー効率が最も良いルートを返します。燃料もしくはエネルギーの節約量が少なすぎる場合、または走行時間が大幅に増える場合は、ルート間の燃料またはエネルギーの節約量が相対的に表示され、簡単に比較できます。
詳しくは、環境に優しいルート選択のテクノロジーに関する資料(PDF)をご覧ください。
前提条件
環境に優しいルート選択を使用する、または燃料消費量を推定するには:
ルーティング設定として
TRAFFIC_AWARE_OPTIMALを指定する必要があります。このモードでは、サーバーは道路網をより徹底的に検索して最適なルートを見つけます。詳細については、品質とレイテンシを構成するをご覧ください。travelModeをDRIVEまたはTWO_WHEELERに設定する必要があります。他の移動手段のリクエストではエラーが返されます。TWO_WHEELERの環境に優しいルート選択は、一部の国でのみサポートされています。サポート対象の地域で、出発地のウェイポイントの場所を設定する必要があります。それ以外の場合、API はエラーを返します。
TWO_WHEELERの場合、二輪車がサポート対象の地域で出発地のウェイポイントの場所を設定する必要があります。それ以外の場合、API はエラーを返します。ルートに中間ウェイポイントを含めることはできません。
課金
通常、Google Maps Platform ではプレビュー機能の使用に対して料金は発生しません。ただし、環境に優しいルート選択と燃料消費量の推定では、ルーティング設定として TRAFFIC_AWARE_OPTIMAL を指定する必要があるため、SKU: Compute Routes Pro に基づいて課金されます。
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)
- オーストラリア(AU)
- オーストリア(AT)
- ベルギー(BE)
- ボスニア ヘルツェゴビナ(BA)
- ブルガリア(BG)
- カナダ(CA)
- クロアチア(HR)
- キプロス(CY)
- チェコ(CZ)
- デンマーク(DK)
- エジプト(EG)
- エストニア(EE)
- フィンランド(FI)
- フランス(FR)
- ドイツ(DE)
- ギリシャ(GR)
- ハンガリー(HU)
- アイスランド(IS)
- インド(IN)
- インドネシア(ID)
- アイルランド(IE)
- イタリア(IT)
- コソボ(XK)
- ラトビア(LV)
- リヒテンシュタイン(LI)
- リトアニア(LT)
- ルクセンブルク(LU)
- マルタ(MT)
- メキシコ(MX)
- モンテネグロ(ME)
- オランダ(NL)
- 北マケドニア(MK)
- ノルウェー(NO)
- ポーランド(PL)
- ポルトガル(PT)
- ルーマニア(RO)
- サウジアラビア(SA)
- セルビア(RS)
- スロバキア(SK)
- スロベニア(SI)
- スペイン(ES)
- スウェーデン(SE)
- スイス(CH)
- トルコ(TR)
- アラブ首長国連邦(AE)
- 英国(GB)
- 米国(US)
自動二輪車がサポートされている地域
以下のリストに、二輪車の環境に優しいルート選択の詳しいサポート範囲に関する最新情報を国別に示します。
- インド(IN)
- インドネシア(ID)