コンテンツにスキップ

ランニング効率API

ランニングの効率を定量化し、スピード向上につながるトレーニングのヒントを返します。

エンドポイント

  • GET /api/v1/fitness/running-economy
  • POST /api/v1/fitness/running-economy/post

パラメータ

名前 タイプ 必須 クエリ/ボディ 説明
pace_per_km 数値 (2.0-15.0) はい クエリ/ボディ 1kmあたりの平均ペース (分)。
heart_rate_avg 数値 (80-210) はい クエリ/ボディ 平均心拍数 (bpm)。
vo2max 数値 (15-90) はい クエリ/ボディ VO2 maxの推定/値。
body_weight 数値 (35-250) はい クエリ/ボディ 体重 (kg)。
lang 文字列 いいえ クエリ レスポンス言語 (en,es,de,fr,pt,ja,hi,ar)。

このエンドポイントを使用する理由

  • ランニングのデータを1つの明確な効率信号に変換する。
  • パーセンタイルとバンドを使用してパフォーマンスを比較する。
  • 改善のための実用的なヒントを返す。

始める

リクエストの例

curl -X GET "https://api.hefitapi.com/api/v1/fitness/running-economy?pace_per_km=4.9&heart_rate_avg=162&vo2max=51&body_weight=73&lang=en" \
  -H "X-API-Key: YOUR_API_KEY"

curl -X POST "https://api.hefitapi.com/api/v1/fitness/running-economy/post?lang=en" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: YOUR_API_KEY" \
  -d '{"pace_per_km":5.6,"heart_rate_avg":171,"vo2max":45,"body_weight":80}'

レスポンスの例

Info

以下のレスポンス例は、デモンストレーションのみを目的としています。 このエンドポイントに実際のリクエストを送信して、完全でリアルタイム、および可能性のあるより詳細なJSON構造を受け取ります。

{
  "pace_per_km": 4.9,
  "heart_rate_avg_bpm": 162.0,
  "vo2max_ml_kg_min": 51.0,
  "body_weight_kg": 73.0,
  "running_efficiency_score": 79,
  "efficiency_band": {"band": "strong", "band_label": "Strong", "insight": "Strong economy profile with room for refinement."},
  "economy_percentile": 79,
  "economy_index": 33.2,
  "efficiency_components": {"pace_component": 41.4, "heart_rate_component": 15.4, "aerobic_component": 39.0, "mass_penalty": 2.9},
  "improvement_lever_suggestions": ["Use threshold intervals and aerobic volume consistency"],
  "stimulus_focus": "Threshold + aerobic durability",
  "confidence_score": 87,
  "summary": "Running economy is strong with targeted gains available.",
  "language": "en",
  "_enterprise": {"client": "Acme Health", "plan": "pro", "request_id": "93027cd0f866757d", "quota": 120, "usage_tracking": true},
  "_api_metadata_": {"endpoint_name": "fitness_running_economy", "response_language": "en"}
}

製品ポジショニング

エンドゥランス分析、トレーニングアプリ、およびレースパフォーマンス製品向けの差別化された機能。

注意

pace_per_km はkm/hではなく、分/km形式を期待します。

推奨されるエンドポイント