Library . Foursquare . Checkins . GetNearbyFriends

Returns a list of recent friends' check-ins that are nearby the specified location.

Input
• OauthToken The Foursquare API OAuth token string.
• Latitude The latitude point of the user's location.
• Longitude The longitude point of the user's location.
Optional Input
• Distance The distance (in meters) between the supplied coordinates and the checkin location. This returns friends' checkins where the distance is less than or equal to this value. Default is 500.
• Limit Number of results to return, up to 100.
• ResponseMode Used to simplify the response. Valid values are: simple and verbose. When set to simple, an array of user objects are returned. Verbose mode returns an array of checkin objects. Defaults to "simple".
Log In To Run
• Output
  Actuator Trigger Condition

  If{"Response":{"type":"","description":"The response from Foursquare. Corresponds to the ResponseFormat input. Defaults to JSON."},"Success":{"type":"boolean"}}ResponseSuccess then write

  High Low

  to at

  • Response The response from Foursquare. Corresponds to the ResponseFormat input. Defaults to JSON.
• CHOREO CLASS

  • /*
    TembooTask class placeholder
    */

• iOS HEADER

  • /*
    TembooTask header placeholder
    */

• • Simple
  Enhanced
  Add a sensor via the virtual pin board above to generate code for sensor data graphs.
  Compiled
  Add a sensor or actuator via the virtual pin board above to generate compiled code for sensor data graphs and remote actuator control.
  Device Configure Changed

  Since you've changed your device configuration, you'll need to tell us about this new device.

  Update Device
  1. Add a sensor or actuator to your device.
  2. Register your board and download your code.

  Download
  • Download editable code
  • Commit to GitHub
  • Send to CCS Cloud

  OK! Let's set up your device

  This feature is in experimental mode - pricing coming soon.

  Device Name *

  Device ID

  Description

  Location *

  Use lat/long

  Sensor Data
  Frequency *

  Pro Tip!

  Power consumption will increase if you choose a higher frequency.

  Every 30 seconds Every minute Every 5 minutes Every 30 minutes Every hour Every day Custom interval

  Safeguard data

  what's this?

  If connectivity is lost, up to 2MB of data will be stored locally on your device, and updated when connectivity is restored.

  + new tag

  Save
  Commit your generated code
  and collaborate with others.

  Send your code straight to a GitHub repository.

  Collaborating on GitHub?

  Your code will be visible by others in your repos. Keep credentials private by saving a Profile or commit code with Placeholder inputs.

  Choose a GitHub Repository

  Name:

  The following files will be added to this repo:

  * Don't worry! Your credentials and any inputs that aren't saved in a Profile will not be included.

  Success!

  Visit the link below to view, modify, and share code.

  Cancel Commit code to GitHub Use Placeholders Save a Profile Commit Close
  Send code to CCS Cloud.

  You'll be able to edit and share your code from TI's CCS Cloud IDE.

  Name your application

  Names can only contain letters, numbers, hyphens, and underscores.

  The following will be sent to CCS Cloud:

  TembooMain.c

  TembooAccount.h

  instructions.txt

  + 9 others

  Success!

  Visit the link below to view, modify, and share code.

  https://dev.ti.com/ide/

  Cancel Send to CCS Cloud Send Close
  Code

  • // Instantiate the Choreo, using a previously instantiated TembooSession object, eg:
    // TembooSession session = new TembooSession("accountName", "myFirstApp", "abc123xxxxxxxxxxxxxx");
    
    GetNearbyFriends getNearbyFriendsChoreo = new GetNearbyFriends(session);
    
    // Get an InputSet object for the choreo
    GetNearbyFriendsInputSet getNearbyFriendsInputs = getNearbyFriendsChoreo.newInputSet();
    
    // Set inputs
    
    // Execute Choreo
    GetNearbyFriendsResultSet getNearbyFriendsResults = getNearbyFriendsChoreo.execute(getNearbyFriendsInputs);

• Header File

  • /* 
    A header file containing your Temboo account information will appear here once you've
    configured your device above.
    */

• Proxy Code

  • /*
    Please log in to generate proxy server code for use with the JavaScript SDK.
    */

• Notes

  • This Choreo returns a list of recent friends' check-ins that are nearby the specified location. The documentation for this Foursquare resource can be found here.

    Note that this Choreo has an input called ResponseMode which can be used to simplify the response. When using the "simple" ResponseMode, an array of only User objects are returned. When using the "verbose" ResponseMode, an array of Checkin objects is returned.

    Here's an example of acceptable inputs:

    OauthToken: {YOUR FOURSQUARE OAUTH TOKEN}
    Longitude: 40.71863
    Latitude: -74.005584
    Distance: 200

    The following is a sample of the JSON returned by this Choreo when setting the ResponseMode to "simple":

    [
        {
            "bio": [],
            "contact": {
                "email": "aaron.jennings@temboo.com",
                "twitter": "qatemboo"
            },
            "firstName": "Aaron",
            "gender": "male",
            "homeCity": "Brooklyn, NY",
            "id": "8567311",
            "lastName": "Jennings",
            "lists": {
                "groups": [
                    {
                        "count": 4,
                        "items": [],
                        "type": "created"
                    }
                ]
            },
            "photo": "https://foursquare.com/img/blank_boy.png",
            "relationship": "self",
            "tips": {
                "count": 11
            }
        },
        {
            "bio": [],
            "contact": {
                "email": "reasonable.man.v@gmail.com",
                "facebook": "11493",
                "twitter": "vonlinepersona"
            },
            "firstName": "Vaughn",
            "gender": "none",
            "homeCity": "New York, NY",
            "id": "25344881",
            "lastName": "Shinall",
            "lists": {
                "groups": [
                    {
                        "count": 1,
                        "items": [],
                        "type": "created"
                    }
                ]
            },
            "photo": "https://is0.4sqi.net/userpix_thumbs/H5N2XT3RWP00GGXO.jpg",
            "relationship": "friend",
            "tips": {
                "count": 5
            }
        },
        {
            "bio": [],
            "contact": {
                "email": "fstmb@mailinator.com",
                "phone": "2122748131"
            },
            "firstName": "Jonhny",
            "gender": "none",
            "homeCity": "New York, NY",
            "id": "12852031",
            "lastName": "Smith",
            "lists": {
                "groups": [
                    {
                        "count": 4,
                        "items": [],
                        "type": "created"
                    }
                ]
            },
            "photo": "https://is1.4sqi.net/userpix_thumbs/3FW3M3LAVPJS3AC1.jpg",
            "relationship": "friend",
            "tips": {
                "count": 1
            }
        },
        {
            "bio": [],
            "contact": {
                "email": "aarontemboodev@gmail.com"
            },
            "firstName": "Stan",
            "gender": "male",
            "homeCity": "Brooklyn",
            "id": "22382615",
            "lastName": "Johnson",
            "lists": {
                "groups": [
                    {
                        "count": 1,
                        "items": [],
                        "type": "created"
                    }
                ]
            },
            "photo": "https://is1.4sqi.net/userpix_thumbs/HJJYVTONCJCG3MD2.png",
            "relationship": "friend",
            "tips": {
                "count": 1
            }
        }
    ]

    When setting the ResponseMode to "verbose", the Response will look something like this:

    [
        {
            "createdAt": 1380137245,
            "distance": 22,
            "id": "5243391d11d2345b104ee5da",
            "photos": {
                "count": 0,
                "items": []
            },
            "source": {
                "name": "foursquare for Android",
                "url": "https://foursquare.com/download/#/android"
            },
            "timeZone": "America/New_York",
            "timeZoneOffset": -240,
            "type": "checkin",
            "user": {
                "bio": [],
                "contact": {
                    "email": "aaron.jennings@temboo.com",
                    "twitter": "qatemboo"
                },
                "firstName": "Aaron",
                "gender": "male",
                "homeCity": "Brooklyn, NY",
                "id": "8567311",
                "lastName": "Jennings",
                "lists": {
                    "groups": [
                        {
                            "count": 4,
                            "items": [],
                            "type": "created"
                        }
                    ]
                },
                "photo": "https://foursquare.com/img/blank_boy.png",
                "relationship": "self",
                "tips": {
                    "count": 11
                }
            },
            "venue": {
                "beenHere": {
                    "count": 23,
                    "marked": true
                },
                "categories": [
                    {
                        "icon": "https://foursquare.com/img/categories/shops/technology.png",
                        "id": "4bf58dd8d48988d125941735",
                        "name": "Tech Startup",
                        "parents": [
                            "Professional & Other Places",
                            "Office"
                        ],
                        "pluralName": "Tech Startups",
                        "primary": true,
                        "shortName": "Tech Startup"
                    }
                ],
                "contact": {
                    "twitter": "temboo"
                },
                "id": "4d432a7d3be6a093af469736",
                "likes": {
                    "count": 0,
                    "groups": []
                },
                "listed": {
                    "groups": [
                        {
                            "count": 1,
                            "items": [],
                            "type": "dones"
                        }
                    ]
                },
                "location": {
                    "address": "104 Franklin Street",
                    "cc": "US",
                    "city": "New York",
                    "country": "United States",
                    "crossStreet": "Btw Church & West Broadway",
                    "distance": 4,
                    "lat": 40.71863,
                    "lng": -74.00552,
                    "postalCode": "10013",
                    "state": "NY"
                },
                "name": "Temboo",
                "specials": [],
                "stats": {
                    "checkinsCount": 771,
                    "tipCount": 17,
                    "usersCount": 15
                },
                "verified": false
            }
        },
        {
            "createdAt": 1380042212,
            "distance": 92,
            "id": "5241c5e411d2836530269975",
            "photos": {
                "count": 0,
                "items": []
            },
            "source": {
                "name": "foursquare for iPhone",
                "url": "https://foursquare.com/download/#/iphone"
            },
            "timeZone": "America/New_York",
            "timeZoneOffset": -240,
            "type": "checkin",
            "user": {
                "bio": [],
                "contact": {
                    "email": "reasonable.man.v@gmail.com",
                    "facebook": "11493",
                    "twitter": "vonlinepersona"
                },
                "firstName": "Vaughn",
                "gender": "none",
                "homeCity": "New York, NY",
                "id": "25344881",
                "lastName": "Shinall",
                "lists": {
                    "groups": [
                        {
                            "count": 1,
                            "items": [],
                            "type": "created"
                        }
                    ]
                },
                "photo": "https://is0.4sqi.net/userpix_thumbs/H5N2XT3RWP00GGXO.jpg",
                "relationship": "friend",
                "tips": {
                    "count": 5
                }
            },
            "venue": {
                "beenHere": {
                    "count": 0,
                    "marked": false
                },
                "categories": [
                    {
                        "icon": "https://foursquare.com/img/categories/food/sandwiches.png",
                        "id": "4bf58dd8d48988d1c5941735",
                        "name": "Sandwich Place",
                        "parents": [
                            "Food"
                        ],
                        "pluralName": "Sandwich Places",
                        "primary": true,
                        "shortName": "Sandwiches"
                    }
                ],
                "contact": {
                    "formattedPhone": "(212) 965-0909",
                    "phone": "2129650909"
                },
                "hasMenu": true,
                "id": "3fd66200f964a520c9e61ee3",
                "likes": {
                    "count": 0,
                    "groups": []
                },
                "location": {
                    "address": "227 W Broadway",
                    "cc": "US",
                    "city": "New York",
                    "country": "United States",
                    "crossStreet": "at White St.",
                    "distance": 104,
                    "lat": 40.719498,
                    "lng": -74.00605,
                    "postalCode": "10013",
                    "state": "NY"
                },
                "menu": {
                    "anchor": "See menu",
                    "label": "Menu",
                    "mobileUrl": "https://foursquare.com/v/3fd66200f964a520c9e61ee3/device_menu",
                    "type": "Menu",
                    "url": "https://foursquare.com/v/caf%C3%A9-clementine/3fd66200f964a520c9e61ee3/menu"
                },
                "name": "Café Clementine",
                "specials": [],
                "stats": {
                    "checkinsCount": 3544,
                    "tipCount": 31,
                    "usersCount": 947
                },
                "url": "http://cafeclementine.com",
                "verified": false
            }
        },
        {
            "createdAt": 1360102655,
            "distance": 4,
            "id": "511184ffe4b05bd6602d76dd",
            "photos": {
                "count": 0,
                "items": []
            },
            "source": {
                "name": "temboo User",
                "url": "http://www.temboo.com"
            },
            "timeZone": "America/New_York",
            "timeZoneOffset": -300,
            "type": "checkin",
            "user": {
                "bio": [],
                "contact": {
                    "email": "fstmb@mailinator.com",
                    "phone": "2122748131"
                },
                "firstName": "Jonhny",
                "gender": "none",
                "homeCity": "New York, NY",
                "id": "12852031",
                "lastName": "Smith",
                "lists": {
                    "groups": [
                        {
                            "count": 4,
                            "items": [],
                            "type": "created"
                        }
                    ]
                },
                "photo": "https://is1.4sqi.net/userpix_thumbs/3FW3M3LAVPJS3AC1.jpg",
                "relationship": "friend",
                "tips": {
                    "count": 1
                }
            },
            "venue": {
                "beenHere": {
                    "count": 23,
                    "marked": true
                },
                "categories": [
                    {
                        "icon": "https://foursquare.com/img/categories/shops/technology.png",
                        "id": "4bf58dd8d48988d125941735",
                        "name": "Tech Startup",
                        "parents": [
                            "Professional & Other Places",
                            "Office"
                        ],
                        "pluralName": "Tech Startups",
                        "primary": true,
                        "shortName": "Tech Startup"
                    }
                ],
                "contact": {
                    "twitter": "temboo"
                },
                "id": "4d432a7d3be6a093af469736",
                "likes": {
                    "count": 0,
                    "groups": []
                },
                "listed": {
                    "groups": [
                        {
                            "count": 1,
                            "items": [],
                            "type": "dones"
                        }
                    ]
                },
                "location": {
                    "address": "104 Franklin Street",
                    "cc": "US",
                    "city": "New York",
                    "country": "United States",
                    "crossStreet": "Btw Church & West Broadway",
                    "distance": 4,
                    "lat": 40.71863,
                    "lng": -74.00552,
                    "postalCode": "10013",
                    "state": "NY"
                },
                "name": "Temboo",
                "specials": [],
                "stats": {
                    "checkinsCount": 771,
                    "tipCount": 17,
                    "usersCount": 15
                },
                "verified": false
            }
        }
    ]