Routes API は、ルート、距離、移動時間の計算のパフォーマンスが向上しているため、現在 Directions API と Distance Matrix API を使用しているアプリを置き換える価値があります。Routes API の機能のほとんどは、Directions API と Distance Matrix API の両方と下位互換性があります。
このガイドでは、Routes API と、置き換えられるプロダクトとの主な違いと、必要な変更を処理する方法について説明します。Routes API のその他の機能の詳細については、プロダクトの概要をご覧ください。
主な改善点
このセクションでは、アプリで Routes API を使用する際に期待できる機能強化について説明します。
リクエスト数の上限の引き上げ
| Routes API |
|
| Distance Matrix API |
|
リクエスト レスポンスの高速化
Compute Route Matrix 機能により、次のレイテンシが改善されます。
- 行列全体が計算される前に、レスポンスをストリーミングで受信します。
- フィールド マスクを使用してレスポンスの詳細をカスタマイズし、必要なデータのみをリクエストします。これは、コスト削減にもつながるおすすめの方法です。
- トラフィックのルート計算を拡張し、データ品質とレスポンス時間のトレードオフを実現。
ルーティングの機能強化
コンピューティング ルート機能には、次のルーティング機能の強化が含まれています。
- 距離と到着予定時刻に加えて、通行料金情報。
- 2 輪車のルート。
- 安全性を確保するため、経由地のウェイポイントを適格性評価します。
- ウェイポイントの進行方向と道路の通行側を設定することで、到着予定時刻の精度を向上しました。
必要なデータのみをリクエストする
返すフィールドを指定することで、処理時間と課金料金を削減できます。
| Routes API | リクエストでは、フィールドマスクを使用して、レスポンスで返すフィールドを指定する必要があります。フィールド マスキングにより、不要なデータをリクエストしないようにすることで、不要な処理時間と請求料金を回避できます。 詳細については、返されるフィールドを選択するをご覧ください。 |
| Directions API Distance Matrix API |
アプリで厳密に必要とされていない場合でも、フィールドのデフォルト リストを返します。これにより、不要な処理時間と課金が発生する可能性があります。 |
交通量のルート計算の強化
Routes API は、3 つのルーティング設定をサポートしています。これらの設定を使用すると、交通情報をリクエストする際のレスポンス レイテンシとデータ品質のバランスを取ることができます。
詳細については、品質とレイテンシの構成をご覧ください。
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_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。 |
|
リクエストで
|
| リアルタイムの交通状況を考慮した到着予定時刻。 |
|
リクエストで
|
ポリライン ウェイポイント
このサービスでは、緯度と経度の座標をポリラインのウェイポイントに変換する必要がなくなりました。このサービスは POST リクエスト本文をサポートしているため、URL 文字列の上限の影響を受けなくなりました。Distance Matrix API の一部ユーザーは、緯度/経度の地点をポリラインのウェイポイントに変換することで、リクエスト数の上限の問題に対処しています。
フォーマット済み住所（リバース ジオコーディング）
Routes API は、レスポンスでフォーマットされた住所を提供していません。フォーマットされた住所を取得するには、このユースケース用に構築され、より高品質な結果を提供する Geocoding API を使用します。
利用可能な移動手段
Directions API と同様に、ルート リクエストで移動手段が指定されていない場合、Routes API はデフォルト モードとして DRIVE を使用します。ただし、リクエストでルートの移動手段が指定されている場合、Routes API は、リクエストの代替の選択肢として利用可能な移動手段の配列を返しません。この機能に依存するユースケースの場合は、問題を報告して、その機能の使用方法を説明してください。追跡いたします。
レスポンス形式としての XML
Routes API は、レスポンス形式として XML を提供していません。目的に合った JSON から XML へのコンバータは、オンラインで多数見つかります。