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

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 は緯度と経度に基づいて数字と文字で表示されます。

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