Search for places, addresses and POIs near a location in Iran.

Convert coordinates into a human-readable Persian address.

Convert a free-text Persian address into geographic coordinates.

Cheaper than neshan_geocode_plus — prefer this by default. Switch to neshan_geocode_plus only when the address includes a plaque (پلاک) number or refers to a point of interest by name, which this endpoint does not resolve.

Geocode an address that includes a plaque (پلاک) number or a named point of interest — neshan_geocode can't resolve those.

More expensive than neshan_geocode, so only use this when plaque/POI resolution is actually needed. Whenever available, pass city, province, a bias location, and/or a bounding box: all of them improve geocoding accuracy regardless of whether plaque/POI resolution is involved.

Calculate a route between two points, choosing how traffic is modeled.

Compute travel distance and duration for every origin-destination pair.

Find the optimal visiting order for multiple destinations (TSP).

Snap a sequence of GPS points onto the road network (map matching).

Calculate the reachable area from a point within a given time or distance (isochrone).

Returns a GeoJSON FeatureCollection. Each feature's geometry is a Polygon or LineString (controlled by 'polygon') and properties.metric is 'time' or 'distance'. Both distance and time can be requested simultaneously.

Render a static map image (PNG) centered on a coordinate.

Render a static map image (PNG) with a curved arc line between two points.

Useful for visualising geographic connections, travel reports, or origin-destination relationships on a map without performing full routing.

Generate an interactive Neshan map HTML file and save it locally.

Creates a fully interactive map page using the Neshan Maps SDK. Supports markers with popups and route polylines drawn on the map. The map auto-fits to show all markers and routes. Open the returned file_path in any browser to view the map.

Analyse historical traffic patterns around a location.

Returns three things:

• kpi: overall traffic congestion score for the location (higher = more congested).

• chart: 24-hour traffic breakdown — one entry per hour with a numeric score and a color key (green → free flow, yellow → moderate, orange → heavy, red → congested).

• static_map: a PNG image of the area (~500 m radius) with traffic overlay.

Solve a Vehicle Routing Problem (VRP) for logistics / delivery optimization.

Assigns a set of jobs to vehicles starting from a depot, minimising total distance or duration, respecting vehicle capacities, skills, and time windows. See each object's field descriptions in the tool schema for exact shape.

Fetch full details of a place using its poiHash from neshan_search results.

Only works for items where neshan_search marked 'verified_details_available: true' (owner-claimed places). This call is expensive — use it selectively for specific candidates you need confirmed details on (precise address, category, working hours, region), not as a blanket follow-up for every search result.

Generate Neshan app deeplinks for showing a point or navigating between two points.

If the Neshan app is installed the link opens it directly; otherwise it falls back to the Neshan web app. Returns both Android/Web and iOS variants.