カスタムルートを計画する

非推奨: ComputeCustomRoutes メソッドは非推奨となり、新規顧客にはご利用いただけません。

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

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 コンソールの 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 メソッドの使用例については、カスタムルートの計算の例をご覧ください。

通行料金の計算

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

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