本文介绍文字识别（ocr）类目下的出租车发票识别RecognizeTaxiInvoice的语法及示例。
功能描述
出租车发票识别能力可以准确识别出全国各大城市出租车发票在图像中的位置，支持出租车发票结构化识别，输出发票号码、代码、车号、日期、时间、金额，共6个关键字段信息。
接入指引
- 注册阿里云账号：打开阿里云官网，在阿里云官网右上角，单击立即注册，按照操作提示完成账号注册。
- 开通能力：请确保您已开通文字识别服务，若未开通服务请立即开通。
- 创建AccessKey：请确保您已创建AccessKey，如果您使用的是子账号AccessKey，您需要给子账号赋予AliyunVIAPIFullAccess权限，具体操作，请参见RAM授权。
- 在线调试（可选）：您可以通过OpenAPI Explorer在线调试能力，查看完整的调用示例代码及SDK依赖信息，也可以下载完整的工程。
-
开发接入步骤：
- 在SDK总览中选择您要接入使用的SDK语言。
- 在对应语言的SDK文档中找到AI类目为文字识别（ocr）的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 | 发票旋转角度。
|
| InvoiceRoi | Object | 发票位置。 |
|
| W | Float | 1773 | 发票宽度。 |
| H | Float | 3625 | 发票高度。 |
| Y | Float | 302 | 发票左上角Y坐标。 |
| X | Float | 513 | 发票左上角X坐标。 |
SDK参考
阿里云视觉AI文字识别类目下的出租车发票识别能力推荐使用SDK调用，支持多种编程语言，调用时请选择AI类目为文字识别（ocr）的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小时后会被系统自动清理删除。
文档内容是否对您有帮助？