Java SDK

您可以通过直接添加Maven依赖方式安装城市视觉智能引擎的Java SDK。同时您必须安装Alibaba Cloud SDK for Java核心库。

在线调试和生成SDK示例

OpenAPI Explorer提供在线调用城市视觉智能引擎API、动态生成 SDK示例代码和快速检索接口等功能，能显著降低使用API 的难度，推荐您使用。

前提条件

• 使用城市视觉智能引擎的Java SDK，您需要一个阿里云账号和访问密钥（AccessKey）。 请在阿里云控制台中的AccessKey管理页面上创建和查看您的AccessKey，或联系您的系统管理员。
• 调用城市视觉智能引擎的API前，确保您已经在阿里云控制台开通了该产品。
• 安装Java环境。城市视觉智能引擎的Java SDK要求使用JDK1.6或更高版本。

安装城市视觉智能引擎 Java SDK

如果您使用Maven管理Java项目，可以通过在pom.xml文件中添加Maven依赖安装城市视觉智能引擎Java SDK。

<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-core</artifactId>
    <version>[4.4.2,5.0.0)</version>
</dependency>
<dependency>
    <groupId>com.aliyun</groupId>
    <artifactId>aliyun-java-sdk-cityvisual</artifactId>
    <version>1.0.0</version>
</dependency>
<dependency>
    <groupId>com.google.code.gson</groupId>
    <artifactId>gson</artifactId>
    <version>2.8.5</version>
</dependency>

使用城市视觉智能引擎 Java SDK

以下代码示例展示了调用城市视觉智能引擎 Java SDK的三个主要步骤：

1. 创建DefaultAcsClient实例并初始化。
2. 创建API请求并设置参数。
3. 发起请求并处理应答或异常。

本示例介绍如何使用调用城市视觉智能引擎 Java SDK调用DescribeInstances接口获取已创建的实例。

import com.aliyuncs.DefaultAcsClient;
import com.aliyuncs.IAcsClient;
import com.aliyuncs.cityvisual.model.v20181030.DescribeInstancesRequest;
import com.aliyuncs.cityvisual.model.v20181030.DescribeInstancesResponse;
import com.aliyuncs.exceptions.ClientException;
import com.aliyuncs.exceptions.ServerException;
import com.aliyuncs.profile.DefaultProfile;
import java.util.UUID;
public class Demo {
    public static void main(String[] args) {
        // 创建DefaultAcsClient实例并初始化
        DefaultProfile profile = DefaultProfile.getProfile(
            "yourRegionId",                     // 您的地域ID
            "yourAccessKeyId",             // 您的AccessKey ID
            "yourAccessKeySecret");        // 您的AccessKey Secret
        IAcsClient client = new DefaultAcsClient(profile);
        // 创建API请求并设置参数
        DescribeInstanceseRequest request = new DescribeInstancesRequest();
        request.setRegionId("cn-shanghai");
        request.setPageSize(10);
        // 发起请求并处理应答或异常
        DescribeInstancesResponse response;
        try {
            response = client.getAcsResponse(request);
            for (DescribeInstancesResponse.Instance instance:response.getInstances()) {
                System.out.println(instance.getInstanceId());
            }
        } catch (ServerException e) {
            e.printStackTrace();
        } catch (ClientException e) {
            e.printStackTrace();
        }
    }
}