🛂 แกะข้อมูลผู้ถือพาสปอร์ต (Passport OCR)

🛂 พาสปอร์ต

ยินดีต้อนรับสู่ iApp Passport OCR API ผลิตภัณฑ์ AI ที่พัฒนาโดย บริษัท ไอแอพพ์เทคโนโลยี จำกัด API ของเราได้รับการออกแบบมาเพื่อจดจำและดึงข้อมูลจากภาพพาสปอร์ตที่สแกนโดยอัตโนมัติด้วยความแม่นยำและความเร็วสูง ระบบมุ่งเน้นไปที่การอ่านเขตข้อมูลที่อ่านได้ด้วยเครื่อง (MRZ) ที่ด้านล่างของหน้าพาสปอร์ต โดยดึงข้อมูลสำคัญ เช่น ชื่อผู้ถือสัญชาติ วันเกิด และอื่นๆ

Try Demo

Visit our API Portal to test the Passport OCR API with your own images.

เริ่มต้นใช้งาน

1. ข้อกำหนดเบื้องต้น

   • API key จาก ไอแอพพ์เทคโนโลยี
   • ภาพพาสปอร์ตที่สแกน (หน้ารูปถ่าย)
   • รูปแบบไฟล์ที่รองรับ: JPEG, JPG, PNG, PDF
   • ขนาดไฟล์สูงสุด: 10MB

2. เริ่มต้นอย่างรวดเร็ว

   • การประมวลผลที่รวดเร็ว (1-2 วินาทีต่อภาพ)
   • การดึงข้อความที่มีความแม่นยำสูง (95.51%)
   • รองรับรูปแบบไฟล์หลายรูปแบบ

3. คุณสมบัติหลัก

   • ดึงข้อมูลจาก MRZ ชนิด TD3
   • การให้คะแนนและการตรวจสอบความถูกต้องของ OCR
   • การดึงภาพใบหน้าในรูปแบบ base64
   • รองรับเอกสาร PDF หลายหน้า
   • จัดการกับภาพที่หมุนและเอียง
   • การประมวลผลล่วงหน้าการแบ่งส่วนภาพสำหรับภาพที่เอียง
   • รองรับภาษาไทยและภาษาอังกฤษ

4. ความปลอดภัยและการปฏิบัติตามกฎระเบียบ

   • ปฏิบัติตาม GDPR และ PDPA
   • ไม่มีการเก็บรักษาข้อมูลหลังจากการประมวลผล

วิธีรับ API Key?

กรุณาเยี่ยมชม API Portal เพื่อดู API key ที่มีอยู่ของคุณหรือขอ API key ใหม่

ตัวอย่าง

หน้ารูปถ่าย

คำขอ:

curl -X POST https://api.iapp.co.th/passport-ocr/v2/ocr \
-H "apikey: YOUR_API_KEY" \
-F "file=@/path/to/passport.jpg"

การตอบสนอง:

{
    "check_composite": "4",
    "check_date_of_birth": "4",
    "check_expiration_date": "4",
    "check_number": "6",
    "check_personal_number": "3",
    "country": "THA",
    "date_of_birth": "930710",
    "expiration_date": "250304",
    "method": "direct",
    "mrz_type": "TD3",
    "names": "MATHANIDA",
    "nationality": "THA",
    "number": "AC1062346",
    "personal_number": "0012345678913",
    "raw_text": "P<THAPOSHNASWADIWONG<<MATHANIDA<<<<<<<<<<<<<\nAC10623466THA9307104F25030440012345678913<34",
    "sex": "F",
    "surname": "POSHNASWADIWONG",
    "type": "P",
    "valid_composite": true,
    "valid_date_of_birth": true,
    "valid_expiration_date": true,
    "valid_number": true,
    "valid_personal_number": true,
    "valid_score": 100,
    "face": "/9j/4AAQSkZJRgABAQAAAQABAAD/..."
}

คำอธิบายฟิลด์การตอบสนอง

ฟิลด์	คำอธิบาย	รูปแบบ	ตัวอย่าง
check_composite	ตัวเลขตรวจสอบโดยรวมสำหรับบรรทัดที่อ่านได้ด้วยเครื่องด้านบนและกลาง	หลักเดียว	"4"
check_date_of_birth	ตัวเลขตรวจสอบสำหรับฟิลด์วันเกิด	หลักเดียว	"4"
check_expiration_date	ตัวเลขตรวจสอบสำหรับฟิลด์วันหมดอายุ	หลักเดียว	"4"
check_number	ตัวเลขตรวจสอบสำหรับหมายเลขเอกสาร	หลักเดียว	"6"
check_personal_number	ตัวเลขตรวจสอบสำหรับหมายเลขประจำตัว	หลักเดียว	"3"
country	รหัสประเทศของการออกพาสปอร์ต	3 ตัวอักษร	"THA"
date_of_birth	วันเกิด	YYMMDD	"930710"
expiration_date	วันหมดอายุของเอกสาร	YYMMDD	"250304"
method	วิธีการอ่านที่ใช้	ข้อความ	"direct"
mrz_type	ชนิดของเขตข้อมูลที่อ่านได้ด้วยเครื่อง	ข้อความ	"TD3"
names	ชื่อ/ชื่อจริง	ข้อความ	"MATHANIDA"
nationality	สัญชาติของผู้ถือ	3 ตัวอักษร	"THA"
number	หมายเลขพาสปอร์ต	ข้อความ	"AC1062346"
personal_number	หมายเลขประจำตัวประชาชน	ข้อความ	"0012345678913"
raw_text	ข้อความ MRZ ดิบจากพาสปอร์ต	ข้อความ	"P<THAPOSHNASWADIWONG..."
sex	เพศ	ตัวอักษรเดียว	"F"
surname	นามสกุล	ข้อความ	"POSHNASWADIWONG"
type	ชนิดเอกสาร	ข้อความ	"P"
valid_composite	การตรวจสอบความถูกต้องของ MRZ โดยรวม	บูลีน	true
valid_date_of_birth	ความถูกต้องของตัวเลขตรวจสอบวันเกิด	บูลีน	true
valid_expiration_date	ความถูกต้องของตัวเลขตรวจสอบวันหมดอายุ	บูลีน	true
valid_number	ความถูกต้องของตัวเลขตรวจสอบหมายเลขเอกสาร	บูลีน	true
valid_personal_number	ความถูกต้องของตัวเลขตรวจสอบหมายเลขประจำตัว	บูลีน	true
valid_score	คะแนนความถูกต้องโดยรวม	จำนวนเต็ม 0-100	100
face	ภาพใบหน้าที่ดึงออกมา	ข้อความ Base64	"/9j/4AAQSkZJRgABA..."

การประมวลผลไฟล์ PDF

เมื่อประมวลผลไฟล์ PDF รูปแบบการตอบสนองจะแตกต่างกันเล็กน้อย:

1. การตอบสนองจะเป็น JSON array ที่มีผลลัพธ์สำหรับแต่ละหน้า
2. ผลลัพธ์ของแต่ละหน้าประกอบด้วย:
   • page: หมายเลขหน้า
   • info: ประกอบด้วยฟิลด์มาตรฐานทั้งหมดตามที่แสดงไว้ข้างต้น
3. ฟิลด์ process_time แสดงระยะเวลาการประมวลผลทั้งหมด

ตัวอย่างโครงสร้างการตอบสนอง PDF:

[
    {
        "page": 1,
        "info": {
            "sex": "F",
            "number": "AC1062346",
            "expiration_date": "04/03/25",
            "raw_text": "P<THAPOSHNASWADIWONG<<MATHANIDA<<<<<<<<<<<<<\nAC10623466THA9307104F25030440012345678913<34",
            "personal_number": "0012345678913",
            "surname": "POSHNASWADIWONG",
            "nationality": "THA",
            "date_of_birth": "10/07/93",
            "names": "MATHANIDA",
            "country": "THA",
            "face": "iVBORw0...CYII=",
            "inference": "3.888",
            "file_name": "1676365480.3823211_thai_passport_page_1.png",
            "message": "Success",
            "status_code": 200
        }
    },
    {
        "process_time": "4.918s"
    }
]

คุณสมบัติและความสามารถ

คุณสมบัติหลัก

• การดึงข้อความ MRZ (Machine Readable Zone)
• การดึงภาพใบหน้า
• รองรับ PDF หลายหน้า
• การแก้ไขทิศทางภาพอัตโนมัติ
• การแบ่งส่วนภาพสำหรับภาพที่เอียง
• การตรวจสอบความถูกต้องที่มีความแม่นยำสูง

ฟิลด์ที่รองรับ

• ชนิดเอกสาร
• ประเทศที่ออก
• หมายเลขเอกสาร
• ชื่อผู้ถือ
• สัญชาติ
• วันเกิด
• เพศ
• วันหมดอายุ
• หมายเลขประจำตัว
• ภาพใบหน้า (base64)
• ข้อความ MRZ ดิบ
• คะแนนการตรวจสอบความถูกต้อง

ข้อมูลอ้างอิง API

การจดจำพาสปอร์ต

POST https://api.iapp.co.th/passport-ocr/v2

ดำเนินการ OCR บนหน้ารูปถ่ายพาสปอร์ตและดึงข้อมูล MRZ

พารามิเตอร์:

• file (จำเป็น): ไฟล์รูปภาพ (JPG, PNG, PDF)
• apikey (จำเป็น): API key ของคุณ
• options: เปิดใช้งาน "segmentation" สำหรับการประมวลผลภาพที่เอียง

ราคา

ชื่อบริการ AI API	Endpoint	IC ต่อคำขอ	On-Premise
Passport OCR [v2.0]	passport_ocr_v1	0.75 IC/Request	ติดต่อ
	passport_ocr_v2	0.75 IC/Request

ตัวอย่างโค้ด

Python

import requests

url = "https://api.iapp.co.th/passport-ocr/v2/ocr"
headers = {
"apikey": "YOUR_API_KEY"
}
files = {
"file": open("passport.jpg", "rb")
}

response = requests.post(url, headers=headers, files=files)
print(response.json())

JavaScript

const axios = require("axios")
const FormData = require("form-data")
const fs = require("fs")

let data = new FormData()
data.append("file", fs.createReadStream("passport.jpg"))

let config = {
    method: "post",
    url: "https://api.iapp.co.th/passport-ocr/v2/ocr",
    headers: {
        apikey: "YOUR_API_KEY",
        ...data.getHeaders(),
    },
    data: data,
}

axios(config)
    .then((response) => console.log(response.data))
    .catch((error) => console.log(error))

PHP

<?php
$curl = curl_init();

curl_setopt_array($curl, array(
CURLOPT_URL => 'https://api.iapp.co.th/passport-ocr/v2/ocr',
CURLOPT_RETURNTRANSFER => true,
CURLOPT_POST => true,
CURLOPT_HTTPHEADER => array(
    'apikey: YOUR_API_KEY'
),
CURLOPT_POSTFIELDS => array(
    'file'=> new CURLFILE('passport.jpg')
)
));

$response = curl_exec($curl);
curl_close($curl);
echo $response;

Swift

import Foundation

let url = URL(string: "https://api.iapp.co.th/passport-ocr/v2/ocr")!
let boundary = "Boundary-\(UUID().uuidString)"

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue("YOUR_API_KEY", forHTTPHeaderField: "apikey")
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

let imageData = try! Data(contentsOf: URL(fileURLWithPath: "passport.jpg"))

var body = Data()
body.append("--\(boundary)\r\n")
body.append("Content-Disposition: form-data; name=\"file\"; filename=\"passport.jpg\"\r\n")
body.append("Content-Type: image/jpeg\r\n\r\n")
body.append(imageData)
body.append("\r\n--\(boundary)--\r\n")

let task = URLSession.shared.uploadTask(with: request, from: body) { data, response, error in
    if let data = data {
        let json = try? JSONSerialization.jsonObject(with: data)
        print(json ?? "")
    }
}
task.resume()

Kotlin

import okhttp3.*
import java.io.File

val client = OkHttpClient()

val file = File("passport.jpg")
val requestBody = MultipartBody.Builder()
    .setType(MultipartBody.FORM)
    .addFormDataPart(
        "file",
        file.name,
        RequestBody.create(MediaType.parse("image/jpeg"), file)
    )
    .build()

val request = Request.Builder()
    .url("https://api.iapp.co.th/passport-ocr/v2/ocr")
    .addHeader("apikey", "YOUR_API_KEY")
    .post(requestBody)
    .build()

client.newCall(request).execute().use { response ->
    println(response.body()?.string())
}

Java

import java.io.*;
import java.net.HttpURLConnection;
import java.net.URL;
import java.nio.file.*;

public class PassportOCR {
    public static void main(String[] args) throws IOException {
        String boundary = "Boundary-" + System.currentTimeMillis();
        URL url = new URL("https://api.iapp.co.th/passport-ocr/v2/ocr");
        HttpURLConnection conn = (HttpURLConnection) url.openConnection();

        conn.setRequestMethod("POST");
        conn.setDoOutput(true);
        conn.setRequestProperty("apikey", "YOUR_API_KEY");
        conn.setRequestProperty("Content-Type", "multipart/form-data; boundary=" + boundary);

        try (OutputStream os = conn.getOutputStream()) {
            byte[] fileBytes = Files.readAllBytes(Paths.get("passport.jpg"));

            os.write(("--" + boundary + "\r\n").getBytes());
            os.write(("Content-Disposition: form-data; name=\"file\"; filename=\"passport.jpg\"\r\n").getBytes());
            os.write(("Content-Type: image/jpeg\r\n\r\n").getBytes());
            os.write(fileBytes);
            os.write(("\r\n--" + boundary + "--\r\n").getBytes());
        }

        try (BufferedReader br = new BufferedReader(new InputStreamReader(conn.getInputStream()))) {
            String line;
            while ((line = br.readLine()) != null) {
                System.out.println(line);
            }
        }
    }
}

Dart

import 'package:http/http.dart' as http;
import 'dart:io';

Future<void> scanPassport() async {
    var url = Uri.parse('https://api.iapp.co.th/passport-ocr/v2/ocr');
    var request = http.MultipartRequest('POST', url);

    request.headers['apikey'] = 'YOUR_API_KEY';

    request.files.add(
    await http.MultipartFile.fromPath(
        'file',
        'passport.jpg',
    ),
    );

    var response = await request.send();
    var responseBody = await response.stream.bytesToString();
    print(responseBody);
}

ข้อจำกัดและแนวทางปฏิบัติที่ดีที่สุด

ข้อจำกัด

• ขนาดไฟล์สูงสุด: 10MB
• รูปแบบที่รองรับ: JPG, PNG, PDF
• พาสปอร์ตหนึ่งเล่มต่อภาพหนึ่งภาพ
• จำเป็นต้องใช้ภาพที่ชัดเจนและโฟกัส

แนวทางปฏิบัติที่ดีที่สุด

• ตรวจสอบให้แน่ใจว่าสภาพแสงสว่างดี
• หลีกเลี่ยงแสงสะท้อนและแสงจ้า
• จัดวางพาสปอร์ตให้ตรงกลางเฟรม
• วางพาสปอร์ตให้เรียบ
• ใช้ภาพความละเอียดสูง
• เปิดใช้งานตัวเลือกการแบ่งส่วนสำหรับภาพที่เอียง

ความแม่นยำและประสิทธิภาพ

ความแม่นยำโดยรวม

• เวอร์ชันปัจจุบัน (2.0): 95.51%
• เวอร์ชันก่อนหน้า (1.1): 88.86%

ความแม่นยำในระดับฟิลด์ (เวอร์ชัน 1.1)

• ชื่อ: 81.93%
• นามสกุล: 90.26%
• หมายเลขเอกสาร: 84.03%
• สัญชาติ: 88.09%
• การตรวจจับใบหน้า: 100%

ความเร็วในการประมวลผล

• ภาพเดียว: 1-2 วินาที
• เอกสาร PDF: 2-3 วินาทีต่อหน้า
• เวลาเพิ่มเติมเมื่อใช้การแบ่งส่วน

ปัจจัยที่ส่งผลต่อความแม่นยำ

• คุณภาพของภาพ
• สภาพแสงสว่าง
• ตำแหน่งของเอกสาร
• ความละเอียดของภาพ
• สภาพของเอกสาร
• มุมเอียงของภาพ

ประวัติ

เวอร์ชัน 2.0 (กุมภาพันธ์ 2023)

• เพิ่มความแม่นยำโดยรวมจาก 88.86% เป็น 95.51%
• อัปเกรดเครื่องมือ OCR ทั้งหมด
• เพิ่มการประมวลผลล่วงหน้าการแบ่งส่วนภาพสำหรับภาพที่เอียง

เวอร์ชัน 1.1 (มกราคม 2023)

• เพิ่มการดึงใบหน้าเป็น base64
• เพิ่มการรองรับภาพที่เอียงเล็กน้อย
• เพิ่มการรองรับไฟล์ PDF
• เพิ่มการรองรับ PDF หลายหน้า

เวอร์ชัน 1.0 (กุมภาพันธ์ 2022)

• การเปิดตัวครั้งแรก
• รองรับพาสปอร์ตของทุกประเทศที่ใช้ MRZ
• รองรับรูปแบบไฟล์พื้นฐาน (PNG, JPG, JPEG)

ราคา

ชื่อบริการ AI API	Endpoint	IC ต่อคำขอ	On-Premise
Passport OCR [v2.0]	passport_ocr_v1	0.75 IC/Request	ติดต่อ
	passport_ocr_v2	0.75 IC/Request