プレビュー リリースからの移行

Routes API は、2022 年 9 月に公開プレビュー版（一般提供前）としてリリースされました。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳細については、リリース ステージの説明をご覧ください。

このセクションでは、アプリをプレビュー リリースから一般提供リリースに移行する方法について説明します。

一般提供版に追加された新機能

一般提供版では、プレビュー版には含まれていなかった次の新機能が追加されています。

• プレイス ID と緯度/経度座標に加えて、GA リリースでは次の方法で場所を指定できるようになりました。

  • 住所文字列（「シカゴ、イリノイ」、「ダーウィン、NT、オーストラリア」など）

    住所文字列は、ユーザーが住所を入力する際によく使用されます。ただし、{product_name} は、ルートを計算する前に、住所文字列を内部でジオコーディングして緯度と経度の座標に変換する必要があります。

    また、regionCode リクエスト パラメータのサポートが追加され、特定の地理的地域のジオコード結果を返すように指定できるようになりました。

  • プラスコード

    Plus Codes は、実際の住所がない人や場所の番地のようなものです。Plus Code は、通りの名前と番地を含む住所ではなく、緯度と経度に基づいており、数字と文字で表示されます。

• コンピューティング ルートのレスポンスに 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" に設定します。