地点资源 最后更新时间: 2024年02月28日
产品介绍
地点资源 API 是通过 HTTPS 协议访问远程服务的接口,提供新建/修改/删除标记地点的能力。
适用场景
- 新建地点:创建地点资源
- 修改地点:修改地点资源
- 删除地点:删除地点资源
- 查询地点:查询已创建的地点资源
使用限制
详细的服务调用量限制可点我查阅。
使用说明
接收请求返回的数据(JSON或XML格式),参考返回参数文档解析数据。
如无特殊声明,接口的输入参数和输出数据编码全部统一为 UTF-8 编码方式。
1. 新建地点
请求地址
parameters代表的参数为“url 请求参数”,包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
http body 请求参数
示例代码 (以java为例)
import com.amap.wia.openapi.test.lib.MyHttpUtils;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/demo-lib
import com.amap.wia.openapi.test.lib.SignatureHelper;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/biz-token-sign
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
/*
* 通用 import 内容等暂略
*/
public static void main(String[] args) {
String url = "https://restwia.amap.com/api/v1/wia/point/create";
Map<String, Object> params = new HashMap<>();
String workMapId = "要操作的workMapId";
params.put("key","在高德开放平台申请的key");
params.put("workMapId",workMapId);
params.put("openId","当前操作用户的openId");
params.put("bizToken","在高德开放平台申请的bizToken");
String[] signArgs = new String[]{workMapId};
params.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret",signArgs));
url = MyHttpUtils.attachParamsToUrl(url, params);
Map<String, String> createMapRequest = Maps.newHashMap();
createMapRequest.put("title","坐标点名称");
createMapRequest.put("desc","坐标点描述信息11");
PointInfoRequest obj = PointInfoRequest.builder().lat("39.917796").lon("116.395999").build();
String pointInfoStr = JSONObject.toJSONString(obj);
createMapRequest.put("pointInfoStr",pointInfoStr);
String response = MyHttpUtils.postFormUrlencoded(url, createMapRequest);
System.out.println(response);
}
返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明:
2. 修改地点
请求地址
parameters代表的参数为“url 请求参数”,包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
http body 请求参数
返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明:
3. 删除地点
请求地址
parameters代表的参数为“url 请求参数”,包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明:
4. 查询单个地点详情
请求地址
parameters代表的参数为“url 请求参数”,包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
示例代码 (以java为例)
import com.amap.wia.openapi.test.lib.MyHttpUtils;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/demo-lib
import com.amap.wia.openapi.test.lib.SignatureHelper;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/biz-token-sign
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
/*
* 通用 import 内容等暂略
*/
public static void main(String[] args) {
String url = "https://restwia.amap.com/api/v1/wia/point/detail";
Map<String, Object> params = new HashMap<>();
String workMapId = "要操作的workMapId";
String openId = "当前操作用户的openId";
String resourceId = "要获取的point id";
params.put("key","在高德开放平台申请的key");
params.put("workMapId",workMapId);
params.put("openId",openId);
params.put("bizToken","在高德开放平台申请的bizToken");
String[] signArgs = new String[]{workMapId,resourceId};
params.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret",signArgs));
url = MyHttpUtils.attachParamsToUrl(url, params);
String response = MyHttpUtils.postFormUrlencoded(url,new HashMap<>());
System.out.println(response);
}
返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明:
5. 分页查询资源列表
请求地址
parameters代表的参数为“url 请求参数”,包括必填参数和可选参数。所有参数均使用字符"&"进行分隔。下面的列表枚举了这些参数及其使用规则。
url 请求参数
http body请求参数
示例代码 (以java为例)
import com.amap.wia.openapi.test.lib.MyHttpUtils;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/demo-lib
import com.amap.wia.openapi.test.lib.SignatureHelper;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/biz-token-sign
import com.alibaba.fastjson.JSON;
import com.alibaba.fastjson.JSONObject;
/*
* 通用 import 内容等暂略
*/
public static void main(String[] args) {
String url = "https://restwia.amap.com/api/v1/wia/resource/list";
Map<String, Object> params = new HashMap<>();
String workMapId = "要操作的workMapId";
String openId = "当前操作用户的openId";
params.put("key","在高德开放平台申请的key");
params.put("workMapId",workMapId);
params.put("openId",openId);
params.put("bizToken","在高德开放平台申请的bizToken");
String[] signArgs = new String[]{workMapId,openId};
params.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret",signArgs));
url = MyHttpUtils.attachParamsToUrl(url, params);
ResoureListRequest request = new ResoureListRequest();
Integer[] resourceTypes = new Integer[]{1};
request.setResourceTypes(resourceTypes);
request.setPageNumber(1);
request.setPageSize(20);
String jsonData = JSONObject.toJSONString(request);
String response = MyHttpUtils.postApplicationJson(url,jsonData);
System.out.println(response);
}
@Data
public
class ResoureListRequest {
private Integer[] resourceTypes;
private PointInfoRequest poiInfo;
private Integer sortType;
private Integer distance;
private String[] creatorOpenIdList;
private String[] principalIds;
private Integer[] categoryIds;
private Integer pageNumber;
private Integer pageSize;
}
返回参数
响应结果的格式为 JSON 形式。
以下是返回参数说明: