出租车发票识别
调试
您可以在API Explorer中调试该接口。
URI
POST https://{endpoint}/v2/{project_id}/ocr/taxi-invoice
请求参数
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
X-Auth-Token |
是 |
String |
用户Token。 Token认证就是在调用API的时候将Token加到请求消息头，从而通过身份认证，获得操作API的权限，响应消息头中X-Subject-Token的值即为Token。 |
参数 |
是否必选 |
参数类型 |
说明 |
|---|---|---|---|
image |
否，该参数与url二选一 |
String |
图像数据，base64编码，要求base64编码后大小不超过10MB。 图片最小边不小于15px，最长边不超过4096px，支持JPEG、JPG、PNG、BMP、TIFF格式。 |
url |
否，该参数与image二选一 |
String |
图片的url路径，目前支持：
说明：
|
响应参数
状态码： 200
参数 |
参数类型 |
描述 |
|---|---|---|
result |
TaxiInvoiceResultBody object |
调用成功时表示调用结果。 调用失败时无此字段。 |
参数 |
参数类型 |
描述 |
|---|---|---|
location |
String |
归属地区。 |
code |
String |
发票代码。 |
number |
String |
发票号码。 |
phone_number |
String |
电话（包括电话、监督电话）。 |
company |
String |
单位。 |
taxi_number |
String |
车号。 |
certificate_number |
String |
证号。 |
identification_number |
String |
识别编号。 |
date |
String |
开票日期。 |
boarding_time |
String |
上车时间。 |
alighting_time |
String |
下车时间。 |
time |
String |
时间(起止时间、上下车时间)。 |
unit_price |
String |
单价。 |
distance |
String |
总里程。 |
waiting_time |
String |
等候时间。 |
fare |
String |
金额。 |
fuel_oil_surcharge |
String |
燃油附加费。 |
call_service_surcharge |
String |
电调费（预约费）。 |
total |
String |
实收金额。 |
confidence |
Object |
相关字段的置信度信息，置信度越大，表示本次识别的对应字段的可靠性越高，在统计意义上，置信度越大，准确率越高。 置信度由算法给出，不直接等价于对应字段的准确率。 |
状态码： 400
参数 |
参数类型 |
说明 |
|---|---|---|
error_code |
String |
调用失败时的错误码，具体请参见错误码。 当出现错误码“ModelArts.4204”时，请参考为什么调用API时提示“ModelArts.4204”？章节。 调用成功时无此字段。 |
error_msg |
String |
调用失败时的错误信息。 调用成功时无此字段。 |
请求示例
- 请求示例（方式一：使用图片的base64编码）
POST https://{endpoint}/v2/{project_id}/ocr/taxi-invoice Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "image":"/9j/4AAQSkZJRgABAgEASABIAAD/4RFZRXhpZgAATU0AKgAAAA..." } - 请求示例（方式二：使用图片URL）
POST https://{endpoint}/v2/{project_id}/ocr/taxi-invoice Request Header: Content-Type: application/json X-Auth-Token: MIINRwYJKoZIhvcNAQcCoIINODCCDTQCAQExDTALBglghkgBZQMEAgEwgguVBgkqhkiG... Request Body: { "url":"https://BucketName.obs.xxxx.com/ObjectName" } - Python语言请求代码示例（其他语言参照下列示例编写或使用OCR SDK）
# encoding:utf-8 import requests import base64 url = "https://{endpoint}/v2/{project_id}/ocr/taxi-invoice" token = "用户获取得到的实际token值" headers = {'Content-Type': 'application/json', 'X-Auth-Token': token} imagepath = r'./data/taxi-invoice-demo.png' with open(imagepath, "rb") as bin_data: image_data = bin_data.read() image_base64 = base64.b64encode(image_data).decode("utf-8") # 使用图片的base64编码 payload = {"image": image_base64} # url与image参数二选一 response = requests.post(url, headers=headers, json=payload) print(response.text)
响应示例
状态码：200
成功响应示例
{
"result": {
"location": "上海市",
"code": "130XXXXXXXX88",
"number": "00XXXX08",
"phone_number": "62XXX22",
"company": "",
"taxi_number": "GXXXXXX",
"certificate_number": "3XXXX9",
"identification_number": "",
"date": "2019-03-15",
"boarding_time": "12:03",
"alighting_time": "12:15",
"time": "12:03-12:15",
"unit_price": "￥2.50",
"distance": "7.8",
"waiting_time": "00:02:09",
"fare": "￥29.00",
"fuel_oil_surcharge": "￥0.00",
"call_service_surcharge": "￥0.00",
"total": "￥29.00",
"confidence": {
"location": 0.9977,
"code": 0.9998,
"number": 0.9976,
"phone_number": 0.859,
"company": 0,
"taxi_number": 0.9607,
"certificate_number": 0.9411,
"identification_number": 0,
"date": 0.9665,
"boarding_time": 0.9847,
"alighting_time": 0.9798,
"time": 0.9798,
"unit_price": 0.9174,
"distance": 0.9731,
"waiting_time": 0.9936,
"fare": 0.9896,
"fuel_oil_surcharge": 0.8433,
"call_service_surcharge": 0.7843,
"total": 0.9896
}
}
}
状态码：400
失败响应示例
{
"error_code": "AIS.0103",
"error_msg": "The image size does not meet the requirements."
}
错误码
错误码请参见错误码。
