Google は AI 技術を使用して、コンテンツをご希望の言語に翻訳しています。AI 翻訳には誤りが含まれる場合があります。

Directions API（従来版）または Distance Matrix API（従来版）から移行する

欧州経済領域（EEA）のデベロッパー

このガイドでは、Directions API または Distance Matrix API を使用するアプリを Routes API を使用するように移行する方法について説明します。Routes API の詳細については、プロダクトの概要をご覧ください。

移行の請求に関するベストプラクティス

このガイダンスは、API の使用量が第 2 階層の料金体系に移行するほど多い場合に適用されます。API の新しいバージョンに移行すると、別の SKU の料金も請求されます。移行月の費用が増加しないようにするには、できるだけ月の初めに本番環境で新しい 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 のパラメータ、または GA リリースでサポートされていないパラメータを示します。これらのパラメータを使用している場合は、コードを更新してください。

リクエストパラメータの変換

Directions または距離行列のパラメータ	Routes API パラメータ	メモ
`alternatives`	`computeAlternativeRoutes`
`arrival_time`	`arrivalTime`	`TRANSIT` モードでのみ使用できます。`departureTime` と同時に使用することはできません。
`avoid`	`routeModifiers`
`departure_time`	`departureTime`	`arrivalTime` と同時に使用することはできません。
`language`	`languageCode`	Compute ルートでのみサポートされます。
`mode`	`travelMode`	`TWO_WHEELER` と `TRANSIT` のサポートを追加しました。
`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 または距離行列のパラメータ	Routes API パラメータ	メモ
`copyrights`		レスポンスには含まれません。結果をユーザーに表示する際には、次の文を含める必要があります。 `Powered by Google, ©YEAR Google` 次に例を示します。 `Powered by Google, ©2022 Google`
`distance`	`distanceMeters`	距離はメートル単位でのみ表示されます。
`duration_in_traffic`	`duration`	Routes API で削除されました。`duration` を使用してください。
`status`		利用できません。API によって報告されたエラーには、HTTP レスポンスコードを使用します。詳細については、リクエストエラーを処理するをご覧ください。
`geocoded_waypoints`	`geocoding_results`	Compute Routes でのみサポートされます。住所として指定された経由地のみのジオコーディングレスポンス情報が含まれます。
`bounds`	`viewport`
`legs.end_address`	利用できません。	高精度のルート検索には、座標ではなくプレイス ID を使用します。プレイス ID には、ルートを正しいアクセスポイントにスナップするデータが含まれています。住所から始める場合: Place Autocomplete または Geocoding API を使用して、プレイス ID に解決します。座標から始める場合: 目的地を検索を使用して、より意味のある場所を指定することを検討してください。座標から住所を取得するだけでは、複雑になり、不正確なスナップにつながる可能性があります。Routes API は、座標を住所に逆ジオコーディングしません。
`legs.start_address`	利用できません。
`overview_polyline`	ポリライン
`summary`	`description`
`waypoint_order`	`optimizedIntermediateWaypointIndex`