package com.ruoyi.system.service;

import java.util.Map;

/**
 * 地图服务接口
 * 支持多种地图服务提供商（百度地图、天地图等）
 * 
 * @author ruoyi
 */
public interface IMapService {
    
    /**
     * 地址转GPS坐标（地理编码）
     * 
     * @param address 地址
     * @param city 城市（可选，用于提高解析准确性）
     * @return GPS坐标，包含lng和lat，如果获取失败返回null
     */
    Map<String, Double> geocoding(String address, String city);

    /**
     * GPS坐标转地址（逆向地理编码）
     *
     * @param lng 经度
     * @param lat 纬度
     * @return 地址，如果获取失败返回null
     */
    String reverseGeocoding(double lng, double lat);
}