このガイドでは、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 の制限(8,192 文字)に収めることができます。Routes API では、REST または gRPC リクエスト本文で地点を中間地点として送信できるため、この機能は必要ありません。
既存のパラメータを Routes API のパラメータに変換する
次の表に、Directions API と Distance Matrix API で名前が変更された、または変更されたパラメータ、または一般提供リリースでサポートされていないパラメータを示します。これらのパラメータのいずれかを使用している場合は、コードを更新してください。
Routes または Distance Matrix パラメータ | Routes API のパラメータ | メモ |
---|---|---|
alternatives |
computeAlternativeRoutes |
|
arrival_time |
TRANSIT モードを使用できないため利用できません。 |
|
avoid |
routeModifiers |
|
copyrights |
レスポンスに含まれない。結果をユーザーに表示する場合は、次のステートメントを含める必要があります。
次に例を示します。
|
|
departure_time |
departureTime |
|
distance |
distanceMeters |
距離はメートル単位で設定できます。 |
duration_in_traffic |
|
Routes API で削除しました。duration を使用してください。詳細については、前述の新しい Routes API の機能変更をご覧ください。 |
language |
languageCode |
Compute Routes でのみサポートされます。 |
mode |
travelMode |
|
region |
regionCode |
|
status |
利用できません。API から報告されたエラーには HTTP レスポンス コードを使用します。詳細については、リクエスト エラーの処理をご覧ください。 | |
traffic_model |
利用できません。 | |
transit_mode |
TRANSIT モードを使用できないため利用できません。 |
|
transit_routing_preference |
TRANSIT モードを使用できないため利用できません。 |
|
units |
ルート マトリックスでは使用できません。 | |
waypoints |
intermediates |
エンコード ポリラインのサポートを終了しました。 |
optimize=true : 地点 |
利用できません。 |