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.

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.

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.

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.

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 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.

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.

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).