From 3a65b3864d442a5e428c530fd4a56052063b74be Mon Sep 17 00:00:00 2001
From: Meng Li <34143965+Meng6@users.noreply.github.com>
Date: Tue, 9 Mar 2021 23:37:04 -0500
Subject: [PATCH] Migrate phone locations sensor to new data stream

---
 docs/datastreams/aware-mysql.md            | 29 +++++++++++++++++++++
 docs/datastreams/mandatory-phone-format.md | 15 +++++++++++
 src/data/streams/aware_mysql/format.yaml   | 30 ++++++++++++++++++++++
 src/data/streams/rapids_columns.yaml       | 11 ++++++++
 4 files changed, 85 insertions(+)

diff --git a/docs/datastreams/aware-mysql.md b/docs/datastreams/aware-mysql.md
index 9d8c5e45..a1834e9e 100644
--- a/docs/datastreams/aware-mysql.md
+++ b/docs/datastreams/aware-mysql.md
@@ -368,3 +368,32 @@ Stream columns named `FLAG_TO_MUTATE` means they are extracted based on the `MUT
 
         This sensor is not supported by iOS devices.
 
+
+??? info "PHONE_LOCATIONS"
+
+    === "ANDROID"
+    
+        **RAPIDS_COLUMN_MAPPINGS**
+
+        | RAPIDS column        | Stream column       |
+        |----------------------|---------------------|
+        | TIMESTAMP            | timestamp           |
+        | DEVICE_ID            | device_id           |
+        | DOUBLE_LATITUDE      | double_latitude     |
+        | DOUBLE_LONGITUDE     | double_longitude    |
+        | DOUBLE_BEARING       | double_bearing      |
+        | DOUBLE_SPEED         | double_speed        |
+        | DOUBLE_ALTITUDE      | double_altitude     |
+        | PROVIDER             | provider            |
+        | ACCURACY             | accuracy            |
+
+        **MUTATION**
+
+        - **COLUMN_MAPPINGS** (None)
+        - **SCRIPTS** (None)
+
+    === "IOS"
+    
+        Same as ANDROID
+
+
diff --git a/docs/datastreams/mandatory-phone-format.md b/docs/datastreams/mandatory-phone-format.md
index 3c4de06d..14f245b5 100644
--- a/docs/datastreams/mandatory-phone-format.md
+++ b/docs/datastreams/mandatory-phone-format.md
@@ -89,3 +89,18 @@ This is a description of the format RAPIDS needs to process data for the followi
     | DOUBLE_LIGHT_LUX   | The ambient luminance in lux units                                                                                   |
     | ACCURACY           | An integer that denotes the sensor's accuracy level: 3 = maximum accuracy, 2 = medium accuracy, 1 = low accuracy     |
 
+
+??? info "PHONE_LOCATIONS"
+
+    | RAPIDS column      | Description                                                               |
+    |--------------------|---------------------------------------------------------------------------|
+    | TIMESTAMP          | An UNIX timestamp (13 digits) when a row of data was logged               |
+    | DEVICE_ID          | A string that uniquely identifies a device                                |
+    | DOUBLE_LATITUDE    | The location’s latitude, in degrees                                       |
+    | DOUBLE_LONGITUDE   | The location’s longitude, in degrees                                      |
+    | DOUBLE_BEARING     | The location’s bearing, in degrees                                        |
+    | DOUBLE_SPEED       | The speed if available, in meters/second over ground                      |
+    | DOUBLE_ALTITUDE    | The altitude if available, in meters above sea level                      |
+    | PROVIDER           | A string that denotes the provider: `gps`, `fused` or `network`           |
+    | ACCURACY           | The estimated location accuracy                                           |
+
diff --git a/src/data/streams/aware_mysql/format.yaml b/src/data/streams/aware_mysql/format.yaml
index ab7e0482..d1f6ffc9 100644
--- a/src/data/streams/aware_mysql/format.yaml
+++ b/src/data/streams/aware_mysql/format.yaml
@@ -152,3 +152,33 @@ PHONE_LIGHT:
     MUTATION:
       COLUMN_MAPPINGS:
       SCRIPTS: # List any python or r scripts that mutate your raw data
+
+PHONE_LOCATIONS:
+  ANDROID:
+    RAPIDS_COLUMN_MAPPINGS:
+      TIMESTAMP: timestamp
+      DEVICE_ID: device_id
+      DOUBLE_LATITUDE: double_latitude
+      DOUBLE_LONGITUDE: double_longitude
+      DOUBLE_BEARING: double_bearing
+      DOUBLE_SPEED: double_speed
+      DOUBLE_ALTITUDE: double_altitude
+      PROVIDER: provider
+      ACCURACY: accuracy
+    MUTATION:
+      COLUMN_MAPPINGS:
+      SCRIPTS: # List any python or r scripts that mutate your raw data
+  IOS:
+    RAPIDS_COLUMN_MAPPINGS:
+      TIMESTAMP: timestamp
+      DEVICE_ID: device_id
+      DOUBLE_LATITUDE: double_latitude
+      DOUBLE_LONGITUDE: double_longitude
+      DOUBLE_BEARING: double_bearing
+      DOUBLE_SPEED: double_speed
+      DOUBLE_ALTITUDE: double_altitude
+      PROVIDER: provider
+      ACCURACY: accuracy
+    MUTATION:
+      COLUMN_MAPPINGS:
+      SCRIPTS: # List any python or r scripts that mutate your raw data
diff --git a/src/data/streams/rapids_columns.yaml b/src/data/streams/rapids_columns.yaml
index 4aecdadc..08e2140f 100644
--- a/src/data/streams/rapids_columns.yaml
+++ b/src/data/streams/rapids_columns.yaml
@@ -54,6 +54,17 @@ PHONE_LIGHT:
   - DOUBLE_LIGHT_LUX
   - ACCURACY
 
+PHONE_LOCATIONS:
+  - TIMESTAMP
+  - DEVICE_ID
+  - DOUBLE_LATITUDE
+  - DOUBLE_LONGITUDE
+  - DOUBLE_BEARING
+  - DOUBLE_SPEED
+  - DOUBLE_ALTITUDE
+  - PROVIDER
+  - ACCURACY
+
 
 FITBIT_STEPS_SUMMARY:
   - TIMESTAMP