📄 ระบบตรวจสอบและแยกข้อมูลจากทะเบียนบ้านภาษาไทย (Civil Registeration Certificate OCR) 🆕

📄 แบบรับรองรายการทะเบียนราษฎร

ยินดีต้อนรับสู่ API ระบบตรวจสอบและแยกข้อมูลจากเอกสารทะเบียนบ้านภาษาไทยด้วยเทคโนโลยี AI ซึ่งพัฒนาโดย บริษัท ไอแอพพ์เทคโนโลยี จำกัด สำหรับการดึงข้อมูลจากเอกสารทะเบียนบ้าน เอกสารฉบับนี้จะช่วยให้คุณสามารถใช้งานบริการ OCR ของเราได้อย่างมีประสิทธิภาพ

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

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

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

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

   • การประมวลผลที่รวดเร็ว (5-10 วินาทีต่อเอกสาร)
   • ความแม่นยำสูงในการแยกข้อความ
   • รองรับรูปแบบไฟล์หลายรูปแบบ

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

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

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

   • เป็นไปตามมาตรฐาน GDPR และ PDPA
   • จุดสิ้นสุด API ที่ปลอดภัย
   • ไม่มีการเก็บรักษาข้อมูลหลังจากการประมวลผลเสร็จสิ้น

วิธีการขอ API Key?

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

ตัวอย่าง

นี่คือตัวอย่างเอกสารทะเบียนบ้านและข้อมูลที่ถูกแยกออกมา:

คำขอ:

cURL

curl -X POST https://api.iapp.co.th/ocr/v3/civil-registeration-certificate/file \
-H apikey: YOUR_API_KEY \
-F file=@/path/to/document.jpg \
-F return_image=false \
-F return_ocr=false

การตอบสนอง:

{
    "message": "success",
    "processed": {
        "header": "(ท้องถิ่นเขตยานนาวา) ท.ร. 14/1",
        "title": "แบบรับรองรายการทะเบียนราษฎร จากฐานข้อมูลการทะเบียน\nสำนักทะเบียนกลาง กรมการปกครอง กระทรวงมหาดไทย",
        "nationalIdNumber": "X-XXXX-XXXXX-XX-X",
        "houseRegistrationNumber": "XXXX-XXXXXX-X",
        "name": "นายสXXXXX XXXXXXXXXXX",
        "gender": "ชาย",
        "nationality": "ไทย",
        "dateOfBirth": "8 XXXXXXX 2498",
        "age": 64,
        "residentialStatus": "เจ้าบ้าน",
        "mothersName": "XXXXX",
        "mothersNationality": "จีน",
        "fathersName": "XXXXX", 
        "fathersNationality": "จีน",
        "address": "XXX XXXXXXX XXX แขวงตลิ่งชัน เขตตลิ่งชัน กรุงเทพมหานคร",
        "registrationOffice": "ท้องถิ่นเขตตลิ่งชัน",
        "moveInDate": "28 เดือน XXXXXXX พ.ศ. 2537",
        "additionalNotes": "บุคคลนี้ถูกจำหน่ายชื่อจากทะเบียนบ้านเนื่องจากตาย เมื่อ 14 XXXXXXXX 2562",
        "remarks": "คัดรับรองตามคำร้องที่ ๗๙๐๘/๒๕๖๗ ลงวันที่ ๒ กันยายน ๒๕๖๗",
        "lastUpdated": "วันที่ 2 เดือน กันยายน พ.ศ. 2567",
        "footer": {
            "text": "รับรองว่าเป็นรายการจากฐานข้อมูลการทะเบียนราษฎร",
            "date": "2 เดือน กันยายน พ.ศ. 2567",
            "registrar": "นายอิทธิพัทธ์ เล็กชลยุทธ"
        }
    },
    "process_ms": 8115
}

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

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

1. การประมวลผลเอกสาร

   • การแยกข้อความและการจดจำข้อมูลด้วยความแม่นยำสูง
   • รองรับภาษาไทย
   • รองรับเอกสารที่พิมพ์
   • เวลาในการประมวลผลที่รวดเร็ว 5-10 วินาทีต่อเอกสาร
   • รองรับหลายรูปแบบ (JPEG, JPG, PNG, PDF)
   • การจัดการเอกสารแบบหน้าเดียว
   • ตัวเลือกในการส่งคืนข้อความ OCR ต้นฉบับและรูปภาพที่ผ่านการประมวลผล
   • การประมวลผลที่สอดคล้องกับ GDPR และ PDPA

2. การแยกข้อมูล

   • รูปแบบการตอบสนอง JSON ที่ยืดหยุ่นพร้อมการแยกข้อมูลรายละเอียด

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

ฟิลด์	ชนิด	คำอธิบาย
header	String	ชนิดเอกสารและเลขที่แบบฟอร์ม
title	String	ชื่อเอกสารอย่างเป็นทางการ
nationalIdNumber	String	เลขบัตรประชาชน 13 หลัก
houseRegistrationNumber	String	เลขที่บ้าน
name	String	ชื่อเต็มของบุคคล
gender	String	เพศของบุคคล
nationality	String	สัญชาติของบุคคล
dateOfBirth	String	วันเกิดในรูปแบบไทย
age	Number	อายุปัจจุบัน
residentialStatus	String	สถานะในครัวเรือน
mothersName	String	ชื่อเต็มของมารดา
mothersNationality	String	สัญชาติของมารดา
fathersName	String	ชื่อเต็มของบิดา
fathersNationality	String	สัญชาติของบิดา
address	String	ที่อยู่ปัจจุบัน
registrationOffice	String	ชื่อสำนักงานทะเบียน
moveInDate	String	วันที่ย้ายเข้ามาอยู่ที่อยู่ปัจจุบัน
additionalNotes	String	ข้อมูลเพิ่มเติม
remarks	String	หมายเหตุอย่างเป็นทางการ
lastUpdated	String	วันที่อัปเดตล่าสุด
footer	Object	ประกอบด้วยข้อความรับรอง วันที่ และข้อมูลเจ้าหน้าที่

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

การจดจำเอกสารทะเบียนบ้าน

จุดสิ้นสุดนี้จะประมวลผลรูปภาพหรือเอกสาร PDF ของทะเบียนบ้านและส่งคืนข้อมูลที่แยกออกมาในรูปแบบที่มีโครงสร้าง

POST https://api.iapp.co.th/ocr/v3/civil-registeration-certificate/file

ส่วนหัวของคำขอ

ชื่อ	ชนิด	จำเป็น	คำอธิบาย
apikey	string	ใช่	API key ของคุณ

เนื้อหาของคำขอ (multipart/form-data)

พารามิเตอร์	ชนิด	จำเป็น	คำอธิบาย
file	file	ใช่	รูปภาพเอกสาร (JPEG, PNG) หรือเอกสาร PDF
return_image	boolean	ไม่ใช่	รวมรูปภาพที่เข้ารหัส base64 ในการตอบสนอง (ค่าเริ่มต้น: false)
return_ocr	boolean	ไม่ใช่	รวมข้อความ OCR ดิบในการตอบสนอง (ค่าเริ่มต้น: false)

รูปแบบการตอบสนอง

{
    "message": "success",
    "raw": {
        "image": "string",  // Base64 encoded, only if return_image=true
        "text": "string"    // Only if return_ocr=true
    },
    "processed": {
        "header": "string",
        "title": "string",
        "nationalIdNumber": "string",
        "houseRegistrationNumber": "string",
        "name": "string",
        "gender": "string",
        "nationality": "string",
        "dateOfBirth": "string",
        "age": "number",
        "residentialStatus": "string",
        "mothersName": "string",
        "mothersNationality": "string",
        "fathersName": "string",
        "fathersNationality": "string",
        "address": "string",
        "registrationOffice": "string",
        "moveInDate": "string",
        "additionalNotes": "string",
        "remarks": "string",
        "lastUpdated": "string",
        "footer": {
            "text": "string",
            "date": "string",
            "registrar": "string"
        }
    },
    "process_ms": "number"
}

การจัดการข้อผิดพลาด

สถานะ	รหัส	คำอธิบาย
400	BAD_REQUEST	พารามิเตอร์หรือรูปแบบไฟล์ไม่ถูกต้อง
401	UNAUTHORIZED	API key ไม่ถูกต้องหรือหายไป
404	NOT_FOUND	จุดสิ้นสุดไม่ถูกต้อง
500	INTERNAL_SERVER_ERROR	การประมวลผลล้มเหลว

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

Python

import requests
apiKey = 'YOUR_API_KEY'
filePath = '/path/to/civil-registeration-certificate.jpg'
url = "https://api.iapp.co.th/ocr/v3/civil-registeration-certificate/file"

headers = {'apikey': apiKey}
files = {'file': ('civil-registeration-certificate.jpg', open(filePath, 'rb'), 'image/jpeg')}
data = {'return_image': 'false', 'return_ocr': 'false'}

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

Javascript

const axios = require('axios');
const FormData = require('form-data');
const fs = require('fs');

const apiKey = 'YOUR_API_KEY';
const filePath = '/path/to/civil-registeration-certificate.jpg';
const url = 'https://api.iapp.co.th/ocr/v3/civil-registeration-certificate/file';

const form = new FormData();
form.append('file', fs.createReadStream(filePath));
form.append('return_image', 'false');
form.append('return_ocr', 'false');

try {
    const response = await axios.post(
        url,
        form,
        {
            headers: {
                ...form.getHeaders(),
                'apikey': apiKey
            }
        }
    );
    return response.data;
} catch (error) {
    throw error;
}

PHP

$url = 'https://api.iapp.co.th/ocr/v3/civil-registeration-certificate/file';
$apiKey = 'YOUR_API_KEY';
$filePath = '/path/to/civil-registeration-certificate.jpg';

$headers = array(
    'apikey: ' . $apiKey
);

$postFields = array(
    'file' => new CURLFile($filePath),
    'return_image' => 'false',
    'return_ocr' => 'false'
);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postFields);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;

Swift

import Foundation

let url = URL(string: "https://api.iapp.co.th/ocr/v3/civil-registeration-certificate/file")!
let filePath = "/path/to/civil-registeration-certificate.jpg"
let apiKey = "YOUR_API_KEY"

var request = URLRequest(url: url)
request.httpMethod = "POST"
request.setValue(apiKey, forHTTPHeaderField: "apikey")

let boundary = UUID().uuidString
request.setValue("multipart/form-data; boundary=\(boundary)", forHTTPHeaderField: "Content-Type")

var body = Data()
body.append("--\(boundary)\r\n".data(using: .utf8)!)
body.append("Content-Disposition: form-data; name=\"file\"; filename=\"civil-registeration-certificate.jpg\"\r\n".data(using: .utf8)!)
body.append("Content-Type: image/jpeg\r\n\r\n".data(using: .utf8)!)
body.append(try! Data(contentsOf: URL(fileURLWithPath: filePath)))
body.append("\r\n--\(boundary)\r\n".data(using: .utf8)!)
body.append("Content-Disposition: form-data; name=\"return_image\"\r\n\r\nfalse\r\n".data(using: .utf8)!)
body.append("--\(boundary)\r\n".data(using: .utf8)!)
body.append("Content-Disposition: form-data; name=\"return_ocr\"\r\n\r\nfalse\r\n".data(using: .utf8)!)
body.append("--\(boundary)--\r\n".data(using: .utf8)!)

request.httpBody = body

let task = URLSession.shared.dataTask(with: request) { data, response, error in
    guard let data = data, error == nil else {
        print("Error: \(error?.localizedDescription ?? "Unknown error")")
        return
    }
    print(String(data: data, encoding: .utf8)!)
}

task.resume()

Kotlin

import okhttp3.*
import java.io.File

val client = OkHttpClient()
val apiKey = "YOUR_API_KEY"
val filePath = "/path/to/civil-registeration-certificate.jpg"
val url = "https://api.iapp.co.th/ocr/v3/civil-registeration-certificate/file"

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

val request = Request.Builder()
    .url(url)
    .post(requestBody)
    .addHeader("apikey", apiKey)
    .build()

client.newCall(request).enqueue(object : Callback {
    override fun onFailure(call: Call, e: IOException) {
        e.printStackTrace()
    }

    override fun onResponse(call: Call, response: Response) {
        response.use {
            if (!response.isSuccessful) throw IOException("Unexpected code $response")
            println(response.body()?.string())
        }
    }
})

Java

import okhttp3.*;
import java.io.File;
import java.io.IOException;

public class Main {
    public static void main(String[] args) {
        OkHttpClient client = new OkHttpClient();

        String apiKey = "YOUR_API_KEY";
        String url = "https://api.iapp.co.th/ocr/v3/civil-registeration-certificate/file";
        String filePath = "/path/to/civil-registeration-certificate.jpg";

        File file = new File(filePath);
        RequestBody requestBody = new MultipartBody.Builder()
            .setType(MultipartBody.FORM)
            .addFormDataPart("file", file.getName(), RequestBody.create(MediaType.parse("image/jpeg"), file))
            .addFormDataPart("return_image", "false")
            .addFormDataPart("return_ocr", "false")
            .build();

        Request request = new Request.Builder()
            .url(url)
            .post(requestBody)
            .addHeader("apikey", apiKey)
            .build();

        client.newCall(request).enqueue(new Callback() {
            @Override
            public void onFailure(Call call, IOException e) {
                e.printStackTrace();
            }

            @Override
            public void onResponse(Call call, Response response) throws IOException {
                if (!response.isSuccessful()) throw new IOException("Unexpected code " + response);
                System.out.println(response.body().string());
            }
        });
    }
}

Dart

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

String url = 'https://api.iapp.co.th/ocr/v3/civil-registeration-certificate/file';
String filePath = '/path/to/civil-registeration-certificate.jpg';
String apiKey = 'YOUR_API_KEY';

void main() async {
    var url = Uri.parse(url);
    var request = http.MultipartRequest('POST', url)
        ..headers['apikey'] = apiKey
        ..files.add(await http.MultipartFile.fromPath('file', filePath))
        ..fields['return_image'] = 'false'
        ..fields['return_ocr'] = 'false';

    var response = await request.send();

    if (response.statusCode == 200) {
        var responseData = await response.stream.bytesToString();
        print(responseData);
    } else {
        print('Error: ${response.statusCode}');
    }
}

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

ข้อจำกัด

• ขนาดไฟล์สูงสุด: 10MB
• ภาษาที่รองรับ: ไทย
• ไฟล์ PDF: หน้าเดียวเท่านั้น
• ขีดจำกัดอัตรา: 10 คำขอต่อวินาทีต่อ API key

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

1. ตรวจสอบให้แน่ใจว่าคุณภาพของรูปภาพดีเพื่อให้ได้ผลลัพธ์ที่ดีที่สุด
2. ใช้รูปแบบ JPEG หรือ PNG สำหรับรูปภาพ
3. ใช้การจัดการข้อผิดพลาดสำหรับคำขอที่ล้มเหลว
4. แคชการตอบสนองเมื่อประมวลผลเอกสารเดียวกันหลายครั้ง
5. ตั้งค่าระยะเวลาหมดเวลาที่เหมาะสมสำหรับไฟล์ขนาดใหญ่

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

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

จากชุดข้อมูลมาตรฐานของเรา 1,000 เอกสารทะเบียนบ้านภาษาไทย:

ชนิดฟิลด์	ความแม่นยำ (%)	หมายเหตุ
เลขประจำตัว	99.5%	เลขบัตรประชาชนและเลขที่บ้าน
ชื่อ	99.2%	ชื่อบุคคลและชื่อบิดา-มารดา
วันที่	98.7%	วันเกิดและวันที่ลงทะเบียน
ที่อยู่	97.8%	รายละเอียดที่อยู่ทั้งหมด
โดยรวม	98.8%	ค่าเฉลี่ยถ่วงน้ำหนัก

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

• เวลาในการประมวลผลเฉลี่ย: 5-10 วินาที
• เปอร์เซ็นไทล์ที่ 95: 12 วินาที
• เวลาในการประมวลผลสูงสุด: 15 วินาที

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

1. คุณภาพของรูปภาพ

   • ความละเอียด (แนะนำอย่างน้อย 300 DPI)
   • สภาพแสง
   • ความคมชัดของภาพ

2. สภาพของเอกสาร

   • ความเสียหายทางกายภาพ
   • การซีดจางหรือการสึกหรอ
   • การแก้ไขด้วยลายมือ

3. รูปแบบเอกสาร

   • รูปแบบมาตรฐาน: ความแม่นยำ 99%+
   • รูปแบบที่ไม่เป็นมาตรฐาน: ความแม่นยำ 95%+
   • องค์ประกอบลายมือ: ความแม่นยำ 90%+

ประวัติ

แบบจำลองของเราได้รับการฝึกฝนอย่างต่อเนื่องบนข้อมูลใหม่เพื่อปรับปรุงความแม่นยำ:

เวอร์ชัน	วันที่เผยแพร่	ความแม่นยำ	การปรับปรุงที่สำคัญ
3.0	2024-12-27	96.5%	เวอร์ชันพื้นฐาน