ルートの計画

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

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

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

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

ComputeCustomRoutes メソッドを有効にする

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

ComputeCustomRoutes メソッドを使用する

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

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

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

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

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

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

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

通行料金の計算

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

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