このガイドでは、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 では、構成プロパティを 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 つのステップとなります。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 |