Radar
radarRadar is a full-stack location infrastructure platform offering SDKs and APIs for geofencing, location tracking, geocoding, search, routing, and maps.
Acciones disponibles (24)
Cada acción es una operación que el agente puede ejecutar contra este conector. Haz clic en una acción para ver sus parámetros.
Autocomplete Address or PlaceRADAR_AUTOCOMPLETE_ADDRESS_OR_PLACEAcciónTool 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.
RADAR_AUTOCOMPLETE_ADDRESS_OR_PLACEAcciónTool 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.
Parámetros de entrada
nearanylimitintegerMaximum number of results to return (1-100)
querystringObligatorioPartial address or place to autocomplete
layersstring[]Result types to return (e.g., ['address','place'])
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Create TripRADAR_CREATE_TRIPAcciónTool to create a new trip. use after gathering origin and destination details to start tracking a trip.
RADAR_CREATE_TRIPAcciónTool to create a new trip. use after gathering origin and destination details to start tracking a trip.
Parámetros de entrada
modestringenumMode of travel, one of 'car', 'foot', or 'bike'
carfootbikemetadataobjectCustom key-value pairs for trip
externalIdstringObligatorioExternal ID for the trip
originLocationobjectOrigin location as GeoJSON Point
originGeofenceTagstringTag of origin geofence (e.g. warehouse)
destinationLocationobjectDestination location as GeoJSON Point
approachingThresholdintegerDistance threshold in meters for approaching status
destinationGeofenceTagstringTag of destination geofence (e.g. store)
originGeofenceExternalIdstringExternal ID of origin geofence
destinationGeofenceExternalIdstringExternal ID of destination geofence
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete GeofenceRADAR_DELETE_GEOFENCEAcciónTool to delete a geofence by id. use when supplying a geofence’s unique identifier to remove it.
RADAR_DELETE_GEOFENCEAcciónTool to delete a geofence by id. use when supplying a geofence’s unique identifier to remove it.
Parámetros de entrada
idstringObligatorioUnique ID of the geofence to delete
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Delete TripRADAR_DELETE_TRIPAcciónTool to delete a trip by its radar id or external id. use after confirming the trip exists.
RADAR_DELETE_TRIPAcciónTool to delete a trip by its radar id or external id. use after confirming the trip exists.
Parámetros de entrada
idstringObligatorioThe unique identifier of the trip to delete. Can be Radar _id or externalId.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Forward GeocodeRADAR_FORWARD_GEOCODEAcciónTool to convert an address into geographic coordinates. use when you have a full address string and need precise latitude/longitude before further location analysis.
RADAR_FORWARD_GEOCODEAcciónTool to convert an address into geographic coordinates. use when you have a full address string and need precise latitude/longitude before further location analysis.
Parámetros de entrada
limitintegerMaximum number of results to return (default 10, max 100)
querystringObligatorioThe full address or query string to geocode
layersstring[]Place types to filter results, comma-separated (e.g., 'address','locality')
countrystringTwo-letter ISO 3166-1 alpha-2 country code to filter results
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Context for LocationRADAR_GET_CONTEXT_FOR_LOCATIONAcciónTool 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.
RADAR_GET_CONTEXT_FOR_LOCATIONAcciónTool 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.
Parámetros de entrada
latnumberObligatorioLatitude in decimal degrees, between -90 and 90
lngnumberObligatorioLongitude in decimal degrees, between -180 and 180
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get GeofenceRADAR_GET_GEOFENCEAcciónTool to retrieve a geofence by radar id or tag/externalid. use when you need to fetch full details of an existing geofence.
RADAR_GET_GEOFENCEAcciónTool to retrieve a geofence by radar id or tag/externalid. use when you need to fetch full details of an existing geofence.
Parámetros de entrada
idstringObligatorioUnique Radar geofence identifier, or prefix with 'tag:' to look up by tag, or 'externalId:' to look up by external ID
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Places SettingsRADAR_GET_PLACES_SETTINGSAcciónTool 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.
RADAR_GET_PLACES_SETTINGSAcciónTool 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.
Parámetros de entrada
Sin parámetros.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get TripRADAR_GET_TRIPAcciónTool to retrieve a trip by id or externalid. use when you have a trip id or externalid to fetch its details.
RADAR_GET_TRIPAcciónTool to retrieve a trip by id or externalid. use when you have a trip id or externalid to fetch its details.
Parámetros de entrada
idstringObligatorioThe Radar trip ID or externalId.
formatstringSet to 'externalId' when using an external trip ID.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Get Users in GeofenceRADAR_GET_USERS_IN_GEOFENCEAcciónTool 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.
RADAR_GET_USERS_IN_GEOFENCEAcciónTool 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.
Parámetros de entrada
tagstringObligatorioTag of the geofence
limitintegerMaximum number of users to return (default: 100, max: 500)
cursorstringPagination cursor to fetch the next page of results
externalIdstringObligatorioExternal ID of the geofence
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
IP GeocodeRADAR_IP_GEOCODEAcciónTool to geocode an ip address to city, state, and country. use when you need location details based on an ip address.
RADAR_IP_GEOCODEAcciónTool to geocode an ip address to city, state, and country. use when you need location details based on an ip address.
Parámetros de entrada
ipstringThe IP address to geocode; defaults to the requester's IP if omitted
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List BeaconsRADAR_LIST_BEACONSAcciónTool to list all beacons sorted by creation date. use when you need an overview of all configured beacons.
RADAR_LIST_BEACONSAcciónTool to list all beacons sorted by creation date. use when you need an overview of all configured beacons.
Parámetros de entrada
tagstringFilter beacons by tag
namestringFilter beacons by exact name
pageintegerPage number to return (default 1 if not specified)
limitintegerMaximum number of beacons to return (1-500, default 100 if not specified)
metadataobjectFilter beacons by metadata key-value pairs
externalIdstringFilter beacons by external ID
createdAfterstringReturn beacons created after this ISO8601 timestamp
updatedAfterstringReturn beacons updated after this ISO8601 timestamp
createdBeforestringReturn beacons created before this ISO8601 timestamp
updatedBeforestringReturn beacons updated before this ISO8601 timestamp
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List EventsRADAR_LIST_EVENTSAcciónTool to list events. use when you need to retrieve a paginated list of events with optional filtering.
RADAR_LIST_EVENTSAcciónTool to list events. use when you need to retrieve a paginated list of events with optional filtering.
Parámetros de entrada
endstringReturn events created before this ISO 8601 timestamp
typestringFilter events by event type
limitintegerMaximum number of events to return (1-500)
startstringReturn events created after this ISO 8601 timestamp
userIdstringFilter events by user ID
afterIdstringCursor to return events created after this event ID
beforeIdstringCursor to return events created before this event ID
deviceIdstringFilter events by device ID
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List GeofencesRADAR_LIST_GEOFENCESAcciónTool to list all geofences sorted by updated time. use when you need an overview of all configured geofences.
RADAR_LIST_GEOFENCESAcciónTool to list all geofences sorted by updated time. use when you need an overview of all configured geofences.
Parámetros de entrada
tagstringFilter geofences by tag
pageintegerPage number to return (default 1)
limitintegerMaximum number of geofences to return (1-500)
metadataobjectFilter geofences by metadata key-value pairs
externalIdstringFilter geofences by external ID
createdAfterstringReturn geofences created after this ISO8601 timestamp
updatedAfterstringReturn geofences updated after this ISO8601 timestamp
createdBeforestringReturn geofences created before this ISO8601 timestamp
updatedBeforestringReturn geofences updated before this ISO8601 timestamp
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List TripsRADAR_LIST_TRIPSAcciónTool to list all trips, sorted by updated time. use when you need to page through the latest trips.
RADAR_LIST_TRIPSAcciónTool to list all trips, sorted by updated time. use when you need to page through the latest trips.
Parámetros de entrada
limitintegerMaximum number of trips to return (1–100). Defaults to 100 when omitted.
userIdstringFilter trips by Radar user ID.
metadataobjectFilter trips by metadata key/value pairs.
externalIdstringFilter trips by external ID.
endingBeforestringReturn trips ending immediately before this trip ID.
startingAfterstringReturn trips starting immediately after this trip ID.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
List UsersRADAR_LIST_USERSAcciónTool to list radar users sorted by update time. use when you need to page through users in your project.
RADAR_LIST_USERSAcciónTool to list radar users sorted by update time. use when you need to page through users in your project.
Parámetros de entrada
tagsstring[]Only return users who have all of these tags
limitintegerMaximum number of users to return
afterIdstringUser ID after which to return users for pagination
createdAfterstringOnly return users created after this ISO 8601 timestamp
updatedAfterstringOnly return users updated after this ISO 8601 timestamp
createdBeforestringOnly return users created before this ISO 8601 timestamp
updatedBeforestringOnly return users updated before this ISO 8601 timestamp
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Reverse GeocodeRADAR_REVERSE_GEOCODEAcciónTool to convert geographic coordinates to structured addresses. use when you have latitude/longitude and need a human-readable address.
RADAR_REVERSE_GEOCODEAcciónTool to convert geographic coordinates to structured addresses. use when you have latitude/longitude and need a human-readable address.
Parámetros de entrada
limitintegerMaximum number of results to return (default 1, max 10)
layersstring[]Place types to restrict results, comma-separated (e.g., ['address','place'])
countrystringTwo-letter ISO 3166-1 alpha-2 country code to filter results
coordinatesstringObligatorioLatitude and longitude in 'lat,lon' format
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Route DistanceRADAR_ROUTE_DISTANCEAcciónTool to compute distance and travel time between origins and destinations. use when you need route metrics before optimizing or timing routes.
RADAR_ROUTE_DISTANCEAcciónTool to compute distance and travel time between origins and destinations. use when you need route metrics before optimizing or timing routes.
Parámetros de entrada
modestringenumRouting mode
cartruckfootbikeavoidstringRoute features to avoid, comma-separated (e.g., 'tolls,ferries')
unitsstringenumUnits for distance measurement
metricimperialoriginsstringObligatorioList of origin coordinates as 'lat,lng', separated by semicolons
geometrybooleanWhether to include route geometry (GeoJSON LineString) in response
destinationsstringObligatorioList of destination coordinates as 'lat,lng', separated by semicolons
origins_limitintegerMaximum number of origins per destination
destinations_limitintegerMaximum number of destinations per origin
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Search GeofencesRADAR_SEARCH_GEOFENCES_NEAR_LOCATIONAcciónTool to search for geofences near a given location. use when you need to find geofences within a radius of specified coordinates.
RADAR_SEARCH_GEOFENCES_NEAR_LOCATIONAcciónTool to search for geofences near a given location. use when you need to find geofences within a radius of specified coordinates.
Parámetros de entrada
tagsstring[]Filter geofences by these tags
radiusintegerSearch radius in meters (default 1000, max 10000)
latitudenumberObligatorioLatitude of the location to search near
metadataobjectFilter geofences by metadata key-value pairs
longitudenumberObligatorioLongitude of the location to search near
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Search Places Near LocationRADAR_SEARCH_PLACES_NEAR_LOCATIONAcciónTool to search for places near given coordinates. use when you need to find points of interest around a location.
RADAR_SEARCH_PLACES_NEAR_LOCATIONAcciónTool to search for places near given coordinates. use when you need to find points of interest around a location.
Parámetros de entrada
nearanyObligatorioCoordinates to search near in 'lat,lng' format
brandstringFilter by brand name or ID
limitintegerNumber of results to return; max 100; defaults to 10
chainsstring[]Filter by chain IDs
groupsstring[]Filter by custom group names
radiusintegerSearch radius in meters; max 100000 (100 km); defaults to 1000
countrystringISO 3166-1 alpha-2 country code
categoriesstring[]Filter by category names
chain_metadatabooleanIf true, includes chain metadata in each place object
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Search Users Near LocationRADAR_SEARCH_USERS_NEAR_LOCATIONAcciónTool to search for users near a location. use after obtaining coordinates when you need to retrieve users within a given radius.
RADAR_SEARCH_USERS_NEAR_LOCATIONAcciónTool to search for users near a location. use after obtaining coordinates when you need to retrieve users within a given radius.
Parámetros de entrada
limitintegerMaximum number of users to return (default: 100, max: 500).
radiusnumberMaximum distance in meters to search (default: 1000).
latitudenumberObligatorioLatitude of the location in decimal degrees.
longitudenumberObligatorioLongitude of the location in decimal degrees.
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Track Location UpdateRADAR_TRACK_LOCATION_UPDATEAcciónTool to track a user's location update. use when sending a location update for a user, creating or updating user and event data.
RADAR_TRACK_LOCATION_UPDATEAcciónTool to track a user's location update. use when sending a location update for a user, creating or updating user and event data.
Parámetros de entrada
eventsbooleanWhether to evaluate geofences, places, etc.
nearbybooleanWhether to include nearby places/geofences in the response
userIdstringObligatorioUnique identifier for the user
stoppedbooleanWhether the user is stopped
deviceIdstringUnique identifier for the user's device
locationobjectObligatorioLocation object representing the user's position
metadataobjectArbitrary metadata to associate with this track event
replayedbooleanWhether this location update is historical (replayed)
foregroundbooleanWhether the location was tracked in the foreground
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Update TripRADAR_UPDATE_TRIPAcciónTool to update a trip. use when you need to modify mode, destination, schedule, or active status.
RADAR_UPDATE_TRIPAcciónTool to update a trip. use when you need to modify mode, destination, schedule, or active status.
Parámetros de entrada
idstringObligatorioThe Radar trip ID or externalId to update
modestringenumMode of travel
cartruckbikefootmotorcyclescooteractivebooleanWhether the trip is active (true) or paused/completed (false)
formatstringSet to 'externalId' when the provided ID is an external trip ID
metadataobjectCustom metadata (max 16 key-value pairs)
externalIdstringNew external ID for the trip
destinationobjectExplicit destination coordinates if not using a geofence.
arrivedThresholdnumberThreshold in meters for the 'arrived' state
scheduledArrivalAtstringScheduled arrival time in ISO8601 format
approachingThresholdnumberThreshold in meters for the 'approaching' state
destinationGeofenceTagstringTag of destination geofence
destinationGeofenceRadiusnumberRadius in meters for the destination geofence
destinationGeofenceExternalIdstringExternal ID of destination geofence
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not
Upsert GeofenceRADAR_UPSERT_GEOFENCEAcciónTool to create or update a geofence by tag and externalid. use when ensuring a geofence exists or is updated based on identifiers.
RADAR_UPSERT_GEOFENCEAcciónTool to create or update a geofence by tag and externalid. use when ensuring a geofence exists or is updated based on identifiers.
Parámetros de entrada
tagstringObligatorioTag of the geofence to create or update
typestringObligatorioenumShape type of the geofence
circlepolygonradiusnumberRadius in meters defining a circle. Required when type='circle'.
geometryobjectGeoJSON geometry object for the geofence
metadataobjectCustom key-value pairs attached to the geofence
externalIdstringObligatorioExternal identifier of the geofence
coordinatesarray[]Array of [longitude, latitude] pairs defining a polygon. Required when type='polygon'.
descriptionstringHuman-readable description of the geofence
Parámetros de salida
dataobjectObligatorioData from the action execution
errorstringError if any occurred during the execution of the action
successfulbooleanObligatorioWhether or not the action execution was successful or not