Routes API クイック リファレンス

Routes API は、2 つのメソッドを備えたウェブサービスです。Compute Routes は、2 つの場所間のルートを返します(オプションで中間地点を指定可能)。Compute Route Matrix は、出発地と目的地の組み合わせ(最大 625 個のルート マトリックス要素)の移動距離と時間を返します。

Routes API: 主な特長

  • プロダクト: Routes API
  • 別名: Routes API v2、Compute Routes、Compute ルート マトリックス
  • カテゴリ: ルート
  • プラットフォーム: ウェブサービス(REST)
  • 実行場所: サーバー(バックエンド コード)
  • リリース ステージ: GA
  • ライフサイクル: アクティブ
  • 概要: Routes API の概要
  • 対象地域: グローバル。二輪車ルート、環境に優しいルート選択、通行料金の計算は、サポートされている国と都市に限定されます。独自の CLDR コードを持つ従属地域は、リストに記載されていない限りサポートされません。欧州経済領域(EEA)の請求先住所の場合、https://developers.google.com/maps/comms/eea/routes の EEA 規約により、ルートの説明やステップを地図で使用することは禁止されています。(カバレッジの詳細)

Routes API: 使用するタイミング

Routes API を使用する場合:

  • 出発地と目的地の間のルート(オプションで中間ウェイポイントを含む)が必要な場合。移動手段は、車、徒歩、自転車、二輪車、公共交通機関です。
  • 1 つのリクエストで、多数の出発地と目的地のペア(最大 625 要素)の移動距離と移動時間が必要な場合。
  • 通行料金の見積もり(一部の都市)、環境に優しいルート(一部の地域)、交通状況を考慮したポリライン、大型車両のルート設定(利用制限あり)が必要な場合。
  • 以前の Directions API または Distance Matrix API からサーバーアプリを移行する場合。

Routes API を使用すべきでない場合:

  • 車両群全体の積載割り当てと配送順序を最適化する必要があります。代わりに Route Optimization API を使用してください。
  • Android で、計算されたルートに沿ってアプリ内でターンバイターン方式のナビを行う必要があります。代わりに Navigation SDK for Android を使用してください。
  • iOS で、計算されたルートに沿ったアプリ内ターンバイターン方式のナビゲーションが必要。代わりに Navigation SDK for iOS を使用してください。

Routes API: 設定

公式の Routes API パッケージ:

  • npm: @googlemaps/routing
  • pypi: google-maps-routing
  • go: cloud.google.com/go/maps
  • Maven: com.google.maps:google-maps-routing

Routes API: よくある間違い

  • 問題: 返されるフィールドのデフォルト リストがありません。フィールド マスク(X-Goog-FieldMask ヘッダーまたは $fields パラメータ)のないリクエストはエラーを返します。修正方法: 必要なレスポンス フィールドをリストしたフィールド マスクを常に送信します。/maps/documentation/routes/choose_fields をご覧ください。
  • 問題: 本番環境でワイルドカード フィールド マスク(*)を使用すると、費用とレイテンシが増加します。また、新しい上級者向け機能がレスポンスに追加されると、費用が予期せず増加する可能性があります。修正方法: * は開発時にのみ使用し、本番環境では必要なフィールドのみをリクエストします。/maps/documentation/routes/choose_fields をご覧ください。
  • 問題: フィールド マスクに追加するだけでは、通行料金情報と燃料消費量が返されません。GA 以降、これらは明示的に有効にする必要があります。修正: フィールド マスクに加えて、extraComputations 配列(TOLLS、FUEL_CONSUMPTION など)をリクエストに追加します。/maps/documentation/routes/migrate-routes-preview をご覧ください。
  • 問題: Compute Route Matrix では 625 個の要素を使用できますが、routingPreference が TRAFFIC_AWARE_OPTIMAL の場合は 100 個の要素しか使用できません。修正: TRAFFIC_AWARE_OPTIMAL を使用する場合は、出発地 x 目的地を 100 以下に保つか、リクエストを分割します。/maps/documentation/routes/compute_route_matrix をご覧ください。

Routes API でできること

各タスクについては、以下のリンク先のガイドをご覧ください。また、機能エクスプローラでプロダクトを比較することもできます。