Routes API は、2022 年 9 月に公開プレビュー版(pre-GA)としてリリースされました。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳細については、リリース ステージの説明をご覧ください。
このセクションでは、アプリをプレビュー リリースから一般提供リリースに移行する方法について説明します。
一般提供リリースに追加された新機能
一般提供リリースでは、プレビュー版に含まれていなかった次の新機能が追加されています。
一般提供リリースでは、プレイス ID と緯度/経度の座標のほか、次のコマンドを使用して場所を指定できるようになりました。
住所文字列(「Chicago, IL」または「Darwin, NT, Australia」)
多くの場合、ユーザーが住所を入力するために使用されるのが住所文字列です。ただし、{product_name} はルートを計算する前に、まず住所の文字列を内部でジオコーディングして緯度と経度の座標に変換する必要があります。
さらに、
regionCode
リクエスト パラメータのサポートが追加されました。これにより、特定の地域のジオコーディングされた結果を返すように指定できます。-
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"
に設定します。