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

功能描述

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

前提条件

请确保您已开通文字识别服务,详情请参见服务开通

图片限制

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

调试

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

请求参数

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

要执行的操作。取值:RecognizeTaxiInvoice。

ImageURL String https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecognizeTaxiInvoice/TaxiInvoice.jpg

图片URL地址。当前仅支持上海地域的OSS链接,如何生成URL请参见生成URL

返回数据

名称 类型 示例值 描述
Data Struct

返回的数据内容。

Invoices Array

发票列表详细信息。

InvoiceRoi Struct

发票位置。

H Float 3625

发票高度。

W Float 1773

发票宽度。

X Float 513

发票左上角x坐标。

Y Float 302

发票左上角y坐标。

Items Array

每张发票的文字列表。

ItemRoi Struct

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

Angle Float -90

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

Center Struct

位置框中心点。

X Float 1593

位置框中心点x坐标。

Y Float 1360

位置框中心点y坐标。

Size Struct

位置框长宽。

H Float 81.999984741210938

位置框高度。

W Float 887.9998779296875

位置框宽度。

Text String 86655664

发票每个字段信息。

RotateType Integer 0

发票旋转角度。

  • 0:不需要旋转。
  • 1:顺时针旋转90。
  • 2:顺时针旋转180。
  • 3:顺时针旋转270。
RequestId String B2BBBD26-1D3E-4CFA-A80B-6A9266B8D125

请求ID。

示例

请求示例

http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeTaxiInvoice
&ImageURL=https://viapi-demo.oss-cn-shanghai.aliyuncs.com/viapi-demo/images/RecognizeTaxiInvoice/TaxiInvoice.jpg
&<公共请求参数>

正常返回示例

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 格式

{
  "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.999984741210938
              }
            },
            "Text": "013560325483"
          },
          {
            "ItemRoi": {
              "Center": {
                "X": 1744,
                "Y": 1507.5
              },
              "Angle": 0,
              "Size": {
                "W": 585.9998779296875,
                "H": 80.999984741210938
              }
            },
            "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.999984741210938,
                "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.999984741210938
              }
            },
            "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.999984741210938
              }
            },
            "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": "**"
          }
        ]
      }
    ]
  }
}

错误码

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

SDK参考

单击SDK简介查看SDK信息。