D

README.md

@@ -6,4 +6,5 @@ Amap JAVA SDK v3
 - [地理编码](https://lbs.amap.com/api/webservice/guide/api/georegeo)
 - [逆地理编码](https://lbs.amap.com/api/webservice/guide/api/georegeo)
 - [IP定位](https://lbs.amap.com/api/webservice/guide/api/ipconfig)
-- [天气查询](https://lbs.amap.com/api/webservice/guide/api/weatherinfo)
+- [天气查询](https://lbs.amap.com/api/webservice/guide/api/weatherinfo)
+- [行政区域查询](https://lbs.amap.com/api/webservice/guide/api/district)

pom.xml

@@ -6,7 +6,7 @@
 
     <groupId>xyz.felh</groupId>
     <artifactId>amap-java</artifactId>
-    <version>0.1.0</version>
+    <version>0.2.0</version>
     <packaging>jar</packaging>
 
     <name>open API of Amap for Java</name>

src/main/java/xyz/felh/amap/AmapOpenApi.java

@@ -3,6 +3,7 @@
 import io.reactivex.rxjava3.core.Single;
 import retrofit2.http.GET;
 import retrofit2.http.QueryMap;
+import xyz.felh.amap.response.district.DistrictResponse;
 import xyz.felh.amap.response.geocode.GeoCodeRegeoResponse;
 import xyz.felh.amap.response.geocode.GeoCodeResponse;
 import xyz.felh.amap.response.ip.IpResponse;
@@ -43,4 +44,10 @@ public interface AmapOpenApi {
     @GET("/v3/weather/weatherInfo")
     Single<WeatherResponse> weather(@QueryMap Map<String, String> map);
 
+    /**
+     * 行政区域查询是一类简单的HTTP接口，根据用户输入的搜索条件可以帮助用户快速的查找特定的行政区域信息。
+     */
+    @GET("/v3/config/district")
+    Single<DistrictResponse> district(@QueryMap Map<String, String> map);
+
 }

src/main/java/xyz/felh/amap/AmapOpenApiService.java

@@ -12,10 +12,12 @@
 import retrofit2.Retrofit;
 import retrofit2.adapter.rxjava3.RxJava3CallAdapterFactory;
 import retrofit2.converter.jackson.JacksonConverterFactory;
+import xyz.felh.amap.request.district.DistrictRequest;
 import xyz.felh.amap.request.geocode.GeoCodeRegeoRequest;
 import xyz.felh.amap.request.geocode.GeoCodeRequest;
 import xyz.felh.amap.request.ip.IpRequest;
 import xyz.felh.amap.request.weather.WeatherRequest;
+import xyz.felh.amap.response.district.DistrictResponse;
 import xyz.felh.amap.response.geocode.GeoCodeRegeoResponse;
 import xyz.felh.amap.response.geocode.GeoCodeResponse;
 import xyz.felh.amap.response.ip.IpResponse;
@@ -113,4 +115,9 @@ public WeatherResponse weather(WeatherRequest request) {
         return execute(api.weather(request.toQueryMap()));
     }
 
+    public DistrictResponse district(DistrictRequest request) {
+        request.setKey(key);
+        return execute(api.district(request.toQueryMap()));
+    }
+
 }

src/main/java/xyz/felh/amap/request/district/DistrictRequest.java

@@ -0,0 +1,101 @@
+package xyz.felh.amap.request.district;
+
+import com.alibaba.fastjson2.annotation.JSONField;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.*;
+import lombok.experimental.SuperBuilder;
+import xyz.felh.amap.request.BaseRequest;
+import xyz.felh.amap.request.Extensions;
+
+import java.util.Map;
+
+@EqualsAndHashCode(callSuper = true)
+@Data
+@AllArgsConstructor
+@NoArgsConstructor(force = true)
+@ToString(callSuper = true)
+@SuperBuilder(toBuilder = true)
+public class DistrictRequest extends BaseRequest {
+
+    /**
+     * 查询关键字
+     * <p>
+     * 规则：只支持单个关键词语搜索关键词支持：行政区名称、citycode、adcode
+     * 例如，在subdistrict=2，搜索省份（例如山东），能够显示市（例如济南），区（例如历下区）
+     */
+    private String keywords;
+
+    /**
+     * 子级行政区
+     * <p>
+     * 规则：设置显示下级行政区级数（行政区级别包括：国家、省/直辖市、市、区/县、乡镇/街道多级数据）
+     * 可选值：0、1、2、3等数字，并以此类推
+     * 0：不返回下级行政区；
+     * 1：返回下一级行政区；
+     * 2：返回下两级行政区；
+     * 3：返回下三级行政区；
+     * <p>
+     * 需要在此特殊说明，目前部分城市和省直辖县因为没有区县的概念，故在市级下方直接显示街道。
+     * 例如：广东-东莞、海南-文昌市
+     */
+    @JsonProperty("subdistrict")
+    @JSONField(name = "subdistrict")
+    private Integer subDistrict;
+
+    /**
+     * 需要第几页数据
+     * <p>
+     * 最外层的districts最多会返回20个数据，若超过限制，请用page请求下一页数据。
+     * 例如page=2；page=3。默认page=1
+     */
+    private Integer page;
+
+    /**
+     * 最外层返回数据个数 default: 20
+     */
+    private Integer offset;
+
+    /**
+     * 返回结果控制, default: base
+     * <p>
+     * 此项控制行政区信息中返回行政区边界坐标点； 可选值：base、all;
+     * base:不返回行政区边界坐标点；
+     * all:只返回当前查询district的边界值，不返回子节点的边界值；
+     * 目前不能返回乡镇/街道级别的边界值
+     */
+    private Extensions extensions;
+
+    /**
+     * 根据区划过滤
+     * <p>
+     * 按照指定行政区划进行过滤，填入后则只返回该省/直辖市信息
+     * 需填入adCode，为了保证数据的正确，强烈建议填入此参数
+     */
+    private String filter;
+
+
+    @Override
+    public Map<String, String> toQueryMap() {
+        Map<String, String> map = super.toQueryMap();
+        if (keywords != null) {
+            map.put("keywords", keywords);
+        }
+        if (subDistrict != null) {
+            map.put("subdistrict", subDistrict.toString());
+        }
+        if (page != null) {
+            map.put("page", page.toString());
+        }
+        if (offset != null) {
+            map.put("offset", offset.toString());
+        }
+        if (extensions != null) {
+            map.put("extensions", extensions.value());
+        }
+        if (filter != null) {
+            map.put("filter", filter);
+        }
+        return map;
+    }
+
+}

src/main/java/xyz/felh/amap/response/district/District.java

@@ -0,0 +1,51 @@
+package xyz.felh.amap.response.district;
+
+import com.alibaba.fastjson2.annotation.JSONField;
+import com.fasterxml.jackson.annotation.JsonProperty;
+import lombok.Data;
+
+import java.io.Serializable;
+import java.util.List;
+
+@Data
+public class District implements Serializable {
+
+    @JsonProperty("citycode")
+    @JSONField(name = "citycode")
+    private String cityCode;
+
+    @JsonProperty("adcode")
+    @JSONField(name = "adcode")
+    private String adCode;
+
+    private String name;
+
+    /**
+     * 行政区边界坐标点
+     * <p>
+     * 当一个行政区范围，由完全分隔两块或者多块的地块组
+     * 成，每块地的 polyline 坐标串以 | 分隔 。
+     * 如北京 的 朝阳区
+     */
+    private String polyline;
+
+    /**
+     * country:国家
+     * province:省份（直辖市会在province显示）
+     * city:市（直辖市会在province显示）
+     * district:区县
+     * street:街道
+     */
+    private String level;
+
+    /**
+     * 区域中心点
+     */
+    private String center;
+
+    /**
+     * 下级行政区列表，包含district元素
+     */
+    private List<District> districts;
+
+}

src/main/java/xyz/felh/amap/response/district/DistrictResponse.java

@@ -0,0 +1,17 @@
+package xyz.felh.amap.response.district;
+
+import lombok.Data;
+import lombok.EqualsAndHashCode;
+import xyz.felh.amap.response.BaseResponse;
+
+import java.util.List;
+
+@EqualsAndHashCode(callSuper = true)
+@Data
+public class DistrictResponse extends BaseResponse {
+
+    private Suggestion suggestion;
+
+    private List<District> districts;
+
+}

src/main/java/xyz/felh/amap/response/district/Suggestion.java

@@ -0,0 +1,14 @@
+package xyz.felh.amap.response.district;
+
+import lombok.Data;
+
+import java.io.Serializable;
+
+@Data
+public class Suggestion implements Serializable {
+
+    private String keywords;
+
+    private String cities;
+
+}

src/test/java/xyz/felh/amap/AmapServiceTest.java

@@ -7,10 +7,12 @@
 import org.junit.jupiter.api.Test;
 import retrofit2.Retrofit;
 import xyz.felh.amap.request.Extensions;
+import xyz.felh.amap.request.district.DistrictRequest;
 import xyz.felh.amap.request.geocode.GeoCodeRegeoRequest;
 import xyz.felh.amap.request.geocode.GeoCodeRequest;
 import xyz.felh.amap.request.ip.IpRequest;
 import xyz.felh.amap.request.weather.WeatherRequest;
+import xyz.felh.amap.response.district.DistrictResponse;
 import xyz.felh.amap.response.geocode.GeoCodeRegeoResponse;
 import xyz.felh.amap.response.geocode.GeoCodeResponse;
 import xyz.felh.amap.response.ip.IpResponse;
@@ -64,9 +66,19 @@ public void ip() {
     public void weather() {
         WeatherResponse response = getAmapService().weather(WeatherRequest.builder()
                 .city("110101")
-                        .extensions(Extensions.ALL)
+                .extensions(Extensions.ALL)
                 .build());
         log.info("weather: {}", JSON.toJSONString(response));
     }
 
+    @Test
+    public void district() {
+        DistrictResponse response = getAmapService().district(DistrictRequest.builder()
+                .keywords("上海市")
+                .extensions(Extensions.ALL)
+                .subDistrict(3)
+                .build());
+        log.info("district: {}", JSON.toJSONString(response));
+    }
+
 }