ルートの計画

このプロダクトまたは機能は、pre-GA（一般提供前）のプレビュー版です。pre-GA のプロダクトや機能では、サポートが限定されることがあります。また、pre-GA のプロダクトや機能を変更すると、他の pre-GA バージョンに対応しなくなる場合があります。pre-GA のサービスには、Google Maps Platform サービス固有の規約が適用されます。詳しくは、リリース ステージの説明をご覧ください。

ライドシェアの移動に最適なルートを決定する際、必ずしも最速のルートが最適とは限りません。ルートを計画することをおすすめします。

Routes Preferred API を使用すると、ComputeCustomRoutes メソッドを使用してルートの目的を指定することで、ルートを計画できます。

また、ComputeCustomRoutes メソッドは、オペレーターが選択したルートと走行したルートの差を最小限に抑えることで、ルートのコンプライアンスにも役立ちます。

ルート計画のメリットを最大限に活用するには、Routes Preferred API と Navigation SDK の両方を使用します。

注: Routes Preferred API と Navigation SDK で同じクラウド プロジェクトを使用する必要はありません。

注: ComputeRoutes API とは異なり、ComputeCustomRoutes は DRIVE（または同等の TRAVEL_MODE_UNSPECIFIED）と TWO_WHEELER の 2 つの移動手段のみをサポートしています。また、このメソッドは via 中間地点もサポートしていません。他の交通手段や via 経由地を使用しようとすると、リクエストは失敗します。via 地点の詳細については、Routes Preferred API の地点をご覧ください。

ComputeCustomRoutes メソッドを有効にする

コードで ComputeCustomRoutes メソッドを使用するには、まずこのメソッドを有効にする必要があります。Routes Preferred API メソッドの有効化の詳細については、スタートガイドをご覧ください。

重要: Routes Preferred API メソッドの割り当て上限を確認してください。割り当て上限を引き上げる必要がある場合は、Google Cloud Console の Google Maps Platform サポートページでケースを報告するか、Google Cloud サポート ホットラインにお電話ください。

ComputeCustomRoutes メソッドを使用する

ComputeCustomRoutes メソッドでは、入力でレスポンス フィールド マスクを指定する必要があります。レスポンス フィールド マスクは、URL パラメータ $fields または fields を使用するか、HTTP/gRPC ヘッダー X-Goog-FieldMask を使用して指定できます。詳細については、システム パラメータをご覧ください。

フィールド マスクの値は、フィールド パスのカンマ区切りリストです。各フィールド パスは、メッセージ階層を表すフィールド名のドット区切りリストです。フィールド名は、JSON オブジェクト キーまたは protobuf フィールド タグ名です。フィールド パスは最上位のレスポンス メッセージ タイプから始まり、必要に応じて 1 つ以上のドットと次のレベルのフィールド名が続きます。一般に、フィールド パスは次のように構築されます。

topLevelField[.secondLevelField][.thirdLevelField][...]

特殊なケースのフィールド マスクはワイルドカード「*」で、すべてのルートレベルのフィールドを選択します。

詳しくは以下をご覧ください。

• gRPC API リファレンス
• REST API リファレンス

ComputeCustomRoutes メソッドの使用例については、カスタムルートの計算（ベータ版）の例をご覧ください。

通行料金の計算

通行料金の計算については、通行料金を計算するをご覧ください。

通行料金の計算例については、カスタム ルートの計算例をご覧ください。