ממשקי ה-API של Google Fit, כולל Google Fit, לא יהיו זמינים יותר אחרי 30 ביוני 2025. החל מ-1 במאי 2024, מפתחים לא יוכלו להירשם לשימוש בממשקי ה-API האלה.

כדי לקבל הוראות לגבי ה-API או הפלטפורמה שאליהם צריך לעבור, אפשר לעיין במדריך להעברת נתונים של Health Connect. להשוואה בין Health Connect לממשקי ה-API של Google Fit לבין ממשקי ה-API של Fitbit Web, אפשר לעיין במדריך ההשוואה של Health Connect.

מידע נוסף על Health Connect ועל השילוב עם ה-API.

דף זה תורגם על ידי Cloud Translation API.

סוגים של נתוני מיקום

סוגי נתונים של נתוני מיקום.

סל"ד סיבוב גלגל האופניים

אם משתמש רוכב על אופניים, אפשר להשתמש בסוג הנתונים הזה כדי לתעד את סיבובי הגלגל לדקה (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
שדות (פורמט – יחידות)	rpm (`float`—rpm) מספר סיבובי גלגל האופניים לדקה.

Android

שם	`com.google.cycling.wheel_revolution.rpm`
אובייקט סוג נתונים	`TYPE_CYCLING_WHEEL_RPM`
שדות (פורמט – יחידות)	FIELD_RPM (`float` - סל"ד) מספר סיבובי גלגל האופניים לדקה.

סיבוב מצטבר של גלגלי אופניים

אם משתמש רוכב על אופניים, אפשר להשתמש בסוג הנתונים הזה כדי לתעד את מספר סיבובי הגלגלים במהלך תקופה. כל נקודה על הגרף מייצגת את מספר הסיבובים מאז הספירה בנקודת ההתחלה.

REST

שם	`com.google.cycling.wheel_revolution.cumulative`
היקפי ההרשאות של OAuth	https://www.googleapis.com/auth/fitness.location.read https://www.googleapis.com/auth/fitness.location.write
שדות (פורמט – יחידות)	revolutions (`int`—count) מספר סיבובי גלגל האופניים.

Android

שם	`com.google.cycling.wheel_revolution.cumulative`
אובייקט סוג נתונים	`TYPE_CYCLING_PEDALING_CUMULATIVE`
שדות (פורמט – יחידות)	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
שדות (פורמט – יחידות)	מרחק (`float` – מטרים) המרחק עבר במטרים. טווח חוקי: 0 עד 100 מטר לשנייה

Android

שם	`com.google.distance.delta`
אובייקט סוג נתונים	`TYPE_DISTANCE_DELTA`
הרשאות ב-Android	`ACCESS_FINE_LOCATION` וגם `ACTIVITY_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

שדות (פורמט – יחידות)

קו רוחב (float – מעלות)

קו הרוחב של המיקום במעלות.

טווח חוקי: -90 עד 90 מעלות

longitude (float – מעלות)

קו האורך של מיקום במעלות.

טווח חוקי: -180 עד 180 מעלות

דיוק (float – מטרים)

'רדיוס הדיוק' המשוער שבו המיקום יהיה בטווח, במטרים. לדוגמה, אם ציירת מעגל סביב המיקום הזה ברדיוס ששווה לדיוק, צריך להיות סיכוי של 68% שהמיקום האמיתי של המשתמש נמצא בתוך העיגול. האומדן הזה מיועד לרמת דיוק אופקית בלבד. היא לא מציינת את הדיוק של הכיוון, המהירות או הגובה (אם המאפיינים האלה נכללים במיקום הזה). אם למיקום הזה אין דיוק אופקי, מוחזר 0.0.

טווח חוקי: 0 עד 10,000 מטרים

גובה (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 – מטרים)

טווח חוקי: 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
שדות (פורמט – יחידות)	מהירות (`float` – מטרים לשנייה) מהירות הנסיעה. טווח חוקי: 0 עד 11,000 מטר לשנייה

Android

שם	`com.google.speed`
אובייקט סוג נתונים	`TYPE_SPEED`
הרשאה ב-Android	`ACCESS_FINE_LOCATION`
שדות (פורמט – יחידות)	מהירות (`float` – מטרים לשנייה) מהירות הנסיעה. טווח חוקי: 0 עד 11,000 מטר לשנייה