- CHN_ENG：中英文混合；
- ENG：英文；
- POR：葡萄牙语；
- FRE：法语；
- GER：德语；
- ITA：意大利语；
- SPA：西班牙语；
- RUS：俄语；
- JAP：日语；
- KOR：韩语；
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:
- true：检测朝向；
- 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。可选值包括：
- CHN_ENG：中英文混合；
- ENG：英文；
- POR：葡萄牙语；
- FRE：法语；
- GER：德语；
- ITA：意大利语；
- SPA：西班牙语；
- RUS：俄语；
- JAP：日语；
- KOR：韩语；
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:
- true：检测朝向；
- 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度。可选值包括:
- true：检测朝向；
- 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。可选值包括：
- CHN_ENG：中英文混合；
- ENG：英文；
- POR：葡萄牙语；
- FRE：法语；
- GER：德语；
- ITA：意大利语；
- SPA：西班牙语；
- RUS：俄语；
- JAP：日语；
- KOR：韩语；
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:
- true：检测朝向；
- 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。可选值包括：
- CHN_ENG：中英文混合；
- ENG：英文；
- POR：葡萄牙语；
- FRE：法语；
- GER：德语；
- ITA：意大利语；
- SPA：西班牙语；
- RUS：俄语；
- JAP：日语；
- KOR：韩语；
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:
- true：检测朝向；
- 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度。可选值包括:
- true：检测朝向；
- 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。可选值包括：
- CHN_ENG：中英文混合；
- ENG：英文；
- POR：葡萄牙语；
- FRE：法语；
- GER：德语；
- ITA：意大利语；
- SPA：西班牙语；
- RUS：俄语；
- JAP：日语；
- KOR：韩语；
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:
- true：检测朝向；
- 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。可选值包括：
- CHN_ENG：中英文混合；
- ENG：英文；
- POR：葡萄牙语；
- FRE：法语；
- GER：德语；
- ITA：意大利语；
- SPA：西班牙语；
- RUS：俄语；
- JAP：日语；
- KOR：韩语；
* detect_direction 是否检测图像朝向，默认不检测，即：false。朝向是指输入图像是正常方向、逆时针旋转90/180/270度。可选值包括:
- true：检测朝向；
- 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度。可选值包括:
- true：检测朝向；
- 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度。可选值包括:
- true：检测朝向；
- 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度。可选值包括:
- true：检测朝向；
- 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度。可选值包括:
- true：检测朝向；
- 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度。可选值包括:
- true：检测朝向；
- 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度。可选值包括:
- true：检测朝向；
- 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 string $templateSign - 您在自定义文字识别平台制作的模版的ID
* @param array $options - 可选参数对象，key: value都为string类型
* @description options列表:
* @return array
*/
public function custom($image, $templateSign, $options = array())
{
$data = array();
$data['image'] = base64_encode($image);
$data['templateSign'] = $templateSign;
$data = array_merge($data, $options);
return $this->request($this->customUrl, $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);
}
/**
* 同步请求
* @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;
}
}