ルートの計画

ライドシェアリングの最適なルートを決定する際は、最速ルートが必ずしも最適な選択肢になるとは限りません。ルートを計画してもよいでしょう。

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][...]

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

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

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

通行料の計算

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

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