다양한 기기와 앱의 데이터를 저장하는 중앙 저장소입니다. 피트니스 스토어는 클라이언트에게 투명한 클라우드 서비스입니다.
센서 프레임워크
피트니스 스토어를 쉽게 사용할 수 있는 상위 수준 표현 집합입니다. Google Fit API와 함께 이러한 표현을 사용합니다.
권한 및 사용자 제어
건강 및 웰빙 데이터를 사용할 수 있도록 사용자 권한을 요청하는 승인 범위 모음입니다. Google 피트니스에서 건강 및 웰빙 데이터에 액세스하려면 사용자 동의가 필요합니다.
Google Fit API
피트니스 스토어에 액세스하기 위한 Android 및 REST API. Android, iOS, 웹 앱과 같은 여러 플랫폼과 기기에서 Google 피트니스를 지원하는 앱을 만들 수 있습니다.
피트니스 매장
피트니스 스토어는 Google의 인프라를 사용하여 건강 및 웰빙 데이터를 유지하는 클라우드 서비스입니다. 다양한 플랫폼과 기기의 앱은 데이터를 저장하고 다른 앱에서 만든 데이터에 액세스할 수 있습니다. Google 피트니스는 쉽게 데이터를 삽입하고 피트니스 매장을 쿼리할 수 있는 API 세트를 제공합니다.
센서 프레임워크
센서 프레임워크는 센서, 데이터 유형, 데이터 포인트 및 세션의 상위 수준 표현을 정의합니다. 이러한 표현을 사용하면 모든 플랫폼에서 피트니스 스토어와 쉽게 작업할 수 있습니다.
데이터 소스
데이터 소스는 센서를 나타내며 이름, 수집된 데이터 유형, 기타 센서 세부정보로 구성됩니다. 데이터 소스는 하드웨어 센서 또는 소프트웨어 센서를 나타낼 수 있습니다. 앱에서 소프트웨어 센서를 정의할 수 있습니다.
데이터 유형
데이터 유형은 걸음 수나 심박수와 같은 다양한 종류의 건강 및 웰빙 데이터를 나타냅니다. 데이터 유형은 여러 앱이 서로의 데이터를 이해할 수 있는 스키마를 설정합니다. 데이터 유형은 이름과 정렬된 필드 목록으로 구성되며, 각 필드는 측정기준을 나타냅니다. 예를 들어 위치의 데이터 유형에는 3개의 필드 (위도, 경도, 정확성)가 포함되지만 가중치의 데이터 유형에는 필드가 하나만 포함됩니다.
데이터 포인트
데이터 포인트는 데이터 소스에서 읽은 데이터 유형에 대한 타임스탬프가 적용된 값 배열로 구성됩니다. 데이터 포인트를 사용하여 건강 및 웰빙 데이터를 기록 및 피트니스 스토어에 삽입하고, 데이터 소스에서 원시 데이터를 읽습니다. 시작 시간이 포함된 지점은 즉각적인 측정 대신 기간을 나타냅니다.
데이터 세트
데이터 세트는 특정 시간 간격을 두고 특정 데이터 소스에서 가져온 동일한 유형의 데이터 포인트 집합을 나타냅니다. 데이터 세트를 사용하여 피트니스 저장소에 데이터를 삽입합니다. 피트니스 저장소에서 데이터를 읽는 쿼리도 데이터 세트를 반환합니다.
세션
세션은 사용자가 달리기, 자전거 타기와 같은 피트니스 활동을 하는 시간 간격을 나타냅니다. 세션은 피트니스 활동을 위해 피트니스 저장소에서 데이터를 정리하고 상세 쿼리 또는 집계 쿼리를 실행하는 데 도움이 됩니다.
권한 및 사용자 제어
Google 피트니스에서 앱이 건강 및 웰니스 데이터를 읽거나 저장하려면 먼저 사용자 동의를 받아야 합니다.
Google 피트니스는 활동, 신체, 위치, 영양 및 건강 관련 데이터 유형과 같은 별도의 읽기 및 쓰기 권한을 가진 여러 권한 그룹에 매핑되는 OAuth 범위를 정의합니다 (건강 관련 데이터 유형은 더 세부적으로 그룹화됩니다). 각 권한 그룹은 데이터 유형 집합에 대한 액세스 권한을 앱에 부여합니다.
앱에서는 건강 및 웰빙 데이터를 사용할 범위를 하나 이상 지정하고, Google 피트니스는 사용자에게 해당 권한을 요청합니다.
[null,null,["최종 업데이트: 2025-08-31(UTC)"],[[["\u003cp\u003eGoogle Fit provides a central platform and APIs for storing, accessing, and sharing health and wellness data from various apps and devices.\u003c/p\u003e\n"],["\u003cp\u003eUsers have control over their data and must grant permission for apps to access it.\u003c/p\u003e\n"],["\u003cp\u003eDevelopers can build apps that integrate with Google Fit using Android or REST APIs, supporting cross-platform functionality.\u003c/p\u003e\n"],["\u003cp\u003eData is organized using data sources, data types, data points, datasets, and sessions for efficient storage and retrieval.\u003c/p\u003e\n"],["\u003cp\u003eCompliance with the Google Fit Developer and User Data Policy and Terms and Conditions is essential when utilizing the platform.\u003c/p\u003e\n"]]],[],null,["# Platform Overview\n\nGoogle Fit is an open ecosystem. It lets developers upload health and wellness\ndata to a central repository where users can access their data from different\ndevices and apps in one location. They can still access their data if they\nupgrade to a new device.\n\nYour health and wellness app can store data from any wearable or sensor, and\naccess data created by other apps.\n| **Note:** The Google Fit app uses the Google Fit platform, which is included in Google Play services. Your app can use this platform without needing users to install the Google Fit app.\n\nRead the [Google Fit Developer and User Data Policy](/fit/policy) thoroughly and\nmake sure your app complies with it. Carefully review the [Google Fit Terms and\nConditions](/fit/terms) before using Google Fit. By using the API, you agree to\nthe Google Fit Terms and Conditions.\n\nComponents\n----------\n\nGoogle Fit consists of the following components: \n**Figure 1** : Platform overview.\n\nThe fitness store\n: A central repository that stores data from a variety of devices and apps. The\n fitness store is a cloud service that is transparent to clients.\n\nThe sensor framework\n: A set of high-level representations that make it easy to work with the fitness\n store. You use these representations with the Google Fit APIs.\n\nPermissions and user controls\n: A set of authorization scopes to request user permission to work with health\n and wellness data. Google Fit requires user consent to access health and\n wellness data.\n\nGoogle Fit APIs\n: Android and REST APIs to access the fitness store. You can create apps that\n support Google Fit on multiple platforms and devices, such as Android, iOS, and\n Web apps.\n\nThe fitness store\n-----------------\n\nThe fitness store is a cloud service that persists health and wellness data using Google's\ninfrastructure. Apps on different platforms and devices can store data and\naccess data created by other apps. Google Fit provides a set of APIs that make\nit easy to insert data and query the fitness store.\n\nThe sensor framework\n--------------------\n\nThe sensor framework defines high-level representations for sensors,\ndata types, data points, and sessions. These representations make it easy to\nwork with the fitness store on any platform.\n\nData Sources\n: Data sources represent sensors and consist of a name, the type of data\n collected, and other sensor details. A data source may represent a hardware\n sensor or a software sensor. You can define software sensors in your apps.\n\nData Types\n: Data types represent different kinds of health and wellness data, like step count or heart\n rate. Data types establish a schema through which different apps can understand\n each other's data. A data type consists of a name and an ordered list of fields,\n where each field represents a dimension. For example, a data type for location\n contains three fields (latitude, longitude, and accuracy), whereas a data type\n for weight contains only one field.\n\nData Points\n: Data points consist of a timestamped array of values for a data type, read\n from a data source. You use data points to record and insert health and wellness data in the\n fitness store, and to read raw data from a data source. Points that contain a\n start time represent a time range instead of an instantaneous reading.\n\nDatasets\n: Datasets represent a set of data points of the same type from a particular\n data source covering some time interval. You use datasets to insert data into\n the fitness store. Queries to read data from the fitness store also return\n datasets.\n\nSessions\n: Sessions represent a time interval during which users perform a fitness\n activity, such as a run, a bike ride, and so on. Sessions help organize data and\n perform detailed or aggregate queries on the fitness store for a fitness\n activity.\n\nPermissions and user controls\n-----------------------------\n\nGoogle Fit requires user consent before apps can read or store health and wellness data.\nGoogle Fit defines OAuth scopes that map to a number of permission groups with\nseparate read and write privileges: activity, body, location, nutrition and\nhealth-related data types (health-related data types are grouped with finer\ngranularity). Each permission group grants apps access to a set of data types.\nApps specify one or more of these scopes to work with health and wellness data, and Google\nFit requests the corresponding permissions from the user.\n\nGoogle Fit APIs\n---------------\n\nGoogle Fit provides the following APIs:\n\n- [Android APIs](/fit/android) for Android apps.\n- [REST API](/fit/rest) for apps on any platform."]]
