MTS Nearby Search

overview the mts nearby search api extends motion tracking service by providing the capability to search for nearby devices (vehicles or drivers) that are close to the specified point of interest you can sort the search for devices can be done using radial distance or by the most recent timestamp applications that require real time proximity data can use nearby search api to optimize their driver/vehicle allocation the nearby search api enables applications to provide latitude and longitude for a given point of interest specify the radial distance to filter nearby vehicles or devices within the vicinity sort results by the most recent timestamp using sortbytis control the number of results returned in each response with the limit parameter you can set how many results you want to see at once, up to a maximum of 50 common use cases the nearby search api is useful in several scenarios find nearby riders for last mile delivery when an order is received, the app needs to find the riders within a specified radial distance from the pickup location the api enables hyper local and last mile applications to search for nearby riders and sort them by the most recent timestamp to track the status or location and identify who can pick up the package the fastest food delivery when an order is ready for pickup, the app needs to locate riders within the shortest radial distance from the restaurant the api allows the app to quickly notify available riders who are up to date with their current location and availability transport management system (tms) when a logistics manager needs to fulfill delivery demands, the app needs to find nearby available vehicles within a specified radius the api provides a list of nearby vehicles and sorts them by the most recent timestamp using nearby search api this section explains how to use the nearby api, including key parameters and customization options you'll learn how to configure requests to find nearby devices, as well as how to tailor responses to meet specific application needs to use the nearby search api, follow the steps below create an mts track before you can use the nearby search api, you need to create an mts track this is required to track devices and their movements refer to create mts track https //docs getos1 com/smartphone tracking#tujkq for the detailed steps insert traces after you have created an mts track, insert trace data pertaining to that track refer to insert traces https //docs getos1 com/smartphone tracking# xbex for the detailed steps perform a nearby search after creating an mts track and updating or inserting traces, you can now use the api to find devices within a specific vicinity provide the latitude and longitude of a trace to search for nearby devices the api will return details based on the provided coordinates configuration parameters the following parameters allow you to tailor the search based on location, distance, and other criteria parameter data type description required center string latitude and longitude of the point of interest which will be considered as the origin for the search to be conducted yes radius number radial distance from the point of interest in kilometers yes mode string denotes the types of provider sending trace data such as smartphone optional sortbytis string timestamp (in milliseconds) of when the device was last seen optional limit integer maximum number of results to return in a single response optional offset string number of results to skip before returning the next set optional example usage below is a sample example of how the nearby search api fetches a list of nearby available devices based on radial distance and sort by timestamp sample request get /core/api/v1/mts/nearby search?center=28 6514657,77 2378349\&radius=16 sample response { "error" {}, "data" \[ { "tis" 1726646286000, "lat" 28 6423879, "lon" 77 2442371, "deviceid" "test context 1", "appid" "platform\ app\ coreos", "trackid" "mts\ track\ cc300c91 c8fe 837d 64b5 9958791a5a42", "distance" 1 187, "mode" "smart phone" }, { "tis" 1726646418000, "lat" 28 6923879, "lon" 77 2542371, "deviceid" "test context 2", "appid" "platform\ app\ coreos", "trackid" "mts\ track\ afdb7cfc 36f1 2df8 b7e0 734f6083758e", "distance" 4 823, "mode" "smart phone" } ], "request" { "uri" "/core/api/v1/mts/nearby search?center=28 6514657,77 2378349\&radius=16", "body" {} } } in this example the request specifies the center coordinates and a radius of 16 kilometers the response returns an array of devices with their respective latitude (lat), longitude (lon) , deviceid , distance from the center, and mode reference documentation to learn more about nearby search api, refer to our api reference documentation