Nearby places by category
bl_nearbyFind nearby pharmacies, restaurants, gas stations, or other place categories around a coordinate, returning address, phone, rating, and straight-line distance.
Instructions
List places of one kind (pharmacy, restaurant, gas station...) around a point, with address, phone and rating.
Balad's own order, each with straight-line distance_km. Free text naming a category (پیتزا) lists that
whole category (category says which). Get the point from bl_search. For driving time use
bl_nearest_by_drive; for places on a trip bl_along_route; for hours and reviews bl_place with id. Empty:
widen radius_km or drop filters.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"what": "<what>",
"lat": "<lat>",
"lng": "<lng>"
},
"name": "bl_nearby"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lat | Yes | Latitude, e.g. 35.7448. | |
| lng | Yes | Longitude, e.g. 51.3753. | |
| sort | No | rating = best first, popular = most visited. | relevance |
| what | Yes | Category slug from bl_categories (e.g. pharmacy, gas-station) or free text (e.g. پیتزا). | |
| limit | No | Max places (1-40). | |
| price | No | Restaurants and cafes only. | |
| open_now | No | Only places open now. | |
| radius_km | No | Box half-width in km (0.2-20). | |
| min_rating | No | Only places rated above this. | |
| with_phone | No | Only places with a phone number. | |
| with_photos | No | Only places with photos. |