Movement SDK Data Usage

This is the data sent to Foursquare servers on every “stop” detected by the SDK. We use these data elements both to predict the current venue a user is at.

Data collected by the Movement SDK

VenueSearch Signals

• Venue type, i.e. does the client think this is a Home/Work location
• Device lat/long
• Wifi scan, as available
• Beacon scan, as available
• Barometer/magnet/phone sensors. See the list below for a complete review of sensor data rights to be requested (Foursquare does not collect all of this data today but does ask for rights to help conduct R&D that can improve our products)

IDs and Admin

• Timestamp
• Unique installid for this instance
• Consumer ID (i.e. a unique ID for all Partner requests)
• AdID
• AdID opt-out setting

Device Info

• Current battery level
• Device model
• Operating system version

NOTE: The only header we add is for our internal user agent

Sensor Data Specifics and Requested Rights

Wifi Address

iOS

• The bssid of the connected network
• https://developer.apple.com/reference/systemconfiguration/kcnnetworkinfokeyssid

Android

• The bssid and frequency of the nearby wi-fi networks.

Motion State Data

iOS

• N/A - Rights reserved for future collection

Android

• If your app requests the Google Activity monitoring permission, we will get a timestamp and a motion state (i.e. “walking”).

Accelerometer

iOS

• N/A - Rights reserved for future collection

Android

• N/A - Rights reserved for future collection

Barometer

iOS

• N/A - Rights reserved for future collection

Android

• N/A - Rights reserved for future collection

Altimeter

iOS

• Altitude in meters for the stopped location
• https://developer.apple.com/reference/corelocation/cllocation/1423820-altitude

Android

• The altitude of the stopped location from the device provided location

Floor Level Data

iOS

• Floor in building for the stopped location
• https://developer.apple.com/reference/corelocation/clfloor

Android

• N/A - Rights reserved for future collection

Magnetometer Data

iOS

• N/A - Rights reserved for future collection

Android

• N/A - Rights reserved for future collection

Bluetooth Data

iOS

• N/A - Rights reserved for future collection

Android

• N/A - Rights reserved for future collection

Visible Beacon Data

iOS

• N/A - Rights reserved for future collection

Android

• N/A - Rights reserved for future collection

Data Sent to Partners via SDK

This is the data returned to the client on every stop detected by the SDK. Clients/Partners/Customers have different rights to this data, depending on the field. As a general principle, partners own data related to the stop in perpetuity, however will only have a license to fields related to the location information of a venue that terminates at the end of the agreement term.

Sample Movement SDK Webhook Response

JSON

{
    "VisitId": "5b8821d9bcbf7a002dab91fc",
    "eventType": "placeArrival",
    "timestamp": 1535648217088,
    "placeEvent": {
        "venues": [
            {
                "id": "3fd66200f964a52098ed1ee3",
                "name": "The Irish Bank",
                "location": {
                    "address": "10 Mark Ln",
                    "crossStreet": "at Harlan Pl.",
                    "city": "San Francisco",
                    "state": "CA",
                    "postalCode": "94108",
                    "country": "US",
                    "lat": 37.7903451920591,
                    "lng": -122.40459322929382
                },
                "categories": [
                    {
                        "id": "52e81612bcbc57f1066b7a06",
                        "name": "Irish Pub",
                        "pluralName": "Irish Pubs",
                        "shortName": "Irish",
                        "icon": {
                            "prefix": "https://ss3.4sqi.net/img/categories_v2/nightlife/pub_",
                            "suffix": ".png"
                        }
                    }
                ],
                "probability": 0.6088516762188961
            }
        ],
        "otherPossibleVenues": [
            {
                "id": "49e7e380f964a52027651fe3",
                "name": "Akiko’s Restaurant & Sushi Bar",
                "location": {
                    "address": "431 Bush St",
                    "crossStreet": "at Mark Ln.",
                    "city": "San Francisco",
                    "state": "CA",
                    "postalCode": "94108",
                    "country": "US",
                    "lat": 37.790623,
                    "lng": -122.404657
                },
                "categories": [
                    {
                        "id": "4bf58dd8d48988d1d2941735",
                        "name": "Sushi Restaurant",
                        "pluralName": "Sushi Restaurants",
                        "shortName": "Sushi",
                        "icon": {
                            "prefix": "https://ss3.4sqi.net/img/categories_v2/food/sushi_",
                            "suffix": ".png"
                        }
                    },
                    {
                        "id": "4bf58dd8d48988d111941735",
                        "name": "Japanese Restaurant",
                        "pluralName": "Japanese Restaurants",
                        "shortName": "Japanese",
                        "icon": {
                            "prefix": "https://ss3.4sqi.net/img/categories_v2/food/japanese_",
                            "suffix": ".png"
                        }
                    }
                ],
                "probability": 0.042400647818909835
            },
            {
                "id": "4ed92126f5b92139871ce962",
                "name": "Foursquare SF",
                "location": {
                    "address": "425 Bush St Ste 500",
                    "crossStreet": "btwn Grant & Kearny",
                    "city": "San Francisco",
                    "state": "CA",
                    "postalCode": "94108",
                    "country": "US",
                    "lat": 37.7905997608588,
                    "lng": -122.40459154855427
                },
                "categories": [
                    {
                        "id": "4bf58dd8d48988d125941735",
                        "name": "Tech Startup",
                        "pluralName": "Tech Startups",
                        "shortName": "Tech Startup",
                        "icon": {
                            "prefix": "https://ss3.4sqi.net/img/categories_v2/shops/technology_",
                            "suffix": ".png"
                        }
                    }
                ],
                "venueChains": [
                    {
                        "id": "556e5779bd6a82902e28bcea",
                        "name": "Foursquare"
                    }
                ],
                "probability": 0.01599619603673202
            },
            ...
        ],
        "confidence": "high",
        "locationType": "venue"
    },
    "lat": 37.790459,
    "lng": -122.404695,
    "user": {
        "userId": "12345"
    },
    "installId": "1A11C111-11FA-1C71-111C-FC1111BAB111",
    "sdkType": "iossdk",
    "sdkBuild": "4.0.3"
}

Visit Object

Venue Object

Location Object

Category Object

Chain Object