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 数の上限は 16,384 文字です。この機能は 必要があります。これは、ウェイポイントはルート内で送信できるため、 緯度と経度の座標としての REST または gRPC リクエスト本文。たとえば 詳しくは、 HTTP の例 をご覧ください。または、ルート マトリックスの計算のドキュメントを参照してください。 中間地点を定義する 「中間ウェイポイントの指定」ドキュメントをご覧ください。

パラメータを変換する

次の表に、 Directions API と Distance Matrix API 名前や変更された内容、Google アナリティクスでサポートされていないパラメータ なります。これらのパラメータを使用している場合は、コードを更新してください。

パラメータの変換をリクエストする

Directions または Distance Matrix パラメータ Routes API パラメータ メモ
alternatives computeAlternativeRoutes
arrival_time arrivalTime TRANSIT モードでのみ使用可能で、同じでは使用できません。 時刻は departureTime です。
avoid routeModifiers
departure_time departureTime arrivalTime と同時には使用できません。
language languageCode Compute Routes でのみサポートされています。
mode travelMode

TWO_WHEELER と TRANSIT。
region regionCode
traffic_model trafficModel 詳細
transit_mode "travelMode": "TRANSIT" Directions API では、交通機関のルートでは、 あるルートの区間を、同じ交通手段（徒歩、 乗換案内など）は 1 つのステップと見なされ、各ルートの サブステップです対照的に、 Routes API では、手順は一貫して 1 つのナビゲーション手順である あらゆる旅行業界のユーザーに提供しています。つまり、各ナビゲーション命令が 1 つのステップとなります。 1 つの移動手段で複数のステップを実行する場合、Routes API は その交通手段の手順の概要を含むメタデータを `stepsOverview`.このメタデータをリクエストするには、 「routes.legs.stepsOverview」フィールド マスク。 詳細
transit_routing_preference transitRoutingPreference 詳細
units ルート マトリックスでは使用できません。
waypoints intermediates エンコードされたポリラインのサポートを削除しました。
optimize=true（地点） "optimizeWaypointOrder": "true" 詳細

レスポンス パラメータの変換

Directions または Distance Matrix パラメータ Routes API パラメータ メモ
copyrights

回答には含まれません。次の情報を含める必要があります ステートメントを 2 つ追加する必要があります。

Powered by Google, ©YEAR Google

例:

Powered by Google, ©2022 Google
distance distanceMeters 距離はメートル単位でのみ表示できます。
duration_in_traffic duration Routes API で削除された場合は、duration を使用します。
status 利用できません。HTTP レスポンス コードを使用して、 API によって報告されたエラーですリクエスト エラーを処理するをご覧ください。 をご覧ください。
geocoded_waypoints geocoding_results Compute ルートでのみサポートされます。住所として指定されたウェイポイントのジオコーディングのレスポンス情報のみが含まれます。
bounds viewport
legs.end_address 利用できません。
legs.start_address 利用できません。
overview_polyline ポリライン
summary description
waypoint_order optimizedIntermediateWaypointIndex