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

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

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

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

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—הכנסה לאלף צפיות)
מספר סיבובי הגלגל של האופניים בדקה.

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
הרשאות ב-AndroidACCESS_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
שדות (פורמט – יחידות)
latitude (float—degrees)
קו הרוחב של מיקום במעלות.
טווח תקין: ‎-90 עד 90 מעלות
longitude (float—degrees)
קו האורך של מיקום במעלות.
טווח תקין: ‎-180 עד 180 מעלות
דיוק (float – מטרים)
הערכה של 'רדיוס הדיוק' של המיקום, במטרים. לדוגמה, אם מציירים עיגול סביב המיקום הזה עם רדיוס ששווה לדיוק, יש סיכוי של 68% שהמיקום האמיתי של המשתמש נמצא בתוך העיגול. האומדן הזה מתייחס לדיוק אופקי בלבד. הוא לא מציין את רמת הדיוק של הכיוון, המהירות או הגובה (אם הם כלולים במיקום הזה). אם למיקום הזה אין רמת דיוק אופקית, המערכת מחזירה 0.0.
טווח תקין: 0 עד 10,000 מטרים
גובה (float – מטרים)
הגובה של המיקום מעל פני הים, במטרים.
טווח תקין: ‎-100,000 עד 100,000 מטרים

Android

שםcom.google.location.sample
אובייקט מסוג נתוניםTYPE_LOCATION_SAMPLE
הרשאה ב-AndroidACCESS_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
שדות (פורמט – יחידות) מהירות (float – מטרים לשנייה)
מהירות הנסיעה.
טווח ערכים תקין: 0 עד 11,000 מטרים לשנייה

Android

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