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"
に設定します。