package com.rj.service;

import com.rj.dto.NearbyMerchantSearchResult;

/**
 * 基于高德地图：地址转坐标 + 周边全行业 POI（商家）检索。
 */
public interface INearbyMerchantSearchService {

    /**
     * 根据城市、详细地址得到中心点，再按半径分页拉取周边商家。
     *
     * @param city               城市（传给地理编码 city 参数，如「河北省廊坊市三河市燕郊镇」）
     * @param address            地址/地标（传给地理编码 address 参数）
     * @param radiusMeters       周边搜索半径（米）
     * @param maxPage            最多请求页数（从 1 递增）
     * @param maxRecordsPerPage  每页条数，高德允许 1～50，超出会被裁剪
     */
    NearbyMerchantSearchResult searchNearbyMerchants(String city, String address,
                                                     int radiusMeters, int maxPage, int maxRecordsPerPage);
}
