本文介紹文字識別（ocr）類目下的車牌識別RecognizeLicensePlate的語法及示例。

功能描述

車牌識別能力可以準確識別出圖像中車牌位置，輸出車牌位置坐標、車牌類型、車牌號碼、車牌號碼置信度、車牌置信度，共5個關鍵字段信息。

說明
  • 您可以進入在線咨詢獲取在線人工幫助。
  • 當前能力可在視覺智能開放平臺有完整的免費產(chǎn)品體驗，您可以單擊立即試用對該能力進行更直觀試用以及在線購買。
  • 阿里云視覺智能開放平臺視覺AI能力API接入、接口使用或問題咨詢等，請通過釘釘群（23109592）加入阿里云視覺智能開放平臺咨詢?nèi)郝?lián)系我們。

接入指引

1. 注冊阿里云賬號：打開阿里云官網(wǎng)，在阿里云官網(wǎng)右上角，單擊立即注冊，按照操作提示完成賬號注冊。

2. 開通能力：請確保您已開通文字識別服務，若未開通服務請立即開通。

3. 創(chuàng)建AccessKey：請確保您已創(chuàng)建AccessKey，如果您使用的是子賬號AccessKey，您需要給子賬號賦予AliyunVIAPIFullAccess權限，具體操作，請參見RAM授權。

4. 在線調試（可選）：您可以通過OpenAPI Explorer在線調試能力，查看完整的調用示例代碼及SDK依賴信息，也可以下載完整的工程。

5. 開發(fā)接入步驟：

  • 在SDK總覽中選擇您要接入使用的SDK語言。
  • 在對應語言的SDK文檔中找到AI類目為文字識別（ocr）的SDK包進行安裝。
  • 參考文檔中提供的示例代碼進行適當修改后調用。

6. 示例代碼：該能力常用語言的示例代碼，請參見車牌識別示例代碼。

7. 客戶端直接調用：該能力常用的客戶端調用方式包括以下幾種。

輸入限制

  • 圖像格式：JPEG、JPG、PNG、BMP、GIF。
  • 圖像大小：不超過4 MB。
  • 圖像分辨率：大于15×15像素，小于4096×4096像素。
  • URL地址中不能包含中文字符。

計費說明

關于車牌識別的計費方式及報價，請參見計費介紹。

說明 下方調試接口為付費接口，如需免費體驗調試請前往體驗中心。

調試

您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。

請求參數(shù)

名稱 類型 是否必選 示例值 描述
Action String 是 RecognizeLicensePlate

系統(tǒng)規(guī)定參數(shù)。取值：RecognizeLicensePlate。
ImageURL String 是 http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeLicensePlate/cpsb1.jpg

車牌識別能力目前支持的地域（Region）有上海和深圳，當您開通服務時選擇的是上海地域，推薦使用上海地域的OSS鏈接，對于文件在本地或者非上海地域OSS鏈接的情況，請參見文件URL處理。當您開通服務時選擇的是深圳地域時，僅支持深圳地域OSS鏈接進行調用。

返回數(shù)據(jù)

名稱 類型 示例值 描述
RequestId String 3F10DAC3-CF4A-487C-BF33-3B8EB9AA12F2

請求ID。
Data Object

返回的結果數(shù)據(jù)內(nèi)容。
Plates Array of Plate

車牌面板詳細信息。
PlateTypeConfidence Float 1

車牌類型的置信度，取值范圍0~1。
PlateType String 小型汽車

車牌類型。包括：小型汽車、新能源車、大型汽車、掛車、教練車、警車、軍車、使領館車、港澳車。
Confidence Float 0.99745339155197144

車牌號碼的置信度，取值范圍0~1。
PlateNumber String 粵BP57E7

車牌號碼。
Roi Object

車牌位置。
W Integer 141

車牌號寬度。
H Integer 53

車牌號高度。
Y Integer 256

車牌號左上角y坐標。
X Integer 294

車牌號左上角x坐標。
Positions Array of positions

車牌識別框位置信息。識別矩形框四個角的坐標順時針排列，分別為左上XY坐標、右上XY坐標、右下XY坐標、左下XY坐標。
X Long 466

矩形框X坐標。
Y Long 293

矩形框Y坐標。

SDK參考

阿里云視覺AI文字識別類目下的車牌識別能力推薦使用SDK調用，支持多種編程語言，調用時請選擇AI類目為文字識別（ocr）的SDK包，文件參數(shù)通過SDK調用可支持本地文件及任意URL，具體可參見SDK總覽。

示例代碼

該能力常用語言的示例代碼，請參見車牌識別示例代碼。

示例

請求示例

http(s)://ocr.cn-shanghai.aliyuncs.com/?Action=RecognizeLicensePlate      //更多關于訪問域名（Endpoint）信息，請參見：http://bestwisewords.com/document_detail/143103.html
&ImageURL=http://viapi-test.oss-cn-shanghai.aliyuncs.com/viapi-3.0domepic/ocr/RecognizeLicensePlate/cpsb1.jpg
&<公共請求參數(shù)>

正常返回示例

XML格式

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

<RecognizeLicensePlateResponse>
    <RequestId>3F10DAC3-CF4A-487C-BF33-3B8EB9AA12F2</RequestId>
    <Data>
        <Plates>
            <PlateTypeConfidence>1</PlateTypeConfidence>
            <PlateType>小型汽車</PlateType>
            <Confidence>0.9974534</Confidence>
            <PlateNumber>粵BP57E7</PlateNumber>
            <Roi>
                <W>141</W>
                <H>53</H>
                <Y>256</Y>
                <X>294</X>
            </Roi>
            <Positions>
                <X>466</X>
                <Y>293</Y>
            </Positions>
            <Positions>
                <X>667</X>
                <Y>283</Y>
            </Positions>
            <Positions>
                <X>669</X>
                <Y>330</Y>
            </Positions>
            <Positions>
                <X>469</X>
                <Y>341</Y>
            </Positions>
        </Plates>
    </Data>
</RecognizeLicensePlateResponse>

JSON格式

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

{
  "RequestId" : "3F10DAC3-CF4A-487C-BF33-3B8EB9AA12F2",
  "Data" : {
    "Plates" : {
      "PlateTypeConfidence" : 1,
      "PlateType" : "小型汽車",
      "Confidence" : 0.9974534,
      "PlateNumber" : "粵BP57E7",
      "Roi" : {
        "W" : 141,
        "H" : 53,
        "Y" : 256,
        "X" : 294
      },
      "Positions" : [ {
        "X" : 466,
        "Y" : 293
      }, {
        "X" : 667,
        "Y" : 283
      }, {
        "X" : 669,
        "Y" : 330
      }, {
        "X" : 469,
        "Y" : 341
      } ]
    }
  }
}

錯誤碼

關于車牌識別的錯誤碼，詳情請參見常見錯誤碼。

安全聲明

  • 請確保上傳的圖片或文件來源符合相應的法律法規(guī)。
  • 通過體驗調試上傳的臨時文件有效期為1小時，在24小時后會被系統(tǒng)自動清理刪除。