Javascript Library

Search…
Roam v1
Javascript Library
A Javascript library for Roam Location Subscription. It is used to subscribe to user's locations at project level or location of a single user.
roam-js supports subscription to the following location data:
Specific user
All users of a group
All users of project
Note: Before you get started signup to our dashboard to get your Publishable Keys.
Installation:
Via NPM
You can install our package using npm.
Via CDN
roam-js bundle is available through http://unpkg.com, specifically at https://unpkg.com/roam-js/dist/roam.min.js. See http://unpkg.com for the full documentation on version ranges.
Usage
You can think this library as a wrapper around our REST API which needs your Publishable Key for authorization and it works as per project level. It is fairly simple to use:
Initialize() the package with the publishable key. This will return an instance of our client.
Define your custom callback function. client.setCallback(fn)
Create an instance of subscription. You can create subscription for project, user or group of users using the following methods on client:
projectSubscription() takes no parameters
groupSubscription(greoupID) - takes in group ID as parameter
userSubscription(userID) - takes in a single user ID or a array of user ids as parameter
Use subscribe() method on the created subscription to start receiving realtime location data
To stop receiving data, call unsubscribe method.
To disconnect() call disconnect method on client. Please find the example usage below:
1
var roam = require("roam-js")
2
​
3
const pk = process.env.roam_pk;
4
​
5
roam.Initialize(pk)
6
    .then((client)=>{
7
        client.setCallback(function(message){console.log(message)})
8
        
9
        client.projectSubscription()
10
        .then((subscription)=>{
11
            subscription.subscribe()
12
            .then((msg)=>{
13
                console.log(msg)
14
                subscription.unsubscribe()
15
                .then((msg)=>{
16
                    console.log(msg)
17
                    client.disconnect().then((msg)=>{
18
                        console.log(msg)
19
                    })
20
                })
21
                .catch((err)=>{
22
                   throw(err)
23
                })
24
            }
25
            )
26
        })
27
        .catch((err)=>{
28
           throw(err)
29
        })
30
        
31
})
32
.catch((err)=>{
33
    throw(err)
34
})
Copied!
Methods
Initialize
First order of process is initialization of the library. Initialize function takes in publishable key as parameter. You can get the publishable key from our dashboard once you have created a project. Initialize returns a promise of our client.
1
client = await roam.Initialize("")
Copied!
Setting up callback function
Once initialized, we recommend setting up a callback function. This callback function will be called once you receive any location data from our backend.
1
var callback = function(data){
2
    console.log(data)
3
}
4
client.setCallback(callback)
Copied!
Subscription
roam-js supports 3 types of subscriptions:
project subscription
user subscription
group subscription
Project Subscription
To create a subscription that allow you to subscribe to location data of all users within the project, you can use projectSubscription() method of client. It does not take in any parameter.
1
subscription = await client.projectSubscription()
Copied!
Group Subscription
To create a subscription that allow you to subscribe to location data of all users within the group, you can use groupSubscription(groupID) method of client. It takes group ID as parameter.
1
subscription = await client.groupSubscription('')
Copied!
User Subscription
To create a subscription that allow you to subscribe to location data a user or multiple usesrs, you can use userSubscription(groupID) method of client. It takes user ID as parameter.
1
subscription = await client.groupSubscription('user_1')
Copied!
To subscribe to multiple users pass in user ids in an array as parameter
1
subscription = await client.groupSubscription(['user_1','user_2'])
Copied!
Subscribe to a subscription
All of the above methods will give you an subscription promise. You can subscribe to the subscription by using the following:
This will return a promise with a message whether subscription was subscribed successfully or throws an error.
Unsubscribe from a subscription
To stop getting location updates from a subscription you can use ubsubscribe method.
1
subscription.unsubscribe()
Copied!
This will return a promise with a message whether unsubscribe was subscribed successfully or throws an error.
Disconnect
To disconnect from our server, call disconnect method on the client.
Library Integration Examples
See example codes in examples/. To run the example, clone this repository, add your sdk key as environment veriable pk and run the app.
GitHub - roam-ai/roam-js: JavaScript Pub/Sub Library; JS library to subscribe to realtime location updates from Roam.ai's location SDKs.
GitHub
roam.js
Need Help?
If you have any problems or issues over our SDK, feel free to create a github issue or submit a request on Roam Help.
Last modified 4mo ago
Export as PDF
Copy link
Contents
Setting up callback function
Subscription
Disconnect
Library Integration Examples
Need Help?