Location-Based Services on Android Jomar Tigcal GDG DevFest Bacolod 2012 November 5, 2012
Jomar Tigcal● Community Manager of GDG Philippines● Mobile Apps Developer● Software Engineer at Stratpoint Technologies, Inc.● One of the developers of Moochfood http://jomar.tigcal.com firstname.lastname@example.org @jomartigcal
Moochfood Moochfood is an Android application that allows you to record, rate and share dining experiences. http://www.moochfood.com/
Challenges● Obtaining user location can consume a lot of battery● Getting location takes some time● Because the user location changes, you must account for movement by re-estimating user location every so often.● Location estimates from each source may not be accurate.
android.location Android provides a location framework that your application can use to determine the devices location and bearing and register for updates. http://developer.android. com/reference/android/locat ion/package-summary.html
Android PermissionsNote:If you are using both NETWORK_PROVIDERand GPS_PROVIDER, then you need torequest only the ACCESS_FINE_LOCATIONpermission, because it includes permission forboth.
Android Location API● Location A class representing a geographic location sensed at a particular time.● LocationManager This class provides access to the system location services.● LocationListener Interface used for receiving notifications from the LocationManager when the location has changed.
Getting User Location Image Source: http://evalblog.com/2011/06/06/where-am-i/
Getting User Location● Create an instance of LocationManager Location locationManager = (LocationManager) this.getSystemService (Context.LOCATION_SERVICE);● Check Location Provider final boolean gpsEnabled = locationManager.isProviderEnabled (LocationManager.GPS_PROVIDER);
Getting User Location● Start listening for location updates locationManager.requestLocationUpdates (LocationManager.GPS_PROVIDER, 0, 0, locationListener);● Stop listening for location updates locationManager.removeUpdates(this);
Commonly used APIs Image Sources: http://developer.foursquare.com and http://thegreasywiener.com/
Google Places API (https: //developers.google. com/places/)
Google Places API● Place Searches return a list of Places based on a users location or search string.● Place Details requests return more detailed information about a specific Place, including user reviews.● Place Actions allow you to supplement the data in Googles Places Database with data from your application. You can schedule Events, add and remove Places, or weight Place rankings from user activity with Place Bumps.
Google Places API● Places Autocomplete can be used to provide autocomplete functionality for text-based geographic searches, by returning Places as you type.● Query Autocomplete can be used to provide a query prediction service for text-based geographic searches, by returning suggested queries as you type.
Getting API Key● Go to Google APIs console (http://code. google.com/apis/console)● Create an API Project● Select Services● Turn on Places API
Places Search● Nearby Search by location (latitude, longitude)● Text Search by search query (e.g. "pizza in Bacolod")
Nearby Search SyntaxSyntax:https://maps.googleapis.com/maps/api/place/nearbysearch/output?parametersOutput: Either json or xml
Nearby Search Required Parameters● key API Key● location latitude, longitude● radius distance in meters, maximum of 50, 000 m● sensor (true/false) if request came from location sensor (GPS)
Nearby Search Optional Parameterskeyword - contentlanguage - language codename - namerankby - prominence or distance*if rankby=distance, radius should not be includedtypespagetoken
Place Search TypesSeparated by |Examples:food restaurant convenience_storehospital school grocery_or_supermarketMore at:https://developers.google.com/places/documentation/supported_types
Example● Place Search:https://maps.googleapis.com/maps/api/place/nearbysearch/json?location=loc_here&sensor=true&radius=500&key=key_here● Type=foodhttps://maps.googleapis.com/maps/api/place/nearbysearch/json?location=loc_here&sensor=true&radius=500&types=food&key=key_here
Foursquare API (https://developer.foursquare. com)
Foursquare APICore API: Check in, view their history, see wheretheir friends are, create tips and lists, search forand learn more about venues, and access specialsand recommendations.Real-time API: Venue push API notifies venuemanagers when users check in to their venues,and our user push API notifies developers whentheir users check in anywhere.
Foursquare APIMerchant Platform: Allows developers to writeapplications that help registered venue ownersmanage their foursquare presence andspecials.Venues Platform: Search for places and accessa wealth of information about them, includingaddresses, popularity, tips, and photos.
Foursquare Venues SearchSearch Foursquare database and findinformation including tips, photos, check-incounts, and here nowSyntax:https://api.foursquare.com/v2/venues/search
Venues Search ParametersRequired Parameters:● ll (latitude, longitude) - users location or● near (text) - place where to search● v (YYYYMMDD) indicates that the client is up to date as of the specified date
Venues Search ParametersOptional Parameters:● query - name of place to search● limit - number of results (max is 50)● radius - distance in meters (max is 10,000)● categoryId - comma-separated categories to limit search
Foursquare DemoHTTP Request:https://api.foursquare.com/v2/venues/search?ll=40.7,-74&oauth_token=0445ZMNU5XS4JDAURLRE3MARL222RVJITL2XBKF0CR1C2EWR&v=20121102Android Project: * Sample Android Project is available at https://github.com/jomartigcal/lbs-android- sample