Directions API または Distance Matrix API から移行する

このガイドでは、Directions API または Distance Matrix API を使用するアプリを Routes API を使用するように移行する方法について説明します。Routes API の詳細については、プロダクトの概要をご覧ください。

REST API エンドポイントを更新する

新しい Routes API エンドポイントを使用するようにコードを更新します。

Directions API から

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

Distance Matrix API から

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

HTTPS リクエスト本文を使用するように URL パラメータを変換する

Directions API と Distance Matrix API を使用すると、HTTP GET リクエストに構成プロパティを URL パラメータとして渡します。たとえば、Directions API では、次のようになります。

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

Routes API では、リクエスト本文またはヘッダーで HTTP POST リクエストの一部としてパラメータを渡します。例については、次をご覧ください。

エンコードされたポリラインとして表される地点を中間地点に変換する

地点をエンコード ポリラインとして指定すると、Directions API で多数の地点を URL の制限(8,192 文字)に収めることができます。Routes API では、REST または gRPC リクエスト本文で地点を中間地点として送信できるため、この機能は必要ありません。

既存のパラメータを Routes API のパラメータに変換する

次の表に、Directions API と Distance Matrix API で名前が変更された、または変更されたパラメータ、または一般提供リリースでサポートされていないパラメータを示します。これらのパラメータのいずれかを使用している場合は、コードを更新してください。

Routes または Distance Matrix パラメータ Routes API のパラメータ メモ
alternatives computeAlternativeRoutes
arrival_time TRANSIT モードを使用できないため利用できません。
avoid routeModifiers
copyrights

レスポンスに含まれない。結果をユーザーに表示する場合は、次のステートメントを含める必要があります。

Powered by Google, ©YEAR Google

次に例を示します。

Powered by Google, ©2022 Google

departure_time departureTime
distance distanceMeters 距離はメートル単位で設定できます。
duration_in_traffic Routes API で削除しました。duration を使用してください。詳細については、前述の新しい Routes API の機能変更をご覧ください。
language languageCode Compute Routes でのみサポートされます。
mode travelMode

TWO_WHEELER のサポートを追加しました。

TRANSIT モードは利用できません。

region regionCode

status 利用できません。API から報告されたエラーには HTTP レスポンス コードを使用します。詳細については、リクエスト エラーの処理をご覧ください。
traffic_model 利用できません。
transit_mode TRANSIT モードを使用できないため利用できません。
transit_routing_preference TRANSIT モードを使用できないため利用できません。
units ルート マトリックスでは使用できません。
waypoints intermediates エンコード ポリラインのサポートを終了しました。
optimize=true: 地点 利用できません。