自動車向け Routes API

Routes API for Automotive には、車内ナビゲーション機能を開発する自動車パートナー向けの特別な属性が用意されています。これにより、標準の Routes API が拡張され、自動車業界に合わせた属性が追加されます。

Routes API for Automotive のドキュメントの内容

Routes API for Automotive には、標準の Routes API のドキュメントに加えて、以下が含まれています。

リクエストを承認する

annotatePaths へのリクエストを承認するには、OAuth(Automotive)を使用するで説明されている OAuth メソッドを使用する必要があります。リクエストでは、Automotive Maps API を呼び出す方法と同様に、OAuth で権限借用を使用する必要があります(ただしスコープは異なります)。

ただし、computeRoutes メソッドまたは computeRoutesMatrix メソッドを呼び出す場合は、通常の Routes API ドキュメントで説明されている API キーまたは OAuth のいずれかのタイプの承認を使用できます。

Standard Routes API とドキュメントを共有

Routes API for Automotive では、[ガイド] タブのチュートリアルなどのドキュメントが標準の Routes API と共有されます。

標準の Routes API チュートリアルを使用する場合、リンクは標準リファレンスを参照していることに注意してください。Routes API for Automotive の対応するリンクに移動する必要があります。これを行うには、ブラウザの URL で routes/ の後に automotive/ を追加します(例: routes/automotive/)。

困ったときは

Routes API for Automotive は一般公開されていないため、公開されている Issue Tracker にバグを報告しないでください。バグを報告するための会社固有の Issue Tracker コンポーネントをチームに提供しました。その他のご不明点については、Google の担当者にお問い合わせください。

キャメルケースの規則と用語

このドキュメントでは、主に RPC の大文字と小文字の規則(AnnotatePaths)ではなく、REST のキャメルケース規則(annotatePaths など)を使用しています。ただし、どちらの大文字小文字も同じように有効です。

また、annotatePathscomputeRoutescomputeRoutesMatrix は「API」と呼ぶのが一般的ですが、実際にはカスタム メソッドです。ただし、メソッドまたは API と呼ばれることもあります。

GA(一般提供)と試験運用版機能

このセクションでは、Routes API for Automotive に固有の属性について説明します。次の機能は一般提供されています。

Routes API を通じて公開される基本属性

E7 ポリライン(E5 の代わりに E7 座標で記述された標準のエンコード済みポリライン):

  • フェリーを使わない。FerryInfo に関する説明をご覧ください。
  • 有料道路を使わない。TollInfo に関する説明をご覧ください。
  • [プレビュー] エンジンタイプに基づいてエコルートを選択できるようになりました。詳しくは、環境に優しいルートを取得するをご覧ください。

試験運用機能

以下の機能は試験運用版で、一部のお客様のみご利用いただけます。

Routes API を通じて公開される基本属性

  • オプションの入力として使用されるルートトークン。RouterouteToken をご覧ください。

ポリライン上で利用できる情報

  • 渋滞による遅延は分単位で測定されます。詳細については、IncidentType をご覧ください。
  • インシデントの詳細のテキストがないインシデント列挙型。詳細については、IncidentInfo をご覧ください。

詳細については、PolylineDetails をご覧ください。

その他の機能

  • ルート沿いの高度。詳細については、AltitudeInfo をご覧ください。
  • ルート上の予測速度バケット(8 バケット、各バケット幅は時速 10 ~ 20 km)。詳細については、PredictedSpeedInfo をご覧ください。

ルート修飾子

API から次の RouteModifiers をトリガーできます。ただし、まだ開発とテストが進行中のため、修飾子の目的が重視されない可能性があります。ご不明な点がある場合は、Google 担当者にお問い合わせください。

  • 全画面広告の使用を避ける(avoidVignettes[])。オーストリア、スイス、ハンガリー、スロベニア、スロバキア、チェコ共和国の 6 か国でサポートされています。
  • 乗員の多い車(HOV)の道路(hovPreference)を許可します。米国とカナダでサポートされています。
  • トンネルを使わない(avoidTunnels)。
  • トレーラー固有のルート(totalAxleCounttotalHeightMmtotalLengthMmtotalWidthMmtotalWeightKg)。