Go Library
The Golang backend library for Roam Location Subscription is used to subscribe to user's locations at a project level. It can also be used to subscribe to the locations of a single user.
roam-go supports subscription to the following location data:
- Specific user
- All users of a group
- All users of the project
You can install our Golang library as mentioned below.
go get -u github.com/roam-ai/roam-go/roam
You can use the SDK to subscribe to single user's location and listen to it. You have to pass the userID which our Mobile SDKs return when a user is created.
userSubscription , err := roam.NewUserSubscription("apikey","userID")
Example Usage
package main
import (
"fmt"
"github.com/roam-ai/roam-go/roam"
"time"
)
func main() {
// initialization
subscription , _ := roam.NewUserSubscription("apikey","userID")
// Declaring handler function
var handler roam.MessageHandler = func(userID string , payload []byte){
// logic
}
// start subscription
subscription.Subscribe(handler)
}
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 and use the group id when creating the client instance to listen to location at user group level.
groupSubscription , err := roam.NewGroupSubscription("apikey","groupID")
package main
import (
"fmt"
"github.com/roam-ai/roam-go/roam"
"time"
)
func main() {
// initialization
subscription , _ := roam.NewGroupSubscription("apikey","groupID")
// Declaring handler function
var handler roam.MessageHandler = func(userID string , payload []byte){
// logic
}
// start subscription
subscription.Subscribe(handler)
}
At any point, if you wish to unsubscribe from location updates, use the code below:
subscription.Unsubscribe()
While calling Subscribe method on subscription, you will need to pass a handler func as parameter. Handler func should have userID of type string and payload of type []byte and will be invoked on every location update received.
var handler roam.MessageHandler = func(userID string , payload []byte){
// logic
}
subscription.Subscribe(handler)
You can think of this library as a wrapper around our REST API which needs your API key for authorization. It works at the project level and is fairly simple to use:
- Create an instance of a subscription with your API key.
- Define your custom callback function and pass it with the
subscribe()
method, which will be executed on every location received from the server. - To stop receiving data, call the unsubscribe() method. Check out this example code:
package main
import (
"fmt"
"github.com/roam-ai/roam-go/roam"
"time"
)
func main() {
// initialization
subscription , _ := roam.NewProjectSubscription("apikey")
var handler roam.MessageHandler = func(userID string , payload []byte){
fmt.Println(userID)
fmt.Println(string(payload))
}
subscription.Subscribe(handler)
}
If you have any problems or issues regarding our SDK, feel free to create a github issue or submit a request on Roam Help.
Last modified 4mo ago