位置資料類型

位置資料的資料類型。

單車車輪每分鐘轉數

如果使用者去騎自行車,這類資料可用於擷取每分鐘的車輪轉速 (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
欄位 (格式:單位) 每分鐘轉速 (float 每分鐘轉速)
每分鐘的自行車輪轉數。

Android

名稱com.google.cycling.wheel_revolution.rpm
資料類型物件TYPE_CYCLING_WHEEL_RPM
欄位 (格式:單位) 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
欄位 (格式:單位) 革命 (int - 數量)
自行車輪的轉數。

Android

名稱com.google.cycling.wheel_revolution.cumulative
資料類型物件TYPE_CYCLING_PEDALING_CUMULATIVE
欄位 (格式:單位) FIELD_REVOLUTIONS (int—count)
自行車輪的轉數。

距離差異

這個資料類型會擷取使用者自上次讀取以來行進的距離 (以公尺為單位)。如要計算某個時間間隔內的總距離,請將該間隔內的所有值加總。每個資料點的開始時間應代表距離涵蓋的時間間隔開始時間。開始時間必須等於或晚於前一個資料點的結束時間。

REST

名稱com.google.distance.delta
OAuth 權限範圍
https://www.googleapis.com/auth/fitness.location.read
https://www.googleapis.com/auth/fitness.location.write
欄位 (格式:單位) 距離 (float - 公尺)
以公尺為單位的行經距離。
有效範圍:每秒 0 到 100 公尺

Android

名稱com.google.distance.delta
資料類型物件TYPE_DISTANCE_DELTA
Android 權限ACCESS_FINE_LOCATIONACTIVITY_RECOGNITION
欄位 (格式:單位) 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
欄位 (格式:單位)
latitude (float 度)
位置的緯度 (以度為單位)。
有效範圍:-90 至 90 度
longitude (float 度)
位置的經度 (以度為單位)。
有效範圍:-180 至 180 度
準確度 (float 公尺)
位置資訊的「精確度半徑」估計值 (以公尺為單位)。舉例來說,如果您以這個位置為圓心,以精確度為半徑畫出圓形,使用者真實位置有 68% 的機率會落在圓內。這項預估值僅適用於水平準確度。這項資訊不會指出方位、速度或海拔高度的準確度 (如果這個位置資訊包含這些資料)。如果這個位置沒有水平精確度,則會傳回 0.0。
有效範圍:0 到 10,000 公尺
altitude (float 公尺)
位置高於海平面的高度,單位為公尺。
有效範圍:-100,000 至 100,000 公尺

Android

名稱com.google.location.sample
資料類型物件TYPE_LOCATION_SAMPLE
Android 權限ACCESS_FINE_LOCATION
欄位 (格式:單位)
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
欄位 (格式:單位) speed (float—公尺/秒)
行進速度。
有效範圍:每秒 0 到 11,000 公尺

Android

名稱com.google.speed
資料類型物件TYPE_SPEED
Android 權限ACCESS_FINE_LOCATION
欄位 (格式:單位) speed (float—公尺/秒)
行進速度。
有效範圍:每秒 0 到 11,000 公尺