The Python backend library for Roam Location Subscription is used to subscribe to user locations at a project level. It can also be used to subscribe to the locations of a single user.
Installation
You can install our python SDK from the PIP package manager.
pip install roam-python
Example Usage
You can think of this library as a wrapper around our REST API which needs your API key for authorization. It works at a project level and is fairly simple to use:
Create an instance of a client with your API key.
Define your custom callback function which will be executed in every location received from the server.
Subscribe with the help of the client to receive location updates.
Example usage code:
from roam import Client
#Do something when you receive locations
def custom_callback_function(payload):
print(payload)
log(payload)
#To listen locations at project level with the callback function
client = Client(API_KEY=<API-KEY>, CALLBACK=<custom_callback_function>)
#Subcribe to locations
client.sub()
Subscribe Locations
Single User Locations
You can also use the Library to subscribe to a single user's location and listen to it. You have to pass the User ID which our Mobile SDKs return while creating a user.
from roam import Client
#Do something when you receive locations
def custom_callback_function(payload):
print(payload)
log(payload)
#To listen locations at user level with the callback function
client = Client(API_KEY=<API-KEY>, USER_ID=<USER-ID>, CALLBACK=<custom_callback_function>)
#Subcribe to locations
client.sub()
List of User Locations
You can use the Library to subscribe to a list of users and listen to their location updates.
Create a list with the User IDs you want to listen to and use it when creating the client instance.
from roam import Client
#Do something when you receive locations
def custom_callback_function(payload):
print(payload)
log(payload)
#Create a user list with the list of user_id's
USER_LIST = ["user_id1", "user_id2", ..]
#To listen locations for list of user with the callback function
client = Client(API_KEY=<API-KEY>, USER_ID=<USER-LIST>, CALLBACK=<custom_callback_function>)
#Subcribe to locations
client.sub()
Group User Location
You can also use the SDK to subscribe to a user group and listen to their location updates.
You can get the group_id from our developer API for user grouping. You can use the group_id when creating the client instance to listen to locations at the user group level.
from roam import Client
#Do something when you receive locations
def custom_callback_function(payload):
print(payload)
log(payload)
#To listen locations for list of user with the callback function
client = Client(API_KEY=<API-KEY>, GROUP_ID=<GROUP_ID>, CALLBACK=<custom_callback_function>)
#Subcribe to locations
client.sub()
Unsubscribe
If you wish to unsubscribe from location updates at any point, use the code below to disconnect from the client instance.
client.disconnect()
Handling Callbacks
By default, the library prints out the locations. If locations are required for any other output, then use the callback function.
