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

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

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

一般提供リリースに追加された新機能

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

  • 一般提供リリースでは、プレイス ID と緯度/経度の座標のほか、次のコマンドを使用して場所を指定できるようになりました。

    • 住所文字列(「Chicago, IL」または「Darwin, NT, Australia」)

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

      さらに、regionCode リクエスト パラメータのサポートが追加されました。これにより、特定の地域のジオコーディングされた結果を返すように指定できます。

    • Plus Codes

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

  • Compute Routes のレスポンスgeocodingResults 配列が追加されました。リクエスト内の場所(出発地、目的地、中間地点)が「住所文字列」または「Plus code」として指定された場合、API はプレイス ID 検索を実行します。この配列の各要素には、ビジネスに対応するプレイス ID と、そのビジネスに関する追加のメタデータが含まれます。プレイス ID または緯度/経度座標として指定されたリクエスト内の場所は無視されます。

既存のプレビュー機能に対する変更

新しい配列 extraComputations フィールドをリクエストに追加して、一般提供の次の機能を明示的に有効にする必要があります。

プレビュー リリースでは、フィールド マスクを使用して、レスポンスでこれらの機能の情報を返すように指定していました。次の 2 つの要件を満たす必要があります。

  • これらの機能を有効にするには、新しい 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" に設定します。