package com.seer.teach.iot.api;

import org.springframework.cloud.openfeign.FeignClient;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RequestParam;

/**
 * 位置数据
 * <p>
 * 获取设备的位置数据
 * </p>
 *
 * @author Captain
 * @version 1.0
 * @since 2025-07-16 9:51
 */
@FeignClient(name = ApiConstants.SERVER_NAME,contextId = "locationServiceApi",path = "/seer/iot")
public interface DeviceLocationInfoServiceApi {
    /**
     * 根据城市ID获取对应的省份名称
     *
     * @param cityId 城市ID
     * @return 所属省份名称，例如 "广东省"
     */
    @GetMapping("/getProvinceNameByCityId")
    String getProvinceByCityId(@RequestParam("cityId") Integer cityId);

    /**
     * 根据城市ID获取城市名称
     *
     * @param cityId 城市ID
     * @return 城市名称，例如 "广州市"
     */
    @GetMapping("/getCityNameByCityId")
    String getCityNameByCityId(@RequestParam("cityId") Integer cityId);
}