Proximity-Based Search

Table of Contents


Target Audience

Objectives (of this release)

Assumptions and Validations

Process flow




This document describes the need and scope of proximity based search included within V2.0, explaining the module’s features, specifications, purpose, and functionality. It also provides the descriptive view of the application along with the specification of each element.

Proximity-based search is a feature implemented in HCM to enhance user experiences and provide relevant results based on last recorded location. It leverages location data to enable the field team to identify a nearby household.

Proximity-based search is designed to address the need for location-specific information and improve the user’s convenience by presenting results that are geographically relevant.

Target Audience

This document is intended for the engineering and platform (tech teams), product management, and implementation teams to agree on requirements for the Health Campaign Management (HCM) Platform.

Objectives (of this release)

  1. Improve accessibility:

- By enabling actors to easily find nearby households and deliver bed nets accordingly.

  1. Enhance user experience:

- Proximity-based search offers a seamless and intuitive way to find the nearby households based on the latitude, longitude, saved by the application.

  1. Enhance offline functionality:

- Aims to address scenarios where internet connectivity may be limited or unavailable.

Assumptions and Validations

Sr. No.




Search households

- The “Search Household” feature provides a comprehensive overview of the registered household in the administrative area, including the number of bed nets delivered.

- It also displays the list of beneficiaries registered within the application, with the most recent beneficiary registered displaying at the top.


Search near me

- By selecting the “Search Near Me” checkbox , the user can retrieve a list of beneficiaries who are in close proximity to the user’s last recorded latitude/longitude coordinates.

-The “Search Household” screen should organise the displayed list, starting from the beneficiary near the user’s latitude/longitude location and extending to the remaining beneficiary listed on the landing page.

- When sorting the list based on proximity, prioritise displaying the households that have “not been visited yet”, followed by the visited households in case two households are at the same distance.

- On unchecking the “Search Near Me” box, the list should reset to its initial list of beneficiaries.

Process flow



Data type

Data validation

Required (Y/N)


Beneficiary List


Last registered beneficiary to be displayed first


The list of beneficiaries registered within the application.

Search by proximity


  1. Display the beneficiary in close proximity with the user’s last recorded Lat/Long coordinates (Close-In-to-Far-Out)

  2. Display the “not visited” household first in case two households are at the same distance.


List of beneficiaries near to the user’s last recorded latitude/ longitude coordinates.


Find the mock-ups below:

HCM Home Screen

After logging into the application, the user lands on this screen which displays the daily performance (number of households registered). The progress bar must reset daily at 00:00 hours and start from zero registrations. The action buttons related to the beneficiary include:

  • Beneficiaries

  • View Reports

  • Sync Data

  • Call Supervisor

  • File Complaint

At the bottom, there is a card that shows how many records are unsynced for the user’s convenience to sync data. If all the records are synced, then the card must say “All records are synced”.

The help button is on every screen of the application, and by clicking on it, a user can get a walkthrough of the elements on that screen.

On the top right, the administrative area assigned to the user is displayed which is based on the level of hierarchy.

The hamburger button on the top left corner covers some other actions mentioned further.

Search Households

During implementation, there must be an option to configure the default view of the search households screen. There are two views:

  1. Show results only after searching (current v1 state).

  2. Display results (list of households) based on LIFO (last registered households displayed first).

For #2:

The Search Household screen displays the number of households registered along with the number of bed nets delivered in that administrative area. It also displays a comprehensive list of beneficiaries who have been registered within the system. The list is sorted in descending order, with the most recently registered beneficiary appearing at the top, allowing for easy access to the latest beneficiary information. This feature ensures that users can quickly identify and review the most recent additions to the beneficiary database, enabling efficient tracking and management of beneficiary records.

The “Search Near Me” checkbox will allow users to conveniently view the list of beneficiaries who are in close proximity to the user’s last recorded latitude/longitude coordinates.

The register button is primarily disabled to ensure that the user performs the search action.

The search bar allows the user to search by the household head’s name and the system provides the search results. The minimum string length to show results is 2 characters and the order of the results will be the last record displayed first. The ‘Back’ button on the top will navigate to the home screen.

Search Near Me

The "Search Near Me" checkbox enables users to find beneficiaries in close proximity to their latitude/longitude location (search radius must be configurable).

  1. When the checkbox is enabled, users can access a list of beneficiaries located near their current GPS coordinates - latitude and longitude coordinates - allowing them to identify nearby households.

  2. When sorting the list by proximity, prioritise showing the households that have not been visited yet. If two households are at the same distance, display the visited households afterwards. This ensures efficient organisation and visibility of household visits based on the status.

  3. When the "Search Near Me" box is unchecked, the list of beneficiaries should revert back to its original state, displaying the initial list of beneficiaries. This allows users to easily reset the search and view all beneficiaries without proximity filtering.

  4. The distance must be displayed dynamically, that is, if the distance is less than 1 km, display it in metres, and for distances above 1 km, display it in kilometres.

Last updated