Routes API は、2022 年 9 月に公開プレビュー（pre-GA）としてリリースされました。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳細については、リリース ステージの説明をご覧ください。
このセクションでは、プレビュー リリースから一般提供リリースにアプリを移行する方法について説明します。
一般提供版に追加された新機能
一般提供リリースでは、プレビューに含まれていなかった次の新機能が追加されています。
一般提供版では、プレイス ID と緯度と経度の座標のほかに、以下を使用して場所を指定できるようになりました。
住所文字列（「Chicago, IL」、「Darwin, NT, Australia」）
多くの場合、ユーザーが住所を入力するときに、住所文字列を使用します。ただし、{product_name} はまず、住所の文字列を内部でジオコーディングして緯度/経度の座標に変換する必要があります。これにより、ルートが計算されるようになります。
また、
regionCodeリクエスト パラメータのサポートが追加されました。これにより、特定の地域のジオコーディングの結果を返すように指定できます。-
Plus Codes は、実際の住所が存在しない人や場所を示す番地のようなものです。Plus Codes は、番地や番号が付加された住所ではなく、緯度と経度に基づいており、数字と文字で表示されます。
コンピューティングルートのレスポンスに
geocodingResults配列が含まれるようになりました。住所文字列または Plus Code として指定されたリクエストに含まれる場所（出発地、目的地、中間地点）ごとに、API でプレイス ID の検索が行われます。この配列の各要素には、場所に対応するプレイス ID と、場所に関する追加のメタデータが含まれます。プレイス ID または緯度/経度の座標として指定されたリクエスト内の場所は無視されます。
既存のプレビュー機能に対する変更
今後、一般提供では、新しい配列 extraComputations フィールドをリクエストに追加して、次の機能を明示的に有効にする必要があります。
プレビュー リリースでは、フィールド マスクを使用して、レスポンスでこれらの機能の情報を返すように指定していました。次に、以下の両方を行う必要があります。
- これらの機能を有効にするには、新しい
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"に設定します。