このガイドでは、次のいずれかを使用するアプリを移行する方法について説明します。 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 |
|
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 つ追加する必要があります。
例:
|
|
distance |
distanceMeters |
距離はメートル単位でのみ表示できます。 |
duration_in_traffic |
duration |
Routes API で削除された場合は、duration を使用します。 |
status |
利用できません。HTTP レスポンス コードを使用して、 API によって報告されたエラーですリクエスト エラーを処理するをご覧ください。 をご覧ください。 | |
geocoded_waypoints |
geocoding_results |
Compute Routes でのみサポートされています。住所として指定されたウェイポイントのジオコーディングのレスポンス情報のみが含まれます。 |
bounds |
viewport |
|
legs.end_address |
利用できません。 | |
legs.start_address |
利用できません。 | |
overview_polyline |
ポリライン | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |