×
Namespaces

Variants
Actions
(Difference between revisions)

Display Facebook Friend position with Nokia Maps API for Qt

From Nokia Developer Wiki
Jump to: navigation, search
somnathbanik (Talk | contribs)
(Somnathbanik -)
somnathbanik (Talk | contribs)
(Somnathbanik -)
Line 1: Line 1:
 
[[Category:Draft]]
 
[[Category:Draft]]
{{Abstract| This article demonstrates how to display Facebook friends  on Nokia Map using Nokia Map API for Qt.}}
+
{{Abstract| This article demonstrates how to display Facebook friends  on Nokia Map using [https://www.developer.nokia.com/Develop/Maps/Maps_API_for_Qt.xhtml Nokia Map API for Qt].}}
 
{{ArticleMetaData
 
{{ArticleMetaData
 
|sourcecode= [[Media: FacebookFriends_NokiaMap.zip]]<!-- Link to example source code e.g. [[Media:The Code Example ZIP.zip]] -->
 
|sourcecode= [[Media: FacebookFriends_NokiaMap.zip]]<!-- Link to example source code e.g. [[Media:The Code Example ZIP.zip]] -->
Line 16: Line 16:
 
}}
 
}}
 
==Introduction==
 
==Introduction==
The example combines gets information about Facebook friends and display the location of the friends on Nokia Map using pushpin. We create dynamic pushpins with friend’s image using   Dynamic Object Management in QML.  This article also talk about Facebook login and authentication using OAuth.
+
The example combines gets information about Facebook friends and display the location of the friends on [https://www.developer.nokia.com/Develop/Maps/Maps_API_for_Qt.xhtml Nokia Map] using pushpin. We create dynamic pushpins with friend’s image using [http://doc.qt.nokia.com/4.7-snapshot/qdeclarativedynamicobjects.html  Dynamic Object Management in QML].  This article also talks about Facebook login and authentication using [http://developers.facebook.com/docs/authentication/ OAuth]. To start with the application first create a Facebook app from [https://developers.facebook.com/apps here] and get the '''Key''' and '''Secret''' for future use.  
  
 
<gallery widths=185px heights=300px>
 
<gallery widths=185px heights=300px>
Line 25: Line 25:
  
 
==Implementation ==
 
==Implementation ==
We create  two pages in MainPage.qml, one is for displaying  Facebook friend list and  the other is to display friends on Nokia Map.  When we start the application we load the Facebook login dialog in the first screen, which calls the Facebook login page
+
We create  two pages in {{Icode|MainPage.qml}}, one is for displaying  Facebook friend list and  the other is to display friends on [https://www.developer.nokia.com/Develop/Maps/Maps_API_for_Qt.xhtml Nokia Map].  When we start the application we load the Facebook login dialog in the first screen, which calls the Facebook login page
<html code>
+
<code html>
 
https://www.facebook.com/dialog/oauth?client_id=<Your Key>&redirect_uri=https://www.facebook.com/connect/login_success.html  
 
https://www.facebook.com/dialog/oauth?client_id=<Your Key>&redirect_uri=https://www.facebook.com/connect/login_success.html  
</html>
+
</code>
By default the application will ask for the authentication of basic information  about the user in Facebook. As we use user location and other information we need to request for more permission from the user, which can be done with the scope parameter. So our URL should look like this
+
By default the application will ask for the authentication of ''basic information''   about the user in Facebook. As we use user location and other information we need to request for more [http://developers.facebook.com/docs/reference/api/permissions/ permissions] from the user, which can be done with the ''scope'' parameter. So our ''URL'' should look like this
  
<html code>
+
<code html>
 
https://www.facebook.com/dialog/oauth?client_id=<Your Key>&redirect_uri=https://www.facebook.com/connect/login_success.html&scope=user_hometown,friends_hometown,user_location,friends_location,email,publish_stream,offline_access,read_stream,user_status,user_photos,friends_photos,friends_status,user_checkins,friends_checkins,user_events
 
https://www.facebook.com/dialog/oauth?client_id=<Your Key>&redirect_uri=https://www.facebook.com/connect/login_success.html&scope=user_hometown,friends_hometown,user_location,friends_location,email,publish_stream,offline_access,read_stream,user_status,user_photos,friends_photos,friends_status,user_checkins,friends_checkins,user_events
 
</code>
 
</code>
The login page is an HTML page, so we display it on QML WebView
+
The login page is an HTML page, so we display it on [http://doc.qt.nokia.com/4.7/qml-webview.html QML WebView].
  
 
<code cpp>
 
<code cpp>
Line 52: Line 52:
  
 
</code>
 
</code>
  Once the user is authenticated and authorizes the application, the browser will get an alpha-numeric  number  in the code parameter of  its response. We parse the code for further use.  
+
  Once the user is authenticated and authorizes the application, the browser will get an alpha-numeric  number  in the ''code'' parameter of  its response. We parse the ''code'' for further use.  
 
<code cpp>
 
<code cpp>
 
onFinished: {
 
onFinished: {
Line 69: Line 69:
 
</code>
 
</code>
 
   
 
   
getAccessToken() function pass the code as its parameter  and calls the URL to get the access token.  
+
{{Icode|getAccessToken()}} function pass the ''code'' as its parameter  and calls the ''URL'' to get the access token.  
  
  
Line 92: Line 92:
  
 
</code>
 
</code>
loadFriends() gets friends information from Facebook  and load the information on  ListModel
+
{{Icode|loadFriends()}} gets friends information from Facebook  and load the information on  [http://doc.qt.nokia.com/4.7/qml-listmodel.html ListModel]
 
<code javascript>
 
<code javascript>
  
Line 123: Line 123:
  
 
</code>
 
</code>
Once the informations are loaded in the ListModel,  we display the list of Facebook friends on the page
+
Once the information are loaded in the [http://doc.qt.nokia.com/4.7/qml-listmodel.html ListModel],  we display the list of Facebook friend List on the page
 
<code cpp>
 
<code cpp>
  
Line 137: Line 137:
  
  
On clicking the menu “Friends on Map” we call the function startcalculatingfrineds(), which first calculates the number of friends loaded in the model  and then get the location name of each friends
+
On clicking the menu ''Friends on Map'' we call the function {{Icode|startcalculatingfrineds()}}, which first calculates the number of friends loaded in the model  and then gets the location name for each friends.
  
 
<code javascript>
 
<code javascript>
Line 173: Line 173:
  
 
</code>
 
</code>
As the Facebook API we used here doesn’t provide the latitude and longitude information of friends in the friend list, so we will use Google API to get the latitude and longitude of each location individually.   
+
As the [[developers.facebook.com/docs/authentication/ Facebook API]] we used here doesn’t provide the ''latitude'' and ''longitude'' information of friends in the friend list, so we will use [http://code.google.com/apis/maps/documentation/webservices/ Google API] to get the ''latitude'' and ''longitude'' of each location individually.   
 
<code cpp>
 
<code cpp>
  
Line 191: Line 191:
 
     XmlRole { name: "lng"; query: "lng/string()" }
 
     XmlRole { name: "lng"; query: "lng/string()" }
 
}
 
}
</code>
+
</Code>
  
And then calls the addPushPin() function which first  creates instances of PushPin.qml component dynamically using  Dynamic Object Management in QML. Each instance is a MapImage with properties latitude,longitude,name and image. When the instances are ready we call the method  addMapObject() to add the instance on the Map.
+
And then calls the {{Icode|addPushPin()}} function which first  creates instances of {{Icode|PushPin.qml}} component dynamically using  [http://doc.qt.nokia.com/4.7-snapshot/qdeclarativedynamicobjects.html Dynamic Object Management in QML]. Each instance is a [http://doc.qt.nokia.com/qtmobility-1.2/qml-mapimage.html MapImage] with properties ''latitude'',''longitude'',''name'' and ''image''. When the instances are ready we call the method  {{Icode|addMapObject()}} to add the instance on the [http://doc.qt.nokia.com/qtmobility-1.2/qml-map.html Map].
  
</code javascript>
+
<Code javascript>
  
 
function addPushPin( latitude, longitude,name,friendImage)
 
function addPushPin( latitude, longitude,name,friendImage)
Line 234: Line 234:
 
}
 
}
  
</code>
+
</Code>
We also put the entire pushpins object into an Array, so that we can have a track of all the pushpin plotted on the Map.  
+
We also put the entire pushpins object into an ''Array'', so that we can have a track of all the pushpin plotted on the [http://doc.qt.nokia.com/qtmobility-1.2/qml-map.html Map].  
 
+
So when ever user switches from Facebook friend list to Map it will display the friends location on the Nokia Map.
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
 
+
  
 +
So when ever user switches from Facebook friends List View to Map View it will display the friends location on the [http://doc.qt.nokia.com/qtmobility-1.2/qml-map.html Nokia Map].
  
 
==Summary==  
 
==Summary==  
  
This article shows the use of Nokia Map API along with Facebook API. It also talks about how to create  a Map Object Dynamically using Dynamic Object Management in QML.   
+
This article shows the use of [https://www.developer.nokia.com/Develop/Maps/Maps_API_for_Qt.xhtml Nokia Map API] along with [https://developers.facebook.com/docs/ Facebook API]. It also talks about how to create  a [http://doc.qt.nokia.com/qtmobility-1.2/qml-map.html Map] object dynamically using [http://doc.qt.nokia.com/4.7-snapshot/qdeclarativedynamicobjects.html Dynamic Object Management in QML].   
  
 
==Source Code==
 
==Source Code==
 
The full source code of the example is available here: [[File: FacebookFriends_NokiaMap.zip]]
 
The full source code of the example is available here: [[File: FacebookFriends_NokiaMap.zip]]

Revision as of 17:18, 31 January 2012

This article demonstrates how to display Facebook friends on Nokia Map using Nokia Map API for Qt.

Article Metadata
Code ExampleTested with
Devices(s): N9/ N950
Compatibility
Platform(s): Symbian^3 and later/MeeGo, Qt 4.7.3 and later
Symbian
Device(s): GPS
Platform Security
Signing Required: Self-Signed
Capabilities: NetworkServices
Article
Keywords: Facebook, Map
Created: somnathbanik (31 Jan 2014)
Last edited: somnathbanik (31 Jan 2012)

Contents

Introduction

The example combines gets information about Facebook friends and display the location of the friends on Nokia Map using pushpin. We create dynamic pushpins with friend’s image using Dynamic Object Management in QML. This article also talks about Facebook login and authentication using OAuth. To start with the application first create a Facebook app from here and get the Key and Secret for future use.

Implementation

We create two pages in MainPage.qml, one is for displaying Facebook friend list and the other is to display friends on Nokia Map. When we start the application we load the Facebook login dialog in the first screen, which calls the Facebook login page

Invalid language.

You need to specify a language like this: <source lang="html4strict">...</source>

Supported languages for syntax highlighting:

4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript, actionscript3, ada, algol68, apache, applescript, apt_sources, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, ecmascript, eiffel, email, epc, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, gdb, genero, genie, gettext, glsl, gml, gnuplot, go, groovy, gwbasic, haskell, hicest, hq9plus, html4strict, html5, icon, idl, ini, inno, intercal, io, j, java, java5, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, mmix, modula2, modula3, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml, ocaml-brief, oobas, oracle11, oracle8, oxygene, oz, pascal, pcre, per, perl, perl6, pf, php, php-brief, pic16, pike, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, uscript, vala, vb, vbnet, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, whois, winbatch, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic


https://www.facebook.com/dialog/oauth?client_id=<Your Key>&redirect_uri=https://www.facebook.com/connect/login_success.html

By default the application will ask for the authentication of basic information about the user in Facebook. As we use user location and other information we need to request for more permissions from the user, which can be done with the scope parameter. So our URL should look like this

Invalid language.

You need to specify a language like this: <source lang="html4strict">...</source>

Supported languages for syntax highlighting:

4cs, 6502acme, 6502kickass, 6502tasm, 68000devpac, abap, actionscript, actionscript3, ada, algol68, apache, applescript, apt_sources, asm, asp, autoconf, autohotkey, autoit, avisynth, awk, bascomavr, bash, basic4gl, bf, bibtex, blitzbasic, bnf, boo, c, c_loadrunner, c_mac, caddcl, cadlisp, cfdg, cfm, chaiscript, cil, clojure, cmake, cobol, coffeescript, cpp, cpp-qt, csharp, css, cuesheet, d, dcs, delphi, diff, div, dos, dot, e, ecmascript, eiffel, email, epc, erlang, euphoria, f1, falcon, fo, fortran, freebasic, fsharp, gambas, gdb, genero, genie, gettext, glsl, gml, gnuplot, go, groovy, gwbasic, haskell, hicest, hq9plus, html4strict, html5, icon, idl, ini, inno, intercal, io, j, java, java5, javascript, jquery, kixtart, klonec, klonecpp, latex, lb, lisp, llvm, locobasic, logtalk, lolcode, lotusformulas, lotusscript, lscript, lsl2, lua, m68k, magiksf, make, mapbasic, matlab, mirc, mmix, modula2, modula3, mpasm, mxml, mysql, newlisp, nsis, oberon2, objc, objeck, ocaml, ocaml-brief, oobas, oracle11, oracle8, oxygene, oz, pascal, pcre, per, perl, perl6, pf, php, php-brief, pic16, pike, pixelbender, pli, plsql, postgresql, povray, powerbuilder, powershell, proftpd, progress, prolog, properties, providex, purebasic, pycon, python, q, qbasic, rails, rebol, reg, robots, rpmspec, rsplus, ruby, sas, scala, scheme, scilab, sdlbasic, smalltalk, smarty, sql, systemverilog, tcl, teraterm, text, thinbasic, tsql, typoscript, unicon, uscript, vala, vb, vbnet, verilog, vhdl, vim, visualfoxpro, visualprolog, whitespace, whois, winbatch, xbasic, xml, xorg_conf, xpp, yaml, z80, zxbasic


https://www.facebook.com/dialog/oauth?client_id=<Your Key>&redirect_uri=https://www.facebook.com/connect/login_success.html&scope=user_hometown,friends_hometown,user_location,friends_location,email,publish_stream,offline_access,read_stream,user_status,user_photos,friends_photos,friends_status,user_checkins,friends_checkins,user_events

The login page is an HTML page, so we display it on QML WebView.

WebView {
id: webView
anchors.fill: parent
preferredHeight: height
preferredWidth: Math.max(parent.width,640)
url: "https://www.facebook.com/dialog/oauth?client_id=<Your Key>&redirect_uri=https://www.facebook.com/connect/login_success.html&scope=user_hometown,friends_hometown,user_location,friends_location,email,publish_stream,offline_access,read_stream,user_status,user_photos,friends_photos,friends_status,user_checkins,friends_checkins,user_events";//&display=touch";
onLoadFinished: {
loginDialog.finished( webView.url );
}
onLoadFailed: {
loginDialog.loadFailed();
}
}
Once the user is authenticated and authorizes the application, the browser will get an alpha-numeric  number  in the code parameter of  its response. We parse the code for further use. 
onFinished: {
if(url.indexOf("code=")>0) {
login.visible = false;
friendsList.visible= true;
var codeStart = url.indexOf("code=");
//CODE from facebook
var code = url.substring(codeStart + 5);
//get the access token
Facebook.getAccessToken(code);
console.log("Code: "+code);
}
}

getAccessToken() function pass the code as its parameter and calls the URL to get the access token.


function getAccessToken(code) {
//access token URL request
var url = "https://graph.facebook.com/oauth/access_token?client_id=<Your Key>&redirect_uri=https://www.facebook.com/connect/login_success.html&client_secret=<Your Secret>&code=" +code;
doWebRequest("GET", url, "", parseAccessToken);
}

And then we parse the access token from the response

//parse the access token
function parseAccessToken(response) {
accessToken = "access_token=" + parseParameter(response, "access_token");
console.log("parseAccessToken:"+accessToken);
//load friends on list
loadFriends();
}

loadFriends() gets friends information from Facebook and load the information on ListModel

function parseFriends(response) {
var data = eval("[" + response + "]")[0].data;
data = data.sort(sortByName);
friendsModel.clear();
for(var i in data) {
var user = data[i];
if(user.location!==undefined)
{
if(user.location.id !== "" || user.location.name !== null )
{
//save friends data in model
friendsModel.append({
"id": user.id,
"name": user.name,
// "profileImageUrl":"https://graph.facebook.com/" + user.id + "/picture",
"profileImageUrl":user.picture ,
"lid": (user.location!==undefined ? user.location.id : ""),
"lname": (user.location!==undefined ? user.location.name : ""),
});
}
}
}
//count number of content in the list model
friendsCount= friendsModel.count;
console.log("parseFriends : "+friendsCount);
}

Once the information are loaded in the ListModel, we display the list of Facebook friend List on the page

//display friends in list view
FriendsList {
id: friendsList
friendsModel: friendsModel
y: commonTools.height
height: parent.height - commonTools.height
}


On clicking the menu Friends on Map we call the function startcalculatingfrineds(), which first calculates the number of friends loaded in the model and then gets the location name for each friends.

function parseFriendsLocation()
{
//when friend list is more then zero
// get information about each friend from the model
if( i <friendsNumber)
{
fid = friendsModel.get(i).id;
fname = friendsModel.get(i).name;
fprofileImageUrl = friendsModel.get(i).profileImageUrl;
flid = (friendsModel.get(i).lid!==undefined ? friendsModel.get(i).lid : "" );
flname = (friendsModel.get(i).lname!==undefined ? friendsModel.get(i).lname :"");
i++;
if(flname !== "" || flid!== "" )
{
//pass friend location to get the latitude and longitude
feedModel.locationName = flname;
feedModel.reload();
}
else
{
//no user
console.log("no location for the user");
}
}
else
{
//count else
console.log("Stopped : "+friendsNumber);
}
}

As the developers.facebook.com/docs/authentication/ Facebook API we used here doesn’t provide the latitude and longitude information of friends in the friend list, so we will use Google API to get the latitude and longitude of each location individually.

XmlListModel {
id: feedModel
property string access_Token: ""
property string xmlData:"";
property string locationID:"";
property string locationName:""
// using Google API to get latitude and longitude of a location
source:"http://maps.googleapis.com/maps/api/geocode/xml?address="+locationName+"&sensor=false"
query:"/GeocodeResponse/result/geometry/location" //google query
namespaceDeclarations:""
//get latitude and longitude
//google
XmlRole { name: "lat"; query: "lat/string()" }
XmlRole { name: "lng"; query: "lng/string()" }
}

And then calls the addPushPin() function which first creates instances of PushPin.qml component dynamically using Dynamic Object Management in QML. Each instance is a MapImage with properties latitude,longitude,name and image. When the instances are ready we call the method addMapObject() to add the instance on the Map.

function addPushPin( latitude, longitude,name,friendImage)
{
count = map.markers.length
counter++
component = Qt.createComponent("PushPin.qml");
console.log(" Call "+component.status + " " + Component.Null);
//create pushpin object
object = component.createObject(container,
{ "latid": latitude, "longit": longitude,"name":name, "friendImage":friendImage}
);
if (object.status == Component.Ready)
{
console.log("Component ready");
map.addMapObject(object);
myArray = new Array()
for (var i = 0; i<count; i++){
myArray.push(map.markers[i])
}
myArray.push(object)
map.markers = myArray
}
else // when status is ready add the pushpin on the map
object.statusChanged.connect(addRemoteImages);
}
//add pushpn on the map
function addRemoteImages()
{
// console.log("addRemoteImages");
map.addMapObject(object);
myArray = new Array()
for (var i = 0; i<count; i++){
myArray.push(map.markers[i])
}
myArray.push(object)
map.markers = myArray
}

We also put the entire pushpins object into an Array, so that we can have a track of all the pushpin plotted on the Map.

So when ever user switches from Facebook friends List View to Map View it will display the friends location on the Nokia Map.

Summary

This article shows the use of Nokia Map API along with Facebook API. It also talks about how to create a Map object dynamically using Dynamic Object Management in QML.

Source Code

The full source code of the example is available here: File:FacebookFriends NokiaMap.zip

194 page views in the last 30 days.
×