APIهای Google Fit، از جمله Google Fit REST API، در سال 2026 منسوخ خواهند شد . از 1 می 2024، توسعه دهندگان نمی توانند برای استفاده از این API ها ثبت نام کنند .
چگونه می توانم مقادیر مشابه (شمار گام، کالری، مسافت و غیره) را با برنامه Google Fit دریافت کنم؟
خواندن بر اساس نوع داده را برای دریافت مقادیر مشابه با برنامه Google Fit توصیه می کنیم. نحوه خواندن تعداد گام های روزانه را در اینجا بیاموزید.
پلتفرم Google Fit تمام اطلاعات موجود برای یک نوع داده خاص را از منابع مختلف بررسی می کند و آنها را به روشی منطقی ادغام می کند. به عنوان مثال، یک کاربر با ساعت هوشمند و تلفن خود، دویدن را ردیابی می کند. تعداد گامهای ساعت و تلفن آنها ادغام میشوند تا کاملترین تعداد گامها را به دست آورند. هنگام ادغام دادهها، دادههای ساعت بر دادههای تلفن اولویت دارند (اولویتبندی از شمارش مراحل تکراری جلوگیری میکند). وقتی نوع داده را میخوانید، پلتفرم Google Fit این اطلاعات دقیق و ادغامشده را برمیگرداند.
به ویژه در مراحل، این اعتبار سنجی اضافی اعمال می شود تا شمارش مرحله نهایی تا حد امکان دقیق باشد.
Google Fit تشخیص میدهد که کاربران چه زمانی فعالیتهایی را انجام میدهند که نباید به تعداد قدمهای آنها کمک کند (مانند دوچرخهسواری، رانندگی یا سفر با حملونقل عمومی) و این موارد را از تعداد مراحل نهایی حذف میکند.
برنامه Google Fit این تعداد گام دقیقتر و تخمینی را هم در برنامه Android و iOS و هم در برنامه Google Fit در ساعتهای هوشمند دارای سیستم عامل Wear OS نشان میدهد.
اگر بر اساس منبع داده برنامه خود به جای نوع داده مطالعه میکنید و برنامه شما فقط از دادههای گام محلی استفاده میکند، تعداد گامها با تعداد گامها در برنامه Google Fit متفاوت خواهد بود.
اگر در حال خواندن انواع دادهها هستید اما مقادیر هنوز با برنامه Google Fit متفاوت است، این تفاوت موقت در اعداد ممکن است به دلیل تأخیر همگامسازی باشد. Backend ما جدیدترین نسخه داده را دارد و برنامه شما پس از همگام سازی با Backend مقادیر مشابهی را نشان می دهد.
چگونه می توانم داده های نوشته شده توسط برنامه ها یا دستگاه های دیگر روی پلتفرم را بخوانم؟
برای REST API، یک درخواست HTTP برای فهرست کردن منابع داده ایجاد کنید. پاسخ، تمام منابع دادهای را که برنامه شما برای خواندن در دسترس است فهرست میکند.
برای APIهای Android، خواندن بر اساس نوع داده و پلتفرم Fit جریان ادغام شده را به طور پیشفرض برمیگرداند. این به طور خودکار شامل تمام داده های موجود برای برنامه شما می شود، از جمله داده های نوشته شده توسط برنامه های دیگر. نمیتوانید فهرستی از برنامهها یا دستگاههایی را ببینید که دادهها با APIهای Android از کدام برنامهها یا دستگاهها آمدهاند.
آیا برای استفاده از APIها باید برنامه Google Fit را نصب کنم؟
خیر، برای استفاده از APIها یا پلتفرم Fit نیازی به نصب برنامه Google Fit ندارید.
تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی.
[null,null,["تاریخ آخرین بهروزرسانی 2025-08-29 بهوقت ساعت هماهنگ جهانی."],[[["\u003cp\u003eTo get the same values (e.g., step count) as the Google Fit app, read data by data type, as the platform merges information from various sources for accuracy.\u003c/p\u003e\n"],["\u003cp\u003eAccessing data written by other apps requires user authorization for relevant Fitness scopes, otherwise, you can only access data written by your app.\u003c/p\u003e\n"],["\u003cp\u003eUsing Google Fit APIs or the platform does not require the Google Fit app to be installed.\u003c/p\u003e\n"]]],[],null,["# Frequently Asked Questions (FAQ)\n\n- [How do I get the same values (step count, calories, distance etc.) as the Google Fit app?](#get-same-values)\n- [How do I read data written to the platform by other apps or devices?](#query-data-sources)\n- [Do I need to install the Fit app to use the APIs?](#install-fit-app)\n\nHow do I get the same values (step count, calories, distance etc.) as the Google Fit app?\n-----------------------------------------------------------------------------------------\n\nWe recommend reading by data type to get the same values as the Google Fit app.\nLearn how to read the daily step count [here](/fit/scenarios/read-daily-step-total).\n\nThe Google Fit platform reviews all the information available for a specific\ndata type from different sources and merges it in a logical way. For example, a\nuser tracks a run with their smart watch and their phone. The step counts from\ntheir watch and phone are merged to get the most complete step count. When\nmerging data, watch data is prioritised over phone data (prioritisation avoids\ncounting duplicate steps). The Google Fit platform returns this accurate, merged\ninformation when you read the data type.\n\nSteps in particular have these extra validation applied to make the final step\ncount as accurate as possible.\n\nGoogle Fit detects when users are doing activities that shouldn't contribute\nto their step count (like cycling, driving or travelling via public transport)\nand removes these from the final step count.\n\nThe Google Fit app shows this more accurate, **estimated step count** on both\nthe Android and iOS app, and the Google Fit app on smart watches with Wear\nOS.\n\nIf you read by your app's data source rather than by data type, and your app\nonly uses local step data, the step count will be different from the step count\nin the Google Fit app.\n\nIf you're reading the data types but values are *still* different from the\nGoogle Fit app, this temporary difference in numbers could be due to syncing\ndelays. Our backend has the most recent version of data and your app will show\nthe same values once it's synced with the backend.\n\nHow do I read data written to the platform by other apps or devices?\n--------------------------------------------------------------------\n\n| **Note:** These requests require authorization from the [relevant Fitness\n| scopes](https://developers.google.com/identity/protocols/oauth2/scopes#fitness). If users are happy to share their information with your app and have authorised the relevant scopes, you'll see results. Otherwise you can only access the data your own app has written.\n\nFor the REST API, make an HTTP request to [list data\nsources](https://developers.google.com/fit/rest/v1/reference/users/dataSources/list).\nThe response will list all the data sources available to your app to read.\n\nFor the Android APIs, read by data type and the Fit platform will return the\nmerged stream by default. This automatically includes all data available to your\napp, including data written by other apps. You won't be able to see a list of\nwhich apps or devices the data came from with the Android APIs.\n\nDo I need to install the Google Fit app to use the APIs?\n--------------------------------------------------------\n\nNo, you don't need to install the Google Fit app to use the APIs or the Fit\nplatform."]]