本文介绍门头照识别RecognizePoiName的语法及示例。

功能描述

门头照识别能力可以识别门头招牌的图像,并且过滤出门头信息,例如门头照、Logo、店铺地址、联系方式等。

您可以在体验中心进行体验与试用。

说明 阿里云视觉智能开放平台视觉AI能力API接入、接口使用或问题咨询等,请通过钉钉群(23109592)加入阿里云视觉智能开放平台咨询群联系我们。

应用场景

  • 外卖取货送达认证:外卖骑手在到店取货、送达外卖时拍摄并上传门头照片,通过门头照识别验证真实性。
  • 巡店拜访:零售业经销商代表在拜访终端门店过程中,拍摄门店门头照片,结合位置信息,核验拜访的真实性。
  • 店铺信息录入:通过拍摄门头照片,识别店铺信息,快速创建客户信息库。

特点优势:

  • 更高的识别准确率:基于文字识别技术的门头照文字识别,和图片检索技术的多模型门头招牌图片识别,可提高识别的准确率。
  • 实际场景验证:在全国范围的实际使用。算法模型经历了长时间的数据积累和迭代,每天支持海量的实际业务场景的识别。
  • 涵盖大部分线下餐饮商户以及部分非餐饮类门店。

接入指引

1. 注册阿里云账号:打开阿里云官网,在阿里云官网右上角,单击立即注册,按照操作提示完成账号注册。

2. 开通能力:请确保您已开通文字识别服务,若未开通服务请立即开通

3. 创建AccessKey:请确保您已创建AccessKey,如果您使用的是子账号AccessKey,您需要给子账号赋予AliyunVIAPIFullAccess权限,具体操作,请参见RAM授权

4. 在线调试(可选):您可以通过OpenAPI Explorer在线调试能力,查看完整的调用示例代码及SDK依赖信息,也可以下载完整的工程。

5. 开发接入:能力支持SDK方式调用,您可以选择合适的开发语言进行接入,具体操作,请参见SDK总览

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP。
  • 图像大小:不超过10 MB。
  • 图像分辨率:大于15×15像素,小于4096×4096像素。
  • 图像要求无遮挡、无明显反光、曝光、阴影,在拍摄门头照时,请尽量以正对角度拍摄。
  • URL地址中不能包含中文字符。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String RecognizePoiName

系统规定参数。取值:RecognizePoiName

ImageURL String https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/October/RecognizePoiName9.jpeg

图片URL地址。推荐使用上海地域的OSS链接,对于文件在本地或者非上海地域OSS链接的情况,请参见文件URL处理

返回数据

名称 类型 示例值 描述
RequestId String 76D4FAB5-4BFE-5A4F-B2EC-9DB2155F1AF7

请求ID。

Data Object

返回的结果数据内容。

Summary Object

主题招牌名。

Brand String 煌上煌酱鸭

品牌名。

Score Float 0.9765625

置信度。

Signboards Array of Signboards

招牌区域。

Texts Array of Texts

文字信息。

Type String text

类别。枚举取值如下:

  • text:属于文字文本。
  • logo:属于图标或其他。
Score Float 0.9994

置信度。

Tag String name

属性标签。枚举取值如下:

  • name:招牌名称。
  • address:店铺地址。
  • phone:联系方式。
  • other:其他信息。
Label String 煌烤鸭

识别出招牌文字的具体内容。

Points Array of Integer [524,350,658,370,650,422,517,401]

文字区域按顺时针方向四个点坐标[x1,y1,x2,y2,x3,y3,x4,y4]

SDK参考

阿里云视觉AI能力推荐使用SDK调用,支持多种编程语言,文件参数通过SDK调用可支持本地文件及任意URL,具体可参见SDK总览

示例

请求示例

http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizePoiName      //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&ImageURL=https://viapi-test.oss-cn-shanghai.aliyuncs.com/test-team/xuhan/October/RecognizePoiName9.jpeg
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<RecognizePoiNameResponse>
    <RequestId>76D4FAB5-4BFE-5A4F-B2EC-9DB2155F1AF7</RequestId>
    <Data>
        <Signboards>
            <Texts>
                <Score>0.9083</Score>
                <Type>text</Type>
                <Points>413</Points>
                <Points>452</Points>
                <Points>491</Points>
                <Points>452</Points>
                <Points>491</Points>
                <Points>471</Points>
                <Points>413</Points>
                <Points>471</Points>
                <Label>煌烤鸭</Label>
                <Tag>name</Tag>
            </Texts>
            <Texts>
                <Score>0.7716</Score>
                <Type>text</Type>
                <Points>911</Points>
                <Points>460</Points>
                <Points>946</Points>
                <Points>460</Points>
                <Points>946</Points>
                <Points>472</Points>
                <Points>911</Points>
                <Points>472</Points>
                <Label>容大杜号</Label>
                <Tag>other</Tag>
            </Texts>
            <Texts>
                <Score>0.4564</Score>
                <Type>text</Type>
                <Points>227</Points>
                <Points>448</Points>
                <Points>237</Points>
                <Points>448</Points>
                <Points>237</Points>
                <Points>485</Points>
                <Points>227</Points>
                <Points>485</Points>
                <Label>肚品</Label>
                <Tag>other</Tag>
            </Texts>
            <Texts>
                <Score>0.469</Score>
                <Type>text</Type>
                <Points>320</Points>
                <Points>451</Points>
                <Points>353</Points>
                <Points>451</Points>
                <Points>353</Points>
                <Points>478</Points>
                <Points>320</Points>
                <Points>478</Points>
                <Label>家</Label>
                <Tag>name</Tag>
            </Texts>
            <Texts>
                <Score>0.9765625</Score>
                <Type>text</Type>
                <Points>132</Points>
                <Points>63</Points>
                <Points>810</Points>
                <Points>63</Points>
                <Points>810</Points>
                <Points>200</Points>
                <Points>132</Points>
                <Points>200</Points>
                <Label>煌上煌酱鸭</Label>
                <Tag>name</Tag>
            </Texts>
        </Signboards>
        <Summary>
            <Brand>煌上煌酱鸭</Brand>
            <Score>0.9765625</Score>
        </Summary>
    </Data>
</RecognizePoiNameResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "76D4FAB5-4BFE-5A4F-B2EC-9DB2155F1AF7",
  "Data" : {
    "Signboards" : {
      "Texts" : [ {
        "Score" : 0.9083,
        "Type" : "text",
        "Points" : [ 413, 452, 491, 452, 491, 471, 413, 471 ],
        "Label" : "煌烤鸭",
        "Tag" : "name"
      }, {
        "Score" : 0.7716,
        "Type" : "text",
        "Points" : [ 911, 460, 946, 460, 946, 472, 911, 472 ],
        "Label" : "容大杜号",
        "Tag" : "other"
      }, {
        "Score" : 0.4564,
        "Type" : "text",
        "Points" : [ 227, 448, 237, 448, 237, 485, 227, 485 ],
        "Label" : "肚品",
        "Tag" : "other"
      }, {
        "Score" : 0.469,
        "Type" : "text",
        "Points" : [ 320, 451, 353, 451, 353, 478, 320, 478 ],
        "Label" : "家",
        "Tag" : "name"
      }, {
        "Score" : 0.9765625,
        "Type" : "text",
        "Points" : [ 132, 63, 810, 63, 810, 200, 132, 200 ],
        "Label" : "煌上煌酱鸭",
        "Tag" : "name"
      } ]
    },
    "Summary" : {
      "Brand" : "煌上煌酱鸭",
      "Score" : 0.9765625
    }
  }
}

错误码

关于门头照识别的错误码,详情请参见常见错误码

安全声明

  • 请确保上传的图片或文件来源符合相应的法律法规。
  • 通过体验调试上传的临时文件有效期为1小时,在24小时后会被系统自动清理删除。