Routes API に移行する理由

Routes API は、ルート、距離、移動時間の計算のパフォーマンスが向上しているため、現在 Directions API と Distance Matrix API を使用しているアプリを置き換える価値があります。Routes API の機能のほとんどは、Directions API と Distance Matrix API の両方と下位互換性があります。

このガイドでは、Routes API と、置き換えられるプロダクトとの主な違いと、必要な変更を処理する方法について説明します。Routes API のその他の機能の詳細については、プロダクトの概要をご覧ください。

主な改善点

このセクションでは、アプリで Routes API を使用する際に期待できる機能強化について説明します。

リクエスト数の上限の引き上げ

Routes API	TRAFFIC_AWARE_OPTIMAL を指定しない限り、最大 625 個の要素。 TRAFFIC_AWARE_OPTIMAL を使用する要素は最大 100 個です。拡張ルーティングの設定をご覧ください。 プレイス ID を使用した最大 50 個の地点（出発地と目的地）
Distance Matrix API	リクエストあたりの出発地または目的地は最大 25 個。 サーバーサイド リクエストあたり最大 100 個の要素（出発地の数 × 目的地の数）。

リクエスト レスポンスの高速化

Compute Route Matrix 機能により、次のレイテンシが改善されます。

• 行列全体が計算される前に、レスポンスをストリーミングで受信します。
• フィールド マスクを使用してレスポンスの詳細をカスタマイズし、必要なデータのみをリクエストします。これは、コスト削減にもつながるおすすめの方法です。
• トラフィックのルート計算を拡張し、データ品質とレスポンス時間のトレードオフを実現。

ルーティングの機能強化

コンピューティング ルート機能には、次のルーティング機能の強化が含まれています。

• 距離と到着予定時刻に加えて、通行料金情報。
• 2 輪車のルート。
• 安全性を確保するため、経由地のウェイポイントを適格性評価します。
• ウェイポイントの進行方向と道路の通行側を設定することで、到着予定時刻の精度を向上しました。

必要なデータのみをリクエストする

返すフィールドを指定することで、処理時間と課金料金を削減できます。

Routes API	リクエストでは、フィールドマスクを使用して、レスポンスで返すフィールドを指定する必要があります。フィールド マスキングにより、不要なデータをリクエストしないようにすることで、不要な処理時間と請求料金を回避できます。 詳細については、返されるフィールドを選択するをご覧ください。
Directions API Distance Matrix API	アプリで厳密に必要とされていない場合でも、フィールドのデフォルト リストを返します。これにより、不要な処理時間と課金が発生する可能性があります。

交通量のルート計算の強化

Routes API は、3 つのルーティング設定をサポートしています。これらの設定を使用すると、交通情報をリクエストする際のレスポンス レイテンシとデータ品質のバランスを取ることができます。

詳細については、品質とレイテンシの構成をご覧ください。

注: Directions API と Distance Matrix API は、TRAFFIC_AWARE_OPTIMAL オプションと TRAFFIC_UNAWARE オプションと同等のオプションのみを提供します。これらのオプションは、リクエストで departure_time を指定しているかどうかに基づいて暗黙的に設定されます。

TRAFFIC_UNAWARE （デフォルト）	リアルタイムの交通情報ではなく、時間に依存しない平均的な交通データを使用しているため、ルートの計算にかかる時間が短く、レスポンス レイテンシが低くなります。この設定は、Directions API と Distance Matrix API でトラフィックが使用されていない場合と同じです。
TRAFFIC_AWARE （新規）	レイテンシを短縮するためにパフォーマンスが最適化されたライブ トラフィック品質。TRAFFIC_AWARE_OPTIMAL とは対照的に、この設定では最適化が適用され、レイテンシが大幅に短縮されます。この設定も Routes API の新機能で、Directions API や Distance Matrix API に同等の設定はありません。
TRAFFIC_AWARE_OPTIMAL	高品質で包括的なトラフィック データ。この設定ではレイテンシが最も高くなります。これは、Directions API と Distance Matrix API の departure_time 設定と同等です。 この設定は、maps.google.com と Google マップ モバイルアプリで使用されるモードと同じです。

ルート計算の比較

次の表は、Routes API と Directions API および Distance Matrix API サービスのルーティング オプションを比較したものです。

トラフィック オプション	Routes API	Directions API Distance Matrix API	レイテンシ
リアルタイムの交通情報なし	TRAFFIC_UNAWARE	departure_time プロパティが設定されていない	3 つのモードの中で最も低いレイテンシ。
ライブの交通状況が適用されている	TRAFFIC_AWARE	同等のものはありません	Routes API によって追加された新しいモード。TRAFFIC_UNAWARE よりもレイテンシが若干長く、ETA の品質が若干低下します。 TRAFFIC_AWARE_OPTIMAL よりもはるかに低いレイテンシです。
高品質で包括的なライブ交通データが適用されている	TRAFFIC_AWARE_OPTIMAL	departure_time プロパティセット	maps.google.com と Google マップ モバイルアプリで使用されるモードと同等です。 Compute Route Matrix の場合、リクエスト内の要素数（出発地の数 × 目的地の数）は 100 を超えることはできません。

主な違い

このセクションでは、Routes API と、その API が置き換えるサービスとの主な違いについて説明します。また、既存のアプリでこれらのサービスから移行する際に、これらの違いに対処する方法についても説明します。

2 つではなく 1 つのサービスを呼び出す

Routes API	アプリで Compute Routes と Compute Route Matrix を使用するには、API Console で 1 つのサービスのみを有効にします。 詳細については、Google API コンソールで設定するをご覧ください。
Directions API Distance Matrix API	API Console で、Directions API と Distance Matrix API の 2 つのサービスを個別のサービスとして有効にします。

HTTPS POST リクエストを使用します

Routes API	リクエスト本文またはヘッダーで、HTTP POST リクエストの一部としてパラメータを渡します。 例については、以下をご覧ください。 - ルートを計算する - ルート行列を計算する
Directions API Distance Matrix API	HTTP GET リクエストを使用して URL パラメータを渡します。

推定所要時間の回答の違い

Routes API は、ETA を返します。また、以下の表に示すように、duration レスポンス プロパティの使用方法が Directions API サービスと Distance Matrix API サービスとは異なります。

拡張テキスト広告のタイプ	Routes API	Directions API Distance Matrix API
交通状況を考慮しない、時間に依存しない ETA。	TRAFFIC_UNAWARE を使用して設定します。 duration レスポンス プロパティに含まれる予定時刻。 duration レスポンス プロパティと staticDuration レスポンス プロパティに同じ値が含まれています。	リクエストで departure_time が設定されていない場合に相当します。 duration レスポンス プロパティに含まれる予定時刻。 duration_in_traffic レスポンス プロパティは返されません。
リアルタイムの交通状況を考慮した到着予定時刻。	TRAFFIC_AWARE または TRAFFIC_AWARE_OPTIMAL を使用して設定します。 リアルタイム トラフィックを考慮した ETA は、duration レスポンス プロパティに含まれます。 レスポンスの staticDuration プロパティには、交通状況を考慮しない状態でルートを移動する時間が表示されます。 duration_in_traffic プロパティは返されなくなりました。	リクエストで departure_time を使用して設定します。 リアルタイム トラフィックを考慮した ETA は、duration_in_traffic レスポンス プロパティに含まれます。

ポリライン ウェイポイント

このサービスでは、緯度と経度の座標をポリラインのウェイポイントに変換する必要がなくなりました。このサービスは POST リクエスト本文をサポートしているため、URL 文字列の上限の影響を受けなくなりました。Distance Matrix API の一部ユーザーは、緯度/経度の地点をポリラインのウェイポイントに変換することで、リクエスト数の上限の問題に対処しています。

フォーマット済み住所（リバース ジオコーディング）

Routes API は、レスポンスでフォーマットされた住所を提供していません。フォーマットされた住所を取得するには、このユースケース用に構築され、より高品質な結果を提供する Geocoding API を使用します。

利用可能な移動手段

Directions API と同様に、ルート リクエストで移動手段が指定されていない場合、Routes API はデフォルト モードとして DRIVE を使用します。ただし、リクエストでルートの移動手段が指定されている場合、Routes API は、リクエストの代替の選択肢として利用可能な移動手段の配列を返しません。この機能に依存するユースケースの場合は、問題を報告して、その機能の使用方法を説明してください。追跡いたします。

レスポンス形式としての XML

Routes API は、レスポンス形式として XML を提供していません。目的に合った JSON から XML へのコンバータは、オンラインで多数見つかります。