Balad Maps

Find places of one kind (gas station, restaurant, pharmacy...) along the suggested driving route between two points. Use it for "a gas station on my way to Shiraz" or "a cafe on the way home". Places are ordered by where they come on the route (`km_from_start`) with how far off the road they are. Balad is searched in up to 12 boxes spaced along the route, so on long trips (hundreds of km) places between boxes are missed; split the trip with nearer destinations for full coverage. Details of a place: bl_place.

List Balad's place categories with the slug bl_nearby takes, grouped (food, health, shopping, services...). Call it when you need the exact slug for bl_nearby, bl_nearest_by_drive or bl_along_route (e.g. pharmacy, hospital, gas-station, atm, parking).

List places of one kind (pharmacy, restaurant, gas station...) around a point, with address, phone and rating. Results are in Balad's own order (as on balad.ir, filters included), each with its straight-line distance from the point. Text that names a category (پیتزا -> fast-food-restaurant) lists that whole category, as the site does; `category` then says which. Get the point from bl_search (a city or landmark) or from the user. For the closest by driving time use bl_nearest_by_drive; for places on the way between two points use bl_along_route; for hours, photos and reviews of one place call bl_place with its `id`. Empty: widen radius_km, drop filters or use another word; bl_categories lists valid slugs.

Rank places of one kind around a point by driving time from it in current traffic, quickest first. Use it for "which pharmacy / gas station / hospital can I reach fastest from here". It takes Balad's top `candidates` places of that kind in the box (as bl_nearby lists them) and times a drive to each (one route call per place). Places Balad cannot route to are left out. For more places without drive times use bl_nearby; for details of the winner call bl_place.

Get one place's full details from Balad: address, phones, hours, open now, rating, amenities, photos, reviews. `id` comes from bl_search, bl_nearby, bl_nearest_by_drive or bl_along_route. `hours` maps each weekday (شنبه..جمعه) to that day's hours as the site shows them; `menu` is the restaurant's menu link when it has one; `photos` are full-size image URLs. For more reviews call bl_reviews; for directions call bl_route with its lat/lng.

Turn coordinates into a Persian street address with city, county and neighbourhood (reverse geocoding). Use it when the user gives a point or a map pin and wants to know where it is. For the opposite (address or name -> coordinates) use bl_search. Covers Iran only; elsewhere it answers with an error.

Get one page of user reviews of a place on Balad, newest first, with stars and the rating breakdown. `id` comes from bl_search or bl_nearby. 10 reviews per page; when `more` is true, call again with page+1. bl_place already includes the first few reviews.

Get driving routes in Iran with distance, travel time in current traffic, tolls, roads and traffic-zone warnings. Returns up to 3 routes, suggested first, like balad.ir's directions page; `notes` carry the site's labels (traffic delay, toll in Toman, lowest fuel use); `traffic_plan` appears when the route enters a restricted zone (طرح ترافیک, زوج و فرد) with its hours. With `stops`, `legs` gives each part. Driving only: Balad's routing answers car routes for every mode. Get coordinates from bl_search or bl_nearby. Error 'no route': a point is outside Iran or off the road network.

Search Balad (Iranian map) for places, streets, neighbourhoods and cities by name, with coordinates and address. Use it to find a specific place or to turn an address or city name into coordinates (geocoding). Results near the given point rank first, so pass lat/lng (e.g. a city's coordinates from a first bl_search) when searching outside Tehran. `type` is poi (a business or landmark: pass its `id` to bl_place), road, city, region or category; a category row gives a `category` slug for bl_nearby. For every pharmacy, restaurant, etc. around a point use bl_nearby instead; for coordinates -> address use bl_reverse_geocode. Empty: try a shorter or Persian query.