ライドシェアリングでの移動に最適なルートを決定する際、最速のルートが最適な選択肢とは限りません。ルートを計画することをおすすめします。
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 メソッドの使用例については、カスタムルートの計算（ベータ版）の例をご覧ください。
通行料金の計算
通行料の計算については、通行料を計算するをご覧ください。
通行料の計算例については、カスタムルートの計算例をご覧ください。