本文介绍出租车发票识别RecognizeTaxiInvoice的语法及示例。

功能描述

出租车发票识别能力可以准确识别出全国各大城市出租车发票在图像中的位置,支持出租车发票结构化识别,输出发票号码、代码、车号、日期、时间、金额,共6个关键字段信息。

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

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

接入指引

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

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

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

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

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

输入限制

  • 图像格式:JPEG、JPG、PNG、BMP、GIF。
  • 图像大小:不超过3 MB。
  • 图像分辨率:不限制图片分辨率,但图片分辨率太高可能会导致API识别超时,超时时间为5秒。
  • URL地址中不能包含中文字符。

调试

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

请求参数

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

系统规定参数。取值:RecognizeTaxiInvoice

ImageURL String http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeTaxiInvoice/RecognizeTaxiInvoice2.jpg

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

返回数据

名称 类型 示例值 描述
RequestId String B2BBBD26-1D3E-4CFA-A80B-6A9266B8D125

请求ID。

Data Object

返回的数据内容。

Invoices Array of Invoice

发票列表详细信息。

Items Array of Item

每张发票的文字列表。

ItemRoi Object

发票每个字段对应位置信息。

Size Object

位置框长宽。

W Float 887.9998779296875

位置框宽度。

H Float 81.999984741210938

位置框高度。

Angle Float -90

角度信息。坐标的原点在左上角,与X轴平行的方向角度为0。逆时针旋转角度为负,顺时针旋转角度为正。角度是水平轴(X轴)顺时针旋转,与碰到的第一个边的夹角度数。角度范围-180°~180°。

Center Object

位置框中心点。

Y Float 1360

位置框中心点Y坐标。

X Float 1593

位置框中心点X坐标。

Text String 86655664

发票每个字段信息。

RotateType Integer 0

发票旋转角度。

  • 0:不需要旋转。
  • 1:顺时针旋转90。
  • 2:顺时针旋转180。
  • 3:顺时针旋转270。
InvoiceRoi Object

发票位置。

W Float 1773

发票宽度。

H Float 3625

发票高度。

Y Float 302

发票左上角Y坐标。

X Float 513

发票左上角X坐标。

SDK参考

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

示例

请求示例

http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeTaxiInvoice      //更多关于访问域名(Endpoint)信息,请参见:https://help.aliyun.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeTaxiInvoice/RecognizeTaxiInvoice2.jpg
&<公共请求参数>

正常返回示例

XML格式

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

<RequestId>B2BBBD26-1D3E-4CFA-A80B-6A9266B8D125</RequestId>
<Data>
    <Invoices>
        <RotateType>0</RotateType>
        <InvoiceRoi>
            <W>1773</W>
            <H>3625</H>
            <X>513</X>
            <Y>302</Y>
        </InvoiceRoi>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1436</X>
                    <Y>968.5</Y>
                </Center>
                <Angle>-90</Angle>
                <Size>
                    <W>89</W>
                    <H>1110</H>
                </Size>
            </ItemRoi>
            <Text>132011781210</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1246.5</X>
                    <Y>1239</Y>
                </Center>
                <Angle>-90</Angle>
                <Size>
                    <W>92</W>
                    <H>743</H>
                </Size>
            </ItemRoi>
            <Text>13742573</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1593</X>
                    <Y>1360</Y>
                </Center>
                <Angle>0</Angle>
                <Size>
                    <W>887.9998779296875</W>
                    <H>81.99998474121094</H>
                </Size>
            </ItemRoi>
            <Text>013560325483</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1744</X>
                    <Y>1507.5</Y>
                </Center>
                <Angle>0</Angle>
                <Size>
                    <W>585.9998779296875</W>
                    <H>80.99998474121094</H>
                </Size>
            </ItemRoi>
            <Text>86655664</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1778</X>
                    <Y>1668</Y>
                </Center>
                <Angle>-90</Angle>
                <Size>
                    <W>80</W>
                    <H>524</H>
                </Size>
            </ItemRoi>
            <Text>A-B6167</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1629.5</X>
                    <Y>1840</Y>
                </Center>
                <Angle>-90</Angle>
                <Size>
                    <W>81.99998474121094</W>
                    <H>828.9998779296875</H>
                </Size>
            </ItemRoi>
            <Text>2018年02月28日</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1864</X>
                    <Y>2009.5</Y>
                </Center>
                <Angle>-90</Angle>
                <Size>
                    <W>91</W>
                    <H>390</H>
                </Size>
            </ItemRoi>
            <Text>22:24</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1862</X>
                    <Y>2180</Y>
                </Center>
                <Angle>-90</Angle>
                <Size>
                    <W>96</W>
                    <H>384</H>
                </Size>
            </ItemRoi>
            <Text>22:57</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1730</X>
                    <Y>2348</Y>
                </Center>
                <Angle>-90</Angle>
                <Size>
                    <W>96</W>
                    <H>608</H>
                </Size>
            </ItemRoi>
            <Text>3.60元/公里</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1813</X>
                    <Y>2530</Y>
                </Center>
                <Angle>-90</Angle>
                <Size>
                    <W>92</W>
                    <H>466</H>
                </Size>
            </ItemRoi>
            <Text>40.9公里</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1741</X>
                    <Y>2697</Y>
                </Center>
                <Angle>0</Angle>
                <Size>
                    <W>613.9998779296875</W>
                    <H>91.99998474121094</H>
                </Size>
            </ItemRoi>
            <Text>00:04.03</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1785.5</X>
                    <Y>2868.5</Y>
                </Center>
                <Angle>-90</Angle>
                <Size>
                    <W>91</W>
                    <H>519</H>
                </Size>
            </ItemRoi>
            <Text>129.00元</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1850.5</X>
                    <Y>3026</Y>
                </Center>
                <Angle>0</Angle>
                <Size>
                    <W>400.99993896484375</W>
                    <H>105.99998474121094</H>
                </Size>
            </ItemRoi>
            <Text>0.00元</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1848.5</X>
                    <Y>3187</Y>
                </Center>
                <Angle>0</Angle>
                <Size>
                    <W>396.99993896484375</W>
                    <H>99.99998474121094</H>
                </Size>
            </ItemRoi>
            <Text>0.00元</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1953</X>
                    <Y>3368</Y>
                </Center>
                <Angle>0</Angle>
                <Size>
                    <W>166</W>
                    <H>78</H>
                </Size>
            </ItemRoi>
            <Text>**</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1954</X>
                    <Y>3539</Y>
                </Center>
                <Angle>0</Angle>
                <Size>
                    <W>160</W>
                    <H>72</H>
                </Size>
            </ItemRoi>
            <Text>**</Text>
        </Items>
        <Items>
            <ItemRoi>
                <Center>
                    <X>1945</X>
                    <Y>3704.5</Y>
                </Center>
                <Angle>0</Angle>
                <Size>
                    <W>158</W>
                    <H>71</H>
                </Size>
            </ItemRoi>
            <Text>**</Text>
        </Items>
    </Invoices>
</Data>

JSON格式

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

{
  "RequestId" : "B2BBBD26-1D3E-4CFA-A80B-6A9266B8D125",
  "Data" : {
    "Invoices" : [ {
      "RotateType" : 0,
      "InvoiceRoi" : {
        "W" : 1773,
        "H" : 3625,
        "X" : 513,
        "Y" : 302
      },
      "Items" : [ {
        "ItemRoi" : {
          "Center" : {
            "X" : 1436,
            "Y" : 968.5
          },
          "Angle" : -90,
          "Size" : {
            "W" : 89,
            "H" : 1110
          }
        },
        "Text" : "132011781210"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1246.5,
            "Y" : 1239
          },
          "Angle" : -90,
          "Size" : {
            "W" : 92,
            "H" : 743
          }
        },
        "Text" : "13742573"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1593,
            "Y" : 1360
          },
          "Angle" : 0,
          "Size" : {
            "W" : 887.9998779296875,
            "H" : 81.99998474121094
          }
        },
        "Text" : "013560325483"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1744,
            "Y" : 1507.5
          },
          "Angle" : 0,
          "Size" : {
            "W" : 585.9998779296875,
            "H" : 80.99998474121094
          }
        },
        "Text" : "86655664"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1778,
            "Y" : 1668
          },
          "Angle" : -90,
          "Size" : {
            "W" : 80,
            "H" : 524
          }
        },
        "Text" : "A-B6167"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1629.5,
            "Y" : 1840
          },
          "Angle" : -90,
          "Size" : {
            "W" : 81.99998474121094,
            "H" : 828.9998779296875
          }
        },
        "Text" : "2018年02月28日"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1864,
            "Y" : 2009.5
          },
          "Angle" : -90,
          "Size" : {
            "W" : 91,
            "H" : 390
          }
        },
        "Text" : "22:24"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1862,
            "Y" : 2180
          },
          "Angle" : -90,
          "Size" : {
            "W" : 96,
            "H" : 384
          }
        },
        "Text" : "22:57"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1730,
            "Y" : 2348
          },
          "Angle" : -90,
          "Size" : {
            "W" : 96,
            "H" : 608
          }
        },
        "Text" : "3.60元/公里"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1813,
            "Y" : 2530
          },
          "Angle" : -90,
          "Size" : {
            "W" : 92,
            "H" : 466
          }
        },
        "Text" : "40.9公里"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1741,
            "Y" : 2697
          },
          "Angle" : 0,
          "Size" : {
            "W" : 613.9998779296875,
            "H" : 91.99998474121094
          }
        },
        "Text" : "00:04.03"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1785.5,
            "Y" : 2868.5
          },
          "Angle" : -90,
          "Size" : {
            "W" : 91,
            "H" : 519
          }
        },
        "Text" : "129.00元"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1850.5,
            "Y" : 3026
          },
          "Angle" : 0,
          "Size" : {
            "W" : 400.99993896484375,
            "H" : 105.99998474121094
          }
        },
        "Text" : "0.00元"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1848.5,
            "Y" : 3187
          },
          "Angle" : 0,
          "Size" : {
            "W" : 396.99993896484375,
            "H" : 99.99998474121094
          }
        },
        "Text" : "0.00元"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1953,
            "Y" : 3368
          },
          "Angle" : 0,
          "Size" : {
            "W" : 166,
            "H" : 78
          }
        },
        "Text" : "**"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1954,
            "Y" : 3539
          },
          "Angle" : 0,
          "Size" : {
            "W" : 160,
            "H" : 72
          }
        },
        "Text" : "**"
      }, {
        "ItemRoi" : {
          "Center" : {
            "X" : 1945,
            "Y" : 3704.5
          },
          "Angle" : 0,
          "Size" : {
            "W" : 158,
            "H" : 71
          }
        },
        "Text" : "**"
      } ]
    } ]
  }
}

错误码

关于出租车发票识别的错误码,详情请参见常见错误码

安全声明

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