Search Location
Use Search Location to resolve the patient location before displaying doctor availability and booking options.
The selected location determines supported services, doctor availability, pricing, and booking flows.
This screen includes:
| # | Element | Description |
|---|---|---|
| 1 | Branding header | Displays the Air Doctor logo |
| 2 | Location selector | Opens location search and selection |
| 3 | Location illustration | Indicates location-based doctor discovery |
| 4 | Availability message | Explains nearby doctor search behavior |
| 5 | Use current location action | Requests device location access |
| 6 | Enter location action | Opens manual location search |
| 7 | Bottom navigation | Opens primary app sections |
| 8 | Notification indicator | Displays unread updates when available |
Workflow
- Open the onboarding or Home location flow.
- Request the location screen configuration.
- Select Use current location or Enter location.
- Search for a location when manual selection is used.
- Display predicted locations.
- Select a location.
- Refresh Home content for the selected location.
Validations
| Scenario | App Behavior | SDK Output |
|---|---|---|
| Location permission granted | Resolve device location | location = resolved |
| Location permission denied | Keep manual search flow available | location = denied |
| Search input empty | Hide prediction results | results = empty |
| Search returns matches | Display predicted locations | results = available |
| Search returns no matches | Display empty state | results = unavailable |
| Selected location supported | Load Home content | availability = available |
| Selected location unsupported | Display unsupported state | availability = unavailable |
| Session invalid | Block access | state = unauthenticated |
Actions
| Scenario | App Behavior | SDK Output |
|---|---|---|
| Location screen opened | Load location flow | PUT /api/v3/home/location |
| Search value updated | Refresh predicted locations | PATCH /api/v3/home/location/search |
| Predicted location selected | Load Home content for location | PATCH /api/v3/home/location/show |
| Current location selected | Resolve device coordinates | location = requested |
| Location resolved | Refresh Home availability | location = updated |
| Request rejected | Display error state | state = error |
Endpoint Resources
Search
PUT
v3/home/location
Produces the patient search location screen.
Search Location
PATCH
v3/home/location/search
Predicts locations from user input.
Select Location
PATCH
v3/home/location/show
Selects a location and presents Home page content based on that location.