文档首页 > > 快速入门>

如何使用SDK调用华为云OCR服务

如何使用SDK调用华为云OCR服务

分享
更新时间:2021/07/23 GMT+08:00

文字识别服务软件开发工具包(OCR SDK)是对文字识别服务提供的REST API进行的封装,以简化用户的开发工作。OCR SDK目前支持Java、Python、iOS、Android、Node.js、PHP、C++和C#。

本章节提供了通过Java SDK调用身份证识别服务的样例,用户直接调用接口函数即可使用SDK功能。

使用OCR SDK的详细步骤如下所示:

步骤1:开通服务

步骤2:配置环境

步骤3:修改配置信息

步骤4:调用服务

准备工作

已注册华为云帐号,并完成实名认证,帐号不能处于欠费或冻结状态。

步骤1:开通服务

  1. 登录华为云文字识别服务管理控制台。

    控制台左上角默认显示服务部署在“华北-北京四”区域,请您根据业务需要选择对应区域,各服务部署的区域具体请参见终端节点

  2. 选择需要使用的API,进行开通。

    本示例中需开通身份证识别API。

    如未开通服务,调用服务时会提示ModelArts.4204报错,请在调用服务前先进入控制台开通服务,并注意开通服务区域与调用服务的区域保持一致。

步骤2:配置环境

  1. 下载OCR Java SDK开发工具包
  2. 准备Java开发环境。

    详细的环境配置过程请参见Java开发环境配置

  3. 导入OCR Java SDK工程。
    1. 打开Eclipse,确保“Window>Preferences>Java>Installed JREs”配置正确的JRE路径。
    2. 在左侧“Package Explorer”页面单击右键,单击“Import”,选择“General>Existing Projects into Workspace”,选择OCR SDK Demo包所在路径。
    3. 单击“Finish”,导入Demo。
      图1 OCR Java SDK Demo

      OCR SDK中服务所属区域为“华北-北京四”,如果您在开通服务时,选择了其他区域,在执行步骤3时请将配置文件中的所有“cn-north-4”字段替换为实际区域,服务部署的区域具体请参见终端节点

步骤3:修改配置信息

Java SDK Demo中认证鉴权方式可选AK/SK认证或者Token认证,本示例中使用AK/SK认证。

  1. 获取AK/SK。

    AK/SK即访问秘钥,请登录“我的凭证”界面,选择“管理访问密钥 > 新增访问密钥”获取。

  2. AK/SK认证鉴权,配置Java SDK中的AK/SK。

    根据获取的AK/SK,修改Demo工程“OCRDemo.java”文件中函数的“AK”和“SK”的值。

    图2 配置AK/SK
  3. 修改Java SDK中OCRDemo.java配置文件。
    图3 OCRDemo.java文件
    表1 Main函数中参数说明

    参数名称

    参数说明

    参数值

    AK

    访问密钥ID(Access Key ID)

    登录“我的凭证”界面,选择“管理访问密钥 > 新增访问密钥”获取。

    SK

    秘密访问密钥(Secret Access Key)

    登录“我的凭证”界面,选择“管理访问密钥 > 新增访问密钥”获取。

    regionName

    服务所在区域

    cn-north-4

    httpUri

    统一资源标识符

    /v1.0/ocr/id-card

    imgPath

    图片文件路径

    ./data/id-card-demo.jpg

    sideKey

    可选参数

    side

    身份证识别API请求参数,可选以下值:

    • front:身份证人像面
    • back:身份证国徽面

    sideValue

    可选参数值

    front或back。

步骤4:调用服务

执行OCRDemo.java文件,输出状态码“200”即表示程序执行成功。身份证识别服务的返回结果为JSON格式,如下所示。

{
    "result": {
        "name": "xx", 
        "sex": "女", 
        "ethnicity": "满", 
        "birth": "1990-xx-xx", 
        "address": "河北省承德市围场满族蒙古族自治县金车路", 
        "number": "3892011990012xxxxx"
    }
}
分享:

    相关文档

    相关产品