Routes API は、2022 年 9 月に公開プレビュー版（pre-GA）としてリリースされました。一般提供前サービスには、Google Maps Platform サービス固有の規約が適用されます。詳細については、リリース ステージの説明をご覧ください。
このセクションでは、プレビュー リリースから一般提供リリースにアプリを移行する方法について説明します。
一般提供版に追加された新機能
一般提供版リリースでは、プレビュー版には含まれていなかった次の新機能が追加されています。
プレイス ID と緯度/経度座標に加えて、GA リリースでは次の方法で場所を指定できるようになりました。
住所文字列（「シカゴ、イリノイ」、「ダーウィン、NT、オーストラリア」など）
住所文字列は、ユーザーが住所を入力する際によく使用されます。ただし、{product_name} でルートを計算するには、まず住所文字列を内部でジオコーディングして緯度と経度の座標に変換する必要があります。
また、
regionCodeリクエスト パラメータのサポートが追加され、特定の地理的地域のジオコード結果を返すように指定できるようになりました。-
Plus Codes は、実際の住所がない人や場所の番地のようなものです。Plus Codes は、通りの名前や番地を含む住所ではなく、緯度と経度に基づいており、数字と文字で表示されます。
ルート計算レスポンスに
geocodingResults配列が含まれるようになりました。リクエスト内のすべての場所（出発地、目的地、中間経由地）が住所文字列またはプラスコードとして指定されている場合、API はプレイス ID のルックアップを実行します。この配列の各要素には、位置に対応するプレイス ID と、その位置に関する追加のメタデータが含まれます。リクエストでプレイス ID または緯度と経度の座標として指定された位置は無視されます。
既存のプレビュー機能の変更
リクエストに新しい配列 extraComputations フィールドを追加して、GA で次の機能を明示的に有効にする必要があります。
プレビュー リリースでは、フィールド マスクを使用して、レスポンスでこれらの機能の情報を返すように指定していました。ここで、次の両方を行う必要があります。
- これらの機能を有効にするには、新しい
extraComputations配列リクエスト パラメータを設定します。 - フィールド マスクを設定して、レスポンスで情報を返すように指定します。
概要
extraComputations を設定して明示的に有効にしない限り、次のフィールドは computeRouteMatrix レスポンスに含まれなくなります。
travelAdvisory.tollInfo（通行料金情報）
extraComputations を設定して明示的に有効にしない限り、次のフィールドは computeRoutes レスポンスに含まれなくなります。
routes.legs.travelAdvisory.tollInfo（通行料金情報）routes.travelAdvisory.tollInfo（通行料金情報）routes.travelAdvisory.fuelConsumptionMicroliters（燃費）routes.travelAdvisory.speedReadingIntervals（ポリラインの交通情報）routes.legs.travelAdvisory.speedReadingIntervals（ポリラインの交通情報）
必要なご対応
ポリライン上の有料道路情報、燃料消費量、交通状況のレスポンス フィールドを取得するには、新しいリクエスト配列フィールド extraComputations を設定して、次の 1 つ以上の値を含める必要があります。
通行料金情報を受け取るには、新しい
extraComputations配列フィールドを"TOLLS"に設定します。燃料消費量を受け取るには、新しい
extraComputations配列フィールドを"FUEL_CONSUMPTION"に設定します。ポリラインの交通情報を受信するには、新しい
extraComputations配列フィールドを"TRAFFIC_ON_POLYLINE"に設定します。