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

欧州経済領域（EEA）のデベロッパー

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配列が含まれるようになりました。リクエスト内の場所（出発地、 目的地、中間経由地）が住所 文字列 またはプラスコード として指定されている場合、API は場所 ID のルックアップを実行します。この配列の各要素には、場所に対応する場所 ID と、場所に関する追加のメタデータが含まれます。場所 ID または緯度/経度座標として指定されたリクエスト内の場所は無視されます。

既存のプレビュー機能の変更

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

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

  • 新しい extraComputations 配列リクエスト パラメータを設定して、これらの機能を有効にします。
  • フィールド マスクを設定して、レスポンスで情報を返すように指定します。

必知事項

`extraComputations` を設定して明示的に有効にしない限り、次のフィールドは computeRouteMatrix レスポンス に含まれなくなります。

  • travelAdvisory.tollInfo（通行料金情報）

computeRoutes レスポンス で extraComputations を設定して明示的に有効にしない限り、次のフィールドは含まれなくなります。

  • routes.legs.travelAdvisory.tollInfo（通行料金情報）
  • routes.travelAdvisory.tollInfo（通行料金情報）
  • routes.travelAdvisory.fuelConsumptionMicroliters（燃料消費量）
  • routes.travelAdvisory.speedReadingIntervals（ポリライン上の交通状況）
  • routes.legs.travelAdvisory.speedReadingIntervals（ポリライン上の交通状況）

必要なご対応

通行料金情報、燃料消費量、ポリライン上の交通状況のレスポンス フィールドを受け取るには、新しいリクエスト配列フィールド extraComputations を設定して、次の 1 つ以上の値を含める必要があります。