位置資料類型

位置資料的資料類型。

單車車輪革命 RPM

如果使用者騎自行車，這個資料類型可用於擷取每分鐘的輪轉數 (RPM)。每個資料點都代表的輪轉迴轉的即刻度量，因此只能設定結束時間。這會做為讀取的時間戳記。

REST

名稱com.google.cycling.wheel_revolution.rpm
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
欄位 (format—units) rpm (float—rpm)
單車輪轉數每分鐘數。

Android

名稱com.google.cycling.wheel_revolution.rpm
資料類型物件TYPE_CYCLING_WHEEL_RPM
欄位 (format—units) FIELD_RPM (float—rpm)
單車輪轉數每分鐘數。

自行車輪革命累計

如果使用者騎自行車，這個資料類型可用於擷取一段時間內的輪轉次數次數。每個資料點都代表自開始時間開始以來的革命次數。

REST

名稱com.google.cycling.wheel_revolution.cumulative
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
欄位 (format—units) revolutions (int—計數)
單車輪革數。

Android

名稱com.google.cycling.wheel_revolution.cumulative
資料類型物件TYPE_CYCLING_PEDALING_CUMULATIVE
欄位 (format—units) FIELD_REVOLUTIONS (int—計數)
單車輪革數。

距離差異

這個資料類型會擷取使用者自上次讀取以來移動的距離 (以公尺為單位)。將間隔期間的所有值相加，可以計算一段時間內的總距離。每個資料點的開始時間應代表該距離涵蓋的間隔開始時間。開始時間必須等於或大於上一個資料點的結束時間。

REST

名稱com.google.distance.delta
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
欄位 (format—units) distance (float - 公尺)
移動的距離 (以公尺為單位)。
有效範圍：每秒 0 至 100 公尺

Android

名稱com.google.distance.delta
資料類型物件TYPE_DISTANCE_DELTA
Android 權限ACCESS_FINE_LOCATION和ACTIVITY_RECOGNITION
欄位 (format—units) FIELD_DISTANCE (float—公尺)
移動的距離 (以公尺為單位)。
有效範圍：每秒 0 至 100 公尺

位置範例

此資料類型會擷取使用者的位置。由於每個資料點都代表使用者讀取時的位置，因此只需設定結束時間。這會做為讀取的時間戳記。

REST

名稱com.google.location.sample
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
欄位 (format—units)
latitude (float—度數)
位置的緯度，以度為單位。
有效範圍：-90 到 90 度
longitude (float—度)
位置的經度，以度為單位。
有效範圍：-180 到 180 度
accuracy (float - 公尺)
位置的預估「準確度半徑」(以公尺為單位)。舉例來說，如果您在該地點周圍畫出一個半徑，且半徑等於該位置，使用者實際位置在圓形範圍內的機率應是 68%。這項預估值僅代表水平準確率。但不適用於方位、速率或高度 (如有納入這個位置的資料) 的準確性。如果這個位置沒有水平準確度，系統就會傳回 0.0。
有效範圍：0 至 10,000 公尺
高度 (float—公尺)
海平面間的地點高度 (以公尺為單位)。
有效範圍：-100,000—100,000 公尺

Android

名稱com.google.location.sample
資料類型物件TYPE_LOCATION_SAMPLE
Android 權限ACCESS_FINE_LOCATION
欄位 (format—units)
FIELD_LATITUDE (float—度)
位置的緯度，以度為單位。
有效範圍：-90 到 90 度
FIELD_LONGITUDE (float — 度)
位置的經度，以度為單位。
有效範圍：-180 到 180 度
FIELD_ACCURACY (float—公尺)
位置的預估「準確度半徑」(以公尺為單位)。舉例來說，如果您在該地點周圍畫出一個半徑，且半徑等於該位置，使用者實際位置在圓形範圍內的機率應是 68%。這項預估值僅代表水平準確率。但不適用於方位、速率或高度 (如有納入這個位置的資料) 的準確性。如果這個位置沒有水平準確度，系統就會傳回 0.0。
有效範圍：0 至 10,000 公尺
FIELD_ALTITUDE (float—公尺)
海平面間的地點高度 (以公尺為單位)。
有效範圍：-100,000—100,000 公尺

速度

這個資料類型會擷取使用者速度 (單位為每秒公尺)。這個值代表速度的純量規模，因此不應出現負值。由於每個資料點都代表讀取時的速度，因此只需設定結束時間。這會做為讀取的時間戳記。

REST

名稱com.google.speed
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
欄位 (format—units) speed (float：每秒公尺數)
移動速度。
有效範圍：每秒 0 至 11,000 公尺

Android

名稱com.google.speed
資料類型物件TYPE_SPEED
Android 權限ACCESS_FINE_LOCATION
欄位 (format—units) speed (float：每秒公尺數)
移動速度。
有效範圍：每秒 0 至 11,000 公尺