このページは Cloud Translation API によって翻訳されました。

Directions API または Distance Matrix API から移行する

このガイドでは、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`		レスポンスに含まれない。結果をユーザーに表示する場合は、次のステートメントを含める必要があります。 `Powered by Google, ©YEAR Google` 次に例を示します。 `Powered by Google, ©2022 Google`
`departure_time`	`departureTime`
`distance`	`distanceMeters`	距離はメートル単位で設定できます。
`duration_in_traffic`		Routes API で削除しました。`duration` を使用してください。詳細については、前述の新しい Routes API の機能変更をご覧ください。
`language`	`languageCode`	Compute Routes でのみサポートされます。
`mode`	`travelMode`	`TWO_WHEELER` のサポートを追加しました。 `TRANSIT` モードは利用できません。
`region`	`regionCode`
`status`		利用できません。API から報告されたエラーには HTTP レスポンスコードを使用します。詳細については、リクエストエラーの処理をご覧ください。
`traffic_model`		利用できません。
`transit_mode`		`TRANSIT` モードを使用できないため利用できません。
`transit_routing_preference`		`TRANSIT` モードを使用できないため利用できません。
`units`		ルートマトリックスでは使用できません。
`waypoints`	`intermediates`	エンコードポリラインのサポートを終了しました。
`optimize=true`: 地点		利用できません。