このガイドでは、Directions / 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 を使用する場合は、設定プロパティを URL パラメータとして HTTP GET リクエストに渡します。たとえば、Directions API の場合は次のようになります。
https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API では、HTTP POST リクエストの一部として、リクエスト本文またはヘッダーでパラメータを渡します。例については、次をご覧ください。
ポリラインでエンコードされた地点を地点の地点に変換する
Directions API では、地点をエンコード ポリラインとして指定することで、16,384 文字の URL 制限内に多数の地点を配置できます。地点は REST または gRPC リクエスト本文で緯度と経度の座標として送信できるため、Routes API ではこの機能は必要ありません。例については、ルート マトリックスの計算のドキュメントの HTTP の例または中間のウェイポイントの指定のドキュメントの中間ウェイポイントの定義をご覧ください。
パラメータを変換する
次の表に、Directions API と Distance Matrix API で名前が変更された、または変更されたパラメータと、一般提供版でサポートされていないパラメータを示します。これらのパラメータのいずれかを使用している場合は、コードを更新してください。
リクエスト パラメータの変換
| 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 つの交通機関のルート内で同じ移動手段（徒歩や公共交通機関など）が使用されるルートの各セグメントは 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 |
レスポンスには含まれません。結果をユーザーに表示する場合は、次のステートメントを含める必要があります。
例:
|
|
distance |
distanceMeters |
距離はメートル単位でのみ指定できます。 |
duration_in_traffic |
duration |
Routes API で削除されました。duration を使用してください。 |
status |
利用できません。API から報告されたエラーには、HTTP レスポンス コードを使用します。詳しくは、リクエスト エラーの処理をご覧ください。 | |
geocoded_waypoints |
geocoding_results |
Compute Routes でのみサポートされます。住所として指定された地点のジオコーディング レスポンス情報のみが含まれます。 |
bounds |
viewport |
|
legs.end_address |
利用できません。 | |
legs.start_address |
利用できません。 | |
overview_polyline |
ポリライン | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |