Google 피트니스 앱과 동일한 값 (걸음 수, 칼로리, 이동 거리 등)을 얻으려면 어떻게 하나요?
Google 피트니스 앱과 동일한 값을 얻으려면 데이터 유형별로 읽는 것이 좋습니다. 여기에서 일일 걸음 수를 읽는 방법을 알아보세요.
Google 피트니스 플랫폼은 다양한 소스에서 특정 데이터 유형에 사용할 수 있는 모든 정보를 검토하고 논리적인 방식으로 병합합니다. 예를 들어 사용자가 스마트시계와 휴대전화로 달리기를 추적합니다. 가장 완전한 걸음 수를 계산하기 위해 시계와 휴대전화의 걸음 수가 병합됩니다. 데이터를 병합하면 시계 데이터가 전화 데이터보다 우선순위가 높습니다 (우선순위를 지정하여 중복 단계가 계산되지 않음). 데이터 유형을 읽을 때 Google 피트니스 플랫폼은 이렇게 정확하고 병합된 정보를 반환합니다.
특히 단계에는 이러한 추가 검증이 적용되어 최종 단계 수를 최대한 정확하게 계산할 수 있습니다.
Google 피트니스는 사용자가 걸음 수에 반영되지 않는 활동 (예: 자전거 타기, 운전, 대중교통 이동)을 할 때 이를 감지하고 최종 걸음 수에서 삭제합니다.
Google 피트니스 앱은 Android 및 iOS 앱과 Wear OS가 설치된 스마트시계의 Google 피트니스 앱에서 더 정확한 예상 걸음 수를 표시합니다.
데이터 유형이 아닌 앱의 데이터 소스로 읽으며 앱에서 로컬 걸음 수 데이터만 사용하는 경우 걸음 수는 Google 피트니스 앱의 걸음 수와 다릅니다.
데이터 유형을 읽고 있지만 값이 Google 피트니스 앱과 여전히 다른 경우 동기화 지연으로 인한 일시적인 수치 차이일 수 있습니다. 백엔드에는 최신 버전의 데이터가 있으며 백엔드와 동기화되면 앱에 동일한 값이 표시됩니다.
다른 앱이나 기기에서 플랫폼에 쓴 데이터를 읽으려면 어떻게 해야 하나요?
REST API의 경우 데이터 소스 나열을 위한 HTTP 요청을 수행합니다.
응답에는 앱에서 읽을 수 있는 모든 데이터 소스가 나열됩니다.
Android API의 경우 데이터 유형별로 읽으면 피트니스 플랫폼에서 기본적으로 병합된 스트림을 반환합니다. 여기에는 다른 앱에서 작성한 데이터를 포함하여 앱에서 사용할 수 있는 모든 데이터가 자동으로 포함됩니다. Android API와 함께 데이터를 가져온 앱이나 기기의 목록은 볼 수 없습니다.
API를 사용하려면 Google 피트니스 앱을 설치해야 하나요?
아니요. API 또는 피트니스 플랫폼을 사용하기 위해 Google 피트니스 앱을 설치할 필요는 없습니다.
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\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."]]