自動車向け Routes API

Routes API for Automotive は、車載ナビゲーション機能を開発する自動車パートナー向けの特別な属性を提供します。これは、標準の Routes API を、自動車業界に合わせた属性で拡張したものです。

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

Routes API for Automotive には、標準の Routes API のドキュメントに加えて、次のものが用意されています。

リクエストを承認する

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

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

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

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

標準の Routes API チュートリアルを使用している場合、リンクは標準リファレンスを指します。Automotive のリファレンスについては、Routes API の同等のリンクに移動する必要があります。これを行うには、ブラウザの 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/h)。詳細については、PredictedSpeedInfo をご覧ください。

ルート修飾子

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

  • 周辺減光を避ける(avoidVignettes[])。オーストリア、スイス、ハンガリー、スロベニア、スロバキア、チェコ共和国の 6 か国でサポートされています。
  • 乗客数の多い車両(HOV)の道路(hovPreference)を許可します。米国とカナダでサポートされています。
  • トンネルを使わない(avoidTunnels)。
  • 後続固有のルート(totalAxleCounttotalHeightMmtotalLengthMmtotalWidthMmtotalWeightKg)。