このガイドでは、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 |
URL パラメータを変換して HTTPS リクエスト本文を使用する
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 では、エンコードされたポリラインとしてウェイポイントを指定することで、URL の制限である 16,384 文字内に多数のウェイポイントを収めることができます。Routes API では、REST または gRPC リクエスト本文でウェイポイントを緯度と経度の座標として送信できるため、この機能は必要ありません。例については、ルート マトリックスを計算するドキュメントの 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 つのステップと見なされ、その移動手段の個々のルートはサブステップとみなされます。一方、Routes API では、ステップはすべての移動タイプで常に 1 つのナビゲーション指示です。つまり、各ナビゲーション命令がステップです。 1 つの移動モードで複数のステップがある場合、Routes API は、その移動モードのステップの概要を含むメタデータを「stepsOverview」に提供します。このメタデータをリクエストするには、「routes.legs.stepsOverview」フィールドマスクを使用します。詳細 |
transit_routing_preference |
transitRoutingPreference |
詳細 |
units |
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 ルートでのみサポートされます。住所として指定されたウェイポイントのジオコーディングのレスポンス情報のみが含まれます。 |
bounds |
viewport |
|
legs.end_address |
利用できません。 | |
legs.start_address |
利用できません。 | |
overview_polyline |
ポリライン | |
summary |
description |
|
waypoint_order |
optimizedIntermediateWaypointIndex |