<?php
namespace addons\cms\library\aip;
/*
* Copyright (c) 2017 Baidu.com, Inc. All Rights Reserved
*
* Licensed under the Apache License, Version 2.0 (the "License"); you may not
* use this file except in compliance with the License. You may obtain a copy of
* the License at
*
* Http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
* WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
* License for the specific language governing permissions and limitations under
* the License.
*/
use addons\cms\library\aip\lib\AipBase;
class AipOcr extends AipBase
{
/**
* 通用文字识别 general_basic api url
* @var string
*/
private $generalBasicUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/general_basic';
/**
* 通用文字识别（高精度版） accurate_basic api url
* @var string
*/
private $accurateBasicUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/accurate_basic';
/**
* 通用文字识别（含位置信息版） general api url
* @var string
*/
private $generalUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/general';
/**
* 通用文字识别（含位置高精度版） accurate api url
* @var string
*/
private $accurateUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/accurate';
/**
* 通用文字识别（含生僻字版） general_enhanced api url
* @var string
*/
private $generalEnhancedUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/general_enhanced';
/**
* 网络图片文字识别 web_image api url
* @var string
*/
private $webImageUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/webimage';
/**
* 身份证识别 idcard api url
* @var string
*/
private $idcardUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/idcard';
/**
* 银行卡识别 bankcard api url
* @var string
*/
private $bankcardUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/bankcard';
/**
* 驾驶证识别 driving_license api url
* @var string
*/
private $drivingLicenseUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/driving_license';
/**
* 行驶证识别 vehicle_license api url
* @var string
*/
private $vehicleLicenseUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/vehicle_license';
/**
* 车牌识别 license_plate api url
* @var string
*/
private $licensePlateUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/license_plate';
/**
* 营业执照识别 business_license api url
* @var string
*/
private $businessLicenseUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/business_license';
/**
* 通用票据识别 receipt api url
* @var string
*/
private $receiptUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/receipt';
/**
* 火车票识别 train_ticket api url
* @var string
*/
private $trainTicketUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/train_ticket';
/**
* 出租车票识别 taxi_receipt api url
* @var string
*/
private $taxiReceiptUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/taxi_receipt';
/**
* 表格文字识别同步接口 form api url
* @var string
*/
private $formUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/form';
/**
* 表格文字识别 table_recognize api url
* @var string
*/
private $tableRecognizeUrl = 'https://aip.baidubce.com/rest/2.0/solution/v1/form_ocr/request';
/**
* 表格识别结果 table_result_get api url
* @var string
*/
private $tableResultGetUrl = 'https://aip.baidubce.com/rest/2.0/solution/v1/form_ocr/get_request_result';
/**
* VIN码识别 vin_code api url
* @var string
*/
private $vinCodeUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/vin_code';
/**
* 定额发票识别 quota_invoice api url
* @var string
*/
private $quotaInvoiceUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/quota_invoice';
/**
* 户口本识别 household_register api url
* @var string
*/
private $householdRegisterUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/household_register';
/**
* 港澳通行证识别 HK_Macau_exitentrypermit api url
* @var string
*/
private $HKMacauExitentrypermitUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/HK_Macau_exitentrypermit';
/**
* 台湾通行证识别 taiwan_exitentrypermit api url
* @var string
*/
private $taiwanExitentrypermitUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/taiwan_exitentrypermit';
/**
* 出生医学证明识别 birth_certificate api url
* @var string
*/
private $birthCertificateUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/birth_certificate';
/**
* 机动车销售发票识别 vehicle_invoice api url
* @var string
*/
private $vehicleInvoiceUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/vehicle_invoice';
/**
* 车辆合格证识别 vehicle_certificate api url
* @var string
*/
private $vehicleCertificateUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/vehicle_certificate';
/**
* 税务局通用机打发票识别 invoice api url
* @var string
*/
private $invoiceUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/invoice';
/**
* 行程单识别 air_ticket api url
* @var string
*/
private $airTicketUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/air_ticket';
/**
* 保单识别 insurance_documents api url
* @var string
*/
private $insuranceDocumentsUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/insurance_documents';
/**
* 增值税发票识别 vat_invoice api url
* @var string
*/
private $vatInvoiceUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/vat_invoice';
/**
* 二维码识别 qrcode api url
* @var string
*/
private $qrcodeUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/qrcode';
/**
* 数字识别 numbers api url
* @var string
*/
private $numbersUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/numbers';
/**
* 彩票识别 lottery api url
* @var string
*/
private $lotteryUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/lottery';
/**
* 护照识别 passport api url
* @var string
*/
private $passportUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/passport';
/**
* 名片识别 business_card api url
* @var string
*/
private $businessCardUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/business_card';
/**
* 手写文字识别 handwriting api url
* @var string
*/
private $handwritingUrl = 'https://aip.baidubce.com/rest/2.0/ocr/v1/handwriting';
/**
* 自定义模板文字识别 custom api url
* @var string
*/
private $customUrl = 'https://aip.baidubce.com/rest/2.0/solution/v1/iocr/recognise';
/**
* 通用文字识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* language_type 识别语言类型，默认为CHN_ENG。可选值包括：<br>- CHN_ENG：中英文混合；<br>- ENG：英文；<br>- POR：葡萄牙语；<br>- FRE：法语；<br>- GER：德语；<br>- ITA：意大利语；<br>- SPA：西班牙语；<br>- RUS：俄语；<br>- JAP：日语；<br>- KOR：韩语；
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* detect_language 是否检测语言，默认不检测。当前支持（中文、英语、日语、韩语）
* probability 是否返回识别结果中每一行的置信度
* @return array
*/
public function basicGeneral($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->generalBasicUrl, $data);
}
/**
* 通用文字识别接口
*
* @param string $url - 图片完整URL，URL长度不超过1024字节，URL对应的图片base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式，当image字段存在时url字段失效
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* language_type 识别语言类型，默认为CHN_ENG。可选值包括：<br>- CHN_ENG：中英文混合；<br>- ENG：英文；<br>- POR：葡萄牙语；<br>- FRE：法语；<br>- GER：德语；<br>- ITA：意大利语；<br>- SPA：西班牙语；<br>- RUS：俄语；<br>- JAP：日语；<br>- KOR：韩语；
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* detect_language 是否检测语言，默认不检测。当前支持（中文、英语、日语、韩语）
* probability 是否返回识别结果中每一行的置信度
* @return array
*/
public function basicGeneralUrl($url, $options = array())
{
$data = array();
$data['url'] = $url;
$data = array_merge($data, $options);
return $this->request($this->generalBasicUrl, $data);
}
/**
* 通用文字识别（高精度版）接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* probability 是否返回识别结果中每一行的置信度
* @return array
*/
public function basicAccurate($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->accurateBasicUrl, $data);
}
/**
* 通用文字识别（含位置信息版）接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* recognize_granularity 是否定位单字符位置，big：不定位单字符位置，默认值；small：定位单字符位置
* language_type 识别语言类型，默认为CHN_ENG。可选值包括：<br>- CHN_ENG：中英文混合；<br>- ENG：英文；<br>- POR：葡萄牙语；<br>- FRE：法语；<br>- GER：德语；<br>- ITA：意大利语；<br>- SPA：西班牙语；<br>- RUS：俄语；<br>- JAP：日语；<br>- KOR：韩语；
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* detect_language 是否检测语言，默认不检测。当前支持（中文、英语、日语、韩语）
* vertexes_location 是否返回文字外接多边形顶点位置，不支持单字位置。默认为false
* probability 是否返回识别结果中每一行的置信度
* @return array
*/
public function general($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->generalUrl, $data);
}
/**
* 通用文字识别（含位置信息版）接口
*
* @param string $url - 图片完整URL，URL长度不超过1024字节，URL对应的图片base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式，当image字段存在时url字段失效
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* recognize_granularity 是否定位单字符位置，big：不定位单字符位置，默认值；small：定位单字符位置
* language_type 识别语言类型，默认为CHN_ENG。可选值包括：<br>- CHN_ENG：中英文混合；<br>- ENG：英文；<br>- POR：葡萄牙语；<br>- FRE：法语；<br>- GER：德语；<br>- ITA：意大利语；<br>- SPA：西班牙语；<br>- RUS：俄语；<br>- JAP：日语；<br>- KOR：韩语；
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* detect_language 是否检测语言，默认不检测。当前支持（中文、英语、日语、韩语）
* vertexes_location 是否返回文字外接多边形顶点位置，不支持单字位置。默认为false
* probability 是否返回识别结果中每一行的置信度
* @return array
*/
public function generalUrl($url, $options = array())
{
$data = array();
$data['url'] = $url;
$data = array_merge($data, $options);
return $this->request($this->generalUrl, $data);
}
/**
* 通用文字识别（含位置高精度版）接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* recognize_granularity 是否定位单字符位置，big：不定位单字符位置，默认值；small：定位单字符位置
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* vertexes_location 是否返回文字外接多边形顶点位置，不支持单字位置。默认为false
* probability 是否返回识别结果中每一行的置信度
* @return array
*/
public function accurate($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->accurateUrl, $data);
}
/**
* 通用文字识别（含生僻字版）接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* language_type 识别语言类型，默认为CHN_ENG。可选值包括：<br>- CHN_ENG：中英文混合；<br>- ENG：英文；<br>- POR：葡萄牙语；<br>- FRE：法语；<br>- GER：德语；<br>- ITA：意大利语；<br>- SPA：西班牙语；<br>- RUS：俄语；<br>- JAP：日语；<br>- KOR：韩语；
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* detect_language 是否检测语言，默认不检测。当前支持（中文、英语、日语、韩语）
* probability 是否返回识别结果中每一行的置信度
* @return array
*/
public function enhancedGeneral($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->generalEnhancedUrl, $data);
}
/**
* 通用文字识别（含生僻字版）接口
*
* @param string $url - 图片完整URL，URL长度不超过1024字节，URL对应的图片base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式，当image字段存在时url字段失效
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* language_type 识别语言类型，默认为CHN_ENG。可选值包括：<br>- CHN_ENG：中英文混合；<br>- ENG：英文；<br>- POR：葡萄牙语；<br>- FRE：法语；<br>- GER：德语；<br>- ITA：意大利语；<br>- SPA：西班牙语；<br>- RUS：俄语；<br>- JAP：日语；<br>- KOR：韩语；
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* detect_language 是否检测语言，默认不检测。当前支持（中文、英语、日语、韩语）
* probability 是否返回识别结果中每一行的置信度
* @return array
*/
public function enhancedGeneralUrl($url, $options = array())
{
$data = array();
$data['url'] = $url;
$data = array_merge($data, $options);
return $this->request($this->generalEnhancedUrl, $data);
}
/**
* 网络图片文字识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* detect_language 是否检测语言，默认不检测。当前支持（中文、英语、日语、韩语）
* @return array
*/
public function webImage($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->webImageUrl, $data);
}
/**
* 网络图片文字识别接口
*
* @param string $url - 图片完整URL，URL长度不超过1024字节，URL对应的图片base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式，当image字段存在时url字段失效
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* detect_language 是否检测语言，默认不检测。当前支持（中文、英语、日语、韩语）
* @return array
*/
public function webImageUrl($url, $options = array())
{
$data = array();
$data['url'] = $url;
$data = array_merge($data, $options);
return $this->request($this->webImageUrl, $data);
}
/**
* 身份证识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param string $idCardSide - front：身份证含照片的一面；back：身份证带国徽的一面
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* detect_risk 是否开启身份证风险类型(身份证复印件、临时身份证、身份证翻拍、修改过的身份证)功能，默认不开启，即：false。可选值:true-开启；false-不开启
* @return array
*/
public function idcard($image, $idCardSide, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data['id_card_side'] = $idCardSide;
$data = array_merge($data, $options);
return $this->request($this->idcardUrl, $data);
}
/**
* 银行卡识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function bankcard($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->bankcardUrl, $data);
}
/**
* 驾驶证识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* @return array
*/
public function drivingLicense($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->drivingLicenseUrl, $data);
}
/**
* 行驶证识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* accuracy normal 使用快速服务，1200ms左右时延；缺省或其它值使用高精度服务，1600ms左右时延
* @return array
*/
public function vehicleLicense($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->vehicleLicenseUrl, $data);
}
/**
* 车牌识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* multi_detect 是否检测多张车牌，默认为false，当置为true的时候可以对一张图片内的多张车牌进行识别
* @return array
*/
public function licensePlate($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->licensePlateUrl, $data);
}
/**
* 营业执照识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function businessLicense($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->businessLicenseUrl, $data);
}
/**
* 通用票据识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* recognize_granularity 是否定位单字符位置，big：不定位单字符位置，默认值；small：定位单字符位置
* probability 是否返回识别结果中每一行的置信度
* accuracy normal 使用快速服务，1200ms左右时延；缺省或其它值使用高精度服务，1600ms左右时延
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* @return array
*/
public function receipt($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->receiptUrl, $data);
}
/**
* 火车票识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function trainTicket($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->trainTicketUrl, $data);
}
/**
* 出租车票识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function taxiReceipt($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->taxiReceiptUrl, $data);
}
/**
* 表格文字识别同步接口接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function form($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->formUrl, $data);
}
/**
* 表格文字识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function tableRecognitionAsync($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->tableRecognizeUrl, $data);
}
/**
* 表格识别结果接口
*
* @param string $requestId - 发送表格文字识别请求时返回的request id
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* result_type 期望获取结果的类型，取值为“excel”时返回xls文件的地址，取值为“json”时返回json格式的字符串,默认为”excel”
* @return array
*/
public function getTableRecognitionResult($requestId, $options = array())
{
$data = array();
$data['request_id'] = $requestId;
$data = array_merge($data, $options);
return $this->request($this->tableResultGetUrl, $data);
}
/**
* VIN码识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function vinCode($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->vinCodeUrl, $data);
}
/**
* 定额发票识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function quotaInvoice($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->quotaInvoiceUrl, $data);
}
/**
* 户口本识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function householdRegister($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->householdRegisterUrl, $data);
}
/**
* 港澳通行证识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function HKMacauExitentrypermit($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->HKMacauExitentrypermitUrl, $data);
}
/**
* 台湾通行证识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function taiwanExitentrypermit($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->taiwanExitentrypermitUrl, $data);
}
/**
* 出生医学证明识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function birthCertificate($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->birthCertificateUrl, $data);
}
/**
* 机动车销售发票识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function vehicleInvoice($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->vehicleInvoiceUrl, $data);
}
/**
* 车辆合格证识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function vehicleCertificate($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->vehicleCertificateUrl, $data);
}
/**
* 税务局通用机打发票识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* location 是否输出位置信息，true：输出位置信息，false：不输出位置信息，默认false
* @return array
*/
public function invoice($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->invoiceUrl, $data);
}
/**
* 行程单识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* location 是否输出位置信息，true：输出位置信息，false：不输出位置信息，默认false
* @return array
*/
public function airTicket($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->airTicketUrl, $data);
}
/**
* 保单识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* rkv_business 是否进行商业逻辑处理，rue：进行商业逻辑处理，false：不进行商业逻辑处理，默认true
* @return array
*/
public function insuranceDocuments($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->insuranceDocumentsUrl, $data);
}
/**
* 增值税发票识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function vatInvoice($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->vatInvoiceUrl, $data);
}
/**
* 二维码识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function qrcode($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->qrcodeUrl, $data);
}
/**
* 数字识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* recognize_granularity 是否定位单字符位置，big：不定位单字符位置，默认值；small：定位单字符位置
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:<br>- true：检测朝向；<br>- false：不检测朝向。
* @return array
*/
public function numbers($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->numbersUrl, $data);
}
/**
* 彩票识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* recognize_granularity 是否定位单字符位置，big：不定位单字符位置，默认值；small：定位单字符位置
* @return array
*/
public function lottery($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->lotteryUrl, $data);
}
/**
* 护照识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function passport($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->passportUrl, $data);
}
/**
* 名片识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function businessCard($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->businessCardUrl, $data);
}
/**
* 手写文字识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* recognize_granularity 是否定位单字符位置，big：不定位单字符位置，默认值；small：定位单字符位置
* @return array
*/
public function handwriting($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->handwritingUrl, $data);
}
/**
* 自定义模板文字识别接口
*
* @param string $image - 图像数据，base64编码，要求base64编码后大小不超过4M，最短边至少15px，最长边最大4096px,支持jpg/png/bmp格式
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* templateSign 您在自定义文字识别平台制作的模板的ID
* classifierId 分类器Id。这个参数和templateSign至少存在一个，优先使用templateSign。存在templateSign时，表示使用指定模板；如果没有templateSign而有classifierId，表示使用分类器去判断使用哪个模板
* @return array
*/
public function custom($image, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data = array_merge($data, $options);
return $this->request($this->customUrl, $data);
}
/**
* 同步请求
* @param string $image 图像读取
* @param options 接口可选参数
* @return array
*/
public function tableRecognition($image, $options = array(), $timeout = 10000)
{
$result = $this->tableRecognitionAsync($image);
if (isset($result['error_code'])) {
return $result;
}
$requestId = $result['result'][0]['request_id'];
$count = ceil($timeout / 1000);
for ($i = 0; $i < $count; $i++) {
$result = $this->getTableRecognitionResult($requestId, $options);
// 完成
if ($result['result']['ret_code'] == 3) {
break;
}
sleep(1);
}
return $result;
}
}