Radar | Composio Docs

Overview

SLUG: RADAR

Description

Template description for Radar

Authentication Details

API Key

api_key

stringRequired

Connecting to Radar

Create an auth config

Use the dashboard to create an auth config for the Radar toolkit. This allows you to connect multiple Radar accounts to Composio for agents to use.

Select App

Navigate to Radar.

Configure Auth Config Settings

Select among the supported auth schemes of and configure them here.

Create and Get auth config ID

Click “Create Radar Auth Config”. After creation, copy the displayed ID starting with ac_. This is your auth config ID. This is not a sensitive ID — you can save it in environment variables or a database. This ID will be used to create connections to the toolkit for a given user.

Connect Your Account

Using API Key

1 from composio import Composio
2 
3 # Replace these with your actual values
4 radar_auth_config_id = "ac_YOUR_RADAR_CONFIG_ID" # Auth config ID created above
5 user_id = "0000-0000-0000"  # UUID from database/app
6 
7 composio = Composio()
8 
9 def authenticate_toolkit(user_id: str, auth_config_id: str):
10     # Replace this with a method to retrieve an API key from the user.
11     # Or supply your own.
12     user_api_key = input("[!] Enter API key")
13 
14     connection_request = composio.connected_accounts.initiate(
15         user_id=user_id,
16         auth_config_id=auth_config_id,
17         config={"auth_scheme": "API_KEY", "val": {"generic_api_key": user_api_key}}
18     )
19 
20     # API Key authentication is immediate - no redirect needed
21     print(f"Successfully connected Radar for user {user_id}")
22     print(f"Connection status: {connection_request.status}")
23     
24     return connection_request.id
25 
26 
27 connection_id = authenticate_toolkit(user_id, radar_auth_config_id)
28 
29 # You can verify the connection using:
30 connected_account = composio.connected_accounts.get(connection_id)
31 print(f"Connected account: {connected_account}")

Tools

Executing tools

To prototype you can execute some tools to see the responses and working on the Radar toolkit’s playground

OpenAI (Python)

Anthropic (TypeScript)

Google (Python)

Vercel (TypeScript)

Python

1 from composio import Composio
2 from openai import OpenAI
3 import json
4 
5 openai = OpenAI()
6 composio = Composio()
7 
8 # User ID must be a valid UUID format
9 user_id = "0000-0000-0000"  # Replace with actual user UUID from your database
10 
11 tools = composio.tools.get(user_id=user_id, toolkits=["RADAR"])
12 
13 print("[!] Tools:")
14 print(json.dumps(tools))
15 
16 def invoke_llm(task = "What can you do?"):
17     completion = openai.chat.completions.create(
18         model="gpt-4o",
19         messages=[
20             {
21                 "role": "user",
22                 "content": task,  # Your task here!
23             },
24         ],
25         tools=tools,
26     )
27 
28     # Handle Result from tool call
29     result = composio.provider.handle_tool_calls(user_id=user_id, response=completion)
30     print(f"[!] Completion: {completion}")
31     print(f"[!] Tool call result: {result}")
32 
33 invoke_llm()

Tool List

RADAR_AUTOCOMPLETE_ADDRESS_OR_PLACE

Tool Name: Autocomplete Address or Place

Description

Tool to autocomplete partial addresses and place names based on relevance and proximity. use after a user inputs a partial address/place to get suggestions, optionally biased by location.

Action Parameters

layers

array

limit

integerDefaults to 10

near

query

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_CREATE_TRIP

Tool Name: Create Trip

Description

Tool to create a new trip. use after gathering origin and destination details to start tracking a trip.

Action Parameters

approachingThreshold

integer

destinationGeofenceExternalId

string

destinationGeofenceTag

string

destinationLocation

object

externalId

stringRequired

metadata

object

mode

string

originGeofenceExternalId

string

originGeofenceTag

string

originLocation

object

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_FORWARD_GEOCODE

Tool Name: Forward Geocode

Description

Tool to convert an address into geographic coordinates. use when you have a full address string and need precise latitude/longitude before further location analysis.

Action Parameters

country

string

layers

array

limit

integer

query

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_GET_CONTEXT_FOR_LOCATION

Tool Name: Get Context for Location

Description

Tool to retrieve context for a given location. use when you need geofences, place, and region information based on coordinates. use after obtaining valid latitude and longitude.

Action Parameters

lat

numberRequired

lng

numberRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_GET_GEOFENCE

Tool Name: Get Geofence

Description

Tool to retrieve a geofence by radar  id or tag/externalid. use when you need to fetch full details of an existing geofence.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_GET_PLACES_SETTINGS

Tool Name: Get Places Settings

Description

Tool to retrieve current places settings for your radar project. use when you need to inspect chain detection, supported countries, external id requirements, and other places metadata.

Action Parameters

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_GET_TRIP

Tool Name: Get Trip

Description

Tool to retrieve a trip by id or externalid. use when you have a trip id or externalid to fetch its details.

Action Parameters

format

string

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_LIST_BEACONS

Tool Name: List Beacons

Description

Tool to list all beacons sorted by creation date. use when you need an overview of all configured beacons.

Action Parameters

createdAfter

string

createdBefore

string

externalId

string

limit

integer

metadata

object

name

string

page

integer

tag

string

updatedAfter

string

updatedBefore

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_LIST_GEOFENCES

Tool Name: List Geofences

Description

Tool to list all geofences sorted by updated time. use when you need an overview of all configured geofences.

Action Parameters

createdAfter

string

createdBefore

string

externalId

string

limit

integer

metadata

object

page

integer

tag

string

updatedAfter

string

updatedBefore

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_LIST_TRIPS

Tool Name: List Trips

Description

Tool to list all trips, sorted by updated time. use when you need to page through the latest trips.

Action Parameters

endingBefore

string

externalId

string

limit

integer

metadata

object

startingAfter

string

userId

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_LIST_USERS

Tool Name: List Users

Description

Tool to list radar users sorted by update time. use when you need to page through users in your project.

Action Parameters

afterId

string

createdAfter

string

createdBefore

string

limit

integer

RADAR_REVERSE_GEOCODE

Tool Name: Reverse Geocode

Description

Tool to convert geographic coordinates to structured addresses. use when you have latitude/longitude and need a human-readable address.

Action Parameters

coordinates

stringRequired

country

string

layers

array

limit

integer

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_SEARCH_GEOFENCES_NEAR_LOCATION

Tool Name: Search Geofences

Description

Tool to search for geofences near a given location. use when you need to find geofences within a radius of specified coordinates.

Action Parameters

latitude

numberRequired

longitude

numberRequired

metadata

object

radius

integer

RADAR_SEARCH_PLACES_NEAR_LOCATION

Tool Name: Search Places Near Location

Description

Tool to search for places near given coordinates. use when you need to find points of interest around a location.

Action Parameters

brand

string

RADAR_TRACK_LOCATION_UPDATE

Tool Name: Track Location Update

Description

Tool to track a user's location update. use when sending a location update for a user, creating or updating user and event data.

Action Parameters

deviceId

string

events

booleanDefaults to True

foreground

boolean

location

objectRequired

metadata

object

nearby

boolean

replayed

boolean

stopped

boolean

userId

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_UPDATE_TRIP

Tool Name: Update Trip

Description

Tool to update a trip. use when you need to modify mode, destination, schedule, or active status.

Action Parameters

active

boolean

approachingThreshold

number

arrivedThreshold

number

destination

object

destinationGeofenceExternalId

string

destinationGeofenceRadius

number

destinationGeofenceTag

string

externalId

string

format

string

stringRequired

metadata

object

mode

string

scheduledArrivalAt

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_UPSERT_GEOFENCE

Tool Name: Upsert Geofence

Description

Tool to create or update a geofence by tag and externalid. use when ensuring a geofence exists or is updated based on identifiers.

Action Parameters

coordinates

array

description

string

externalId

stringRequired

geometry

object

metadata

object

radius

number

tag

stringRequired

type

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_DELETE_GEOFENCE

Tool Name: Delete Geofence

Description

Tool to delete a geofence by id. use when supplying a geofence’s unique identifier to remove it.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_DELETE_TRIP

Tool Name: Delete Trip

Description

Tool to delete a trip by its radar id or external id. use after confirming the trip exists.

Action Parameters

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_GET_USERS_IN_GEOFENCE

Tool Name: Get Users in Geofence

Description

Tool to retrieve users currently within a specific geofence. use when you need to list all users inside a geofence by its tag and external id.

Action Parameters

cursor

string

externalId

stringRequired

limit

integer

tag

stringRequired

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_IP_GEOCODE

Tool Name: IP Geocode

Description

Tool to geocode an ip address to city, state, and country. use when you need location details based on an ip address.

Action Parameters

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_LIST_EVENTS

Tool Name: List Events

Description

Tool to list events. use when you need to retrieve a paginated list of events with optional filtering.

Action Parameters

afterId

string

beforeId

string

deviceId

string

end

string

limit

integer

start

string

type

string

userId

string

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_ROUTE_DISTANCE

Tool Name: Route Distance

Description

Tool to compute distance and travel time between origins and destinations. use when you need route metrics before optimizing or timing routes.

Action Parameters

avoid

string

destinations

stringRequired

destinations_limit

integer

geometry

boolean

mode

stringDefaults to car

origins

stringRequired

origins_limit

integer

units

stringDefaults to metric

Action Response

data

objectRequired

error

string

successful

booleanRequired

RADAR_SEARCH_USERS_NEAR_LOCATION

Tool Name: Search Users Near Location

Description

Tool to search for users near a location. use after obtaining coordinates when you need to retrieve users within a given radius.

Action Parameters

latitude

numberRequired

limit

integer

longitude

numberRequired

radius

number

Action Response

data

objectRequired

error

string

successful

booleanRequired