本文介紹文字識別（ocr）類目下的出租車發(fā)票識別RecognizeTaxiInvoice的語法及示例。
功能描述
出租車發(fā)票識別能力可以準確識別出全國各大城市出租車發(fā)票在圖像中的位置，支持出租車發(fā)票結構化識別，輸出發(fā)票號碼、代碼、車號、日期、時間、金額，共6個關鍵字段信息。
接入指引
- 注冊阿里云賬號：打開阿里云官網，在阿里云官網右上角，單擊立即注冊，按照操作提示完成賬號注冊。
- 開通能力：請確保您已開通文字識別服務，若未開通服務請立即開通。
- 創(chuàng)建AccessKey：請確保您已創(chuàng)建AccessKey，如果您使用的是子賬號AccessKey，您需要給子賬號賦予AliyunVIAPIFullAccess權限，具體操作，請參見RAM授權。
- 在線調試（可選）：您可以通過OpenAPI Explorer在線調試能力，查看完整的調用示例代碼及SDK依賴信息，也可以下載完整的工程。
-
開發(fā)接入步驟：
- 在SDK總覽中選擇您要接入使用的SDK語言。
- 在對應語言的SDK文檔中找到AI類目為文字識別（ocr）的SDK包進行安裝。
- 參考文檔中提供的示例代碼進行適當修改后調用。
-
客戶端直接調用：該能力常用的客戶端調用方式包括以下幾種。
輸入限制
- 圖像格式：JPEG、JPG、PNG、BMP、GIF。
- 圖像大小：不超過3 MB。
- 圖像分辨率：不限制圖片分辨率，但圖片分辨率太高可能會導致API識別超時，超時時間為5秒。
- URL地址中不能包含中文字符。
計費說明
關于出租車發(fā)票識別的計費方式及報價，請參見計費介紹。
說明
下方調試接口為付費接口，如需免費體驗調試請前往體驗中心。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
請求參數
|
名稱 |
類型 |
是否必選 |
示例值 |
描述 |
| Action | String | 是 | RecognizeTaxiInvoice | 系統規(guī)定參數。取值：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 | 發(fā)票列表詳細信息。 |
|
| Items | Array of Item | 每張發(fā)票的文字列表。 |
|
| ItemRoi | Object | 發(fā)票每個字段對應位置信息。 |
|
| 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 | 發(fā)票每個字段信息。 |
| RotateType | Integer | 0 | 發(fā)票旋轉角度。
|
| InvoiceRoi | Object | 發(fā)票位置。 |
|
| W | Float | 1773 | 發(fā)票寬度。 |
| H | Float | 3625 | 發(fā)票高度。 |
| Y | Float | 302 | 發(fā)票左上角Y坐標。 |
| X | Float | 513 | 發(fā)票左上角X坐標。 |
SDK參考
阿里云視覺AI文字識別類目下的出租車發(fā)票識別能力推薦使用SDK調用，支持多種編程語言，調用時請選擇AI類目為文字識別（ocr）的SDK包，文件參數通過SDK調用可支持本地文件及任意URL，具體可參見SDK總覽。
示例
請求示例
http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeTaxiInvoice //更多關于訪問域名（Endpoint）信息，請參見：http://bestwisewords.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" : "**"
} ]
} ]
}
}錯誤碼
關于出租車發(fā)票識別的錯誤碼，詳情請參見常見錯誤碼。
安全聲明
- 請確保上傳的圖片或文件來源符合相應的法律法規(guī)。
- 通過體驗調試上傳的臨時文件有效期為1小時，在24小時后會被系統自動清理刪除。
文檔內容是否對您有幫助？